Externe Integration - Paperless-ngx

Entwicklung
1

cover-paperless

Hallo zusammen!

Die Selbsthosting-Serie geht weiter, für alle, die einen NAS oder einen Server zu Hause haben. Nach den Filmen von Sonarr & Radarr (die ich sehr gerne gemacht habe), geht es jetzt um die Papiere: Paperless-ngx, das gescannte Rechnungen verschlingt und sie selbst sortiert. Jetzt weiß Gladys, wann die Post kommt.

Was es kann

  • Eine Paperless-ngx-App: online, Gesamtzahl der Dokumente, Dokumente im Posteingang (zu sortieren), heute hinzugefügt, laufende Aufgaben und fehlgeschlagen, Anzahl der Kontakte, Typen und Tags, freier Speicherplatz, Version und verfügbare Updates.
  • Drei Auslöser: „Neues Dokument“ (filterbar nach Kontakt und Typ), „Neues Dokument mit einem Tag“ und „Verarbeitung eines Dokuments fehlgeschlagen“.
  • Ein Widget „Post zu sortieren“: Anzahl der zu sortierenden Dokumente und die letzten Titel.
  • Nur Lesen: Gladys ändert nichts in Paperless-ngx.
  • Auf Französisch, Englisch, Deutsch und Spanisch.

Das coole Ding

EDF-Rechnung erhalten (Kontakt EDF, Typ Rechnung) → Benachrichtigung mit dem Titel
Dokument mit dem Tag Dringend → Das Licht im Flur wird orange
Samstag um 10 Uhr, wenn noch Post zu sortieren ist → kleine Erinnerung

Installation

:warning: Gladys 5.1 mindestens.

Sie kommt im Store beim nächsten Durchlauf des Indexers. In der Zwischenzeit: Integrationen → Von GitHub installieren, mit GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub

  1. In Paperless-ngx: Ihr Name oben rechts → Mein Profil → API-Authentifizierungstoken (erstellen Sie es, falls es nicht existiert), und kopieren Sie es. Das Token eines Administrators gibt zusätzlich den freien Speicherplatz.
  2. In Gladys: Die Adresse von Paperless-ngx (die Ihres Browsers) und das Token, dann Verbindung testen.
  3. Registerkarte Entdeckung: Gerät hinzufügen.

Kleine ehrliche Vorbehalte

  • Eine einzige Instanz, schreibgeschützt: weder Senden noch Taggen von Gladys aus.
  • Die Integration sieht, was der Token-Benutzer sieht: seine Dokumente und die mit ihm geteilten.
  • Die Filter vergleichen exakte Namen (EDF entspricht nicht edf), und ein später manuell hinzugefügtes Tag löst nichts aus.
  • Paperless-ngx 1.x wird nicht unterstützt.
  • Getestet mit echten Paperless-ngx 2.20.6 und 3.3.1, die extra von den offiziellen Images gestartet und mit Dokumenten gefüllt wurden (darunter ein kaputtes PDF für den Verarbeitungsfehler), mit einem Admin-Token und einem einfachen Token. Noch nicht in einer echten Gladys-Installation gesehen, noch nicht hinter einem Reverse-Proxy oder SSO, und die Ankündigung eines Updates konnte nicht in der Praxis gesehen werden: Ihr Feedback ist willkommen.

Wie die vorherigen, entwickelt mit Claude Code. Unabhängiges Projekt, nicht mit Paperless-ngx verbunden.

Repository: GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub