shinkan-jinkendo/docs/architecture
Lars 4b9374765b
All checks were successful
Deploy Development / deploy (push) Successful in 41s
Test Suite / pytest-backend (push) Successful in 43s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 13s
Test Suite / k6 /health Baseline (push) Successful in 34s
Test Suite / playwright-tests (push) Successful in 1m21s
Enhance Progression Graph Management with F15 Features and Evaluation Improvements
- Updated `PROJECT_STATUS.md` to reflect the implementation of F15 features, including the unified slot review and handling of `findings_stale`.
- Enhanced `PROGRESSION_GRAPH_SLOT_EDITOR_SPEC.md` with detailed descriptions of new functionalities related to the match dialog and path quality assessments.
- Introduced new functions in `exercise_progression_graphs.py` to validate exercise visibility against progression graph settings, ensuring proper governance.
- Improved frontend components to support new governance parameters (visibility and club_id) in exercise creation workflows.
- Updated documentation in `HANDOVER.md` and `PLANNING_KI_ROADMAP.md` to outline the latest developments and validation results for the F15 features.
- Enhanced utility functions for exercise creation to incorporate governance settings, improving the overall user experience in the path builder and editor.
2026-06-14 06:44:12 +02:00
..
BASELINE_SNAPSHOT.md chore(version): update version and changelog for release 0.8.131 2026-05-14 16:02:54 +02:00
PLANNING_CATALOG_PROMPT_SNIPPETS.md Enhance Slot Difference Annotation and Rematch Suggestion Logic 2026-06-13 07:55:47 +02:00
PLANNING_KI_ROADMAP.md Enhance Progression Graph Management with F15 Features and Evaluation Improvements 2026-06-14 06:44:12 +02:00
PLANNING_PROGRESSION_GRAPH_KI.md Enhance Progression Graph Management with F15 Features and Evaluation Improvements 2026-06-14 06:44:12 +02:00
README.md Update documentation and enhance planning features in Progression Graph 2026-06-10 07:50:29 +02:00
SCHULDEN_UND_REMEDIATION.md feat(docs): add performance baseline documentation and update architecture references 2026-05-14 06:53:37 +02:00
TRAINING_UNIT_EDIT_PAGE_MIGRATION.md Enhance frontend testing setup and refactor TrainingPlanningPageRoot component 2026-05-19 11:02:03 +02:00
UMSETZUNGSPLAN_ROADMAP.md Enhance Planning AI with Roadmap-First Architecture and New Features 2026-06-08 08:10:53 +02:00
VERBINDLICHE_REGELN_SHINKAN.md feat(docs): update architecture documentation references and enhance handover details 2026-05-14 06:42:13 +02:00
ZIELBILD_ARCHITEKTUR.md feat(docs): update architecture documentation references and enhance handover details 2026-05-14 06:42:13 +02:00

Architektur: Zielbild, Refaktor, Regeln (Shinkan Jinkendo)

Dieses Bündel ist die Leitlinie für die große Refaktorierung nach dem MVP. Es ergänzt die bestehenden Pflichtdokumente (.claude/rules/ARCHITECTURE.md, CODING_RULES.md, Zugriffsschicht, Media-Spec) und ist für Wartbarkeit, Performance und sichere Erweiterung verbindlich, soweit hier ausdrücklich festgelegt.

Inhalt

Datei Zweck
ZIELBILD_ARCHITEKTUR.md Zielarchitektur (Frontend, API, Daten), Qualitätsziele, Einbindung neuer Features
SCHULDEN_UND_REMEDIATION.md Erfasste Architekturschuld, Reihenfolge und Massnahmen zur Behebung
UMSETZUNGSPLAN_ROADMAP.md Phasen, Meilensteine, Abnahmekriterien, Aufwandsschwerpunkte
frontend/src/api/client.js Phase 4: zentraler HTTP-Client (request, ACTIVE_CLUB_STORAGE_KEY, API_URL, mergeActiveClubHeader)
frontend/src/api/exercises.js Phase 4: Übungen, Medien/Archiv, Progressionsgraphen, KI-Hilfen
frontend/src/api/planning.js Phase 4: Trainingsplanung (Einheiten, Vorlagen, Module, Rahmen, KPIs)
BASELINE_SNAPSHOT.md Phase 0: Bundle-, API- und Last-Baseline (Messvorlagen, Vergleich nach Phase 2)
KI-Prompt-Zielarchitektur Roadmap: Kontext-Arten, Composition, Planung/Rahmen, Phasenplan (verbindliche Zielrichtung)
PLANNING_PROGRESSION_GRAPH_KI.md Progressionsgraph-KI Ist-Stand (Module, API, Graph-Verhalten, Persistenz — zentrale Referenz)
PLANNING_KI_ROADMAP.md Planungs-KI Produkt-Roadmap (Phase FG, Abgrenzung Trainingsplanung)
Progressions-Roadmap Spec Phase F: Artefakte A→B→C, API, Workflow-lite

Tests (E2E / Refaktor-Budget)

  • tests/dev-smoke-test.spec.js Playwright-Suite (Smoke + Compliance). Enthält u. a. Test 8: nach Login und Reload des Dashboards werden GET-Aufrufe zu /api/profiles/me und /api/training-units gezählt (Absicherung Dashboard-Refaktor Phase 1). Ausführung: npm run test:e2e; CI: .gitea/workflows/test.yml Job playwright-tests. k6-Baseline: Job k6-health-baseline (siehe scripts/load/README.md).

Pflege

  • Bei abgeschlossenen Phasen: Roadmap und Remediation-Dokument aktualisieren; bei Regeländerungen: nur mit expliziter Projektfreigabe (gleiches Verfahren wie bei .claude/rules/ARCHITECTURE.md).
  • Querschnitt: docs/HANDOVER.md soll auf die aktive Roadmap-Phase verweisen.

Bezug MVP

Die aktuelle Codebasis ist funktional MVP-tauglich; strukturell bestehen bekannte Schwerpunkte (grosse Seiten-Monolithen, API-Monolith im Client, redundante Lesepfade, schwere Listenqueries). Dieses Bündel definiert, wie nach dem MVP weitergebaut wird, ohne jedes neue Feature erneut mit architektonischer Schuld zu überfrachten.