# Portabilität: USER
# Version: 3.0.0
# Zuletzt validiert: 2026-03-11
# Nächste Prüfung: 2026-09-11

FÖRDERBERICHT
==============

ICF-basierte Entwicklungsberichte erstellen, exportieren und archivieren.
Alle Klientendaten werden automatisch anonymisiert.
Name und Geburtsdatum werden aus dem Ordnernamen in data_roh/ erkannt.

SCHNELLSTART
------------

  1. Aktenordner in data_roh/ einlegen (Format: "Nachname, Vorname")
  2. Einen der folgenden Wege nutzen:

  Weg 1 - Chat (empfohlen):
    "Erstelle Förderbericht"

  Weg 2 - Desktop .bat:
    Förderbericht_Pipeline.bat (ENTER für Auto-Detect)

  Weg 3 - llmauto Chain:
    bach chain start förderbericht

  Weg 4 - CLI:
    bach bericht pipeline

  3. Fertiger Bericht liegt in output_berichte/

BEFEHLE
-------

  bach bericht pipeline [name] [geburtsdatum] [optionen]
    End-to-End Pipeline: data_roh -> output_berichte
    Name/Geburtsdatum optional (Auto-Detect aus Ordnername).
    --zeitraum "01.01.2025 - 31.12.2025"  Berichtszeitraum
    --backend claude_code|llmauto          LLM-Backend (Default: claude_code)
    --eltern "Mutter" "Vater"             Elternnamen anonymisieren
    --no-cleanup                           Zwischenordner behalten

  bach bericht list
    Listet alle Klienten-Ordner mit Status (JSON/DOCX vorhanden).

  bach bericht status
    Zeigt Pipeline-Status aller Ordner.

  bach bericht generate <json-datei> -o <output> [-t vorlage]
    Fuellt die Word-Vorlage mit Daten aus der JSON-Datei.

  bach bericht export <klient-ordner> -p <passwort>
    De-anonymisiert den Bericht.

  bach bericht archive [name]
    Verschiebt fertigen Bericht ins Archiv.

  bach bericht help
    Zeigt diese Hilfe an.

LLM-BACKENDS
-------------

  claude_code (DEFAULT)   Claude Code CLI als Subprocess
  llmauto                 llmauto Chain-System
  anthropic_sdk           Direkter API-Aufruf (braucht ANTHROPIC_API_KEY)

  Standardwege sind claude_code und llmauto.
  anthropic_sdk ist nur eine optionale Alternative (kein API-Key eingerichtet).

PIPELINE-ORDNER (nur 4 + README)
---------------------------------

  data_roh/          Klienten-Akte einlegen (1 Ordner = 1 Klient!)
       ↓
  data_ano/          [Auto] Anonymisierte Dateien
       ↓
  data_bundled/      [Auto] Bundle + Prompt + LLM-Response
       ↓
  output_berichte/   [Auto] Fertiger Bericht (de-anonymisiert, Endprodukt)

  README.md          Anleitung

  Keine weiteren Ordner. Legacy-Ordner (data/, output/, bundles/,
  Berichte_ano/, Berichte_clean/) werden beim Cleanup automatisch entfernt.

BEISPIELE
---------

  # Vollautomatisch (Name aus Ordnername erkannt)
  bach bericht pipeline

  # Mit expliziten Angaben
  bach bericht pipeline "Max Mustermann" "15.03.2016"

  # Anderer Zeitraum
  bach bericht pipeline --zeitraum "01.07.2025 - 30.06.2026"

  # Status prüfen
  bach bericht status
  bach bericht list

VERWANDTE DATEIEN
-----------------

  hub/_services/document/foerderbericht_pipeline.py   Orchestrator
  hub/_services/document/pipeline_runner.py           CLI-Runner
  hub/bericht.py                                      CLI-Handler
  tools/llmauto/chains/foerderbericht.json            Chain-Config
  hub/_services/document/anonymizer_service.py        Anonymisierung
  hub/_services/document/document_pipeline.py         Dokument-Scanner
  skills/_templates/bericht_template_geiger_universal.docx  Word-Vorlage
  user/documents/foerderplaner/Berichte/              Arbeitsordner
