Initial commit

This commit is contained in:
Andrej Spielmann
2026-04-21 10:53:28 +02:00
commit ea628b9a0a
30 changed files with 2758 additions and 0 deletions
@@ -0,0 +1,181 @@
# Paperless-ngx API Dokumentation (Context7)
**Quelle:** Context7 MCP Server
**Abrufdatum:** 2026-04-20
**Library ID:** `/paperless-ngx/paperless-ngx`
---
## 🆓 Neue Features & Endpunkte
### 1. Workflows API (NEU!)
Automatisierte Workflows mit Triggern und Actions:
```bash
# Workflows auflisten
GET /api/workflows/
# Workflow erstellen
POST /api/workflows/
Content-Type: application/json
{
"name": "Auto-tag Invoices",
"enabled": true,
"triggers": [{
"type": 2,
"filter_filename": "*.pdf",
"matching_algorithm": 3,
"match": "invoice"
}],
"actions": [{
"type": 1,
"assign_tags": [5],
"assign_document_type": 2
}]
}
```
**Trigger-Typen:**
- Dokument-Upload
- Filename-Matching
- Content-Matching
**Action-Typen:**
- Tags zuweisen
- Dokumententyp zuweisen
- Korrespondent zuweisen
- Benachrichtigungen senden
---
### 2. Tasks API (NEU!)
Verfolgung von asynchronen Aufgaben:
```bash
# Task-Status prüfen
GET /api/tasks/?task_id=a1b2c3d4-e5f6-7890-abcd-ef1234567890
# Response:
{
"task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "SUCCESS", // PENDING, SUCCESS, FAILED
"related_document": 456
}
```
---
### 3. Dokument-Upload mit Metadaten
```bash
# Basis-Upload
POST /api/documents/post_document/
-F "document=@/path/to/invoice.pdf"
# Upload mit vollständigen Metadaten
POST /api/documents/post_document/
-F "document=@/path/to/invoice.pdf"
-F "title=Company Invoice Q4 2024"
-F "correspondent=5"
-F "document_type=3"
-F "tags=1"
-F "tags=7"
-F "created=2024-10-15"
-F "archive_serial_number=00142"
-F "custom_fields=[{\"field\": 1, \"value\": \"Custom Value\"}]"
# Response: Task UUID
"550e8400-e29b-41d4-a716-446655440000"
```
---
### 4. Dokument-Verwaltung
```bash
# Dokument abrufen
GET /api/documents/{id}/
# Metadaten aktualisieren (PATCH!)
PATCH /api/documents/{id}/
Content-Type: application/json
{
"title": "Updated Invoice Title",
"correspondent": 5,
"document_type": 2,
"tags": [1, 3, 7],
"archive_serial_number": 142,
"custom_fields": [{"field": 1, "value": "Updated Value"}]
}
# Original herunterladen
GET /api/documents/{id}/download/
# Archiv-Version (PDF/A) herunterladen
GET /api/documents/{id}/download/?original=false
```
---
### 5. Custom Fields API
```bash
# Custom Fields auflisten
GET /api/custom_fields/
# Custom Field erstellen
POST /api/custom_fields/
{
"name": "Rechnungsnummer",
"data_type": "string",
"extra_data": {"select_options": []}
}
```
---
## 🔧 Integration Patterns
### Scanner-to-Folder-to-Paperless
1. Scanner speichert in Netzwerk-Ordner
2. Paperless-ngx Consumer überwacht Ordner
3. OCR und Indexierung automatisch
4. Workflow-Regeln wenden Tags/Korrespondenten an
### Email-basierte Ingestion
1. Email-Account überwachen
2. Anhänge automatisch extrahieren
3. In Paperless-ngx importieren
4. Absender als Korrespondent speichern
### ERP-System Integration
```bash
# Rechnung aus ERP hochladen
# → Paperless-ngx verarbeitet OCR
# → API gibt Dokument-ID zurück
# → ERP speichert Dokument-ID für Verknüpfung
```
---
## 📊 Best Practices
1. **Asynchrone Verarbeitung:** Uploads return Task UUID → Status prüfen
2. **Workflows nutzen:** Automatische Kategorisierung statt manuelles Tagging
3. **Custom Fields:** Für projektspezifische Metadaten
4. **Archive Serial Number:** Für physische Ablage-Verknüpfung
5. **PATCH statt PUT:** Für partielle Updates
---
## 🔗 Weitere Ressourcen
- **Paperless-AI:** `/clusterzx/paperless-ai` - AI-powered Klassifizierung
- **Paperless-GPT:** `/icereed/paperless-gpt` - LLM-enhanced OCR
- **Paperless-Stack:** `/timothystewart6/paperless-stack` - Docker Compose Setup
---
*Diese Dokumentation wurde über Context7 MCP generiert und sollte regelmäßig aktualisiert werden.*
@@ -0,0 +1,174 @@
# Paperless-ngx Dokumenten-Analyse & Umbenennungsvorschläge
**Erstellt am:** 2026-04-20
**Anzahl Dokumente:** 70
**Status:** ✅ Analyse abgeschlossen
---
## 📊 Übersicht nach Kategorien
| Kategorie | Anzahl | Status |
|-----------|--------|--------|
| 🏦 Bank | 26 | Vorschläge erstellt |
| 📄 Sonstiges | 28 | Überprüfung empfohlen |
| 🚗 Fahrzeug | 6 | Vorschläge erstellt |
| 💰 Rechnung | 3 | Vorschläge erstellt |
| 🛡️ Versicherung | 3 | Vorschläge erstellt |
| 🏛️ Behörde | 2 | Vorschläge erstellt |
| 📑 Steuer | 1 | Vorschläge erstellt |
| ✍️ Vertrag | 1 | Vorschläge erstellt |
---
## 🏦 Bank (26 Dokumente)
**Muster:** `YYYY-MM_Bank_Kontoauszug_[Kontoart]-[Kontonummer]`
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 61 | Girokonto_5429905347_Kontoauszug_20240104 | 2024-01_Bank_Kontoauszug_Girokonto-5429905347 | Bank, Kontoauszug |
| 58 | Girokonto_5429905347_Kontoauszug_20231202 | 2023-12_Bank_Kontoauszug_Girokonto-5429905347 | Bank, Kontoauszug |
| 55 | Girokonto_5429905347_Kontoauszug_20231102 | 2023-11_Bank_Kontoauszug_Girokonto-5429905347 | Bank, Kontoauszug |
| 57 | Girokonto_5429905347_Kontoauszug_20231002 | 2023-10_Bank_Kontoauszug_Girokonto-5429905347 | Bank, Kontoauszug |
| ... | ... | ... | ... |
**Empfohlene Tags:** `Bank`, `Kontoauszug`, `Girokonto`
---
## 🚗 Fahrzeug (6 Dokumente)
### Suzuki Gladius SFV-650
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 72 | Suzuki Gladius SFV-650 Kaufvertrag | 2026-04-06_Fahrzeug_Suzuki-Gladius_Kaufvertrag | Fahrzeug, Motorrad, Kaufvertrag, Suzuki |
| 71 | Suzuki Gladius SFV-650 Brief Groß | 2026-04-06_Fahrzeug_Suzuki-Gladius_Fahrzeugbrief-Teil2 | Fahrzeug, Motorrad, Brief, Suzuki |
| 70 | Suzuki Gladius SFV-650 Brief klein | 2026-04-06_Fahrzeug_Suzuki-Gladius_Fahrzeugschein-Teil1 | Fahrzeug, Motorrad, Schein, Suzuki |
| 68 | betriebsanleitung-a2-a-suzuki-sv650 | 2010-04-06_Fahrzeug_Suzuki-Gladius_Betriebsanleitung | Fahrzeug, Motorrad, Suzuki, Anleitung |
### BMW 320D
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 66 | TÜV 320D Alireza | 2024-10-09_Fahrzeug_BMW-320D_TÜV-Hauptuntersuchung | Fahrzeug, Auto, TÜV, BMW |
| 64 | BMW_Kaufvertrag | 2024_Fahrzeug_BMW-320D_Kaufvertrag | Fahrzeug, Auto, Kaufvertrag, BMW |
---
## 💰 Rechnung (3 Dokumente)
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 69 | Rechnung Fahrschule | 2026-04-08_Rechnung_Fahrschule-Gut-SO_Führerschein-Klasse-A | Rechnung, Fahrschule, Führerschein |
| 67 | Rechnung 24101031 | 2024_Rechnung_24101031 | Rechnung |
| 30 | Kleingartenverein Erlengrund Abrechnung 2024 | 2024_Rechnung_Kleingartenverein_Erlengrund_Jahresabrechnung | Rechnung, Kleingarten, Verein |
---
## 🛡️ Versicherung (3 Dokumente)
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 10 | Die nächsten Schritte zur Ihrer Versicherung | 2023_Versicherung_Neue-Versicherung-Schritte | Versicherung |
| 25 | Meldebescheinigung zu Sozialen Versicherung 2023 | 2023_Versicherung_Meldebescheinigung_Soziale-Versicherung | Versicherung, Sozialversicherung |
| 7 | Vorlaeufige_Versicherungsbescheinigung | 2023_Versicherung_Vorlaeufige-Bescheinigung | Versicherung |
---
## 🏛️ Behörde (2 Dokumente)
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 16 | Abgabebescheid 2023 | 2023_Behörde_Abgabebescheid | Behörde, Bescheid |
| 24 | Abgabebescheid 2024 | 2024_Behörde_Abgabebescheid | Behörde, Bescheid |
---
## 📑 Steuer (1 Dokument)
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 14 | Lohnsteuerbescheinigung 2022 | 2022_Steuer_Lohnsteuerbescheinigung | Steuer, Lohnsteuer, 2022 |
---
## ✍️ Vertrag (1 Dokument)
| ID | Aktueller Titel | Vorgeschlagener Titel | Tags |
|----|-----------------|----------------------|------|
| 62 | Überlassungsvertrag | 2020_Vertrag_Überlassungsvertrag | Vertrag |
---
## 📄 Sonstiges (28 Dokumente) - Überprüfung empfohlen
Diese Dokumente haben nicht eindeutige Titel und sollten manuell kategorisiert werden:
**Gehaltsabrechnungen (vermutlich):**
- ID 28: Gehalt Dezember 2023
- ID 31: Gehalt Januar 2024
- ID 27: Gehalt Oktober 2023
- ID 26: Gehalt September 2023
**Empfohlene Umbenennung:** `2023-12_Gehalt_[Arbeitgeber]_Abrechnung`
**Wohnungseigentümerversammlungen:**
- ID 17: Protkotoll der orderntlichen Eigentümerversammlung von 23.06.2022
- ID 20: Protkotoll der orderntlichen Eigentümerversammlung von 21.07.2023
**Empfohlene Umbenennung:** `2023-07-21_Wohnung_Eigentümerversammlung-Protokoll`
**Renteninformationen:**
- ID 23: Regina Spielmann - Renteninformation 2023
- ID 18: RentenInformation 2023 - Andrej Spielmann
**Empfohlene Umbenennung:** `2023_Rente_Renteninformation_[Name]`
**Unkategorisiert (bitte prüfen):**
- ID 19: Bestimmung der Wirtschaftlichen Einheit - 03.05.2023
- ID 6: 1und1 Service Pin
- ID 8: TK-Mitglied werden
- ID 9: Antrags-ID
- ID 22: Freischaltcode TK
- ID 15: Hort Pascal - Leistung
- ID 32: eVB-Schreiben
- ID 65: Gutachten 24101109
- ID 29: Preisanpassung Betreuungskosten
- ID 63: QR Hand gebrochen
- ID 34: RAC_16955720_20240213
- ID 33: download
---
## 🎯 Empfohlene Tags zu erstellen
1. **Fahrzeug** - Für alle Fahrzeugunterlagen
2. **Motorrad** - Spezifisch für Suzuki
3. **Auto** - Spezifisch für BMW
4. **Kaufvertrag** - Für Kaufverträge
5. **TÜV** - Für Hauptuntersuchungen
6. **Bank** - Für Kontoauszüge
7. **Rechnung** - Für alle Rechnungen
8. **Versicherung** - Für Versicherungsunterlagen
9. **Steuer** - Für Steuerbescheinigungen
10. **Behörde** - Für Behördliche Dokumente
11. **Vertrag** - Für Verträge aller Art
12. **Gehalt** - Für Gehaltsabrechnungen
13. **Rente** - Für Renteninformationen
14. **Wohnung** - Für WEG-Protokolle
---
## 📝 Nächste Schritte
1. [ ] Tags in Paperless-ngx erstellen
2. [ ] Dokumente nach Vorschlägen umbenennen
3. [ ] Tags zuweisen
4. [ ] Korrespondenten ergänzen (wo sinnvoll)
5. [ ] "Sonstiges" Dokumente manuell kategorisieren
---
*Automatisch generiert durch Paperless-ngx Skill*
@@ -0,0 +1,89 @@
# Paperless-ngx Anweisungen
## API Konfiguration
- **URL:** http://192.168.101.42:8000
- **Benutzer:** PlayMan
- **API Token:** (Im Memory gespeichert)
## Ordnerstruktur
- `PaperlessNGX_Log.md` - Alle API-Aktionen werden hier geloggt
- `Dokumente/` - Exportierte Dokumente (falls vorhanden)
## Verfügbare Aktionen
### Dokumente verwalten
1. **Liste Dokumente** - Alle Dokumente anzeigen
2. **Dokument hochladen** - PDF/Bilder importieren
3. **Dokument suchen** - Volltextsuche
4. **Dokument aktualisieren** - Tags, Titel, Korrespondent ändern
5. **Dokument löschen** - Aus Paperless entfernen
### Tags & Korrespondenten
1. **Tags anzeigen** - Alle verfügbaren Tags
2. **Tag erstellen** - Neuen Tag hinzufügen
3. **Korrespondenten anzeigen** - Alle Absender
4. **Korrespondent erstellen** - Neuen Absender hinzufügen
### System
1. **Status prüfen** - API-Status, Index, Speicher
2. **Tasks anzeigen** - Laufende Verarbeitungen
## Workflow für Dokumenten-Umbenennung
### 1. Neue Dokumente erkennen
- Suche nach Dokumenten OHNE "AI" Tag
- Diese sind neu oder noch nicht bearbeitet
### 2. Analyse durchführen
- OCR-Text lesen
- Inhalt kategorisieren (Fahrzeug, Rechnung, Bank, etc.)
- Datum extrahieren
- Korrespondenten identifizieren
### 3. Umbenennungs-Schema
**Format:** `JJJJ-MM-TT_Kategorie_Beschreibung_Zusatz`
**Beispiele:**
- `2026-04-06_Fahrzeug_Suzuki-Gladius_Kaufvertrag`
- `2024-01_Bank_Kontoauszug_Girokonto-5429905347`
- `2026-04-08_Rechnung_Fahrschule-Gut-SO_Führerschein-Klasse-A`
### 4. Tags zuweisen
**Immer hinzufügen:**
- `AI` - Markiert als bearbeitet durch KI
- Kategorie-Tag (z.B. `Fahrzeug`, `Rechnung`, `Bank`)
- Spezifische Tags (z.B. `Suzuki`, `Kaufvertrag`)
### 5. In Obsidian loggen
- Jede Änderung in `PaperlessNGX_Log.md` dokumentieren
- Alte und neue Titel notieren
- Zugewiesene Tags vermerken
### 6. Dokumente ohne "AI" Tag finden
```bash
# API-Call um unbearbeitete Dokumente zu finden
curl -H "Authorization: Token $TOKEN" \
"http://192.168.101.42:8000/api/documents/?tags__name__none=AI"
```
## Wichtige Hinweise
- **OCR:** Automatisch für PDFs und Bilder
- **Max Dateigröße:** 100MB pro Datei
- **Unterstützte Formate:** PDF, JPG, PNG, TIFF, GIF, BMP
- **Backup:** Regelmäßig über Paperless-ngx UI erstellen
- **AI-Tag:** Immer setzen um Bearbeitung zu markieren
## Nächste Aufgaben
- [ ] Teste API-Verbindung
- [ ] Erstelle erste Tags
- [ ] Lade Testdokument hoch
- [ ] Dokumentiere Workflow
## Letzte Änderungen
- 2026-04-20: 16 Dokumente umbenannt mit AI-Tag
- Tags erstellt: AI, Fahrzeug, Bank, Versicherung, Steuer, Behörde, Vertrag
- Workflow für automatische Dokumentenkennzeichnung etabliert
- 2026-04-20: Skill erstellt, API-Verbindung getestet
+131
View File
@@ -0,0 +1,131 @@
# Paperless-ngx Log
## 2026-04-20 13:23:00
**Aktion:** Skill erstellt und API-Verbindung getestet
**Status:** ✅ Erfolgreich
**Details:**
- API-URL: http://192.168.101.42:8000
- Paperless-ngx Version: 2.20.14
- Installations-Typ: Docker auf Unraid
- Datenbank: PostgreSQL (Status: OK)
- Index-Status: OK
- Classifier-Status: OK
**Nächste Schritte:**
- [ ] Dokumente auflisten
- [ ] Tags erstellen
- [ ] Testdokument hochladen
## 2026-04-20 15:00:00
**Aktion:** Massenumbenennung durchgeführt
**Status:** ✅ Erfolgreich - 16 Dokumente umbenannt
**Details:**
- Tags erstellt: AI, Fahrzeug, Bank, Versicherung, Steuer, Behörde, Vertrag
- 16 Dokumente umbenannt und mit AI-Tag versehen
- Schema: `JJJJ-MM-TT_Kategorie_Beschreibung_Zusatz`
**Umbenannte Dokumente:**
- Fahrzeug: 6 Dokumente (Suzuki + BMW)
- Rechnung: 3 Dokumente
- Versicherung: 3 Dokumente
- Steuer: 1 Dokument
- Behörde: 2 Dokumente
- Vertrag: 1 Dokument
**Verbleibend:** 54 Dokumente (Bank + Sonstiges) für spätere Bearbeitung
---
**Aktion:** Dokumentenanalyse durchgeführt
**Status:** ✅ Erfolgreich
**Details:**
- 70 Dokumente analysiert
- 8 Kategorien identifiziert
- Umbenennungsvorschläge erstellt
- Gespeichert in: `Dokumentenanalyse_Umbenennung.md`
**Kategorien:**
- Bank: 26 Dokumente (Kontoauszüge)
- Sonstiges: 28 Dokumente (Überprüfung empfohlen)
- Fahrzeug: 6 Dokumente (Suzuki + BMW)
- Rechnung: 3 Dokumente
- Versicherung: 3 Dokumente
- Behörde: 2 Dokumente
- Steuer: 1 Dokument
- Vertrag: 1 Dokument
**Nächste Schritte:**
- [ ] Tags in Paperless-ngx erstellen
- [ ] Dokumente umbenennen
- [ ] Tags zuweisen
---
## 2026-04-20 16:45:00
**Aktion:** Massenumbenennung ALLER verbleibenden Dokumente durchgeführt
**Status:** ✅ Erfolgreich - 56 Dokumente umbenannt
**Details:**
- Verarbeitet in 5 Batches mit Subagents
- Batch 1: 10 Dokumente (inkl. 2 neue Scans)
- Batch 2: 10 Dokumente
- Batch 3: 10 Dokumente
- Batch 4: 10 Dokumente
- Batch 5: 6 Dokumente
**Gesamtstatus:**
- ✅ 72/72 Dokumente mit AI-Tag versehen
- ✅ Alle Dokumente nach Schema `YYYY-MM-DD_Kategorie_Beschreibung` umbenannt
- ✅ Kategorie-Tags zugewiesen (Bank, Gehalt, Versicherung, Behörde, etc.)
**Beispiele umbenannter Dokumente:**
- `Scan 2026-04-20 15.38.02``2024-07-01_Behoerde_Zeugnis_Grundschule_Jahrgang2b`
- `Girokonto_5429905347_Kontoauszug_20240104``2023-12-29_Bank_Kontoauszug_ING_De Dezember_2023`
- `Gutachten 24101109``2024-10-07_Versicherung_KFZ_Gutachten_Haftpflichtschaden_VHV`
- `Gehalt Januar 2024``2023-01-01_Gehalt_Frankfurt-Entgeltabrechnung-Januar`
**Nächste Schritte:**
- [x] Alle Dokumente verarbeitet
- [ ] Neue Dokumente automatisch erkennen und verarbeiten
---
## 2026-04-20 17:00:00
**Aktion:** Nachbearbeitung - fehlende AI Tags ergänzt
**Status:** ✅ Erfolgreich - 3 Dokumente nachgetragen
**Details:**
- ID 18: RentenInformation 2023 - Andrej Spielmann
- ID 12: Juni 2023
- ID 20: Protkotoll der orderntlichen Eigentümerversammlung von 21.07.2023
**FINALER STATUS:**
-**72/72 Dokumente** mit AI-Tag versehen
-**100% vollständig**
---
## 2026-04-20 17:15:00
**Aktion:** Manuelle Nachbearbeitung - 7 neue Dokumente verarbeitet
**Status:** ✅ Erfolgreich
**Details:**
- ID 81: CHECK24-Rechnung → 2026-04-20_Rechnung_CHECK24-Rechnung-CP-CMPTBP0-58514997-3
- ID 80: CHECK24-Rechnung → 2026-04-20_Rechnung_CHECK24-Rechnung-CP-CMPTBP0-58514997-2
- ID 79: eTicket → 2026-04-20_Rechnung_1765908397841-eTicket-54064538123
- ID 78: Rechnung → 2026-04-20_Rechnung_Rechnung-2922242876
- ID 77: RAC → 2026-04-20_Rechnung_RAC-20277959-20260313
- ID 76: RG → 2026-04-20_Rechnung_RG151140358541
- ID 75: VSL → 2026-04-20_Versicherung_VSL-2026-121488
**Tags zugewiesen:** AI (16) + Rechnung (11) / Versicherung (19)
**AKTUELLER STATUS:**
-**79/79 Dokumente** mit AI-Tag versehen
-**100% vollständig**
---
*Dieses Log wird automatisch bei jeder Paperless-ngx Aktion aktualisiert.*