Lars
f5895b6637
- Updated CLAUDE.md to reflect the addition of exercise_progression_graphs in the backend routers. - Revised PROJECT_STATUS.md to document the current project status and recent milestones, including the implementation of the exercise progression graph feature. - Incremented versioning in DOMAIN_MODEL.md and DATABASE_SCHEMA.md to align with the latest migration updates. - Enhanced technical specifications in TRAINING_FRAMEWORK_SPEC.md to clarify the implementation details of the exercise progression graph and its integration with the training framework.
6.0 KiB
Shinkan Jinkendo - Projekt-Status
Stand: 2026-04-30
Version (Code): 0.8.7 (backend/version.py, APP_VERSION)
DB-Schema-Version: 20260430034
Branch: develop
Executive Summary
Aktueller Meilenstein: Progressionsgraph zwischen Übungen (DB 032–034, API exercise-progression-graphs, UI Tabs + Formularblock) — Zwischenstand: linear/Reihen/Schwestern gut nutzbar; parallele gleichwertige Alternativ‑„Pakete“ noch ohne dedizierte UX (TRAINING_FRAMEWORK_SPEC.md §4). Ausreichend, um mit Trainingsplanung / Rahmen (CURR‑002 (2)) weiterzuarbeiten.
Letzte dokumentierte Änderungen (April 2026):
- ✅ Migration 032–034:
exercise_progression_graphs,exercise_progression_edgesinkl.notes, optionale Varianten-Endpunkte. - ✅
POST /api/exercise-progression-graphs/{id}/edges/sequenceund…/edges/delete-batch. - ✅ Übungsliste: Tabs Liste · Progressionsgraphen; Übung bearbeiten: Block Progressionsgraph.
- ✅ Zuvor geliefert: Varianten Ende-zu-Ende (030), Listen-Suche UX, Medien-Limits, RichText — siehe unten und Feature-Doc.
Referenz: Ausführliche technische Liste → library/FEATURES_DELIVERED_2026-Q2.md · Zwischenstand Graph → technical/TRAINING_FRAMEWORK_SPEC.md
Nächste Schritte (Auszug):
- Trainingsplanungs-/Rahmenmodul nach CURR‑002 (2), CURR‑009–013 (Graph bleibt unterstützend).
- Prod-Deployment Migrationen bis 034 und Smoke-Tests.
- Optional Backlog Graph: Alternativgruppen / bessere Visualisierung verzweigter Graphen.
Deployed Migrations (Dev / Zielstand)
| Migration | Beschreibung | Dev | Prod |
|---|---|---|---|
| 001–017 | Initial Schema + Exercise System | ✅ | ✅ |
| 018 | Wiki Import Tracking | ✅ | ✅ |
| 019 | Exercises Optional Fields | ✅ | ✅ |
| 020 | Exercise Skills UNIQUE Constraint | ✅ | 🔲 |
| 021 | ⚠️ | ❌ | |
| 022 | Skills Schema Complete | ✅ | 🔲 |
| 023 | Skills Complete Import (69 Skills) | ✅ | 🔲 |
| 028–029 | exercise_media / skills Stufen | ✅ | 🔲 |
| 030 | training_unit_exercises.exercise_variant_id | ✅ | 🔲 |
| 032–034 | Progressionsgraph Übung→Übung | ✅ | 🔲 |
Aktuelle Datenbank-Stats (Dev, Richtwerte)
Die exakten Zahlen hängen von der Umgebung ab (siehe Admin/DB). Die Skills/Übungen-Importe aus früheren Meilensteinen bleiben die Datenbasis.
Feature-Status
✅ Deployed Features (Dev)
Kern-System:
- Auth & Profile Management
- Organisation (Clubs, Divisions, Groups)
- Kataloge (Focus Areas, Styles, Target Groups – M:N)
Übungen:
- CRUD (Create, Read, Update, Delete)
- M:N Beziehungen (Focus Areas, Styles, Target Groups, Skills)
- Varianten (CRUD, Reorder, Voraussetzung) + Anzeige im Detail
- Progressionsgraph zwischen Übungen (Bibliotheks-Container, Kanten, Sequenz-Bulk, Varianten-Knoten — Zwischenstand, siehe TRAINING_FRAMEWORK_SPEC §4)
- Medien (Upload/Embed, rollenabhängige Größenlimits)
- Suche & Filter (Multi-Filter, Chips, Fokus beim Suchen)
- Exercise Blocks (Bausteine)
- Saved Searches (wo implementiert)
Trainingsplanung:
- Training Units / Einbinden von Übungen
- Optionale Zuordnung einer Übungsvariante pro Eintrag (
exercise_variant_id) - Kalender-View / erweiterte Roadmap (Backlog)
MediaWiki Import:
- Import-Tracking, Übungs-Import, Skills-Migration (siehe ältere Session-Docs)
Skills-System:
- Hierarchisches Schema, Fokusbereich-Zuordnung, Exercise-Skill mit Levels
Admin-UI:
- Katalog-CRUD, Matrix/Import je nach Rolle
🔲 In Arbeit / Backlog
- Admin-UI für Skill-Kategorien (CRUD) – falls noch offen
- Responsive Design / Dark Mode / PWA
- KI-Suche (
ai_search) über reine Volltextsuche hinaus
📋 Geplant (Backlog)
- Trainingsplan-Generator, Bulk-Export, Review-Workflow (unverändert strategisch geplant)
Technische Schulden
| Bereich | Issue | Priorität |
|---|---|---|
| Skills | Migration 021 bereinigen (falls noch referenziert) | Niedrig |
| Import | Reimport-Flag / DNS – je nach Prod-Realität prüfen | Mittel |
Lessons Learned (Auszug)
- Listen-UX: Bedingtes Rendern der gesamten Seite bei
loadingzerstört Fokus und Scroll – separateslistFetchingfür die Trefferliste. - Upload-Limits: Vergleich immer in MB vor Umrechnung in Bytes; Admin-Limit nie unter Nutzer-Limit.
Deployment-Status
Dev
Branch develop; Migrations bis mindestens 034 auf dem aktuellen Entwicklungsstand; Details in backend/version.py.
Prod
Deployment der oben genannten Migrationen und Datenabgleich nach internem Prozess.
Dokumentation-Status
| Dokument | Pfad | Stand | Status |
|---|---|---|---|
| Lieferliste Q2 2026 | library/FEATURES_DELIVERED_2026-Q2.md |
2026-04-30 | ✅ Aktualisiert (032–034) |
| Trainingsrahmen (Zwischenstand Graph) | technical/TRAINING_FRAMEWORK_SPEC.md |
2026-04-30 | ✅ |
| Anforderungen (Index) | functional/SHINKAN_REQUIREMENTS.md |
2026-04-27 | ✅ Neu |
| Database Schema | technical/DATABASE_SCHEMA.md |
2026-04-30 | ✅ Aktualisiert (034) |
| Domain Model | functional/DOMAIN_MODEL.md |
2026-04-30 | ✅ Aktualisiert |
| API Übungen | technical/EXERCISES_API_SPEC.md |
2026-04-30 | ✅ Ergänzt Progressions-API |
| Frontend Routing | technical/EXERCISES_FRONTEND_ROUTING.md |
2026-04-30 | ✅ Ergänzt UI-Hinweise |
| Search & Filter | technical/SEARCH_FILTER_SPEC.md |
2026-04-27 | ✅ Aktualisiert (Liste UX) |
| Media Upload | technical/MEDIA_UPLOAD_SPEC.md |
2026-04-27 | ✅ Aktualisiert (Limits) |
| Projektstatus | PROJECT_STATUS.md |
2026-04-30 | ✅ Diese Datei |
Team & Kontakte
Product Owner: Lars
Wiki (Datenquelle): https://karatetrainer.net
Letzte Aktualisierung: 2026-04-30