Lars
e2964a077d
All checks were successful
Deploy Development / deploy (push) Successful in 38s
Test Suite / pytest-backend (push) Successful in 24s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 7s
Test Suite / playwright-tests (push) Successful in 27s
- 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.
174 lines
7.7 KiB
Markdown
174 lines
7.7 KiB
Markdown
# 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`](library/FEATURES_DELIVERED_2026-Q2.md) · Medien-Norm: [`technical/MEDIA_ASSETS_AND_ARCHIVE_SPEC.md`](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:**
|
||
|
||
- [x] Auth & Profile Management
|
||
- [x] Organisation (Clubs, Divisions, Groups)
|
||
- [x] Kataloge (Focus Areas, Styles, Target Groups – M:N)
|
||
|
||
**Übungen:**
|
||
|
||
- [x] CRUD (Create, Read, Update, Delete)
|
||
- [x] M:N Beziehungen (Focus Areas, Styles, Target Groups, Skills)
|
||
- [x] **Varianten** (CRUD, Reorder, Voraussetzung) + Anzeige im Detail
|
||
- [x] **Progressionsgraph zwischen Übungen** (Bibliotheks-Container, Kanten, Sequenz-Bulk, Varianten-Knoten — Zwischenstand, siehe TRAINING_FRAMEWORK_SPEC §4)
|
||
- [x] Medien (Upload/Embed, rollenabhängige Größenlimits)
|
||
- [x] Suche & Filter (Multi-Filter, Chips, Fokus beim Suchen)
|
||
- [x] Exercise Blocks (Bausteine)
|
||
- [x] Saved Searches (wo implementiert)
|
||
|
||
**Trainingsplanung:**
|
||
|
||
- [x] Training Units / strukturierter Ablauf (Sektionen + Items)
|
||
- [x] **Optionale Zuordnung einer Übungsvariante** pro Eintrag (`exercise_variant_id`)
|
||
- [x] **Trainingsrahmenprogramm Bibliothek** (Ziele, Slots, Kontext) + **Slot‑Blueprints** in `training_units` (036–037)
|
||
- [x] **Materialisierung** aus Rahmen‑Slot (`POST …/training-units/from-framework-slot`; UI‑Anbindung optional)
|
||
- [ ] Kalender-View / erweiterte Roadmap (Backlog)
|
||
|
||
**MediaWiki Import:**
|
||
|
||
- [x] Import-Tracking, Übungs-Import, Skills-Migration (siehe ältere Session-Docs)
|
||
|
||
**Skills-System:**
|
||
|
||
- [x] Hierarchisches Schema, Fokusbereich-Zuordnung, Exercise-Skill mit Levels
|
||
|
||
**Admin-UI:**
|
||
|
||
- [x] Katalog-CRUD, Matrix/Import je nach Rolle
|
||
|
||
### 🔲 In Arbeit / Backlog
|
||
|
||
- [x] **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
|