# 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