Skip to content

Integrationen

Jump to bottom
Joshua Phu Kuhrau edited this page Jul 23, 2026 · 3 revisions

Integrationen

Integrationen werden als Integration-Datensätze verwaltet (integration_type: google_calendar, caldav, outlook_calendar, paperless_ngx) — siehe Datenmodell und /api/v1/calendar/integrations/.

Google Calendar ✅ (primär, produktiv im Einsatz)

Bidirektionaler Sync via OAuth, automatisch alle 15 Minuten (app.tasks.calendar_sync).

  • Termine aus Dokumenten/Tasks werden automatisch eingetragen
  • Konflikte werden erkannt und können über /calendar/events/{id}/resolve-conflict aufgelöst werden
  • OAuth-Flow: /api/v1/calendar/oauth/google/authorize → /callback

CalDAV ⚙️ (implementiert, aber nicht Standardweg)

caldav_service.py spricht generisch mit CalDAV-kompatiblen Servern (Nextcloud, iCloud, Thunderbird/Lightning). Der Service existiert und funktioniert, wird aber aktuell nicht als primärer Kalender genutzt — Google Calendar ist der gepflegte Standardpfad.

Konfiguration: /api/v1/calendar/integrations/ mit integration_type: caldav, config enthält URL + Zugangsdaten.

Paperless-ngx ✅ (Sync einseitig, Write-back einmalig)

Sync mit bestehender Paperless-ngx-Instanz — kein Doppel-Scanning nötig.

Funktionen:

  • Automatischer Import neuer Dokumente alle 30 Minuten (app.tasks.paperless_sync, Parameter added__date__gte)
  • KI analysiert den OCR-Text aus Paperless und erstellt Tasks (app.tasks.analyze_paperless_document)
  • Write-back: Analyseergebnisse (Tags, Custom Fields) werden einmalig direkt nach der KI-Analyse zurück nach Paperless geschrieben (POST /paperless/writeback/{document_id}) — spätere Änderungen in Workmate (z. B. Task erledigt, Typ korrigiert) werden aktuell nicht laufend zurücksynchronisiert
  • Status-Abfrage über GET /paperless/status
  • Offen: vollständig bidirektionaler Sync inkl. laufendem Metadaten-Write-back und Upload direkt in Workmate hochgeladener Dokumente nach Paperless → Issue #1

E-Mail-Import läuft über Paperless-ngx, nicht über Workmate: Paperless-ngx verarbeitet eingehende E-Mails selbst per IMAP (bei Joshua 3 Konten konfiguriert) und legt daraus Dokumente an. Workmate holt sich diese Dokumente ganz normal über den 30-Minuten-Sync — es gibt keinen eigenen IMAP-Client in Workmate und braucht auch keinen. Offen ist lediglich, dass für so importierte Dokumente noch keine Push-Notification verschickt wird, sobald die KI-Analyse fertig ist → Issue #2.

Push Notifications (Firebase Cloud Messaging) ✅

Kein "Integrations"-Datensatz, sondern direkt am User hinterlegt (user.fcm_token, verwaltet über /api/v1/notifications/fcm-token). Voraussetzung: FIREBASE_CREDENTIALS_PATH zeigt auf eine gültige Service-Account-Datei — siehe Reminder Engine.

Smart Home (Idee, kein Code vorhanden)

In früheren Planungen als optionale Eskalationsstufe für kritische Fristen angedacht (Home Assistant/MQTT). Es gibt aktuell keine entsprechende Service-Anbindung im Backend und kein GitHub Issue dazu.

Aktuelle offene Integrations-Aufgaben: siehe Roadmap bzw. gh issue list --repo commanderphu/workmate_private.

← Reminder Engine | → Setup Guide

Clone this wiki locally