From b7cae606c9a0bbfa0d6b0ad761434f3338a3a428 Mon Sep 17 00:00:00 2001 From: Thorsten Hindermann Date: Mon, 30 Mar 2026 17:02:08 +0200 Subject: [PATCH] Sync shared governance baseline --- .github/copilot-instructions.md | 17 ++++ AGENTS.md | 17 ++++ CLAUDE.md | 17 ++++ GEMINI.md | 17 ++++ README.md | 15 +++ docs/README.md | 28 ++++++ docs/project-statistics.md | 156 +++++++++++++++++++++++++++++++- 7 files changed, 266 insertions(+), 1 deletion(-) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index ec12651..3193e94 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -124,7 +124,24 @@ Each machine runs InventarWorkerService (REST agent) - Maintain `docs/project-statistics.md` as the living statistics ledger for the repository. - Update the file after each completed Spec-Kit implementation phase, after each agent-driven repository change, or when a refresh is explicitly requested. - Within the `## Fortschreibungsprotokoll` table, keep entries in strict chronological order: oldest entry at the top, newest and most recently added entry at the bottom; entries with the same date keep their insertion order. +- Keep a final top-level `## Gesamtstatistik` block as the last section of `docs/project-statistics.md`; do not append any later top-level section after it. +- Inside that final `## Gesamtstatistik` block, keep compact ASCII-only diagrams directly below the textual overall summary so the overall artifact mix, documented branch/phase curves, acceleration factors, and the comparison between experienced-developer effort, Thorsten-solo effort, and visible AI-assisted delivery stay readable in plain Markdown. +- Keep each short CEFR-B2 explanation directly adjacent to its matching ASCII diagram group, and keep the statistics block text-first so Braille displays, screen readers, and text browsers do not depend on color or layout alone. - Each update must capture branch or phase, observable work window, production/test/documentation line counts, main work packages, the conservative manual baseline of 80 manually created lines per workday across code, tests, and documentation, and the repo-specific Thorsten-Solo comparison baseline of 100 lines per workday for this native .NET codebase. - When effort is converted into months, use explicit assumptions such as 21.5 workdays per month and, if applicable, 30 vacation days per year under a TVoeD-style calendar. - When reporting acceleration, compare both manual references against visible Git active days and label the result as a blended repository speedup rather than a stopwatch measurement. - When hour values are shown, convert the day-based estimates with the TVoeD working-day baseline of `7.8 hours` (`7h 48m`) per day. + +## Inclusion & Accessibility + +- Explanatory documentation for learner-facing and governance content MUST be bilingual with German first and English second at CEFR-B2 readability. +- Large normative documents such as `Pflichtenheft*.md` and `Lastenheft*.md` may use a synchronized English sidecar with suffix `.EN.md` instead of one oversized inline-bilingual file; the German version remains canonical unless explicitly marked otherwise. +- Follow `Programmierung #include`: learner-facing guides, statistics, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Treat WCAG 2.2 conformance level AA as the practical baseline for generated HTML documentation. +- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`. +- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. + +## Shared Parent Guidance + +- The shared parent file `/Users/thorstenhindermann/RiderProjects/AGENTS.md` intentionally stores only repo-spanning baseline rules. +- Keep repository-specific build, test, workflow, architecture, and feature guidance in this repository's own files; when both layers exist, the repository-local files are the more specific authority. diff --git a/AGENTS.md b/AGENTS.md index 0502def..fef3e74 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -60,6 +60,9 @@ PRs should include: purpose, touched projects, test evidence (commands run), and - Maintain `docs/project-statistics.md` as the living statistics ledger for the repository. - Update the file after each completed Spec-Kit implementation phase, after each agent-driven repository change, or when a refresh is explicitly requested. - Within the `## Fortschreibungsprotokoll` table, keep entries in strict chronological order: oldest entry at the top, newest and most recently added entry at the bottom; entries with the same date keep their insertion order. +- Keep a final top-level `## Gesamtstatistik` block as the last section of `docs/project-statistics.md`; do not append any later top-level section after it. +- Inside that final `## Gesamtstatistik` block, keep compact ASCII-only diagrams directly below the textual overall summary so the overall artifact mix, documented branch/phase curves, acceleration factors, and the comparison between experienced-developer effort, Thorsten-solo effort, and visible AI-assisted delivery stay readable in plain Markdown. +- Keep each short CEFR-B2 explanation directly adjacent to its matching ASCII diagram group, and keep the statistics block text-first so Braille displays, screen readers, and text browsers do not depend on color or layout alone. - Each update must record branch or phase, observable work window, production/test/documentation line counts, main work packages, the conservative manual baseline of 80 manually created lines per workday across code, tests, and documentation, and the repo-specific Thorsten-Solo comparison baseline of 100 lines per workday for this native .NET codebase. - When effort is converted into months, use explicit assumptions such as 21.5 workdays per month and, if applicable, 30 vacation days per year through calendar year 2026 and 31 vacation days per year from calendar year 2027 onward under a TVoeD-style 5-day-week calendar. - When reporting acceleration, compare both manual references against visible Git active days and label the result as a blended repository speedup rather than a stopwatch measurement. @@ -133,3 +136,17 @@ Each machine runs InventarWorkerService (REST agent) | New API endpoints | `InventarWorkerService/Controllers/` + add integration test | | New DB tables/views | Extend `SqliteDbService`; add indices; use `IF NOT EXISTS` | | App-specific persistence/services | Under the app's own `Services/` folder | + +## Inclusion & Accessibility + +- Explanatory documentation for learner-facing and governance content MUST be bilingual with German first and English second at CEFR-B2 readability. +- Large normative documents such as `Pflichtenheft*.md` and `Lastenheft*.md` may use a synchronized English sidecar with suffix `.EN.md` instead of one oversized inline-bilingual file; the German version remains canonical unless explicitly marked otherwise. +- Follow `Programmierung #include`: learner-facing guides, statistics, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Treat WCAG 2.2 conformance level AA as the practical baseline for generated HTML documentation. +- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`. +- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. + +## Shared Parent Guidance + +- The shared parent file `/Users/thorstenhindermann/RiderProjects/AGENTS.md` intentionally stores only repo-spanning baseline rules. +- Keep repository-specific build, test, workflow, architecture, and feature guidance in this repository's own files; when both layers exist, the repository-local files are the more specific authority. diff --git a/CLAUDE.md b/CLAUDE.md index d08ec77..293d5f3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -139,7 +139,24 @@ InventarViewerApp (TUI) → queries InventarWorkerService API → persists in - Maintain `docs/project-statistics.md` as the living statistics ledger for the repository. - Update the file after each completed Spec-Kit implementation phase, after each agent-driven repository change, or when a refresh is explicitly requested. - Within the `## Fortschreibungsprotokoll` table, keep entries in strict chronological order: oldest entry at the top, newest and most recently added entry at the bottom; entries with the same date keep their insertion order. +- Keep a final top-level `## Gesamtstatistik` block as the last section of `docs/project-statistics.md`; no later top-level section should follow it. +- Inside that final `## Gesamtstatistik` block, keep compact ASCII-only diagrams directly below the textual overall summary so the overall artifact mix, documented branch/phase curves, acceleration factors, and the comparison between experienced-developer effort, Thorsten-solo effort, and visible AI-assisted delivery stay readable in plain Markdown. +- Keep each short CEFR-B2 explanation directly adjacent to its matching ASCII diagram group, and keep the statistics block text-first so Braille displays, screen readers, and text browsers do not depend on color or layout alone. - Each update must capture branch or phase, observable work window, production/test/documentation line counts, main work packages, the conservative manual baseline of 80 manually created lines per workday across code, tests, and documentation, and the repo-specific Thorsten-Solo comparison baseline of 100 lines per workday for this native .NET codebase. - When effort is converted into months, use explicit assumptions such as 21.5 workdays per month and, if applicable, 30 vacation days per year through calendar year 2026 and 31 vacation days per year from calendar year 2027 onward under a TVoeD-style 5-day-week calendar. - When reporting acceleration, compare both manual references against visible Git active days and label the result as a blended repository speedup rather than a stopwatch measurement. - When hour values are shown, convert the day-based estimates with the TVoeD working-day baseline of `7.8 hours` (`7h 48m`) per day. + +## Inclusion & Accessibility + +- Explanatory documentation for learner-facing and governance content must be bilingual with German first and English second at CEFR-B2 readability. +- Large normative documents such as `Pflichtenheft*.md` and `Lastenheft*.md` may use a synchronized English sidecar with suffix `.EN.md` instead of one oversized inline-bilingual file; the German version remains canonical unless explicitly marked otherwise. +- Follow `Programmierung #include`: learner-facing guides, statistics, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Treat WCAG 2.2 conformance level AA as the practical baseline for generated HTML documentation. +- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`. +- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. + +## Shared Parent Guidance + +- The shared parent file `/Users/thorstenhindermann/RiderProjects/AGENTS.md` intentionally stores only repo-spanning baseline rules. +- Keep repository-specific build, test, workflow, architecture, and feature guidance in this repository's own files; when both layers exist, the repository-local files are the more specific authority. diff --git a/GEMINI.md b/GEMINI.md index d76fb95..c8b21a1 100644 --- a/GEMINI.md +++ b/GEMINI.md @@ -80,7 +80,24 @@ Das Projekt nutzt die Standard .NET-CLI. - `docs/project-statistics.md` ist das fortlaufende Statistik-Register des Repositories. - Die Datei muss nach jeder abgeschlossenen Spec-Kit-Implementierungsphase, nach jeder agentischen Änderung am Repository und auf explizite Anforderung aktualisiert werden. - Im `## Fortschreibungsprotokoll` muessen die Tabelleneintraege strikt chronologisch stehen: der aelteste Eintrag oben, der juengste und zuletzt eingetragene Eintrag unten; Eintraege mit demselben Datum behalten ihre Eintragungsreihenfolge. +- Als letzter Top-Level-Block der Datei muss immer ein `## Gesamtstatistik`-Abschnitt stehen; danach darf kein weiterer Top-Level-Abschnitt folgen. +- Innerhalb dieses finalen `## Gesamtstatistik`-Abschnitts muessen kompakte ASCII-only-Diagramme direkt unter der textlichen Gesamtauswertung stehen, damit Artefaktmix, dokumentierte Branch-/Phasenverlaeufe, Beschleunigungsfaktoren und der Vergleich zwischen erfahrener Entwickler-Referenz, Thorsten-Solo-Referenz und sichtbarem KI-Lieferfenster in reinem Markdown lesbar bleiben. +- Jeder kurze CEFR-B2-Erklaertext muss direkt bei seiner ASCII-Diagrammgruppe stehen, und der Statistikblock muss fuer Braille-Zeile, Screenreader und Textbrowser textfreundlich bleiben, ohne auf Farbe oder Layout allein angewiesen zu sein. - Jeder Eintrag muss Branch oder Phase, beobachtbares Arbeitsfenster, Produktions-, Test- und Doku-Zeilen, die wesentlichen Arbeitspakete, die konservative Handarbeits-Basis von 80 manuell erstellten Zeilen pro Arbeitstag ueber Code, Tests und Dokumentation hinweg sowie die repo-spezifische Thorsten-Solo-Vergleichsbasis von 100 Zeilen pro Arbeitstag fuer diese native .NET-Loesung enthalten. - Wenn daraus Monatswerte abgeleitet werden, sind die Annahmen explizit zu nennen, zum Beispiel 21,5 Arbeitstage pro Monat sowie 30 Urlaubstage pro Jahr bis einschliesslich 2026 und 31 Urlaubstage pro Jahr ab 2027 in einer TVoeD-aehnlichen Kalenderannahme bei 5-Tage-Woche. - Beschleunigungsangaben muessen beide Referenzen gegen sichtbare Git-Aktivtage stellen und ausdruecklich als repo-weiten Verdichtungsfaktor statt als Stoppuhrmessung kennzeichnen. - Wenn Stundenwerte ausgewiesen werden, sind die Tageswerte mit der TVoeD-Arbeitszeit von `7,8 Stunden` bzw. `7 Stunden 48 Minuten` pro Arbeitstag umzurechnen. + +## Inclusion & Accessibility + +- Erklaerende Lern- und Governance-Dokumentation muss zweisprachig mit Deutsch zuerst und Englisch danach auf CEFR-B2-Niveau vorliegen. +- Grosse normative Dokumente wie `Pflichtenheft*.md` und `Lastenheft*.md` duerfen statt eines uebergrossen Inline-Zweisprachblocks als synchron gepflegte englische Parallelfassung mit Suffix `.EN.md` gefuehrt werden; die deutsche Fassung bleibt kanonisch, solange nichts anderes markiert ist. +- Follow `Programmierung #include`: learner-facing guides, statistics, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Treat WCAG 2.2 conformance level AA as the practical baseline for generated HTML documentation. +- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`. +- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. + +## Shared Parent Guidance + +- Die gemeinsame Datei `/Users/thorstenhindermann/RiderProjects/AGENTS.md` speichert bewusst nur repo-uebergreifende Basisregeln. +- Repository-spezifische Build-, Test-, Workflow-, Architektur- und Feature-Regeln bleiben in den lokalen Projektdateien; wenn beide Ebenen existieren, ist die repo-lokale Guidance die spezifischere Autoritaet. diff --git a/README.md b/README.md index fcb2456..03c85db 100644 --- a/README.md +++ b/README.md @@ -1070,3 +1070,18 @@ sudo setcap 'cap_net_bind_service=+ep' /usr/lib/dotnet/dotnet Projektstart: 26.06.2025 (Geburtstag und 1. Urlaubstag) Funktionsumfang abgeschlossen: 16.11.2025 Implementierung abgeschlossen: TT.MM.JJJJ + +## Inklusion und Barrierefreiheit / Inclusion and Accessibility + +- Erlaeuternde Lern- und Governance-Dokumentation soll in Deutsch zuerst und Englisch danach auf CEFR-B2-Niveau vorliegen. +- Explanatory learner-facing and governance documentation should be German first and English second at CEFR-B2 readability. +- Grosse normative Dokumente wie `Pflichtenheft*.md` und `Lastenheft*.md` duerfen statt eines uebergrossen Inline-Zweisprachblocks als synchron gepflegte englische Parallelfassung mit Suffix `.EN.md` gefuehrt werden; die deutsche Fassung bleibt kanonisch. +- Large normative documents such as `Pflichtenheft*.md` and `Lastenheft*.md` may use a synchronized English sidecar with suffix `.EN.md` instead of one oversized inline-bilingual file; the German version remains canonical. +- Folge dem Leitsatz `Programmierung #include`: Lernmaterialien, Guides und erzeugte HTML-/API-Dokumentation muessen fuer Braille-Zeile, Screenreader und Textbrowser nutzbar bleiben. +- Follow `Programmierung #include`: learner-facing material, guides, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Fuer erzeugte HTML-Dokumentation gilt WCAG 2.2 Konformitaetsstufe AA als praktische Basis. +- For generated HTML documentation, WCAG 2.2 conformance level AA is the practical baseline. +- Nach jedem `docfx`-Neubau muessen im selben Arbeitsschritt sowohl Playwright + `@axe-core/playwright` als auch `lynx` fuer den textorientierten Review laufen. +- After every `docfx` regeneration, the same work step must also run both Playwright + `@axe-core/playwright` and `lynx` for the text-oriented review. +- Empfohlene A11Y-Toolchain fuer DocFX-basierte Doku: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright` und `lynx`. +- Recommended A11y toolchain for DocFX-based documentation: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. diff --git a/docs/README.md b/docs/README.md index 4c40c15..c6732b2 100644 --- a/docs/README.md +++ b/docs/README.md @@ -597,3 +597,31 @@ Abschließend auf `Push` klicken. Ab diesem Zeitpunkt können nun alle geänderten oder neu hinzugefügten Dateien in das Repository aufgenommen werden. Dazu in der `Commit`-Ansicht den Button `Commit And Push` anklicken, nachdem zuvor die Dateien für den `Git Commit` markiert und eine `Commit Message` eingegeben wurden. + +## Inklusion und Barrierefreiheit / Inclusion and Accessibility + +- Erlaeuternde Lern- und Governance-Dokumentation soll in Deutsch zuerst und Englisch danach auf CEFR-B2-Niveau vorliegen. +- Explanatory learner-facing and governance documentation should be German first and English second at CEFR-B2 readability. +- Grosse normative Dokumente wie `Pflichtenheft*.md` und `Lastenheft*.md` duerfen statt eines uebergrossen Inline-Zweisprachblocks als synchron gepflegte englische Parallelfassung mit Suffix `.EN.md` gefuehrt werden; die deutsche Fassung bleibt kanonisch. +- Large normative documents such as `Pflichtenheft*.md` and `Lastenheft*.md` may use a synchronized English sidecar with suffix `.EN.md` instead of one oversized inline-bilingual file; the German version remains canonical. +- Folge dem Leitsatz `Programmierung #include`: Lernmaterialien, Guides und erzeugte HTML-/API-Dokumentation muessen fuer Braille-Zeile, Screenreader und Textbrowser nutzbar bleiben. +- Follow `Programmierung #include`: learner-facing material, guides, and generated HTML/API documentation must stay usable on Braille displays, with screen readers, and in text browsers. +- Fuer erzeugte HTML-Dokumentation gilt WCAG 2.2 Konformitaetsstufe AA als praktische Basis. +- For generated HTML documentation, WCAG 2.2 conformance level AA is the practical baseline. +- Nach jedem `docfx`-Neubau muessen im selben Arbeitsschritt sowohl Playwright + `@axe-core/playwright` als auch `lynx` fuer den textorientierten Review laufen. +- After every `docfx` regeneration, the same work step must also run both Playwright + `@axe-core/playwright` and `lynx` for the text-oriented review. +- Empfohlene A11Y-Toolchain fuer DocFX-basierte Doku: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright` und `lynx`. +- Recommended A11y toolchain for DocFX-based documentation: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`. + +## Abschlusspruefung fuer Bilingualitaet und A11Y + +- Lernrelevante Dokumente und Guides muessen fuer Auszubildende nachvollziehbar in Deutsch und Englisch auf CEFR-B2-Niveau vorliegen. +- Die Reihenfolge fuer erklaerende Inhalte ist Deutsch zuerst und Englisch danach. +- Fuer grosse normative Dokumente ist aus Uebersichtsgruenden eine synchron gepflegte englische Parallelfassung mit Suffix `.EN.md` zulaessig und empfohlen. +- Erzeugte HTML-/API-Dokumentation muss nach `Programmierung #include` fuer Braille-Zeile, Screenreader und Textbrowser nutzbar sein; WCAG 2.2 AA ist die praktische Baseline. +- Nach jedem `docfx`-Neubau folgen im selben Arbeitsschritt Playwright + `@axe-core/playwright` und `lynx`. +- Learner-facing documents and guides must be understandable for apprentices in German and English at CEFR-B2 readability. +- The order for explanatory content is German first and English second. +- Large normative documents may use a synchronized English sidecar with suffix `.EN.md`. +- Generated HTML/API documentation must remain usable for Braille displays, screen readers, and text browsers under `Programmierung #include`; WCAG 2.2 AA is the practical baseline. +- After every `docfx` regeneration, the same work step must run Playwright + `@axe-core/playwright` and `lynx`. diff --git a/docs/project-statistics.md b/docs/project-statistics.md index 2be3ee2..0bf0f56 100644 --- a/docs/project-statistics.md +++ b/docs/project-statistics.md @@ -1,6 +1,6 @@ # Projektstatistik InventarWorkerService -Stand: 2026-03-27 +Stand: 2026-03-30 (aktualisiert inklusive finalem Gesamtstatistik-Block, ASCII-Diagrammen und Governance-Abgleich fuer Bilingualitaet, A11Y und Parent-Baseline) ## Zweck und Pflege @@ -20,6 +20,14 @@ und auf explizite Anforderung fortgeschrieben. `InventarWorkerServiceIntegrationTest/**/*.cs`. - Dokumentation: Markdown-Dateien in Repository-Wurzel, `docs/`, `.github/`, `.specify/` und projektbezogenen Unterordnern. +- Leitsatz fuer diese Datei und die lernrelevanten Dokumente: + `Programmierung #include`. Inhalte muessen fuer Braille-Zeile, + Screenreader und Textbrowser lesbar bleiben; die ASCII-Diagramme sind + deshalb bewusst textuell und nicht farbgetragen aufgebaut. +- Fuer erzeugte HTML-Dokumentation gilt WCAG 2.2 Konformitaetsstufe AA als + konkrete Pruefbasis; besonders wichtig sind Seitensprache, + Bypass-Mechanismen, Tastaturfokus, Non-Text-Contrast und semantische + Landmarken. - Die konservative Handarbeits-Basis in dieser Datei zaehlt Produktionscode, Testcode und Dokumentation gemeinsam als manuell zu erstellenden Umfang. - Die konservative Handarbeits-Basis folgt dem Beitrag @@ -264,3 +272,149 @@ und auf explizite Anforderung fortgeschrieben. | 2026-03-27 | Branch `002-spec-kit-versioning` | Repo-weite Versionslogik fuer nummerierte Spec-Kit-Branches eingefuehrt: `Directory.Build.props` traegt jetzt `Version`, `AssemblyVersion` und `FileVersion`; die gemeinsame Agent-Governance und die Constitution wurden auf `Minor = Spec-Kit-Feature-/Branch-Nummer als kanonische PR-Nummer` synchronisiert. | | 2026-03-27 | Sortierung des Fortschreibungsprotokolls vereinheitlicht | Die Eintraege im Fortschreibungsprotokoll wurden auf strikt chronologische Reihenfolge gebracht: aeltester Eintrag oben, juengster und zuletzt eingetragener Eintrag unten. Dieselbe Regel wurde in der gemeinsamen Agent-Governance fuer dieses Repository festgeschrieben. | | 2026-03-28 | Lastenheft-Branch-Suffix-Regel in Agent-Guidance verankert | Die gemeinsamen Agent-Dateien (`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`) wurden um die Governance-Regel erweitert, dass ein Lastenheft nach Umsetzung durch einen dedizierten Feature-Branch auf `Lastenheft_..md` umzubenennen ist, damit die Rueckverfolgbarkeit im Repository erhalten bleibt; Aenderungsumfang dieser Runde vor dieser Ledger-Fortschreibung: 0 Produktionscode-Zeilen, 0 Testcode-Zeilen, +4 Dokumentationszeilen netto im Arbeitsbaum, konservative Handarbeits-Untergrenze 0.1 Arbeitstage bzw. 0.4 Stunden auf TVoeD-Basis, Monatsannahme weiterhin 21.5 Arbeitstage pro Monat. | +| 2026-03-30 | Inklusions-Leitsatz und DocFX-A11y-Baseline verankert | `README.md`, `docs/README.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` und `.github/copilot-instructions.md` tragen jetzt den Leitsatz `Programmierung #include`. Damit ist fuer dieses Repository festgelegt, dass Guides und erzeugte HTML-/API-Dokumentation fuer Braille-Zeile, Screenreader und Textbrowser lesbar bleiben muessen. Fuer DocFX-basierte HTML-Dokumentation gilt WCAG 2.2 AA als praktische Baseline; nach jedem DocFX-Neubau soll ein textorientierter A11y-Review mit Playwright/axe und `lynx` folgen. Diese Runde war reine Governance-/Doku-Arbeit mit `0` Produktionscode-Zeilen, `0` Testcode-Zeilen und ca. `+48` Dokumentationszeilen netto. Konservative Manualreferenz: 80 Zeilen/Tag = `0.6` Tage (ca. `4.7` Stunden); Thorsten-Solo-Referenz: 100 Zeilen/Tag = `0.5` Tage (ca. `3.7` Stunden); sichtbares Arbeitsfenster: 1 kurze Agentensitzung am 2026-03-30. | +| 2026-03-30 | Bilinguale Abschlusspruefung und A11Y-Gate in zentraler Doku verankert | Da fuer `InventarWorkerService` aktuell kein separates Pflichtenheft im Repository vorliegt, wurden die formalen Abschlusspruefpunkte in `docs/README.md` verankert: Lernrelevante Dokumente muessen in Deutsch und Englisch auf CEFR-B2-Niveau vorliegen; grosse normative Dokumente duerfen als synchron gepflegte `.EN.md`-Parallelfassung ausgeliefert werden; fuer DocFX-basierte HTML-Dokumentation gilt die A11Y-Pflicht nach `Programmierung #include` mit WCAG 2.2 AA, textorientiertem Review nach `docfx` sowie Nutzbarkeit fuer Braille-Zeile, Screenreader und Textbrowser. Diese Runde war reine Dokumentationsarbeit mit `0` Produktionscode-Zeilen, `0` Testcode-Zeilen und ca. `+8` Dokumentationszeilen netto. Konservative Manualreferenz: 80 Zeilen/Tag = `0.1` Tage (ca. `0.8` Stunden); Thorsten-Solo-Referenz: 100 Zeilen/Tag = `0.1` Tage (ca. `0.6` Stunden); sichtbares Arbeitsfenster: 1 kurze Agentensitzung am 2026-03-30. | +| 2026-03-30 | Parent-Guidance bewusst auf repo-uebergreifende Regeln begrenzt | In den lokalen Guidance-Dateien von `InventarWorkerService` ist jetzt ausdruecklich vermerkt, dass `/Users/thorstenhindermann/RiderProjects/AGENTS.md` nur gemeinsame Basisregeln fuer mehrere Repositories traegt. Repository-spezifische Build-, Test-, Workflow-, Architektur- und Feature-Vorgaben bleiben bewusst in `InventarWorkerService` selbst und sind dort die spezifischere Autoritaet. Diese Runde war reine Dokumentationsarbeit mit `0` Produktionscode-Zeilen, `0` Testcode-Zeilen und ca. `+10` Dokumentationszeilen netto. Konservative Manualreferenz: 80 Zeilen/Tag = `0.1` Tage (ca. `1.0` Stunden); Thorsten-Solo-Referenz: 100 Zeilen/Tag = `0.1` Tage (ca. `0.8` Stunden); sichtbares Arbeitsfenster: 1 kurze Agentensitzung am 2026-03-30. | +| 2026-03-30 | Gemeinsame Governance- und Statistikregeln mit TuiVision abgeglichen | `README.md`, `docs/README.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md` und diese Statistikdatei wurden nur auf die gemeinsamen Soll-Punkte nachgezogen: CEFR-B2 mit Deutsch zuerst/Englisch danach, `.EN.md` als zulaessige Parallelfassung fuer grosse normative Dokumente, `Programmierung #include`, WCAG 2.2 AA, verpflichtender `docfx`-Folgecheck mit Playwright/axe plus `lynx` sowie ein finaler `## Gesamtstatistik`-Block mit ASCII-Diagrammen als letzter Abschnitt. Diese Runde war reine Dokumentationsarbeit mit `0` Produktionscode-Zeilen, `0` Testcode-Zeilen und `+265 / -1` Dokumentationszeilen netto. Konservative Manualreferenz: 80 Zeilen/Tag = `3.3` Tage (ca. `25.8` Stunden); Thorsten-Solo-Referenz: 100 Zeilen/Tag = `2.6` Tage (ca. `20.6` Stunden); sichtbares Arbeitsfenster: 1 kurze Agentensitzung am 2026-03-30. | + +## Gesamtstatistik + +Basis dieses Schlussblocks sind die aktuell dokumentierten Snapshot- und +Phasenwerte aus den Abschnitten `## Gesamtstand des Repositories` und +`## Rekonstruierte Entwicklungsphasen` weiter oben. + +| Kennzahl | Verdichteter Gesamtblick | +|---|---:| +| Artefaktbasis gesamt | `17522` Zeilen | +| Produktions- und Testcode zusammen | `11489` Zeilen (`65.6 %`) | +| Dokumentationsanteil | `6033` Zeilen (`34.4 %`) | +| Spec-Kit-Anteil innerhalb der Doku | `0` Zeilen (`0.0 %`) | +| Governance-/Agent-Anteil innerhalb der Doku | `617` Zeilen (`10.2 %`) | +| `docs/`-Anteil innerhalb der Doku | `1994` Zeilen (`33.1 %`) | +| Beobachtbarer Projektzeitraum | `2025-06-26` bis `2026-03-08` | +| Git-Commits pro sichtbarem Aktivtag | `8.2` (`837 / 102`) | +| Dokumentierte Gesamtzeilen pro sichtbarem Aktivtag | `171.8` (`17522 / 102`) | +| Dokumentierte Gesamtzeilen pro Commit | `20.9` (`17522 / 837`) | +| Konservative Einzelentwickler-Untergrenze | `219.0` Arbeitstage / `1708.2` Stunden | +| Thorsten-Solo-Untergrenze | `175.2` Arbeitstage / `1366.6` Stunden | +| Kleines 3er-Team mit Koordinationsaufschlag | `87.6` Arbeitstage | +| Repo-weiter Speedup gg. 80-Zeilen-Referenz | `2.1x` | +| Repo-weiter Speedup gg. Thorsten-Referenz | `1.7x` | + +Kurzfazit: +`InventarWorkerService` zeigt aktuell deutlich mehr Code- als +Dokumentationsvolumen, hat aber gleichzeitig eine sichtbare Governance- und +Dokuschicht, die fuer den Betrieb und die Nachvollziehbarkeit wichtig ist. Der +groesste dokumentierte Volumensprung liegt in Phase `2` (Datenbank-Backends +und Doku-Ausbau), dicht gefolgt von Phase `4` (Governance-, CI- und Spec-Kit- +Rollout). Die Beschleunigungswerte bleiben bewusst konservativ: Sie vergleichen +sichtbaren Lieferumfang mit manuellen Referenzmodellen und messen keine reale +Stoppuhrzeit. + +### ASCII-Diagramme + +```text +Artefaktmix nach aktuell dokumentiertem Snapshot (Zeilen) +Produktion | ############################## | 9395 | 53.6 % +Tests | ####### | 2094 | 12.0 % +Dokumentation | ################### | 6033 | 34.4 % +``` + +Dieses Diagramm zeigt die aktuelle Verteilung zwischen Produktionscode, +Testcode und Dokumentation. Laengere Balken bedeuten mehr sichtbaren Umfang in +derselben Vergleichsgruppe. So wird schnell lesbar, dass die Codebasis im +Moment groesser ist als die Dokumentation, die Doku aber weiterhin einen +substanziellen Anteil am Repository hat. + +This chart shows the current distribution between production code, test code, +and documentation. Longer bars mean more visible scope inside the same +comparison group. It makes clear that the code base is currently larger than +the documentation, while documentation still remains a substantial part of the +repository. + +```text +Phasenvolumen nach dokumentierter Netto-Basis (Zeilen) +0 Basis | ########## | 2593 +1 Ausbau | ########## | 2528 +2 DB+Doku | ######################## | 8078 +3 Metrik | # | 580 +4 Gov+CI | ################### | 6438 +5 002-ver | # | 41 +``` + +Dieses Diagramm zeigt die grob sichtbare Netto-Basis der rekonstruierten +Phasen. Es beantwortet die Frage, welche Phase den groessten dokumentierten +Umfang erzeugt hat. Besonders sichtbar sind hier der Datenbank- und Doku-Ausbau +in Phase `2` sowie der spaete Governance- und CI-Rollout in Phase `4`. + +This chart shows the rough visible net size of the reconstructed phases. It +answers the question which phase created the largest documented scope. The +database and documentation expansion in phase `2` and the later governance and +CI rollout in phase `4` stand out most clearly. + +```text +X/Y-Skizze: dokumentierte Netto-Basis je Phase +Netto-Zeilen +9000 | * +8000 | +7000 | * +6000 | +5000 | +4000 | +3000 | * * +2000 | +1000 | * + 0 +-------------------------------- + 0 1 2 3 4 5 +``` + +Die X/Y-Skizze zeigt denselben Phasenverlauf noch einmal als einfachen Trend +ueber die Phasenachse. Sie ist bewusst grob gehalten. Wichtig ist hier nicht +Millimetergenauigkeit, sondern dass der starke Ausschlag bei Phase `2`, der +zweite hohe Ausschlag bei Phase `4` und die kleine Restgroesse der aktuellen +Versionierungsrunde schnell sichtbar werden. + +The X/Y sketch shows the same phase progression again as a simple trend over +the phase axis. It is intentionally rough. The goal is not millimetre accuracy, +but quick visibility of the strong peak at phase `2`, the second high peak at +phase `4`, and the very small remaining size of the current versioning round. + +```text +Vergleich Referenzaufwand vs. sichtbare Git-Aktivtage +Erfahrener Dev | ############################## | 219.0 d +Thorsten solo | ######################## | 175.2 d +Git-Aktivtage | ############## | 102.0 d +3er-Team | ############ | 87.6 d +``` + +Dieses Diagramm vergleicht die manuellen Referenzmodelle direkt mit den +sichtbaren Git-Aktivtagen. Damit wird lesbar, wie gross die Luecke zwischen +klassischer Handarbeit und dem dokumentierten Lieferfenster ist. Der Vergleich +ist ein repo-weiter Verdichtungsindikator und keine Aussage ueber echte +Arbeitsstunden. + +This chart compares the manual reference models directly with the visible Git +active days. It makes the gap between classical manual delivery and the +documented delivery window easier to read. The comparison is a repository-wide +compression indicator, not a statement about real worked hours. + +```text +Dokumentierte Beschleunigungsfaktoren +Repo 80 | ########### | 2.1x +Repo100 | ######### | 1.7x +Phase 2 | ############# | 1.4x +Phase 4 | ######################## | 80.5x +Phase 5 | ##### | 0.5x +``` + +Dieses Diagramm zeigt die dokumentierten Beschleunigungsfaktoren gegen die +verfuegbaren Referenzen und markante Einzelphasen. Die sehr hohe Zahl in Phase +`4` kommt daher, dass ein grosser Governance- und Doku-Block an nur einem +sichtbaren Git-Aktivtag dokumentiert ist. Die kleine Zahl in Phase `5` zeigt +umgekehrt, dass die aktuelle Versionierungsrunde bewusst klein gehalten wurde. + +This chart shows the documented acceleration factors against the available +references and selected phases. The very high number in phase `4` appears +because a large governance and documentation package is documented on only one +visible Git active day. The small number in phase `5` shows the opposite case: +the current versioning round was intentionally kept small.