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.

roles.md

@@ -84,6 +84,15 @@ Enthält alle Rollen in denen ich schon Tätig war
 - Ort: München
 - Tätigkeiten: 1st-Level-Support und technischer Support für Serverprodukte.
 
+## Projektbezogene Verantwortlichkeiten
+
+### Fachliche Konzeption und Steuerung KI-gestützter Softwareentwicklung
+
+- Kontext: Anwesenheit PDF Generator im Repository `SUFW/Anweisenheiten`.
+- Zeitraum: März bis Mai 2026.
+- Verantwortung: Fachliche Anforderungen in persistente Agent-Anweisungen, Daten- und Feldzuordnungen, Umsetzungspläne und Prüfkriterien überführen; KI-generierte Umsetzung schrittweise bis zu GUI und Windows-Auslieferung, sowie an Hand konkreter Geschäftsregeln nachsteuern.
+- Tätigkeiten: Anwesenheits-, Stunden- und Pauschalenlogik spezifizieren; Aufgaben und Modulgrenzen strukturieren; Validierungs-, Vorschau- und Testanforderungen festlegen; fachliche Korrekturen und Erweiterungen im Entwicklungsprozess einarbeiten.
+
 ## Engagement und Wissensvermittlung
 
 ### Ehrenamtliche Website-Entwicklung

technologies.md

@@ -477,12 +477,32 @@ Jede Technologie wird einzeln genannt und enthält das Level der verwendeten Kom
 - Kontext: berufliche und private Softwareentwicklung.
 - Zusätzlicher Einsatz: Recherche und Dokumentation zu Neural Radiance Fields (NeRF), KI-Modellgenerierung mit Stable-3D und ComfyUI sowie Evaluation von Unity DOTS.
 
-### RAG, OpenWebUI, LM Studio, GPUStack, MCP, BMAD, SpecKit, SDD, Context Engineering und Caveman
+### RAG, OpenWebUI, LM Studio, GPUStack, MCP, BMAD und SpecKit
 
 - Komplexität: Werkzeuge und Methoden für KI-gestützte Softwareentwicklung und LLM-Anwendungen.
 - Einsatz: Im Lebenslauf als Kenntnisse aufgeführt.
 - Kontext: berufliche und private Softwareentwicklung.
 
+### Context Engineering und spezifikationsgetriebene Entwicklung (SDD)
+
+- Komplexität: Steuerung einer überwiegend KI-generierten Anwendung durch persistente, fachlich konkrete Spezifikationen und Arbeitsregeln.
+- Einsatz: Projektkontext, Modulgrenzen und Datenfluss in Copilot-Instructions dokumentieren; Anwendungsmasterplan mit Excel-Struktur, PDF-Feldzuordnungen, Status- und Berechnungsregeln sowie Validierungskriterien formulieren; dateibezogene Anweisungen über `applyTo` zuordnen; Planung vor Implementierung, Aufgabenzerlegung und sequenzielle Bearbeitung vorgeben.
+- Qualitätssteuerung: Tests der Fachlogik, Eingabevalidierung und prüfbare Vorschauen als Anforderungen verankern; GUI-Erweiterung und Windows-Auslieferung separat planen. Abgleich von Spezifikation und tatsächlichem Ergebnis bleibt erforderlich.
+- Projekt: Anwesenheit PDF Generator (`SUFW/Anweisenheiten`), März bis Mai 2026.
+
+### DeepSeek 4 pro und Copilot Chat in Visual Studio Code
+
+- Komplexität: KI-gestützte Umsetzung einer fachlich spezifizierten Verwaltungsanwendung mit CLI, GUI und Windows-Bereitstellung.
+- Einsatz: LLM im Copilot-Chat-Modul von VS Code mit projektbezogenen Agent-Dateien anleiten; Implementierung anhand von Plänen und fachlichen Korrekturen iterativ entwickeln lassen.
+- Projekt: Anwesenheit PDF Generator; KI-Nutzungskosten unter 3 US-Dollar bei insgesamt weniger als einer Woche eigenem Arbeitsaufwand.
+- Eigener Kompetenzschwerpunkt: Anforderungsformulierung, Kontextgestaltung und Steuerung des Entwicklungsprozesses.
+
+### Caveman-Anweisungen für tokenbewusste Agent-Kommunikation
+
+- Komplexität: Konfiguration knapper Agent-Antworten zur Begrenzung des Tokenverbrauchs bei Erhalt technischer Inhalte.
+- Einsatz: Persistente Kommunikationsregeln mit Kürzungsstufen und Ausnahmen für erforderliche Klarheit in einer Copilot-Instructions-Datei hinterlegen; im Entwicklungsablauf zur Tokenersparnis einsetzen.
+- Projekt: Anwesenheit PDF Generator. Eine isolierte prozentuale Einsparung durch diese Anweisungen wurde nicht ermittelt.
+
 ## Werkzeuge
 
 ### Jira und Visual Studio Code