Intégration externe - Paperless-ngx

Développement
1

cover-paperless

Salut tout le monde !

La série auto-hébergement continue, pour ceux qui ont un NAS ou un serveur à la maison. Après les films de Sonarr & Radarr (que j’ai adoré faire), place aux papiers : Paperless-ngx, qui avale les factures scannées et les range tout seul. Maintenant, Gladys sait quand le courrier arrive.

Ce que ça fait

  • Un appareil Paperless-ngx : en ligne, total des documents, documents dans la boîte de réception (à classer), ajoutés aujourd’hui, tâches en cours et en échec, nombre de correspondants, de types et d’étiquettes, stockage libre, version et mise à jour disponible.
  • Trois déclencheurs : « Nouveau document » (filtrable par correspondant et par type), « Nouveau document avec une étiquette » et « Échec du traitement d’un document ».
  • Un widget « Courrier à classer » : le nombre de documents à classer et les derniers titres.
  • Lecture seule : Gladys ne touche à rien dans Paperless-ngx.
  • En français, anglais, allemand et espagnol.

Le truc sympa

Facture EDF reçue (correspondant EDF, type Facture) → notification avec le titre
Document étiqueté Urgent → la lumière de l’entrée passe en orange
Samedi 10 h, s’il reste du courrier à classer → petit rappel

Installation

:warning: Gladys 5.1 minimum.

Elle arrive dans le store au prochain passage de l’indexeur. En attendant : Intégrations → Installer depuis GitHub, avec GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub

  1. Dans Paperless-ngx : votre nom en haut à droite → Mon profil → Jeton d’authentification d’API (créez-le s’il n’existe pas), et copiez-le. Le jeton d’un administrateur donne en plus le stockage libre.
  2. Dans Gladys : l’adresse de Paperless-ngx (celle de votre navigateur) et le jeton, puis Tester la connexion.
  3. Onglet Découverte : ajoutez l’appareil.

Petites réserves honnêtes

  • Une seule instance, en lecture seule : ni envoi, ni étiquetage depuis Gladys.
  • L’intégration voit ce que voit l’utilisateur du jeton : ses documents et ceux partagés avec lui.
  • Les filtres comparent des noms exacts (EDF ne correspond pas à edf), et une étiquette ajoutée à la main plus tard ne déclenche rien.
  • Paperless-ngx 1.x n’est pas pris en charge.
  • Testée contre de vrais Paperless-ngx 2.20.6 et 3.3.1, lancés pour l’occasion depuis les images officielles et remplis de documents (dont un PDF cassé, pour l’échec de traitement), avec un jeton administrateur et un jeton simple. Pas encore vue dans une vraie installation Gladys, ni derrière un proxy inverse ou un SSO, et l’annonce d’une mise à jour n’a pas pu être vue en vrai : vos retours sont les bienvenus.

Comme les précédentes, développée avec Claude Code. Projet indépendant, non affilié à Paperless-ngx.

Dépôt : GitHub - guim31/gladys-paperless: Paperless-ngx document management for Gladys Assistant · GitHub