add project: sufw - Anwesenheiten aus Excel in SAB PDF generieren

projects.md

@@ -2,6 +2,19 @@
 Enthält alle Projekte/Kontexte in denen ich schon tätig war.
 Jedes Projekt/Kontext besteht aus einem Link bzw Quell, einer Beschreibung, den Herausforderungen des Projektes und den verwendeten Lösungen.
 
+## Anwesenheit PDF Generator – KI-gesteuerte Verwaltungsautomatisierung
+
+- Zeitraum: März bis Mai 2026; eigener Arbeitsaufwand insgesamt weniger als eine Woche, verteilt über den Projektzeitraum.
+- Quelle: lokales Repository `/Users/rob/code/SUFW/Anweisenheiten`, insbesondere `.github/copilot-instructions.md`, `.github/instructions/main.instructions.md`, `.github/instructions/application-masterplan.instructions.md`, `.github/copilot-plan.md`, `.github/copilot-plan-gui.md` und die versionierten Aufgaben in `.github/copilot-tasks.md`.
+- Kontext: Windows-Anwendung zur Übertragung monatlicher Anwesenheitsdaten aus Excel in personalisierte SAB-PDF-Formulare, mit CLI und grafischer Oberfläche.
+- Eigener Schwerpunkt: Fachliche Spezifikation, Gestaltung der Agent-Anweisungen und Steuerung der überwiegend KI-generierten Implementierung. Der Kompetenzbeleg liegt in Anforderungsmodellierung, Context Engineering und Prozessgestaltung; der generierte Code beschreibt den erreichten Funktionsumfang.
+- Arbeitsmittel und Kosten: DeepSeek 4 pro in Visual Studio Code mit dem Copilot-Chat-Modul; KI-Nutzungskosten unter 3 US-Dollar. Ergänzende Caveman-Anweisungen für knappe, tokensparende Agent-Kommunikation.
+- Herausforderungen: Eindeutige Übersetzung von Anwesenheits- und Abwesenheitsstatus, Stundenwerten, Pauschalen und deutschen Datumsformaten in PDF-Felder; korrekte Darstellung eines JavaScript-gestützten Formulars; bedienbare Bereitstellung für Windows.
+- Spezifikation und Vorgehen: Persistenter Anwendungsmasterplan mit Datenmodell, Feldtabellen, Statusregeln und Validierungskriterien; Vorgabe „Plan vor Implementierung“, Aufgabenzerlegung und schrittweiser Bearbeitung; modularer Datenfluss aus Excel-Import, Datenmodell, Validierung und PDF-Ausgabe; gesonderter GUI-Plan mit Wiederverwendung der Fachlogik, Hintergrundverarbeitung und UI-Aktualisierung über den Hauptthread.
+- Qualitätssicherung: Vorgaben für Tests der Fachlogik ohne Abhängigkeit von echten Teilnehmerdateien, Validierung mit Fehlersammlung sowie Vorschau und Bestätigung vor der Generierung; vorhandene Unit-Tests für Import, Feldzuordnung, Stunden- und Pauschalenregeln sowie Validierung; ergänzender visueller PDF-Referenzvergleich mit Differenzbildern.
+- Ergebnis: Python-Anwendung mit openpyxl, pypdf, Click und CustomTkinter; PDF-Feldbefüllung einschließlich Summen und Darstellungskorrekturen; Build- und Installer-Konfiguration mit PyInstaller und Inno Setup, Versionierung, Update-Hinweisen und Übernahme aktualisierter Excel-Dateien vom Netzlaufwerk.
+- Grenzen des dokumentierten Stands: Teile der Agent-Pläne sind gegenüber der Umsetzung veraltet, etwa Pauschalen- und Praktikumsregeln sowie Packaging-Pfade. Der visuelle Regressionstest ist standardmäßig deaktiviert; Referenzdateien fehlen im vorliegenden Projektstand. Daraus lässt sich keine lückenlose Qualitätssicherung ableiten.
+
 ## Private Infrastruktur- und Backup-Automatisierung
 
 - Zeitraum: November 2018 bis Mai 2026, belegt durch eigene Commits im Repository.