erster versuch der KI mit Plan

.github/copilot-plan.md

@@ -0,0 +1,60 @@
+# Copilot Plan: Attendance PDF Generator
+
+## Ziel
+Kombiniertes Python-CLI-Tool, das Anwesenheitsdaten aus einer Excel-Datei liest
+und für jeden Teilnehmer eine ausgefüllte PDF-Datei erzeugt.
+
+## Architektur
+
+```
+generate.py              # Click CLI entry point
+config.json              # Konfiguration (antragsnummer, ort, month_mapping, ...)
+schema.json              # JSON-Schema der Konfiguration (Dokumentation)
+requirements.txt         # openpyxl, pypdf, click
+requirements-dev.txt     # + pytest
+src/
+  __init__.py
+  exceptions.py          # Custom Exception-Hierarchie
+  models.py              # Datenklassen: Person, AttendanceDate, MonthlyAttendance
+  config_loader.py       # config.json laden & validieren
+  excel_reader.py        # Excel → MonthlyAttendance-Objekte
+  pdf_filler.py          # MonthlyAttendance → ausgefüllte PDF
+  validators.py          # Pre-Generation Validierung + Konsolenvorschau
+template/                # PDF-Template (sab.pdf, wird separat bereitgestellt)
+output/                  # Ausgabeverzeichnis für generierte PDFs
+tests/
+  __init__.py
+  test_excel_reader.py
+  test_pdf_filler.py
+  test_validators.py
+```
+
+## Datenfluss
+Excel-Datei → excel_reader → MonthlyAttendance → pdf_filler → PDF-Datei
+
+## Entwurfsentscheidungen
+- `plan.N` = immer `"6"` (mind. 6h), unabhängig von tatsächlichen Stunden
+- Sheet-Auswahl: manuell via `--sheet <name>` (z.B. `--sheet Feb`)
+- Output-Benennung: `(n) Nachname, Vorname.pdf` (n = lfd. Nummer aus Spalte A)
+- `pauschale.N` = `"8,60"` wenn anwesend (X), sonst leer
+- PDF-Template liegt in `./template/sab.pdf`
+
+## Excel-Struktur
+- Spalte A (Index 0): lfd. Nummer
+- Spalte B (Index 1): Name (Format: "Nachname, Vorname")
+- Spalten J–AN (Index 9–39): Tageswerte (Tag 1–31)
+  - Numerischer Wert → anwesend (X), Wert = Ist-Stunden
+  - "K" → Krank
+  - "KK" → Kindkrank
+  - "F" → unentschuldigtes Fehlen
+  - "E" → entschuldigtes Fehlen
+  - "P" → Praktikum
+  - "U" → Urlaub
+  - Leer → Zeile überspringen
+
+## PDF-Feld-Mapping (pro Zeile N, max 23 Zeilen)
+| Excel-Zelle | datum.N | anwesend.N | ist.N | plan.N | pauschale.N |
+|---|---|---|---|---|---|
+| Numerisch   | DD.MM.YYYY | X | Wert (dt. Format) | "6" | "8,60" |
+| "K"/"KK"/etc| DD.MM.YYYY | Code | leer | leer | leer |
+| Leer        | (überspringen) | — | — | — | — |