From d400c90e6a71bad574116b19a294a3790880170d Mon Sep 17 00:00:00 2001 From: duffyduck Date: Sun, 8 Feb 2026 01:21:00 +0100 Subject: [PATCH] updated readme.md --- README.md | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 86 insertions(+) diff --git a/README.md b/README.md index 38bfde07..b9c7bebe 100644 --- a/README.md +++ b/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