document_sorter/README_V2.md
2026-09-16 13:10:15 +02:00

106 lines
2.9 KiB
Markdown

# Fast Sorter V2.0 — Inbox Mode
V2.0 baut auf V1.5 auf und ergänzt einen echten Top-Level-Inbox-Workflow.
## Struktur
```text
<HAUPTORDNER>/
├── 01_INBOX/
├── 02_DEV/
├── 03_PRIVAT/
├── 04_ARBEIT/
├── 05_VAULT/
└── 99_ARCHIV/
```
`01_INBOX` ist damit **kein Unterordner von 03_PRIVAT**, sondern die gemeinsame Eingangsstelle.
## Start
Wenn der Ordner wirklich `01_INBOX` heißt, erkennt V2 den Modus automatisch:
```bash
python quick_sorter.py "/pfad/zum/HAUPTORDNER/01_INBOX"
```
Alternativ explizit:
```bash
python quick_sorter.py "/pfad/zum/HAUPTORDNER/01_INBOX" --profile 01_INBOX
```
Bei einem Testordner an anderer Stelle kann der Ziel-Hauptordner angegeben werden:
```bash
python quick_sorter.py "/pfad/zu/INBOX_TEST" \
--profile 01_INBOX \
--target-root "/pfad/zum/HAUPTORDNER"
```
## Was V2.0 neu kann
### Cross-root sorting
Eine Datei aus `01_INBOX` kann z. B. nach
```text
04_ARBEIT/Cafe_Bach/Verwaltung
03_PRIVAT/Gesundheit
05_VAULT/Wissen/IT
```
verschoben werden. Ziele liegen nicht mehr innerhalb der Inbox.
### Archive zuerst erkennen
Erkannt werden u. a.:
- `.zip`
- `.7z`
- `.rar`
- `.tar`, `.tar.gz`, `.tar.xz`, `.tar.bz2`
- `.tgz`, `.txz`
- `.gz`, `.bz2`, `.xz`
Sie erhalten den Status `archive` und werden nicht automatisch an die Dokumentanalyse geschickt.
Vereinbarter Workflow:
```text
Archiv erkennen
→ entpacken
→ enthaltene Dateien normal analysieren/umbenennen/sortieren
→ bei Bedarf sauber neu packen
→ Archiv nur behalten, wenn das Paket selbst einen Zweck hat
```
### Rescan Inbox
Nach manuellem Entpacken:
1. Dateien in `01_INBOX` entpacken.
2. In der App `Rescan Inbox` klicken.
3. Neue Dateien erscheinen sofort.
Bereits analysierte unveränderte Dateien behalten während dieser laufenden Session ihren Zustand.
### Apply räumt die Inbox wirklich auf
Nach `Apply confirmed` werden bestätigte Dateien in ihre Zielbereiche verschoben. Danach scannt die App die Inbox neu. Erfolgreich verschobene Dateien verschwinden aus der Ansicht; übrig bleiben nur noch nicht bearbeitete, Review- oder Archivfälle.
## Sicherheit
Wie V1.5:
- keine Änderung während Scan/LLM-Analyse
- nur bestätigte Zeilen werden angewendet
- kein Überschreiben vorhandener Dateien
- Kollisionen werden mit vollständigem SHA-256 geprüft
- exakt identische Dubletten dürfen entfernt werden
- unterschiedliche Dateien bleiben als `_variant-N` erhalten
- Änderungen werden in `.quick_sorter_log.csv` protokolliert
## Wichtig vor dem echten Inbox-Durchlauf
Die Technik für die Inbox steht. Die Zielstruktur für `04_ARBEIT` ist bereits gut getestet. Die aktuell eingetragene Struktur für `03_PRIVAT` und `05_VAULT` ist noch die bisherige Arbeitsfassung. Diese Ordner sollten vor einem großen echten Inbox-Apply gemeinsam überprüft und anschließend nur in `sorter_policy.json` angepasst werden — dafür muss der Python-Code nicht erneut umgebaut werden.