Finalize plan and add configuration schema

.github/copilot-plan.md

@@ -0,0 +1,108 @@
+# SAB Taetigkeitsnachweise Generator - Implementierungsplan
+
+## Ziel
+Monatliche SAB-Taetigkeitsnachweise automatisiert erzeugen auf Basis von:
+- PS_PW.xlsx (monatliche gefoerderte Stunden je Projektanteil)
+- Stellenbeschreibungen.xlsx (Stammdaten je Mitarbeiter/Funktion)
+- Taetigkeitsnachweis Stellenfoerderung.xlsx (Ausgabevorlage)
+
+## Scope
+- Nur Verzeichnisse unter Tool verwenden.
+- Eingaben nur aus input.
+- Vorlage nur aus template.
+- Ausgaben nur nach output.
+
+## Annahmen
+- PS_PW.xlsx und Stellenbeschreibungen.xlsx enthalten jeweils Tabelle1.
+- Monatsmarker in PS_PW.xlsx stehen in Zeile 2 im Format ab 01.MM.YYYY.
+- Name ist primaerer Match-Schluessel zwischen beiden Quellen.
+- Template hat genau ein Quellblatt, das geklont wird.
+
+## Architektur
+- cli: Kommandozeilen-Einstieg und Orchestrierung
+- parser: Einlesen und Normalisierung der beiden Quelldateien
+- matcher: Zuordnung und Disambiguierung
+- validator: Source- und Business-Validierung
+- writer: Template-Klonen, Zellen befuellen, Speichern
+- model: gemeinsame Datentypen
+- util: Konvertierung, Datums-/Text-Helfer, Logging
+
+## Reihenfolge (Task-Flow)
+1. T1 Plan finalisieren
+2. T2 Konfiguration definieren
+3. T3 Projektgeruest anlegen
+4. T4 Abhaengigkeiten einrichten
+5. T5 Parser PS_PW
+6. T6 Parser Stellenbeschreibungen
+7. T7 Foerderquote berechnen
+8. T8 Matching-Engine
+9. T9 Source-Validierung
+10. T10 Business-Validierung
+11. T11 Template-Verarbeitung
+12. T12 Dateinamen + Persistenz
+13. T13 CLI Pipeline
+14. T14 Vorschau + Bestaetigung
+15. T15 Smoke-Test
+16. T16 Fachtests
+17. T17 Ergebnisabnahme
+
+## Definition of Done je Task
+
+### T1 Plan final
+- DoD: Dieser Plan ist vollstaendig, nachvollziehbar und in Reihenfolge mit klarer DoD-Liste dokumentiert.
+
+### T2 config.json
+- DoD: Alle Pfade, Dateinamen, Sheetnamen, Spalten, Zielzellen und Dateinamenregeln sind extern konfigurierbar.
+
+### T3 Projektgeruest
+- DoD: Ordner-/Modulstruktur steht, zentrale Datentypen und Fehler-/Log-Basis sind vorhanden.
+
+### T4 Abhaengigkeiten
+- DoD: requirements gepflegt, lokale Installation dokumentiert, Ausfuehrung startet ohne Importfehler.
+
+### T5 Parser PS_PW
+- DoD: Monatsspalte wird eindeutig gefunden, Records sind normalisiert und Mitarbeiterkontext korrekt vererbt.
+
+### T6 Parser Stellenbeschreibungen
+- DoD: Stammdaten sauber eingelesen, Prozentwerte robust konvertiert, Mehrfacheintraege bleiben erhalten.
+
+### T7 Foerderquote
+- DoD: Formel korrekt implementiert, Grenz-/Rundungsfaelle dokumentiert und testsicher.
+
+### T8 Matching
+- DoD: Eindeutige Zuordnung pro aktivem Record oder klarer Fehlerstatus (missing/ambiguous).
+
+### T9 Source-Validierung
+- DoD: Alle Struktur- und Formatpruefungen laufen vor Verarbeitung und liefern konkrete Fehlermeldungen.
+
+### T10 Business-Validierung
+- DoD: Aktivitaet, Eindeutigkeit, Template-Regeln und Dateinamenkollisionen werden vor dem Schreiben geprueft.
+
+### T11 Template-Verarbeitung
+- DoD: Ein Quellblatt wird pro Zuordnung geklont und korrekt mit assignment-spezifischen Werten befuellt.
+
+### T12 Dateinamen/Speichern
+- DoD: Ausgabedateien folgen Muster Taetigkeitsnachweis_YYYY_MM_Vorname_Nachname.xlsx und werden konfliktfrei gespeichert.
+
+### T13 CLI
+- DoD: generate.py akzeptiert month/year, orchestriert End-to-End und liefert sinnvolle Exit-Codes.
+
+### T14 Vorschau/Bestaetigung
+- DoD: Vor Schreibzugriff wird Vorschau angezeigt; Abbruch ist ohne Dateiaenderung moeglich.
+
+### T15 Smoke-Test
+- DoD: Mindestens ein realer Monatslauf erzeugt valide Dateien in output.
+
+### T16 Fachtests
+- DoD: Abdeckung fuer Mehrfachzuordnung, fehlende Matches, ungueltige Monatsmarker und fehlende Struktur.
+
+### T17 Ergebnisabnahme
+- DoD: Pflichtfelder, Monats-/Datumswerte und Taetigkeitstexte stimmen mit Template- und Fachregeln ueberein.
+
+## Risiko- und Entscheidungslog
+- Name-Matching kann uneinheitliche Schreibweisen enthalten; ggf. Normalisierung (Whitespace/Kommas) zentral in util.
+- Prozentvergleich kann Rundungsabweichungen haben; toleranzbasierten Vergleich definieren.
+- Mehrdeutige Matches nicht still aufloesen; immer sichtbar validieren.
+
+## Start der Umsetzung
+- Aktiver Schritt: T2 (Konfiguration als naechste technische Umsetzung)

.github/copilot-tasks.md

@@ -7,10 +7,11 @@ Projekt vollstaendig umsetzen: aus PS_PW.xlsx und Stellenbeschreibungen.xlsx mon
 - [ ] Immer nur genau eine Aufgabe aktiv bearbeiten.
 - [ ] Nach Abschluss jeder Aufgabe: Ergebnis pruefen und abhaken.
 - [ ] Bei Blockern: Fehler dokumentieren und naechsten konkreten Schritt notieren.
+- [ ] Nach jedem erledigten task einen git commit erzeugen
 
 ## Phase 1 - Planung und Konfiguration
-- [ ] T1: Plan final im Plan-Dokument pflegen (Scope, Annahmen, Reihenfolge, DoD pro Aufgabe).
-- [ ] T2: `config.json` Struktur festlegen
+- [x] T1: Plan final im Plan-Dokument pflegen (Scope, Annahmen, Reihenfolge, DoD pro Aufgabe).
+- [x] T2: `config.json` Struktur festlegen
 	- [ ] Pfade fuer `input/`, `template/`, `output/`
 	- [ ] Dateinamen der drei Excel-Dateien
 	- [ ] Sheetnamen und Spaltenzuordnung je Quelle
@@ -110,4 +111,4 @@ Projekt vollstaendig umsetzen: aus PS_PW.xlsx und Stellenbeschreibungen.xlsx mon
 8. T15 -> T16 -> T17
 
 ## Aktueller Startpunkt
-- [ ] Naechste aktive Aufgabe: T1 (Plan final pflegen)
+- [ ] Naechste aktive Aufgabe: T3 (Python-Projektstruktur anlegen)