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

2.9 KiB

Fast Sorter V2.0 — Inbox Mode

V2.0 baut auf V1.5 auf und ergänzt einen echten Top-Level-Inbox-Workflow.

Struktur

<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:

python quick_sorter.py "/pfad/zum/HAUPTORDNER/01_INBOX"

Alternativ explizit:

python quick_sorter.py "/pfad/zum/HAUPTORDNER/01_INBOX" --profile 01_INBOX

Bei einem Testordner an anderer Stelle kann der Ziel-Hauptordner angegeben werden:

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

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:

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.