📄 Paperless-ngx — Classeur de documents¶

Rôle¶

Paperless-ngx est le classeur intelligent de la famille. Il lit automatiquement (OCR) tous les documents scannés ou importés, les classe, et permet de les retrouver en quelques secondes.

Paperless-ngx = Notre Google Drive intelligent pour les documents officiels.

Propriete	Valeur
Container	CT115
IP	`192.168.192.115`
Port	8000
URL	paperless.galexios.fr
Version	Paperless-ngx 2.20.15
Base de donnees	PostgreSQL 16
Cache	Redis 8.0

Flux de traitement¶

sequenceDiagram
    participant U as Utilisateur
    participant SAS as paperless_sas/ (depot)
    participant OCR as Tesseract OCR
    participant ML as Classificateur IA
    participant ARCH as paperless_media/ (archive)

    U->>SAS: Depose un PDF
    Note over SAS: Detection automatique
    SAS->>OCR: Lecture du texte
    OCR-->>ML: Texte extrait
    ML->>ML: Analyse contenu\nDetecte EDF facture date...
    ML->>ARCH: Fichier renomme et archive\n"2025-01-15 Facture EDF.pdf"
    ML-->>U: Document visible dans l'interface

Deux dossiers de stockage¶

Dossier	Role	Acces
`paperless_sas/`	Depot entrant — fichiers a traiter	Ecriture (Nextcloud, scan)
`paperless_media/`	Archives finales apres traitement	Lecture seule (Nextcloud)

Modes d'import¶

1. Depot dans paperless_sas/ (recommande)¶

Deposer n'importe quel fichier dans ce dossier → traitement automatique.

Depuis Nextcloud : le dossier paperless_sas/ est accessible en ecriture. Tu peux deposer un fichier depuis l'app Nextcloud sur ton telephone.

2. Nommage automatique par sous-dossiers¶

Le mode de nommage recursif par tags est active :

paperless_sas/
├── edf/
│   └── facture-jan-2025.pdf     → tag: "edf"
├── impots/
│   └── declaration-2024.pdf     → tag: "impots"
└── sante/
    ├── ordonnances/
    │   └── ordo-mars.pdf        → tags: "sante", "ordonnances"
    └── mutuelles/
        └── remboursement.pdf    → tags: "sante", "mutuelles"

3. Import automatique par email¶

Paperless scanne une boite mail toutes les 4 semaines et importe les PDFs en piece jointe.

Utilisation quotidienne¶

Rechercher un document¶

La recherche full-text cherche dans le contenu OCR du document :

Aller sur paperless.galexios.fr
Taper n'importe quel mot du document (ex: "EDF janvier 2025")
Filtrer par tag, correspondant ou date si besoin

Corriger la classification¶

Si Paperless a mal classe un document : 1. Ouvrir le document 2. Modifier : Correspondant / Type / Tags / Date / Titre 3. Sauvegarder

Technologies¶

Composant	Version	Role
Paperless-ngx	2.20.15	Application
PostgreSQL	16	Base de donnees
Redis	8.0.2	Cache et file de taches
Tesseract OCR	5.5.0	Lecture du texte
ImageMagick	7.1.1	Traitement images
scikit-learn	1.7.2	Classification ML

Administration¶

config 115
cd /opt/paperless-ngx

# Reinitialiser le mot de passe admin
python3 manage.py changepassword admin

# Forcer un scan du dossier d'import
python3 manage.py document_consumer

# Etat des services
systemctl status paperless-webserver
systemctl status paperless-task-queue

Depannage¶

Probleme	Solution
Un document n'est pas traite	Interface → Actions → Redo OCR
Erreur de classification	Corriger manuellement dans l'interface
Service inaccessible	`pct start 115`