Backoffice Module - Detaillierte Übersicht

1. CRM (Customer Relationship Management)

Beschreibung

Das CRM-Modul ist das Herzstück der Kundenverwaltung. Es ermöglicht die zentrale Verwaltung aller Kundenbeziehungen, Kontakte und zugehöriger Aktivitäten.

Hauptfunktionen

Kundenverwaltung: Stammdatenpflege mit Name, E-Mail, Telefon, Adresse, Steuernummer
Kundentypen: Unterscheidung zwischen B2B/B2C
Kontaktpersonen: Mehrere Ansprechpartner pro Kunde mit Position und Kontaktdaten
Kundenhistorie: Übersicht über alle Aktivitäten, Projekte, Rechnungen
CRM-Dashboard: KPIs, aktive Kunden, Umsatzstatistiken

API-Endpunkte

GET    /api/backoffice/crm/customers       → Alle Kunden
GET    /api/backoffice/crm/customers/:id   → Einzelner Kunde
POST   /api/backoffice/crm/customers       → Neuer Kunde
PUT    /api/backoffice/crm/customers/:id   → Kunde aktualisieren
DELETE /api/backoffice/crm/customers/:id   → Kunde löschen

GET    /api/backoffice/crm/contacts        → Alle Kontakte
GET    /api/backoffice/crm/contacts/:id    → Einzelner Kontakt
POST   /api/backoffice/crm/contacts        → Neuer Kontakt
PUT    /api/backoffice/crm/contacts/:id    → Kontakt aktualisieren
DELETE /api/backoffice/crm/contacts/:id    → Kontakt löschen

GET    /api/backoffice/crm/stats           → CRM-Statistiken
GET    /api/backoffice/crm/activities      → CRM-Aktivitäten

Datenmodell

interface Customer {
  id: string;
  name: string;
  type: "B2B" | "B2C";
  email: string | null;
  phone: string | null;
  tax_id: string | null;
  address: string | null;
  created_at: string;
  updated_at: string;
}

interface Contact {
  id: string;
  customer_id: string;
  firstname: string;
  lastname: string;
  email: string | null;
  phone: string | null;
  position: string | null;
  created_at: string;
  updated_at: string;
}

UI-Module

ui/src/modules/crm/CrmApp.vue - Hauptkomponente
ui/src/modules/crm/pages/CustomersListPage.vue - Kundenliste
ui/src/modules/crm/pages/CustomerDetailPage.vue - Kundendetails
ui/src/modules/crm/pages/ContactsListPage.vue - Kontaktliste
ui/src/modules/crm/pages/CrmDashboardPage.vue - CRM-Dashboard

Status

✅ Produktiv - Vollständig implementiert (Backend + Frontend)

Backend: backend/app/modules/backoffice/crm/
Frontend: ui/src/modules/crm/

2. Projektmanagement

Beschreibung

Verwaltung von Kundenprojekten mit Status-Tracking, Zeiterfassung und Team-Zuordnung.

Hauptfunktionen

Projektverwaltung: Titel, Beschreibung, Start-/Enddatum
Status-Tracking: Geplant, In Bearbeitung, Abgeschlossen, Abgebrochen
Kundenzuordnung: Verknüpfung mit CRM-Kunden
Abteilungszuordnung: Zuständige Abteilung
Projektübersicht: Dashboard mit allen aktiven Projekten

API-Endpunkte

GET    /api/backoffice/projects            → Alle Projekte
GET    /api/backoffice/projects/:id        → Einzelnes Projekt
POST   /api/backoffice/projects            → Neues Projekt
PUT    /api/backoffice/projects/:id        → Projekt aktualisieren
DELETE /api/backoffice/projects/:id        → Projekt löschen
GET    /api/backoffice/projects/:id/stats  → Projekt-Statistiken

Datenmodell

interface Project {
  id: string;
  customer_id: string;
  department_id: string;
  title: string;
  status: "planned" | "in_progress" | "completed" | "cancelled";
  start_date: string;
  end_date: string | null;
  description: string | null;
  created_at: string;
  updated_at: string;
}

Status

✅ Vollständig - Backend + Frontend implementiert

Backend: backend/app/modules/backoffice/projects/ ✅
Frontend: ui/src/modules/projects/ ✅
- ProjectsDashboardPage.vue
- ProjectsListPage.vue
- ProjectDetailPage.vue
- ProjectFormPage.vue
API-Endpunkte: Alle CRUD-Operationen verfügbar
Features: Filter nach Kunde, Pagination, Status-Management

3. Zeiterfassung

Beschreibung

Erfassung von Arbeitszeiten pro Mitarbeiter und Projekt mit automatischer Dauerberechnung.

Hauptfunktionen

Zeitbuchung: Start-/Endzeit mit automatischer Berechnung
Projektbezug: Jede Zeitbuchung einem Projekt zugeordnet
Notizen: Beschreibung der durchgeführten Tätigkeit
Mitarbeiterübersicht: Zeitbuchungen pro Mitarbeiter
Projektübersicht: Gesamtzeit pro Projekt
Zeitberichte: Export & Auswertungen

API-Endpunkte

GET    /api/backoffice/time-entries               → Alle Zeiteinträge
GET    /api/backoffice/time-entries/:id           → Einzelner Zeiteintrag
POST   /api/backoffice/time-entries               → Neuer Zeiteintrag
PUT    /api/backoffice/time-entries/:id           → Zeiteintrag aktualisieren
DELETE /api/backoffice/time-entries/:id           → Zeiteintrag löschen
GET    /api/backoffice/time-entries/by-project/:id → Nach Projekt
GET    /api/backoffice/time-entries/by-employee/:id → Nach Mitarbeiter

Datenmodell

interface TimeEntry {
  id: string;
  employee_id: string;
  project_id: string;
  start_time: string;      // ISO 8601 Timestamp
  end_time: string | null; // Null = läuft noch
  duration: string;        // PostgreSQL interval (z.B. "02:30:00")
  note: string | null;
  created_at: string;
  updated_at: string;
}

Status

✅ Vollständig - Backend + Frontend implementiert

Backend: backend/app/modules/backoffice/time_tracking/ ✅
Frontend: ui/src/modules/time-tracking/ ✅
- TimeTrackingDashboard.vue
- TimeEntriesListPage.vue
- TimeEntryDetailPage.vue
- TimeEntryFormPage.vue (mit Start/Stop Timer)
API-Prefix: /api/backoffice/time-tracking
Features: Automatische Dauer-Berechnung, Mitarbeiter & Projekt-Filter

4. Rechnungsmanagement

Beschreibung

Erstellung und Verwaltung von Kundenrechnungen mit PDF-Export und Zahlungsverfolgung.

Hauptfunktionen

Rechnungserstellung: Automatisch aus Projekten/Zeiteinträgen
PDF-Generierung: Rechnungs-PDFs mit Firmenlogo
Status-Tracking: Entwurf, Versendet, Bezahlt, Überfällig
Fälligkeitsdatum: Automatische Berechnung
Kundenzuordnung: Verknüpfung mit CRM
Projektzuordnung: Projektbezogene Rechnungen

API-Endpunkte

# LIST & FILTERS
GET    /api/backoffice/invoices             → Alle Rechnungen (mit Pagination & Filtern)
GET    /api/backoffice/invoices/statistics  → Statistiken (Umsatz, offene Forderungen)
GET    /api/backoffice/invoices/:id         → Einzelne Rechnung
GET    /api/backoffice/invoices/by-number/:invoice_number → Nach Rechnungsnummer

# CREATE & UPDATE
POST   /api/backoffice/invoices             → Neue Rechnung (mit Line Items)
PATCH  /api/backoffice/invoices/:id         → Rechnung aktualisieren
PATCH  /api/backoffice/invoices/:id/status  → Nur Status ändern
POST   /api/backoffice/invoices/:id/recalculate → Totals neu berechnen

# DELETE
DELETE /api/backoffice/invoices/:id         → Rechnung löschen (mit Cascade)

# PDF OPERATIONS
GET    /api/backoffice/invoices/:id/pdf     → PDF herunterladen (auto-generate falls fehlt)
POST   /api/backoffice/invoices/:id/regenerate-pdf → PDF neu generieren

# BULK OPERATIONS
POST   /api/backoffice/invoices/bulk/status-update → Status für mehrere Rechnungen

# PAYMENTS (siehe Zahlungsmanagement)
POST   /api/backoffice/invoices/:id/payments → Zahlung hinzufügen
GET    /api/backoffice/invoices/:id/payments → Alle Zahlungen einer Rechnung

Datenmodell

interface Invoice {
  id: string;
  customer_id: string;
  project_id: string | null;
  total: number;
  status: "draft" | "sent" | "paid" | "overdue";
  due_date: string;
  issued_date: string;
  pdf_path: string | null;
  created_at: string;
  updated_at: string;
}

Status

✅ Vollständig - Backend + Frontend mit Advanced Features!

Backend: backend/app/modules/backoffice/invoices/ ✅
Frontend: ui/src/modules/invoices/ ✅
- InvoicesDashboardPage.vue
- InvoicesListPage.vue (mit Filtern)
- InvoiceDetailPage.vue (mit PDF-Anzeige)
- InvoiceFormPage.vue (mit Line Items)
- CustomerSelect.vue
- ProjectSelect.vue
Backend Features:
- ✅ PDF-Generierung (sync/async mit Background Tasks)
- ✅ Line Items System mit Auto-Positionierung
- ✅ Pagination & Multi-Filter (Status, Kunde, Projekt, Datumsbereich)
- ✅ Statistik-Dashboard (Umsatz, Forderungen, Überfällige)
- ✅ Bulk Status-Updates
- ✅ Auto-Recalculate Totals
- ✅ Payment Integration (siehe Zahlungsmanagement)
Files: routes.py, crud.py, pdf_generator.py, payments_crud.py

5. Zahlungsmanagement

Beschreibung

Verwaltung von Zahlungseingängen für Rechnungen.

Hauptfunktionen

Zahlungserfassung: Betrag, Datum, Zahlungsart
Rechnungszuordnung: Verknüpfung mit Rechnung
Teilzahlungen: Mehrere Zahlungen pro Rechnung möglich
Zahlungshistorie: Übersicht aller Zahlungen
Automatische Status-Updates: Rechnung als "bezahlt" markieren

API-Endpunkte

# Payment Management (über Invoices-Route)
POST   /api/backoffice/invoices/:id/payments → Zahlung hinzufügen (mit Auto-Status)
GET    /api/backoffice/invoices/:id/payments → Alle Zahlungen einer Rechnung
GET    /api/backoffice/invoices/payments/:payment_id → Einzelne Zahlung
PATCH  /api/backoffice/invoices/payments/:payment_id → Zahlung aktualisieren
DELETE /api/backoffice/invoices/payments/:payment_id → Zahlung löschen

Datenmodell

interface Payment {
  id: string;
  invoice_id: string;
  amount: number;
  payment_date: string;
  method: "bank_transfer" | "credit_card" | "cash" | "paypal" | "other";
  note: string | null;
  created_at: string;
  updated_at: string;
}

Status

✅ Vollständig - In Invoices-Modul integriert (Backend + Frontend)

Backend: backend/app/modules/backoffice/invoices/payments_crud.py ✅
Frontend: In ui/src/modules/invoices/ integriert ✅
- Zahlungen werden in InvoiceDetailPage.vue angezeigt
- Zahlungsformular in Invoice-Modul
Features:
- ✅ Teilzahlungen unterstützt
- ✅ Auto-Status-Update (paid/partial bei vollständiger/teilweiser Zahlung)
- ✅ Validierung (Betrag ≤ outstanding_amount)
- ✅ CRUD-Operationen komplett

6. Ausgabenverwaltung

Beschreibung

Erfassung und Verwaltung von Projekt- und Rechnungsausgaben.

Hauptfunktionen

Ausgabenerfassung: Kategorie, Betrag, Beschreibung
Projekt-/Rechnungszuordnung: Verknüpfung mit Projekten oder Rechnungen
Kategorisierung: Material, Personal, Dienstleistung, Sonstiges
Ausgabenberichte: Auswertung nach Projekt/Zeitraum
Kostenanalyse: Projekt-Profitabilität

API-Endpunkte

# CRUD
GET    /api/backoffice/finance/expenses     → Alle Ausgaben (mit Pagination & Filtern)
GET    /api/backoffice/finance/expenses/:id → Einzelne Ausgabe
POST   /api/backoffice/finance/expenses     → Neue Ausgabe
PATCH  /api/backoffice/finance/expenses/:id → Ausgabe aktualisieren
DELETE /api/backoffice/finance/expenses/:id → Ausgabe löschen

# STATISTICS
GET    /api/backoffice/finance/expenses/kpis → KPI-Dashboard (Gesamt, Kategorien, Trends)

# FILTER-PARAMETER
# - title (string)
# - category (material|personnel|service|other)
# - project_id (UUID)
# - invoice_id (UUID)
# - from_date / to_date (date range)
# - limit / offset (pagination)

Datenmodell

interface Expense {
  id: string;
  project_id: string | null;
  invoice_id: string | null;
  category: "material" | "personnel" | "service" | "other";
  amount: number;
  note: string | null;
  created_at: string;
  updated_at: string;
}

Status

✅ Vollständig - Backend + Frontend implementiert

Backend: backend/app/modules/backoffice/finance/ ✅
Frontend: ui/src/modules/expenses/ + ui/src/modules/finance/ ✅
- Expenses-Modul:
  - ExpensesDashboardPage.vue
  - ExpensesListPage.vue (mit Filtern)
  - ExpenseFormPage.vue
- Finance-Modul:
  - FinanceDashboardPage.vue (Übersicht)
Backend Features:
- ✅ KPI-Dashboard (Gesamt, pro Kategorie, Trends)
- ✅ Multi-Filter (Titel, Kategorie, Projekt, Rechnung, Datumsbereich)
- ✅ Pagination
- ✅ Kategorie-basierte Auswertungen
Files: routes.py, crud.py, schemas.py, models.py

7. Projekt-Chat

Beschreibung

Projektbezogene Team-Kommunikation mit Nachrichtenverlauf.

Hauptfunktionen

Projektkommunikation: Chat-Nachrichten pro Projekt
Nachrichtenverlauf: Chronologische Anzeige
Team-Benachrichtigungen: Bei neuen Nachrichten
Dateien teilen: Anhänge zu Nachrichten (über Documents-Modul)
Echtzeit-Updates: WebSocket-basiert

API-Endpunkte

# REST API
GET    /api/backoffice/chat/projects/:project_id/messages → Nachrichten eines Projekts (Pagination)
POST   /api/backoffice/chat/projects/:project_id/messages → Neue Nachricht (mit Broadcast)

# WEBSOCKET (Echtzeit)
WS     /api/backoffice/chat/ws/projects/:project_id → WebSocket-Verbindung

# PARAMETER
# - limit (default: 50, max: 200)
# - offset (default: 0)

# WEBSOCKET EVENTS
# - "new_message" → Broadcast wenn neue Nachricht erstellt wird
# - "pong" → Echo-Response für Keep-Alive

Datenmodell

interface ChatMessage {
  id: string;
  project_id: string;
  author_id: string;
  message: string;
  created_at: string;
}

Status

✅ Backend Ready - WebSocket-basiertes Echtzeit-Chat implementiert!

Backend: backend/app/modules/backoffice/chat/ ✅
Frontend: ⏳ Geplant für Phase 2.4
Features:
- ✅ WebSocket-Support mit Connection Manager
- ✅ Broadcast-System (neue Nachrichten an alle Clients)
- ✅ REST-API für Nachrichtenverlauf (Pagination)
- ✅ Auto-Connect/Disconnect-Management
- ✅ Pro-Projekt-Channels
Files: routes.py, crud.py, schemas.py, models.py
Implementation: ConnectionManager mit Dict[project_id, Set[WebSocket]]

Core-Module (Shared)

Diese Module werden von allen Backoffice-Modulen verwendet:

Employees (Mitarbeiter)

Mitarbeiterstammdaten
Rollen- und Abteilungszuordnung
Siehe: Core-Dokumentation

Departments (Abteilungen)

Abteilungsstruktur
Manager-Zuordnung
Siehe: Core-Dokumentation

Roles (Rollen)

Rollenverwaltung
Berechtigungen (JSON)
Siehe: Backend-Dokumentation

Documents (Dokumente)

Dokumentenverwaltung
Polymorphe Verknüpfung mit allen Modulen
Siehe: Core-Dokumentation

Reminders (Erinnerungen)

Aufgaben & Erinnerungen
Fälligkeitsdatum & Priorität
Siehe: Core-Dokumentation

Dashboards (Dashboards)

Benutzerspezifische Layouts
Widget-Konfiguration
Siehe: Core-Dokumentation

Modul-Integration

Typischer Workflow

1. Kunde anlegen (CRM)
   ↓
2. Projekt erstellen & Kunde zuordnen (Projektmanagement)
   ↓
3. Zeit auf Projekt buchen (Zeiterfassung)
   ↓
4. Rechnung aus Zeiteinträgen generieren (Rechnungsmanagement)
   ↓
5. Zahlungseingang erfassen (Zahlungsmanagement)
   ↓
6. Ausgaben für Projekt erfassen (Ausgabenverwaltung)
   ↓
7. Projekt-Kommunikation (Chat)

Datenfluss-Diagramm

┌──────────┐     ┌──────────┐     ┌─────────────┐
│   CRM    │────→│ Projekte │────→│Zeiterfassung│
│(Kunden)  │     │          │     │             │
└──────────┘     └──────────┘     └─────────────┘
                       │                  │
                       ↓                  ↓
                 ┌──────────┐      ┌──────────┐
                 │Rechnungen│←─────│Ausgaben  │
                 │          │      │          │
                 └──────────┘      └──────────┘
                       │
                       ↓
                 ┌──────────┐
                 │Zahlungen │
                 │          │
                 └──────────┘

Technische Details

Backend (FastAPI)

backend/src/modules/backoffice/
├── crm/
│   ├── router.py           # API-Endpunkte
│   ├── service.py          # Business Logic
│   ├── models.py           # SQLAlchemy Models
│   └── schemas.py          # Pydantic Schemas
├── projects/
├── time_tracking/
├── invoices/
├── payments/
├── expenses/
└── chat/

Frontend (Vue 3)

ui/src/modules/
├── crm/                    # ✅ Implementiert
├── projects/               # 🔄 In Arbeit
├── time-tracking/          # ⏳ Geplant
├── invoices/               # ⏳ Geplant
├── payments/               # ⏳ Geplant
├── expenses/               # ⏳ Geplant
└── chat/                   # ⏳ Geplant

Roadmap

Phase 2.1 (✅ KOMPLETT ABGESCHLOSSEN!)

✅ CRM - Live in Produktion (Backend + Frontend)
✅ Projekte - Vollständig implementiert (Backend + Frontend)
✅ Zeiterfassung - Vollständig implementiert (Backend + Frontend)
✅ Rechnungen - Vollständig implementiert (Backend + Frontend mit PDF!)
✅ Zahlungen - Vollständig implementiert (in Invoices integriert)
✅ Ausgaben/Finance - Vollständig implementiert (Backend + Frontend)
✅ Projekt-Chat Backend - Vollständig implementiert (WebSocket!)

Phase 2.2 (Aktuell)

🔄 Projekt-Chat Frontend - Nächste Priorität (WebSocket-Integration)
⏳ Reporting & Analytics - Geplant

Phase 2.3 (Q2 2026)

⏳ Advanced Features & Optimierungen
⏳ Mobile-Optimierung

Phase 2.4 (Q3 2026)

⏳ AI-Features & Automatisierung
⏳ Advanced Reporting

🎉 Status: Backend & Frontend zu 100% fertig (außer Chat-Frontend)! Nur noch fehlt: Projekt-Chat Frontend (alle anderen Module sind ready)

Letzte Aktualisierung: 30. Dezember 2025

1. CRM (Customer Relationship Management)​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

UI-Module​

Status​

2. Projektmanagement​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

3. Zeiterfassung​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

4. Rechnungsmanagement​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

5. Zahlungsmanagement​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

6. Ausgabenverwaltung​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

7. Projekt-Chat​

Beschreibung​

Hauptfunktionen​

API-Endpunkte​

Datenmodell​

Status​

Core-Module (Shared)​

Employees (Mitarbeiter)​

Departments (Abteilungen)​

Roles (Rollen)​

Documents (Dokumente)​

Reminders (Erinnerungen)​

Dashboards (Dashboards)​

Modul-Integration​

Typischer Workflow​

Datenfluss-Diagramm​

Technische Details​

Backend (FastAPI)​

Frontend (Vue 3)​

Roadmap​

Phase 2.1 (✅ KOMPLETT ABGESCHLOSSEN!)​

Phase 2.2 (Aktuell)​

Phase 2.3 (Q2 2026)​

Phase 2.4 (Q3 2026)​

1. CRM (Customer Relationship Management)

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

UI-Module

Status

2. Projektmanagement

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

3. Zeiterfassung

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

4. Rechnungsmanagement

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

5. Zahlungsmanagement

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

6. Ausgabenverwaltung

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

7. Projekt-Chat

Beschreibung

Hauptfunktionen

API-Endpunkte

Datenmodell

Status

Core-Module (Shared)

Employees (Mitarbeiter)

Departments (Abteilungen)

Roles (Rollen)

Documents (Dokumente)

Reminders (Erinnerungen)

Dashboards (Dashboards)

Modul-Integration

Typischer Workflow

Datenfluss-Diagramm

Technische Details

Backend (FastAPI)

Frontend (Vue 3)

Roadmap

Phase 2.1 (✅ KOMPLETT ABGESCHLOSSEN!)

Phase 2.2 (Aktuell)

Phase 2.3 (Q2 2026)

Phase 2.4 (Q3 2026)