Lars/shinkan-jinkendo
1
0
Fork 0
Code Issues 7 Pull Requests Actions Packages Projects Releases 3 Wiki Activity
e2964a077d
shinkan-jinkendo/.claude/docs/PROJECT_STATUS.md
Lars e2964a077d
All checks were successful
Deploy Development / deploy (push) Successful in 38s
Details
Test Suite / pytest-backend (push) Successful in 24s
Details
Test Suite / lint-backend (push) Successful in 0s
Details
Test Suite / build-frontend (push) Successful in 7s
Details
Test Suite / playwright-tests (push) Successful in 27s
Details
feat: update media management and project status documentation 
- Updated project status to reflect the latest media management milestones and version increment to 0.8.44.
- Enhanced MEDIA_ASSETS_AND_ARCHIVE_SPEC.md with new API details for media asset lifecycle and inline media integration.
- Improved exercise media handling in the frontend, including new preview features and user prompts for media deletion.
- Adjusted backend API to ensure proper handling of media asset deletions without removing files, maintaining governance and user experience.
2026-05-07 13:10:37 +02:00

7.7 KiB
Raw Blame History

Shinkan Jinkendo - Projekt-Status

Stand: 2026-05-07
Version (Code): 0.8.43 (backend/version.py, APP_VERSION)
DB-Schema-Version: 20260507045 (u. a. media_assets, platform_media_storage)
Branch: develop

Executive Summary

Aktueller Meilenstein (Medien): Archiv & Wiederverwendung auf Basis von Migration 045 (media_assets, exercise_media.media_asset_id, Superadmin-Speicherpfad). Papierkorb §5 (Lifecycle-API, Retention-Job), Archiv-Liste (GET /api/media-assets), Direkt-Download für Thumbnails (GET /api/media-assets/{id}/file), Verknüpfen ohne Upload (POST /api/exercises/{id}/media/from-asset), Übungsformular mit Archiv-Dialog und Vorschau sind umgesetzt.

Parallel weiter relevant: Trainingsrahmenprogramm (036–037), Progressionsgraph (032–034) — siehe TRAINING_FRAMEWORK_SPEC.md.

Referenz: library/FEATURES_DELIVERED_2026-Q2.md · Medien-Norm: technical/MEDIA_ASSETS_AND_ARCHIVE_SPEC.md

Nächste Schritte — Medien & Archiv (neu priorisiert, Stand 2026-05-07):

  1. Übung → official Promotion inkl. Medien-Anhebung + Copyright-Pflicht bei official (Spec §4.2) — höchste fachliche Lücke zur Governance.
  2. Eigenständige Medienmanager-Seite (Admin/Verein): Metadaten/Copyright bearbeiten, Filtern nach Lifecycle, Bulk — ergänzt den in der Übung eingebetteten Archiv-Picker.
  3. Tests & Observability: gezielte pytest-Abdeckung für Archiv/Verknüpfen; optional Retention-Job-Dry-Run dokumentieren.
  4. S3 / externes Backend hinter Speicher-Abstraktion (Spec §7) — nach stabiler Nutzung lokaler/NAS-Pfade.
  5. Inline-Medien im Fließtext (Spec §11) — bewusst nach Promotion/Copyright und tragfähigem Archiv-Workflow.

Inline: Leitplanken in MEDIA_ASSETS_AND_ARCHIVE_SPEC.md §11; kein Big-Bang vor stabiler Archiv-/Governance-Basis.

Nächste Schritte (Auszug — Planung/Rahmen):

  1. Kalender‑UI: „Aus Rahmen übernehmen“ an from-framework-slot anbinden; ggf. Bulk.
  2. Governance: Sichtbarkeit club/official für Rahmen so ausprägen, dass andere Trainer kopieren dürfen (Policy + API).
  3. Optional Backlog Graph: Alternativgruppen / bessere Visualisierung (§4).

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 Import Skills from Matrix (DEPRECATED) ⚠️ ❌
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 ✅ 🔲
035–037 Rahmenprogramm, Bibliothek‑Kopf, Slot‑Blueprint‑Units ✅ 🔲
040–045 u. a. Mitgliedschaften, Übungs-Governance, media_assets, Plattform-Speicherpfad ✅ 🔲

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 / strukturierter Ablauf (Sektionen + Items)
  • Optionale Zuordnung einer Übungsvariante pro Eintrag (exercise_variant_id)
  • Trainingsrahmenprogramm Bibliothek (Ziele, Slots, Kontext) + Slot‑Blueprints in training_units (036–037)
  • Materialisierung aus Rahmen‑Slot (POST …/training-units/from-framework-slot; UI‑Anbindung optional)
  • 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

  • Medien: Papierkorb (§5), Retention-Job, Archiv-API, „Aus Archiv verknüpfen“, Picker/Vorschau in Übungsbearbeitung (Release 0.8.42 ff.)
  • Medien: Promotion Übung↔Medien + Copyright-Pflicht official (Spec §4.2)
  • Medien: Eigenständige Medienmanager-UI (Admin/Verein), S3 — Roadmap Executive Summary
  • Medien: Inline im Fließtext — nach Spec §11, nach Promotion/Archiv-Reife
  • 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 loading zerstört Fokus und Scroll – separates listFetching fü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 045 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-05-05 ✅ Aktualisiert (u. a. 036–037)
Trainingsrahmen + Graph technical/TRAINING_FRAMEWORK_SPEC.md 2026-05-05 ✅ §2 Blueprint
Anforderungen (Index) functional/SHINKAN_REQUIREMENTS.md 2026-04-27 ✅ Neu
Database Schema technical/DATABASE_SCHEMA.md 2026-05-05 ✅ Aktualisiert (037)
Domain Model functional/DOMAIN_MODEL.md 2026-05-05 ✅ 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)
Medien-Archiv & Lifecycle technical/MEDIA_ASSETS_AND_ARCHIVE_SPEC.md 2026-05-07 ✅ §11 Inline-Plan, Drift-Tab
Projektstatus PROJECT_STATUS.md 2026-05-07 ✅ Medien-Meilenstein aktualisiert

Team & Kontakte

Product Owner: Lars
Wiki (Datenquelle): https://karatetrainer.net

Letzte Aktualisierung: 2026-05-07