From 5965da6388ed793e24c3d6709ce425e263c73bd9 Mon Sep 17 00:00:00 2001 From: trnq1ll0 Date: Fri, 11 Sep 2026 09:12:19 +0200 Subject: [PATCH] add project: sufw - Anwesenheiten aus Excel in SAB PDF generieren --- projects.md | 13 +++++++++++++ roles.md | 9 +++++++++ technologies.md | 22 +++++++++++++++++++++- 3 files changed, 43 insertions(+), 1 deletion(-) diff --git a/projects.md b/projects.md index 88e3c61..d76aa52 100644 --- a/projects.md +++ b/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. diff --git a/roles.md b/roles.md index 1d30684..c2405df 100644 --- a/roles.md +++ b/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 diff --git a/technologies.md b/technologies.md index baf7552..41baaf8 100644 --- a/technologies.md +++ b/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