ROADMAP.txt

# ROADMAP - UniversalInvoiceMail
==============================

AKTUELL: v2.3.0
===============
Status: Stabiler Desktop-Baseline v2.3.0 + Web/PWA Companion (Local-First; Geräte-/Emulator-Abnahme offen)
Stand: 2026-08-13

### Dokumentations- und Verifikationsstand (2026-08-12)
- Plan-D-Readback: `115/115` Pytest-Tests, Source-Platform-Smoke und `compileall` grün.
- Die getrackte Web-Companion-Baseline bleibt bei `10/10` Node-Tests; eine fremde, uncommittete Manifest-Variante liefert `9/10` und wurde nicht übernommen.
- Android-/iOS-Geräte- bzw. Emulator-Signoff ist nicht aus diesen lokalen Tests ableitbar. Die OneDrive-Projektion bleibt wegen aktivem Cloud-Lock und fremdem Arbeitsstand offen.

## ERLEDIGTE MEILENSTEINE (v1.0 bis v2.3.0)

### v2.3.0 — Redigierte Bundles & Web/PWA Companion (2026-07)
- [x] Schema-Kontrakt `universalinvoicemail-invoicebundle-v1.json` für redigierte Rechnungsbundles.
- [x] Desktop-Export & Reimport mit Hash-Abgleich und Konflikterkennung.
- [x] Web/PWA-Companion (`web_companion/`) für browserbasierte Vorschau, Filterung und Rückexport (Betrag, Status, Notiz).
- [x] Offline-Shell mit Service Worker und PWA-Manifest.
- [x] Accessibility-Härtung (Accessible Names/Descriptions) für alle UI-Aktionen.
- [x] Cross-Platform Source Smoke (`tests/source_platform_smoke.py`) und GitHub Actions CI.

### v2.2.0 — DATEV-Export & Betragsbearbeitung (2026-05)
- [x] DATEV-Buchungsstapel-Export (CSV, cp1252) mit Berater- & Mandanten-Konfiguration.
- [x] Editierbare `Invoice.amount`-Spalte direkt in der GUI.
- [x] IMAP MSN -> UID Umstellung (RFC 3501 §2.3.1.1) & NIL-Guard.
- [x] MIME-Charset-Dekodierung (`get_content_charset`) für ISO-8859-1 / windows-1252 Mails.

### v2.1.0 — Multiformat-Anhänge & Gmail Query Builder (2026-04)
- [x] Automatische PDF-Konvertierung für Bilder (`.png`, `.jpg`), `.xlsx` und `.docx`.
- [x] Legacy Office-Fallback (`.doc`, `.xls`) via LibreOffice/COM.
- [x] Gmail Query Builder im Profil-Dialog für Roh-Suchanfragen.
- [x] IMAP/Gmail `X-GM-RAW` Integration.

### v2.0.0 — Mail-Dateien Import & Security-Härtung (2026-04)
- [x] `.eml` und `.msg` Import & Konvertierung in PDF mit Body/Anhang-Merge.
- [x] HTML-Sanitisierung & Escaping gegen HTML-Injection in PDF-Covern, OCR und Mail-Bodies.
- [x] PySide6-Migration (6.10+).
- [x] Dependency Floor Härtung (`Pillow >= 12.2.0`).

### v1.0.0 – v1.8.1 — Basis-App & Filter-Engine (2026-01 bis 2026-03)
- [x] IMAP & Gmail API Integration.
- [x] Vorkonfigurierte Shop-Profile & Sender/Subject/Body-Filter (muss/darf nicht enthalten).
- [x] Hybrid-Design mit Mail-Header in Body-PDFs.
- [x] Sichere Passwort-Speicherung via Keyring.
- [x] Sicheres Tempfile- & Hash-Dedup-Handling.


## BEKANNTE BUGS & FEHLERFREIHEIT
- Core-Codebase: Keine bekannten offenen P0/P1-Bugs im geprüften Baseline-Stand. `115/115` Pytest-Tests grün.
- HTML-Escaping & Sanitizing vollständig abgedeckte Guards.


## OFFENE GEPLANTE STRÄNGE & TASKPLAN-AUFGABEN

### [TW-UIM-01] Echter Android-/iOS-Geräte- & Emulator-Signoff (TASKPLAN #1153)
- **Status:** Open (PWA Contract-Smoke grün, eche Hardware/Emulator-Abnahme ausstehend)
- **Ziel:** Manuelle Verifikation der PWA auf echten Android (Chrome) & iOS (Safari) Geräten mit realem `universalinvoicemail-invoicebundle-v1.json`.
- **Scope:** Local / Companion-Abnahme.

### [TW-UIM-02] Erweiterte Mail-Provider Anbindung (TASKPLAN #1154)
- **Status:** Lokale Evaluierung am 2026-08-13 abgeschlossen; direkte Adapter-Implementierung bleibt als bedarfs- und security-gated Folgeaufgabe offen (P3)
- **Ziel:** Evaluierung direkter Anbindungen an weitere Provider (ProtonMail, Tutanota, Microsoft Graph API / Outlook.com).
- **Voraussetzung:** Konkreter Nutzerbedarf & API-Spezifikation ohne Security-Einbußen.
- **Readback:** Siehe `PROVIDER_EVALUATION.md`; keine Live-Endpunkte oder Credentials wurden verwendet.

### [TW-UIM-03] Selenium-Webportal-Kanal für Login-geschützte Portale (TASKPLAN #1155)
- **Status:** Open / Evaluierung (P3)
- **Ziel:** Abruf von Rechnungen direkt aus Login-Portalen ohne E-Mail-Versand.
- **Voraussetzung:** Bedarfsbeleg, MFA-Strategie & ToS-Prüfung.

### [TW-UIM-04] GUI für DATEV-Konten-Mapping-Tabelle (TASKPLAN #1156)
- **Status:** UI-Slice am 2026-08-13 fokussiert verifiziert; fachliche Validierungs- und Kontierungsentscheidung offen (P2)
- **Ziel:** UI-Dialog im Einstellungen-Tab zur Definition benutzerdefinierter Sachkonten- & Gegenkonten-Mappings.
- **Belegt:** `DATEVSettingsDialog` bietet Tabelle, Hinzufügen/Entfernen, Standard-Wiederherstellung, Laden/Speichern über `DATEVConfig` sowie Accessible Names/Descriptions/Tooltips; der fokussierte Readback umfasst 14 grüne Tests.
- **Offen:** Ein Accounting-Owner muss erlaubte Kontenbereiche, Duplikat-/Konfliktregeln und Fehlermeldungen festlegen. TASKSOLVER erfindet keine SKR03/SKR04-Regeln; leere oder nicht numerische Zellen fallen derzeit auf `70000/4900` zurück und sind vor dem Export zu prüfen. Der bestehende 93-Spalten-Exportvertrag bleibt unverändert.

### [TW-UIM-05] ROADMAP-/Steuerdokumente gegen v2.3.0-/Companion-Stand (TASKPLAN #1157)
- **Status:** Plan-D-Dokumentationsslice am 2026-08-12 abgeglichen; kanonische OneDrive-Projektion wegen Fremdzustand noch offen.
- **Abgleich:** Version, Bundle-/Companion-Grenzen, aktuelle Teststände und die erledigte DATEV-UI-Scheibe sind in den lokalen Steuerdokumenten konsistent beschrieben; es wurde keine Feature-Implementierung vorgenommen.


## NICHT-ZIELE & VERWORFENE IDEEN
- **System-Tray mit Abruf-Fortschritt:** Verworfen (unnötig).
- **Direct Cloud Server-Sync:** Nicht-Ziel (Widerspricht Local-First & Datensparsamkeit; Bundle-Export/Import wird bevorzugt).
- **Native Mobile-Apps (Swift/Kotlin):** Nicht-Ziel (Web/PWA-Companion deckt den mobilen Prüf- & Rückexport-Usecase ab).


## DOKUMENTATIONS-RESERVEN & REFERENZEN
- `AUFGABEN.txt` — Aktuelle Taskplan-Referenzen & Detailfortschritte
- `CHANGELOG.md` — Chronologische Versionshistorie
- `EXPORTFORMAT.md` — Spezifikation des Bundle-Formats `universalinvoicemail-invoicebundle-v1.json`
- `USER_GUIDE.md` — Handbuch für Einrichtung & Benutzung