shinkan-jinkendo/.claude/docs/working/ACCESS_LAYER_ENDPOINT_AUDIT.md
Lars 8ac723eafe
All checks were successful
Deploy Development / deploy (push) Successful in 34s
Test Suite / pytest-backend (push) Successful in 23s
Test Suite / lint-backend (push) Successful in 0s
Test Suite / build-frontend (push) Successful in 6s
Test Suite / playwright-tests (push) Successful in 24s
feat: enhance media lifecycle management and inline media integration
- Implemented media lifecycle management with new API endpoints for handling asset states (trash_soft, trash_hidden, recover, purge), improving media governance.
- Updated frontend components to filter and display media based on lifecycle states, enhancing user experience and visibility.
- Enhanced documentation in MEDIA_ASSETS_AND_ARCHIVE_SPEC.md to include guidelines for inline media references in exercise texts, establishing a clear implementation plan.
- Incremented version to 0.8.42, reflecting the latest changes in media handling and lifecycle management.
2026-05-07 12:55:50 +02:00

4.5 KiB
Raw Blame History

Endpoint-Audit: Mandanten & Governance

Fortlaufend gemäß ACCESS_LAYER_AND_GOVERNANCE_PLAN.md Stufe AC.

Router / Bereich Beispiel-Endpunkt tenant-relevant Depends(get_tenant_context) / Kontext Governance geprüft (Liste+Detail) Notizen
profiles GET /api/profiles/me ja resolve_tenant_context inline (invalid_header_policy=ignore) teils + effective_club_id; veralteter Header bricht Refresh nicht
profiles GET /api/profiles, GET /profiles/{pid}, POST /profiles, DELETE /profiles/{pid} ja/teils require_auth ja Liste nur Plattform-Admin; GET nach ID eigenes Profil oder Admin; POST/DELETE nur Admin
profiles PUT /api/profiles/{id}, PUT /api/profile ja get_tenant_context active_club_id Mitgliedschaft Validiert X-Active-Club-Id konsistent zu Mitgliedschaft
clubs geschützte /api/clubs*, /divisions*, /groups* ja get_tenant_context Mitgliedschaft / can_manage_* Öffentlich: /clubs/public-directory ohne Auth
club_memberships /clubs/{id}/members* ja get_tenant_context ja
club_join_requests /me/club-join-requests, /clubs/{id}/join-requests* ja get_tenant_context ja
exercises PATCH /api/exercises/bulk-metadata ja get_tenant_context ja Liste: UI-Mehrfachwahl; bis 500 IDs; nur Ersteller oder Plattform-Admin
exercises GET .../media/{mid}/file ja get_tenant_context_flexible ja (wie Übung lesen) Datei oder ?ssetoken; kein anonymes /media/ ohne ALLOW_PUBLIC_MEDIA_STATIC
exercises übrige geschützte /api/exercises* ja get_tenant_context ja
exercise_progression_graphs /api/exercise-progression-graphs* ja get_tenant_context Liste wie Bibliothek; Schreiben Ersteller/Plattform-Admin Kanten: Lesen wenn Graph lesbar
training_planning alle geschützten Endpoints ja get_tenant_context ja Vorlagen-Liste wie Übungen; POST Vorlage Default club_id
training_framework_programs alle geschützten Endpoints ja get_tenant_context ja Liste + POST Default club_id
admin_users GET /api/admin/users Plattform require_auth Admin-Rolle EXEMPT check_access_layer_hints.py
platform_media_storage GET/PUT /api/admin/platform-media-storage Plattform require_auth GET: is_platform_admin; PUT: nur superadmin Relativer Pfad unter MEDIA_ROOT; keine Secrets; EXEMPT wie admin_users
media_assets POST /api/media-assets/{id}/lifecycle ja get_tenant_context ja Papierkorb: trash_soft / trash_hidden / recover / purge; Rechte über Uploader, can_manage_club_org, Superadmin (assert_can_manage_media_asset_lifecycle)
auth /api/auth/* nein Login/Session EXEMPT
catalogs Katalog-CRUD nein (global) require_auth Admin/Trainer je Endpoint EXEMPT; bei späterem club_id nachziehen
skills /api/skills* nein (global) require_auth je Endpoint EXEMPT
maturity_models Admin-Matrix nein (global) require_auth Admin für Schreiben; GET …/{id} nur Portal-Admin EXEMPT
matrix_stack_bundle Export/Import Bundles Plattform/Test require_auth Admin EXEMPT
import_wiki / import_wiki_admin Wiki-Import Werkzeug require_auth/Admin Admin EXEMPT

Legende: Router auf der EXEMPT-Liste des Scripts sind globale oder Auth-only-Pfade; sobald ein Router Vereinsdaten oder Bibliotheks-Sichtbarkeit erhält, EXEMPT entfernen und get_tenant_context einführen.

Pflege / Drift: Änderungen an Mandanten, Governance (visibility/club_id) oder neuen inhaltsbezogenen Endpoints → eine Zeile in dieser Tabelle anpassen und PRODUCTION_READINESS_AUDIT_2026-05.md prüfen.

Letzte Änderung: 2026-05-07 — media_assets Lifecycle-API (Papierkorb); platform_media_storage Admin-API (Speicherpfad Superadmin).


Changelog (Fortführung)

  • 2026-05-07: Legacy GET/PUT /api/profile auf Session-Profil gehärtet; OpenAPI/Health-Ready Produktionsdefaults; Security-Release-Tests + CI-Schritt security_release_checks.py — siehe PRODUCTION_READINESS_AUDIT_2026-05.md.
  • 2026-05-07 (Phase 3): CSP SPA (nginx); API nosniff-Middleware — siehe PRODUCTION_READINESS_AUDIT_2026-05.md.

Hinweis GET /training-units

Kein impliziter Filter nach effective_club_id (Multi-Verein-Kalender); bei Bedarf club_id Query setzen.