Native Desktop-App fuer Mietpark CRM auf Basis von Tauri 2, React und Rust.
- nahezu identische UI zur bestehenden Web-/Docker-App
- lokale SQLite-Datenbank als Primärspeicher
- OAuth 2.0 pro Nutzer fuer Google Kalender, Gmail und Cloud-Backups
- sichere Token-Ablage im Keychain
- spaeter Cloud-Backups ueber Google Drive, OneDrive, Dropbox und optional iCloud
Hinweis zu Google OAuth (Desktop):
- Es wird ein OAuth-Client vom Typ Desktop App in der Google Cloud Console benoetigt (kein Web Application).
- Die Autorisierung laeuft ueber System-Browser + Loopback-Callback (
http://127.0.0.1:<port>). Unter macOS App Sandbox wird der Browser direkt viaNSWorkspacegeoeffnet. - Wenn beim Token-Tausch die Meldung
client_secret is missingauftaucht, wurde sehr wahrscheinlich ein Web Application-Client verwendet.
src/: React-Frontend fuer die UIsrc-tauri/: Rust-Backend mit Tauri-Kommandos, SQLite und Integrationendocs/: Architektur, Roadmap und Migrationsnotizen
Dieses Repository ist das neue Desktop-Projekt. Die bestehende Web-App bleibt separat in ../mietpark-crm.
- Dashboard, Kanban, Kunden, Belege in React
- SQLite lokal
- Google OAuth mit PKCE
- Google Calendar Sync
- lokales verschluesseltes Backup
- spaeter Google Drive als erster Cloud-Backup-Provider
- Frontend aus der Web-App kontrolliert uebernehmen
- Tauri IPC und SQLite-Grundschicht fertig verdrahten
- OAuth- und Google-Services implementieren
- Backup-System aufbauen
Das Projekt ist fuer automatische Desktop-Updates vorbereitet:
- Tauri Updater Plugin ist eingebunden (Rust + Frontend).
- Beim App-Start wird im Desktop-Build regelmaessig auf Updates geprueft.
- GitLab CI (
.gitlab-ci.yml) baut aufmainund publiziertlatest.json+.app.tar.gz+.sigin GitLab Generic Packages.
Pflicht-Variablen in GitLab CI/CD:
TAURI_UPDATER_PUBLIC_KEYTAURI_SIGNING_PRIVATE_KEY- optional:
TAURI_SIGNING_PRIVATE_KEY_PASSWORD
Hinweis:
- Fuer echte In-App-Updates muss der Update-Endpunkt fuer Clients erreichbar sein.
- Bei privaten GitLab-Projekten ist ein zusaetzliches Konzept fuer authentifizierten Download noetig.
- Release-Uploads in GitLab Generic Packages sind robust gegen Duplikate (bestehende Dateien fuehren nicht mehr zu hartem Job-Abbruch).
- Wichtig fuer echte Updates:
src-tauri/tauri.conf.jsonVersion muss pro Release hochgezaehlt werden (nur hoehere Semver-Versionen werden installiert).
- Desktop-Backend unterstützt jetzt iCloud-Drive-Pfade für DB und Dokumente:
- DB:
~/Library/Mobile Documents/iCloud~com~serverraum247~mietparkcrm~desktop/Documents/data/mietpark-crm.db - Dokumente:
~/Library/Mobile Documents/iCloud~com~serverraum247~mietparkcrm~desktop/Documents/documents/
- DB:
- Fallback bleibt aktiv: wenn iCloud lokal nicht verfügbar ist, wird weiterhin
AppDatagenutzt. - Beim App-Start läuft eine sichere Einmal-Migration (best effort) von
AppDatanach iCloud:- bestehende Altdaten bleiben als Backup erhalten
- nur fehlende Zieldateien werden kopiert
- SQLite-Verbindungen laufen mit
PRAGMA journal_mode=WAL; PRAGMA synchronous=NORMAL; PRAGMA busy_timeout=5000;. - Dokument-Metadaten speichern relative Dateinamen statt absolute Pfade; Legacy absolute Pfade werden weiterhin gelesen.
- Für echte iCloud-Container-Synchronisierung muss die App mit Apple Developer Zertifikat signiert werden.
src-tauri/Entitlements.plistist hinterlegt und intauri.conf.jsonunterbundle.macOS.entitlementseingetragen.bundle.macOS.signingIdentitybleibt bis zur Zertifikat-Konfiguration aufnull.- Für CI-Releases kann die Signatur-Identität über
APPLE_SIGNING_IDENTITYgesetzt werden (wird im Release-Script automatisch intauri.conf.jsonübernommen).
- Neuer Rust-Provider erstellt DB-Backups im iCloud-Container:
- Ziel:
.../Documents/backups/mietpark-crm_YYYYMMDD_HHMMSS.db
- Ziel:
- Verfügbare Tauri-Commands:
create_icloud_backuplist_icloud_backups
- UI-Anbindung vorhanden:
Kundenverwaltung -> Backupszeigt Desktop-seitig iCloud-Aktionen- Button
iCloud-Backup erstellen - Liste der gefundenen iCloud-Backups inkl. Zeitstempel/Größe
snapshot()undrestore()arbeiten auf SQLite-Service-Funktionen statt Legacy-IndexedDB-Keys.- Restore legt Dokument-Metadaten wieder an; Dokument-Payloads werden wie bisher im ZIP-Importpfad eingespielt.
- Web-Fallback vermeidet doppelte Nachrichten beim Restore über
message.id.
- Im Dokumentenarchiv gibt es jetzt neben
DownloadauchOeffnen:- PDF- und Bilddateien werden als Vorschau in einem neuen Tab geöffnet.
- Nicht-vorschaufähige Formate werden weiterhin direkt heruntergeladen.
- Download wurde browser-robuster umgesetzt (Anchor wird korrekt in den DOM gehängt).
- Legacy-Werte aus alten Firebase-Importen (
FIREBASE-*) werden nicht mehr als echte Dachträger-Zuordnung akzeptiert. - Die Bereinigung greift für:
assignedRoofRackInventoryKeyim KundenprofilroofRackInventoryKeyim Vorgang
- Dadurch erscheinen diese Altwerte nicht mehr als aktive Zuordnung in Workflow/Angebot.
Ab sofort gilt verbindlich:
- Jede Feature- oder Fix-Aenderung am produktiven Code muss
README.mdundCHANGELOG.mdmit aktualisieren. - GitLab CI prueft das automatisch ueber
scripts/ci/check-doc-sync.sh. - Ohne diese beiden Doku-Updates faellt die Pipeline im
verify-Stage.
- Anzahlung ist optional und kann in Angebot und Auftrag im Editor aktiv/deaktiviert werden.
- Bei
Auftrag -> Rechnungwird der bestehende Auftrag automatisch auf Statusarchiviertgesetzt (Belegnummer bleibt unveraendert). - Beim Klick auf
PDF speichernwird die generierte Druckvorlage automatisch als Kundendokument abgelegt (Kategorie nach Belegtyp). - PDF-Ablage verwendet echte
application/pdfDateien (nicht mehr HTML) mit Standardname:{Belegtyp}_{Belegnummer}_{YYYY-MM-DD}.pdf
- Duplikat-Schutz aktiv: identische PDFs (SHA-256) werden pro Kunde nur einmal gespeichert.
- PDF-Inhalt wird layoutnah aus derselben Beleg-HTML gerendert (mehrseitig), damit Vorschau und gespeicherte Datei visuell uebereinstimmen.
- Seitenumbrueche werden beim Rendern automatisch an visuell ruhige Zeilen gelegt, um harte Schnitte in Tabellen/Text zu minimieren.
- Dashboard-Kennzahlen
Offene VorgängeundAktiv ausgegebenbewerten Mietdaten tagesbasiert (lokaler Tagesanfang), um UTC/Zeitzonen-Importe korrekt abzubilden. - Dashboard
Anstehende Terminenutzt fuer Abholung/Rueckgabe bevorzugt die expliziten TerminzeitpunktepickupDateundreturnDate. - Dashboard-Kacheln sind optisch vereinheitlicht;
Smart Insightswurde aus dem Dashboard entfernt. Offene Aufträge,Aufträge angezahltundErwartete Einnahmenschliessen abgeschlossene Vorgänge und reine Rechnungen aus.
- Inbox bietet einen zentralen Composer mit:
- Vorlagen (Eingangsbestaetigung, Terminabstimmung, Nicht verfuegbar, Reling/Fixpunkte-Ablehnung)
- lokalen Anhaengen
- Direktversand ueber SMTP/App-Passwort (wenn Mail-Bridge konfiguriert)
- Nach Direktversand kann eine Konversation direkt als
Verarbeitetmarkiert werden. - Falls die lokale Mail-Bridge Anhaenge nicht unterstuetzt, wird automatisch ohne Anhaenge erneut gesendet und ein klarer Hinweis angezeigt.
- In den Einstellungen steht
Anhaenge-Test sendenzur Verfuegung, um die Bridge-Attachment-Unterstuetzung mit einer Testmail zu verifizieren.
- Vite-Build ist in funktionsbezogene Chunks aufgeteilt (
inbox,belege-workflow,pdf-service, dedizierte Vendor-Chunks fuer PDF/React/DnD/Date). - Dadurch ist der Main-Entry-Chunk deutlich kleiner und Releases laden stabiler in Desktop-Umgebungen.
- Produktionsbuilds nutzen
terserstattesbuildfuer die Minifizierung, weil der alte Minify-Pfad im Desktop-Projekt haengen konnte. npm run tauri:buildbaut die App und installiert das fertige.appBundle unter macOS automatisch nach/Applications/CRM Buddy Desktop.app.- Optionale lokale Build-Schalter:
APPLE_DISABLE_SIGNING=1 npm run tauri:buildbaut ohne Apple-SigningAPPLE_SKIP_INSTALL=1 npm run tauri:buildueberspringt die Auto-Installation nach/Applications
- Dashboard zeigt zusaetzlich zwei finanzielle Kernkennzahlen:
Offene Forderungen €(gesendete/angenommene Rechnungen minus erfasste Zahlungen)Monatsumsatz €(Zahlungseingaenge im laufenden Monat)
- Neue Liste
Überfällige Rechnungen:- Kriterien:
dueDate < heuteundoffener Betrag > 0 - Zeigt zusätzlich
X Tag(e) überfälligje Rechnung - Klick oeffnet den zugehoerigen Beleg direkt im Editor
- Leerzustand:
Keine überfälligen Rechnungen ✓
- Kriterien:
- Technischer Einstiegspunkt:
src/services/dashboardService.ts(getDashboardFinancials())- Unit-Tests in
src/services/dashboardService.test.ts(Brutto, Payments, Monatsumsatz, Overdue inkl.daysOverdue) - Verwendung in
loadDashboardData()insrc/App.tsx