Skip to content

feat: Push-Notification bei neuem Paperless-Dokument (Email-Import) #2

Description

@commanderphu

Beschreibung

Wenn ein neues Dokument über die Paperless-ngx E-Mail-Verarbeitung importiert und von der Workmate-KI analysiert wurde, soll eine Push-Notification an die App gesendet werden.

Kontext

  • Paperless-ngx verarbeitet E-Mails via IMAP (3 Konten konfiguriert)
  • Workmate synct alle 30 Min via Celery (paperless_sync-Task), 48h Lookback
  • Nach dem Import läuft analyze_paperless_document (Celery-Task in paperless_analyze.py)
  • FCM Push-Service existiert bereits: backend/app/services/push_notification_service.py

Gewünschtes Verhalten

Nach Abschluss der KI-Analyse (processing_status = "done") soll eine Push-Notification versendet werden:

  • Titel: 📄 Neues Dokument
  • Body: {Dokumenttitel} ({KI-Typ}) — z. B. Hetzner Rechnung Juli (Rechnung)
  • Bei action_required=True: Body erweitern mit ⚠️ Handlungsbedarf
  • Data-Payload: {"type": "new_document", "document_id": "<uuid>", "paperless_id": "<id>"}

Implementierung

  1. In analyze_paperless_document (nach doc.processing_status = "done" und Commit) FCM-Notification abfeuern
  2. FCM-Token des Users aus user.ui_preferences["fcm_token"] lesen (oder aus eigenem User-Feld, falls vorhanden)
  3. PushNotificationService.send() aufrufen
  4. Fehler nur loggen, nicht werfen (Notification ist nicht kritisch)

Flutter-seitig (optional, separates Issue)

  • Deep-Link beim Tap auf Notification → Dokumentdetailseite öffnen
  • document_id aus dem FCM-Data-Payload nutzen

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions