updated readme.md

README.md

@@ -9,6 +9,8 @@ Web-basiertes CRM-System für Kundenverwaltung mit Verträgen (Energie, Telekomm
 - **Bankkarten**: Mit Ablaufdatum, Aktiv-Status und Dokument-Upload (PDF)
 - **Ausweise**: Personalausweis, Reisepass, etc. mit Ablaufdatum und Dokument-Upload (PDF)
 - **Zähler**: Strom-/Gaszähler mit Zählerstandhistorie
+- **Rechnungen**: Rechnungsverwaltung für Energieverträge mit Dokumenten-Upload
+- **Vertrags-Cockpit**: Dashboard zur Überwachung offener Aufgaben (fehlende Dokumente, Rechnungen)
 - **Verträge**:
   - Energie (Strom, Gas)
   - Telekommunikation (DSL, Glasfaser, Mobilfunk, TV)
@@ -232,6 +234,7 @@ opencrm/
 │   ├── uploads/            # Hochgeladene Dokumente
 │   │   ├── bank-cards/     # Bankkarten-Dokumente
 │   │   ├── documents/      # Ausweis-Scans
+│   │   ├── invoices/       # Rechnungsdokumente (Strom/Gas)
 │   │   ├── business-registrations/    # Gewerbeanmeldungen
 │   │   ├── commercial-registers/      # Handelsregisterauszüge
 │   │   ├── privacy-policies/          # Datenschutzerklärungen
@@ -388,6 +391,77 @@ Einige Felder werden nur bei bestimmten Anbietern angezeigt:
 
 > **Hinweis Multisim:** Bei Klarmobil, Congstar und Otelo ist Multisim **nicht** buchbar. Dafür wird Freenet oder ein vergleichbarer Anbieter benötigt.
 
+## Rechnungsverwaltung (Energieverträge)
+
+Für Strom- und Gas-Verträge können Rechnungen verwaltet werden, um den Abrechnungsstatus zu tracken.
+
+### Rechnungstypen
+
+| Typ | Beschreibung |
+|-----|--------------|
+| **Zwischenrechnung** (INTERIM) | Reguläre Jahresrechnung während der Vertragslaufzeit |
+| **Schlussrechnung** (FINAL) | Endabrechnung nach Vertragskündigung/Deaktivierung |
+| **Nicht verfügbar** (NOT_AVAILABLE) | Rechnung ist nicht mehr zu bekommen (z.B. Anbieter existiert nicht mehr) |
+
+### Funktionen
+
+- **Rechnungen hinzufügen/bearbeiten/löschen** in der Vertragsdetailansicht
+- **Dokument-Upload** (PDF) - Pflicht, außer bei Typ "Nicht verfügbar"
+- **Statusanzeige**: Grünes Badge bei Schlussrechnung, Orange bei fehlender Schlussrechnung
+- **E-Mail-Anhänge als Rechnung speichern**: Direkt aus dem E-Mail-Client
+
+### E-Mail-Integration
+
+Bei E-Mails, die einem Energievertrag zugeordnet sind:
+1. Toggle zwischen "Als Dokument" und "Als Rechnung" im Speichern-Dialog
+2. Rechnungsdatum und Typ auswählen
+3. Anhang wird automatisch als Rechnungsdokument gespeichert
+
+## Vertrags-Cockpit
+
+Dashboard zur Überwachung offener Aufgaben und fehlender Dokumente.
+
+### Kategorien
+
+| Kategorie | Prüfungen |
+|-----------|-----------|
+| **Fehlende Dokumente** | Kündigungsschreiben, Kündigungsbestätigung (wenn Kündigung markiert) |
+| **Fehlende Rechnungen** | Schluss-/Zwischenrechnungen für Energieverträge |
+| **Ablaufende Dokumente** | Ausweise, Bankkarten (nächste 30 Tage) |
+
+### Rechnungsprüfung für Energieverträge
+
+#### Schlussrechnung (gekündigte/deaktivierte Verträge)
+
+| Status | Prüfung |
+|--------|---------|
+| **CANCELLED** / **DEACTIVATED** | Schlussrechnung oder "Nicht verfügbar" erforderlich |
+
+#### Zwischenrechnung (laufende Verträge)
+
+| Bedingung | Warnung |
+|-----------|---------|
+| Vertrag > 12 Monate alt, keine Rechnung | "Zwischenrechnung fehlt" |
+| Letzte Rechnung > 12 Monate her | "Zwischenrechnung überfällig" |
+
+> **Hinweis Status-Logik:**
+> - **EXPIRED** = Laufzeit abgelaufen, aber Vertrag läuft ohne Kündigung weiter → Zwischenrechnung prüfen
+> - **CANCELLED** = Aktive Kündigung → Schlussrechnung prüfen
+> - **DEACTIVATED** = Manuell beendet → Schlussrechnung prüfen
+
+### Status-Info Modal
+
+An verschiedenen Stellen (Vertragsformular, Vertragsdetails, Vertragsübersicht, Kundenansicht) zeigt ein ℹ-Icon neben dem Status eine Erklärung aller Vertragsstatus:
+
+| Status | Bedeutung |
+|--------|-----------|
+| **Entwurf** | Vertrag wird noch vorbereitet |
+| **Ausstehend** | Wartet auf Aktivierung |
+| **Aktiv** | Vertrag läuft normal |
+| **Abgelaufen** | Laufzeit vorbei, läuft aber ohne Kündigung weiter |
+| **Gekündigt** | Aktive Kündigung eingereicht, Vertrag endet |
+| **Deaktiviert** | Manuell beendet/archiviert |
+
 ## E-Mail-Client
 
 Ein vollständig integrierter E-Mail-Client pro Kunde mit IMAP-Empfang und SMTP-Versand.
@@ -443,6 +517,16 @@ DELETE /api/emails/:id                      # In Papierkorb
 POST /api/emails/:id/restore                # Aus Papierkorb wiederherstellen
 DELETE /api/emails/:id/permanent            # Endgültig löschen
 GET  /api/emails/:id/attachments/:filename  # Anhang herunterladen
+
+# Rechnungen (Invoices)
+GET    /api/invoices/ecd/:ecdId              # Rechnungen für EnergyContractDetails
+POST   /api/invoices/ecd/:ecdId              # Rechnung hinzufügen
+PUT    /api/invoices/ecd/:ecdId/:invoiceId   # Rechnung bearbeiten
+DELETE /api/invoices/ecd/:ecdId/:invoiceId   # Rechnung löschen
+POST   /api/invoices/:invoiceId/upload       # Rechnungsdokument hochladen
+
+# Cockpit
+GET    /api/contracts/cockpit                # Offene Aufgaben abrufen
 ```
 
 #### Datenbank-Modell
@@ -504,6 +588,8 @@ model CachedEmail {
 | `AssignToContractModal.tsx` | Vertragszuordnung |
 | `ContractEmailsSection.tsx` | E-Mails in Vertragsansicht |
 | `SaveAttachmentModal.tsx` | Anhänge in Dokumentfelder speichern |
+| `SaveEmailAsPdfModal.tsx` | E-Mail als PDF in Dokumentfelder speichern |
+| `InvoicesSection.tsx` | Rechnungsverwaltung in Vertragsdetails |
 
 ### Anhänge als Dokumente speichern