# Jinkendo – Medien, Dateien & sicheres Rendering Blueprint
**v0.1 · 16.10.2026 · Ergänzungsblueprint · technisch konkreter Entwurf V/K**
## 1. Ziel, Einordnung und Grenzen
Dieser Blueprint konkretisiert den sicheren produktlokalen Umgang mit Uploads, gespeicherten Dateien, Medienverweisen, Downloads, Rich Text und erzeugten Dokumenten. Die zunächst priorisierten Spezialblueprints sind erstellt. Dieser Ergänzungsblueprint ist sinnvoll, weil Shinkan bereits Medienarchiv, Übungsmedien und Rich Text besitzt, Mitai persönliche Fotos und PDFberichte verwendet und Kanshō private Journalmedien einbindet. Er ist kein Anlass für eine neue Architekturkonsolidierung oder Produktreifebewertung.
Grundlagen:
- [Referenzarchitektur A v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/A_Jinkendo_Technical_Reference_Architecture.md), [Application Foundation B v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/B_Implementation_Blueprint_Application_Foundation.md) und [Entscheidungen C v0.3](C:/Dev/jinkendo-phase3-2-technical-reference-architecture-v0.3-2026-10-16/C_Technical_Decisions_Open_Issues.md).
- [Auth, Session & Scope](C:/Dev/jinkendo-phase3-3-auth-session-scope-blueprint-2026-10-16/Jinkendo_Auth_Session_Scope_Blueprint.md), [Release, Betrieb & Recovery](C:/Dev/jinkendo-release-betrieb-recovery-blueprint-2026-10-16/Jinkendo_Release_Betrieb_Recovery_Blueprint.md), [KI-Gateway](C:/Dev/jinkendo-ki-gateway-provider-privacy-blueprint-2026-10-16/Jinkendo_AI_Gateway_Provider_Privacy_Blueprint.md), [Prompt-/Workflow-Laufzeit](C:/Dev/jinkendo-prompt-placeholder-workflow-blueprint-2026-10-16/Jinkendo_Prompt_Placeholder_Workflow_Blueprint.md), [Entitlements, Usage & Quotas](C:/Dev/jinkendo-entitlements-usage-quotas-blueprint-2026-10-16/Jinkendo_Entitlements_Usage_Quotas_Blueprint.md).
- Beschlossene ADR-01 bis ADR-14 im [Entscheidungsregister](C:/Dev/jinkendo-architecture-consolidation-phase2-v0.2-2026-10-15/05_Architecture_Decision_Register.md). ADR-15/16 werden hier nicht entschieden. Technische Herkunfts-/Versionsbindungen sind keine Festlegung familienweiter Quellhoheit oder aktueller fachlicher Gültigkeit.
- [Phase-3.1-Wissenselemente](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/A01_knowledge_elements.json), besonders KI-SHK-10/16/19, KI-MIT-06/19, KI-KAN-02/22; [Quellen](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/sources.json), [Testregister](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/tests.jsonl) und [Guardrails](C:/Dev/jinkendo-phase3-1-technical-knowledge-inventory-2026-10-15/guardrails_source_register.jsonl).
| Nachweisgrad | Bedeutung |
|---|---|
| **V** | Vorgeschlagener technischer Standard für spätere Umsetzung |
| **I** | Gezielte statische Implementierungs-/Dokumentreferenz |
| **T** | Tatsächlich ausgeführte Prüfung mit ausdrücklich begrenztem Umfang |
| **K** | Noch nicht integrierte oder getestete Kombination |
Neue Schnittstellen und Abläufe sind **V/K**. Vorhandener Code und Testdateien sind **I**, kein Nachweis bestandener Tests. Der abschließende Dokumentcheck ist ausschließlich T für Dateiintegrität, Verweise und Beispielsyntax. Foundation und Blueprint werden nicht als produktionsreife Referenzimplementierung ausgegeben.
Es erfolgen keine Änderungen bestehender Anwendungen, keine Codeimplementierung, keine Datenbank-/Provideraufrufe, keine Paketinstallation, kein Deployment und keine umfassenden Bestands-Testläufe. Kein zentraler Dateidienst, neues S3system, CDN, Virenscanningdienst, universeller Dokumentkonverter oder KI-Bild-/Audioegress als Voraussetzung. Tsumugu ist keine Implementierungsquelle. Ein Produkt ohne Dateien braucht dieses Modul nicht.
### 1.1 Verbindliche Verträge und technische Defaults
| Verbindlicher Architekturvertrag | Begründet anpassbarer Default |
|---|---|
| Aktuelle Identität, Scope und Objekt-/Assetberechtigung; Fail-Closed | Capabilitynamen und konkrete Fachobjekttypen |
| Keine Session in Medien-URLs; Scopehinweise sind keine Autorität | Same-Origin-Fetch mit Blob-URLs; eng definierter nativer Videopfad bei Bedarf |
| Ungeprüfte Uploads niemals ausliefern; Typ-/Ressourcen-/Pfadgrenzen wirksam | Zuerst JPEG/PNG/WebP, konkrete Größen und Normalisierungsprofile |
| Keine behauptete Atomarität von DB und Dateisystem; dauerhafte Zustände und Recovery | Lokales versioniertes Dateiverzeichnis hinter einem Storageport |
| Rendern führt weder untrusted Code noch beliebige Datei-/Netzwerkzugriffe aus | Typisierter begrenzter Renderbaum, ReportLab für einen benötigten PDFadapter |
| Referenzen, Retention, Sperren und tatsächliches Löschen konsistent | Shinkan-nahe Lifecyclezustände und konfigurierbare Fristen |
| Harte Kapazitätsgrenzen atomar; keine Freigabe nur aufgrund logischer Löschung | Produktlokale Kapazitätsreservierung; keine neue Plattform |
| Verbindliche Release-Gates, Buildzuordnung und menschliche Produktionsfreigabe | R1 bevorzugt, kontrollierte getrennte Builds R2 weiter zulässig |
Ein anderer Dateityp oder Grenzwert benötigt einen geeigneten lokalen Adapter und dessen Negativtests. Eine zusätzliche Dateiendung allein ist keine sichere Erweiterung. Anpassungen verlangen keinen zusätzlichen familienweiten ADR oder Freigabezyklus.
## 2. Referenzen und gezielte Anpassungen
| Quelle I | Wiederverwenden | Grenze / Ergänzung V/K |
|---|---|---|
| Shinkan [Medienarchivnorm](C:/Dev/shinkan-jinkendo/.claude/docs/technical/MEDIA_ASSETS_AND_ARCHIVE_SPEC.md:1), [Uploadspec](C:/Dev/shinkan-jinkendo/.claude/docs/technical/MEDIA_UPLOAD_SPEC.md:1), [Assetrouter](C:/Dev/shinkan-jinkendo/backend/routers/media_assets.py:64) | Asset von Fachverknüpfung trennen; Wiederverwendung, Lifecycle und Speicheradapter | Produktnormen bleiben in Shinkan maßgeblich. Neue Familienadapter übernehmen keine automatischen globalen Privatdatenrechte und keine implizite Sichtbarkeitspromotion. |
| Shinkan [Pfadgrenze](C:/Dev/shinkan-jinkendo/backend/media_storage.py:125), [Downloadpfad](C:/Dev/shinkan-jinkendo/backend/routers/exercises.py:3214) | Registrierte Speicherwurzel, Asset-/Übungsbezug, GET/HEAD/Range | Keine Fallbackwurzel nach Konfigurationsfehler, kein späterer Dateiaufruf über beliebigen DBpfad. Geöffnete Datei und geprüfte Version binden; Asset- und Elternrechte als Schnittmenge prüfen. |
| Shinkan [Range-/Headerhelfer](C:/Dev/shinkan-jinkendo/backend/routers/exercises.py:3065) | Dateinamenbereinigung, Inline/Attachment, Single-Range | Unterstützte und ignorierte Rangefälle explizit festlegen; kein versehentliches erstes Segment einer Mehrfachrange. Gleiches Authverhalten für HEAD, 206 und Fehler. |
| Shinkan [Mediengrant](C:/Dev/shinkan-jinkendo/backend/media_grant.py:22), KI-SHK-10 | Kurzlebiger gesonderter Medienzugang statt voller Session in einer URL | Vorhandener Grant bindet Profil/Ablauf, nicht eine konkrete Assetrevision. DBpasswort-/Devsecretfallback und profilweiter Sessionalias werden nicht übernommen. Default braucht keinen URLtoken. |
| Shinkan [serverseitiger Richtext](C:/Dev/shinkan-jinkendo/backend/exercise_rich_text.py:31), [Browser-Sanitizer](C:/Dev/shinkan-jinkendo/frontend/src/utils/exerciseRichTextSanitize.js:68), KI-SHK-16 | Feste Tags/Attribute, geprüfte Medien-ID, Größe und Caption; server-/clientseitige Schutzschicht | Sanitizing ist keine Objektberechtigung. HTML-/Markdownparser und Renderadapter müssen dieselbe begrenzte Semantik erhalten; kein Regex als alleiniger XSSbeweis. |
| Shinkan [Lifecycle](C:/Dev/shinkan-jinkendo/backend/media_lifecycle.py:28), [Purge](C:/Dev/shinkan-jinkendo/backend/media_lifecycle.py:184), [Hold](C:/Dev/shinkan-jinkendo/backend/media_legal_hold.py:43), [Retentionjob](C:/Dev/shinkan-jinkendo/backend/scripts/media_retention_job.py:26), KI-SHK-19 | Verfügbarkeit, Löschschutz, Managementrechte und zeitgesteuerte Übergänge getrennt | Eigene Commits/Dateilöschung innerhalb eines Helfers nicht kopieren. Dauerhaften Purgeintent, tatsächlichen Löschreceipt und Racevertrag ergänzen. Ein geloggter Unlinkfehler ist kein erfolgreicher Purge. |
| Mitai [persönlicher Fotoabruf](C:/Dev/mitai-jinkendo/backend/routers/photos.py:132), [Pfadauflösung](C:/Dev/mitai-jinkendo/backend/routers/photos.py:30), KI-MIT-06 | Foto nur für zugehöriges Profil ausliefern | Sichere Einzelroute schützt nicht automatisch Liste/Upload/Löschen. Header-/Erstprofilfallback, absolute Altpfade und ungeprüfte Dateiendungen nicht als neuen Standard übernehmen. |
| Mitai [PDFbericht](C:/Dev/mitai-jinkendo/backend/report_pdf_render.py:64), KI-MIT-19 | Typisierte Berichtsblöcke, ReportLab und explizites Textescaping als lokale Renderreferenz | Kein freier HTML-/URLrenderer. Daten einmal autorisiert materialisieren; keine neuen DBconnections während des Renderns. Alle Text-/Fehlerpfade escapen, auch Teilpfade ohne bisheriges `escape`. |
| Kanshō [Medienstore](C:/Dev/Kansho/backend/media_store.py:146), [Metadatenbehandlung](C:/Dev/Kansho/backend/media_store.py:87), KI-KAN-22 | Private Journal-/Profileigentümerschaft, Größenlimits, lokale Medien und Metadatenminimierung | Signaturerkennung mit Declared-Type-Fallback ist keine vollständige Validierung. Gelesener Store entfernt nicht sämtliche möglichen Metadaten/Video-GPS; neuer Normalisierer muss sein Profil ausdrücklich nachweisen. |
| Kanshō [Medientokens](C:/Dev/Kansho/frontend/src/journal/document.js:8), [Editor-Mediennode](C:/Dev/Kansho/frontend/src/journal/KanshoMedia.jsx:54), KI-KAN-02 | Medien-ID statt Dateipfad im Dokument; Wortlaut, Caption und Platzierung erhalten | IDsyntax ist keine Lesefreigabe. Fremde oder nicht zugeordnete Medien nicht nachladen; kein externer Bild-URLfallback. |
Kanshōs [Agentenleitfaden](C:/Dev/Kansho/AGENTS.md), [Kontextindex](C:/Dev/Kansho/docs/architecture/functional/documentation_index.md:1) und [Guardrails](C:/Dev/Kansho/docs/architecture/functional/guardrails.md:1) bleiben Bezug für private Inhalte. Bilder können erkennbare Personen oder Orte enthalten; Metadatenentfernung macht sie nicht anonym. Externe KI erhält keine Datei oder beliebige Medien-URL über diesen Blueprint. Der bestehende Gatewaystandard unterstützt hier keinen automatischen Bild-/Audioegress.
Kairo wird mangels benötigter spezieller Dateireferenz nicht als führender Upload-/Renderingmechanismus herangezogen. Die Auswahl betrifft einzelne vorhandene Bausteine, keine Rangfolge der Produkte. Keine Cross-Repo-Runtimeimports; ein gemeinsames Paket erst bei zwei tatsächlichen Konsumenten und stabilem Vertrag.
## 3. Komponenten und Verantwortlichkeiten
```text
Fachrouter / Dokumenteditor
-> MediaService + aktuelle AccessPolicy + EntitlementPolicy
-> UploadIntent / Kapazitätsreservierung (kurze UoW)
-> QuarantineWriter -> TypeInspector / Normalizer (außerhalb UoW)
-> StoragePort.publish_once -> Receipt (außerhalb UoW)
-> Asset + Fachlink + Usage/Audit gemeinsam finalisieren
Autorisierter Dokumentinhalt -> begrenzter RenderDocument-Baum
-> React-/Richtextanzeige mit berechtigten Medienrefs
-> optional lokaler PDFadapter -> geprüftes erzeugtes Asset
Autorisierter Dateilesepfad -> ReadPlan / geöffnetes Handle / erneute Freigabe
-> begrenzter Stream; keine DBtransaktion über die Auslieferung
Retention / explizites Löschen -> Purgeintent -> tatsächliches Löschen
-> bestätigter Abschluss / Reconciliation / Recovery
```
| Komponente | Zuständigkeit |
|---|---|
| `MediaService` | Uploadaufnahme, Link-/Lifecycleoperationen, Readplan und klare UoWgrenzen |
| `MediaPolicy` | AccessPolicy für Parent und Asset, Verfügbarkeit/Scope, gültige Attachmentbezüge; keine Tarif-/Rollenlogik im Storage |
| `MediaTypeRegistry` | Unterstützte MIME-/Codec-/Normalisierungsprofile mit konkreter Revision, Größen-/Ressourcenlimits |
| `QuarantineWriter` | Begrenzt Bytes empfangen, Hash/Receipt bilden, ausschließlich interne temporäre Keys verwenden |
| `MediaNormalizer` | Typ prüfen, begrenzt dekodieren/normalisieren, gereinigte Ausgabe und technische Prüfergebnisse erstellen |
| `StoragePort` | Opaque Keys in registrierter Generation; immutable Publish, gebundenes Öffnen, nachvollziehbares Löschen |
| `MediaCapacityPort` | Tatsächlich benötigte physische Kapazität inklusive temporärer und Trashbytes reservieren/finalisieren |
| `DocumentAdapter` / `DocumentRenderer` | Begrenzte Text-/Mediensemantik aus bestehendem Format herstellen, sichere Anzeige/PDFausgabe |
| `MediaReconciler` | Unvollständige Upload-/Purgeoperationen anhand persistierter Zustände und echter Storagebelege klären |
Default: `app/modules/media/{models,types,policy,service,repository,storage,upload,normalize,lifecycle,api}.py` und `app/modules/documents/{models,adapters,render,pdf}.py`. Renderer nur anlegen, wenn das Produkt ihn benötigt. `bootstrap` verdrahtet Adapter; Lifespan verwaltet Ressourcen. API-/Modulimporte erstellen keine Verzeichnisse, Logdateien, DBschemas oder Netzverbindungen.
## 4. Datenmodell und Python-Verträge
### 4.1 Logische Datenstrukturen
| Struktur | Wesentliche Felder / Bindungen |
|---|---|
| `media_assets` | UUID, Owner/Scope, Fachsichtbarkeit nach Produktvertrag, immutable Dateirevision, Rowversion, geprüfter MIME, Größe, interner Bytehash, Typ-/Normalisierungsrevision, Storagebezug, Verfügbarkeits-/Lifecyclezustand, Hold-/Rightsstatus |
| `media_attachments` | Parenttyp/-ID/-Version, Asset-ID, erlaubter Kontext, Caption/Sortierung; scoped FKs bzw. gleichwertige Service-/Constraintbindung |
| `media_variants` | Optional geprüfte Thumbnail-/Vorschaurevision; eigene Größe/Hash/Storageobjekt und dieselben Schutz-/Purgegrenzen |
| `media_operations` | Upload-/Render-/Purge-ID, Subject/Scope/Parentbindung, Input-HMAC/Key-ID, erwartete Version, Zustandsrevision, Attempt/Fence, Storagegeneration/-key, Prüfreceipts, Capacityref, sichere Fehlercodes/Zeiten |
| `media_read_leases` | Kurzlebige Asset-/Dateirevision, Session-ID/-Generation, Scope/Parentbezug, Ablauf/Status; keine Cookiewerte |
| bestehendes Audit / Usage | Fachliche Lifecycle-/Link-/Verwaltungsereignisse und genau einmalige Verbrauchsbuchung; keine privaten Dateiinhalte |
`StorageRef` ist immutable und enthält Backend-ID, Generation und zufälligen Objektkey. Konfigurationsänderungen biegen alte Keys nicht auf eine neue Wurzel um. Dateiinhalte werden nie unter derselben Dateirevision überschrieben; Ersatz ist eine neue Revision mit neuem Key und geprüftem Pointerwechsel. Metadatenänderung besitzt eine gesonderte Rowversion. Ein starker Downloadvalidator kann eine opake zufällige Dateirevision sein; kein öffentliches SHA-Orakel persönlicher Dateien.
Dateiname ist bereinigte Anzeigemetadaten, weder Pfad noch MIMEautorität. Scope-/Parent-/Assetzuordnungen sind serverseitig gesetzt und bei jeder Mutation aktuell geprüft. Es gibt keine frei beschreibbaren Felder `storage_key`, `owner_id`, `is_clean`, `privacy_checked`, `absolute_path` oder `public_url` im Upload-DTO. Ein zulässiger Datums-/Captionwert bleibt fachliche Benutzereingabe, keine technische Berechtigung.
```python
from dataclasses import dataclass
from typing import BinaryIO, Literal, Protocol
from app.core.context import RequestContext, Tx
@dataclass(frozen=True, slots=True)
class StorageRef:
backend_id: str
generation: str
object_key: str
@dataclass(frozen=True, slots=True)
class VerifiedFile:
operation_id: str
attempt: int
profile_revision: str
mime_type: str
byte_size: int
sha256: str
staging_ref: StorageRef
@dataclass(frozen=True, slots=True)
class PublishReceipt:
operation_id: str
file_ref: StorageRef
byte_size: int
sha256: str
durability_profile: str
class StoragePort(Protocol):
def publish_once(self, source: VerifiedFile,
target: StorageRef) -> PublishReceipt: ...
def open_verified(self, receipt: PublishReceipt) -> BinaryIO: ...
def delete_verified(self, file_ref: StorageRef,
operation_id: str) -> Literal["deleted", "already_absent"]: ...
class MediaCapacityPort(Protocol):
def reserve_upper(self, tx: Tx, context: RequestContext,
operation_id: str, maximum_stored_bytes: int) -> str: ...
def finalize(self, tx: Tx, capacity_id: str,
retained_bytes: int) -> None: ...
def release_deleted(self, tx: Tx, capacity_id: str,
delete_operation_id: str) -> None: ...
```
Die Dataclasses sind interne Ergebnisse vertrauenswürdiger Adapter, keine clientdeserialisierten Beweise. `open_verified` prüft die zugehörige registrierte Generation, Größe/Integrität und die Unveränderlichkeit des tatsächlich geöffneten regulären Objekts; der Aufrufer erhält kein später neu aufzulösendes Dateinamensversprechen. Alle Handles werden bei Erfolg, Fehler und Disconnect geschlossen. Kein Storageadapter prüft selbstständig Nutzerrollen oder committtet die Fach-DB.
Der Kapazitätsport ist ein **lokaler Medienadapter** zu den Atomaritätsregeln des Quotenblueprints, kein Missbrauch von `UsageBudgetPort` mit fingierten KI-Call-IDs. Aktuelle physische Speicherbelegung, periodische Uploadereignisse und Attachment-/Assetbestand sind getrennte Metriken. Port und tatsächlicher Storage müssen bei Hardquotazusage gemeinsam qualifiziert werden; sie sind hier noch K.
Die Kapazitätsprojektion bindet einzelne interne Storageobjekte und ihre nachgewiesenen Größen. `finalize` hält bei U3 auch Roh-/Stagingdateien belegt, die noch tatsächlich existieren. Späteres `release_deleted` reduziert nur die durch die benannte abgeschlossene Deleteoperation nachgewiesenen Objekte, idempotent und ohne verbleibende Asset-/Variantenbytes freizugeben. Kein frei übergebener Kundenwert `removed_bytes` und kein pauschales Freigeben der ganzen Uploadreservation nach dem Löschen nur des Originals. Dasselbe gilt bei Bereinigung einer fehlgeschlagenen Aufnahme.
## 5. Uploadannahme vor Parser und Verarbeitung
### 5.1 Enger HTTPvertrag
Default ist ein zweistufiger Upload: JSONaufnahme erzeugt eine Uploadoperation; danach wird **genau eine rohe Datei** per `PUT /media/uploads/{id}/content` als begrenzter Bytestrom empfangen. Das vermeidet einen verpflichtenden Multipartparser vor der Autorisierung. JSONaufnahme besitzt strikte Metadaten und bekannten Parent, aber kein freies Owner-/Scopefeld. Cookie, CSRF, Origin und Scopeheader gelten auch für den Content-PUT.
Bereits ein vorgelagerter ASGI-/Proxyadapter prüft Route, aktuelle grundlegende Session-/Browsergrenze, maximale Requestgröße und erforderliche Header, bevor der Uploadbody verarbeitet/auf Platte gespult wird. `Content-Length` ist ein früher Plausibilitätscheck, keine Vertrauensquelle; tatsächliche gelesene Bytes werden zusätzlich gezählt. Chunked oder HTTP/2-Daten umgehen das Limit nicht. `Content-Encoding` ist im ersten Schnitt nur `identity`; automatische Dekompression ist ausgeschlossen. Endlossendungen, langsame Bodies und Disconnects erhalten harte Gesamt-/Idlebudgets.
Eine vorhandene Multipartproduktroute kann bleiben, wenn sie dieselben vorgeschalteten Grenzen, begrenzte Teilezahl/-größen, sicheren Spool und frühe Auth-/CSRFprüfung nachweist. `UploadFile` allein belegt das nicht. Kein Parser-/Frameworkupdate ist in diesem Dokument beauftragt.
### 5.2 Uploadaufnahme U0
Kurze Foundation-UoW: aktuellen Principal/Scope, Parenteditrecht, `media.upload`, Funktionsfreigabe und zulässigen Typkandidaten prüfen; Operation-ID/Idempotenz/HMAC samt erwarteter Parentversion binden; atomar technische Spoolkapazität und gegebenenfalls harte kommerzielle Kapazität reservieren; Audit schreiben. Erst nach Commit Aufnahme bestätigen. Parallelität und maximale offene Operationen werden unter dem gemeinsamen Subjektlock begrenzt.
Eine abgegebene Session oder später entzogene Mitgliedschaft erlaubt keinen Abschluss. Es werden keine Cookiewerte in einer Uploadoperation gespeichert. Session-ID/-Generation und Owner-/Scopebindung folgen dem Authvertrag; nach Ablauf bleibt die Operation unzugänglich bis zu einem ausdrücklich erlaubten Rebind des gleichen Subjects im gleichen Scope. Ein Rebind darf weder Parent noch Byteeingabe verändern und ist im ersten Schnitt nur vor endgültiger Aktivierung zulässig.
Für Metadatenaufnahme gilt Idempotenz je Subject/Scope/Operationkey. Derselbe Key mit anderer Eingabe liefert 409. Wiederholtes Senden einer noch unklar laufenden Contentübertragung überschreibt keine Dateien: ein aktueller CAS/Fence beansprucht genau einen Attempt; gleichzeitiger zweiter Upload liefert `upload_in_progress`. Abgebrochene unbestätigte Attempts werden zuerst anhand ihres Receipts/temporären Keys geklärt oder verworfen, erst danach darf ein neuer begrenzter Attempt starten.
## 6. Quarantäne, Typprüfung und Metadaten
U1 läuft **ohne offene DBtransaktion**. Der Quarantänewriter schreibt nur in ein internes zufälliges Attemptverzeichnis, nie unter Originaldateiname oder beliebigen Clientpfad. Quarantäne und vorbereitete Objekte sind für alle normalen Downloadrouten unsichtbar. Rohdaten werden nach vollständigem Empfang gehasht; Content-Typ, Bytes und technische Grenzen werden vor Aktivierung geprüft.
### 6.1 Registrierte Profile
| Profil | Pragmatische Ausführung / erster Stand |
|---|---|
| `raster_image.v1` | JPEG, PNG, WebP; Signatur und begrenztes vollständiges Dekodieren, Dimensionen/Framezahl prüfen; Orientierung lokal anwenden; frisches Bild mit festem Farbprofil ohne fremde Metadaten neu encodieren |
| `video_local.v1` | Bei tatsächlichem Produktbedarf MP4 mit explizit qualifiziertem Container-/Codecprofil; begrenztes lokales Prüfen und erforderliches Remux/Transcode ohne Netz, Entfernung unzulässiger Metadaten und Zusatzstreams nach Profil |
| `pdf_attachment.v1` | Nur bei qualifiziertem begrenztem Parser/Prüfprofil; keine Inlineausführung im Apporigin, keine Vorschau ohne eigenen sicheren Renderadapter |
| `generated_pdf.v1` | Ausgabe eines registrierten lokalen Renderadapters; dessen Output ebenfalls auf Größe/Format prüfen und durch denselben Publish-/Lesepfad führen |
Der erste Foundation-Fachschnitt implementiert `raster_image.v1`. Video/PDF sind wegen konkreter Shinkanverwendung spezifizierte Erweiterungsgrenzen, bleiben aber geschlossen, bis ihre tatsächlich benötigten lokalen Validatoren verfügbar und getestet sind. Ein bereits vorhandenes Produkt wird dadurch nicht nachträglich umkonfiguriert. GIF-/APNG-/animierte WebPdateien, SVG, HTML, XML, Office-/ZIParchive, Audio und beliebige Binärformate sind im neuen ersten Profil nicht zugelassen. Eine Animation wird nicht stillschweigend auf ein Bild reduziert.
Deklarierte MIME/Endung und tatsächlicher Typ müssen zum registrierten Profil passen; bekannte harmlose Aliasformen werden explizit kanonisiert. Bei widersprüchlicher oder unklarer Erkennung verweigern, kein `declared in allowlist` als Ersatz. Magic Bytes allein reichen nicht. Nach Bildprüfung nur die neu encodierte Darstellung speichern/ausliefern; angehängte uninterpretierte Bytes nicht mitkopieren.
Pillow dokumentiert einen Schutz über die Pixelzahl und eine `DecompressionBombWarning`; der qualifizierte Adapter behandelt Überschreitungen als Fehler und verwendet zusätzlich eigene harte Dekodier-/Ressourcenlimits. Den Schutz nicht deaktivieren. [Pillow Image-Dokumentation](https://pillow.readthedocs.io/en/stable/reference/Image.html)
### 6.2 Isolierte lokale Verarbeitung
Decoder und nötige Renderer laufen als begrenzter lokaler Kindprozess aus demselben qualifizierten Backendimage: feste Argumentliste, `shell=False`, keine frei übergebenen Tools/Filter/Skripte, keine Netzwerkfähigkeit, keine DB-/Providercredentials, keine Docker-/Hoststeuerung. Nur der eigene Input-/Outputspool ist zugänglich; Rootdateisystem und feste Fonts sind read-only. Prozess-/Speicher-/CPU-/Dateigrößenlimits und harte Abbruchfrist werden tatsächlich auf Betriebssystemebene bzw. durch den überwachten Prozessadapter erzwungen. Ein Pythonthread-Timeout allein stoppt einen hängenden nativen Decoder nicht.
Ein späterer FFmpeg-/PDFadapter erhält nur geöffnete lokale Eingaben und feste erlaubte Parameter; keine M3U-/HLS-/Netz-/`file://`-Protokollauflösung oder externe Ressourcen. Fehlen wirksame Sandbox-/Ressourcenadapter, wird das betreffende Profil nicht geöffnet. Dafür ist kein neuer zentraler Scan-/Renderingdienst erforderlich. Antivirus kann ein zusätzliches vorhandenes Profil sein; weder dessen Fehlen noch eine Signaturprüfung wird als Beweis vollständiger Malwarefreiheit dargestellt.
### 6.3 Metadaten und fachlicher Wortlaut
Normalisierte Bilder übernehmen keine EXIF-/XMP-/Kommentar-/Textchunks oder beliebigen eingebetteten Profile. Farbumwandlung und Orientierung werden vor dem Entfernen kontrolliert angewendet. Die konkreten Ausgabebytes werden erneut auf den vereinbarten Metadatenumfang geprüft. Originale werden im Default nach erfolgreicher Aktivierung nicht als dauerhafter paralleler Download behalten.
Ein fachlich benötigtes Aufnahmedatum, etwa in Mitai, kann der lokale Adapter vor Normalisierung als begrenzten **unbestätigten Kandidaten mit Herkunft** auslesen und nach dem Produktvertrag übernehmen. Keine GPS-/Geräte-/Seriennummern speichern, wenn sie nicht ausdrücklich erforderlich sind; kein erratenes Zeitzonen-/Wahrheitsversprechen. Nicht Metadaten still entfernen und gleichzeitig behaupten, alle fachlichen Informationen des Originals seien unverändert erhalten.
Die Bildinhalte selbst können persönliche Informationen tragen. Keine Gesichtserkennung, automatische Persönlichkeitsableitung, OCR oder Übertragung an externe Modelle als Teil des Uploads. Kanshōs Privacy Gateway wird nicht durch einen Dateilink umgangen. Originalwortlaut und Captions von Nutzer-/Journaltexten werden durch Sicherheitsvalidierung nicht inhaltlich umformuliert.
## 7. Storagevertrag und Veröffentlichung ohne falsche Atomarität
### 7.1 Registrierte Wurzel und immutable Objekte
Der erste Storageadapter nutzt das bestehende lokale/NAS-Dateiverzeichnis hinter `StoragePort`. Jede Generation besitzt eine explizite Basiswurzel, einen geprüften Identitätsmarker und das erwartete Mount-/Durabilityprofil. Fehlender Mount darf nicht unbemerkt in ein gleichnamiges lokales Verzeichnis schreiben. Keine automatische Fallbackwurzel bei Konfigurationsfehlern; Startup/Readiness bleibt geschlossen.
Keys sind zufällige opaque interne Bezeichner mit einer strikten Segmentgrammatik. Absolute Pfade, `..`, Backslashes als alternative Traversal, Windows-Laufwerke/UNC/Alternate Data Streams, NUL-/Steuerzeichen, URLschemas und überlange Segmente sind unzulässig. Auch DBwerte sind Eingabe an diese Grenze. Elternverzeichnisse dürfen keine durch Benutzer veränderbaren Symlinks/Reparsepunkte enthalten. Der Adapter öffnet/veröffentlicht relativ zur registrierten Wurzel mit einem qualifizierten Schutz gegen Linkwechsel und prüft reguläre Dateien. `resolve()` plus späteres ungebundenes `open(path)` ist kein vollständiger Schutz gegen Austauschrennen.
Physische Dateinamen enthalten im Default weder Profilnamen, Vereinsnamen noch einen öffentlichen Inhaltshash. Sichtbarkeitsänderung benennt die Bytes nicht um. Speicherbackend/-generation wird am Asset gebunden; ein aktiver Konfigurationspointer gilt für neue Objekte, nicht als stiller Umzug vorhandener Daten. Ein späterer Umzug besitzt eigenes Receipt und erwartete Generation, keine HTTPaktion „MEDIA_ROOT umstellen und alte Keys neu interpretieren“.
### 7.2 U2, Dateieffekt und U3
| Phase | Dauerhafter Nachweis | Fehler-/Recoveryverhalten |
|---|---|---|
| U0 `accepted` | Autorisierte Uploadoperation + reservierte Kapazität committed | Ohne Commit kein gültiger Contentauftrag |
| U1 `receiving/verified` | Aktueller Attempt/Fence, begrenzter Quarantänekey, vollständiger Prüfreceipt | Teilfile bleibt unsichtbar; neuer Attempt erst nach Klärung |
| U2 `publishing` | Erwartete geprüfte Größe/Hash/Typ, Zielkey/-generation und Operationsrevision committed | Kein normaler Auslieferungspfad; Reconciler kennt genaue mögliche Dateiwirkung |
| F `publish_once` | Tatsächliche immutable Datei plus PublishReceipt | Keine DBtransaktion offen; bei unklarer Dateiwirkung Receipt/Datei prüfen, nicht neuen Pfad erfinden |
| U3 `ready` | Aktuelle Rechte/Parentversion, Asset + Link + Kapazitätsfinalisierung + nötiger Uploadverbrauch + Audit gemeinsam committed | Erst danach 201 bzw. aktivierbarer Content; kein Teil-Facherfolg |
| `rejected/aborted/expired` | Sicherer Grund, keine aktive Asset-/Linkfreigabe | Temporäre und unverknüpfte Dateien nachvollziehbar bereinigen; Kapazität erst nach wirklicher Löschung freigeben |
`publish_once` veröffentlicht ohne Überschreiben auf einen ausschließlich diesem Vorgang zugeordneten Key. Bei lokaler Same-Filesystem-Variante darf eine qualifizierte atomare Veröffentlichung mit Datei-/Verzeichnis-Durability genutzt werden; Quarantäne und Ziel müssen dafür dieselbe geeignete Generation verwenden. Ein filesystemübergreifendes Rename oder allgemeines NASversprechen wird nicht als atomar/dauerhaft ausgegeben. Der Adapter weist sein tatsächliches Durabilityprofil nach; unerfüllte zugesicherte Haltbarkeit verhindert `ready`.
Existiert der Zielkey schon, prüft ein Wiederanlauf Operationsbindung, vollständige Größe/Hash und Receipt. Nur derselbe verifizierte Inhalt ergibt idempotenten Erfolg. Andere Bytes sind `storage_conflict`; kein Überschreiben. Ein Crash nach F und vor U3 hinterlässt ein nicht auslieferbares Objekt mit bekanntem Intent. Vor U3 werden Session-/Scope-/Objekt-/Hold-/Quotenrechte erneut geprüft; bei Entzug keine Aktivierung, sondern begrenzte Bereinigung. Ist der Parent inzwischen geändert, kein stilles Einhängen an dessen neue Version.
Für Renderjobs gilt derselbe Publishvertrag. Externes Storage ist ein späterer Adapter mit eigenen Konsistenz-/Delete-/Receiptgarantien, kein Pflichtbestandteil. Die DB beschreibt den letzten **nachgewiesenen** Zustand; ein erfolgreicher DBcommit beweist nicht automatisch vorhandene/dauerhafte Bytes.
## 8. Kapazität, Deduplizierung und Verknüpfungen
Technische Spool-/Diskgrenzen gelten unabhängig von bezahlten Plänen. U0 reserviert eine belastbare obere **gleichzeitige** Belegung aus Rohdatei, normalisiertem Ergebnis, Varianten und gegebenenfalls Publishkopie. Passt ein tatsächlicher Zwischenschritt nicht in diese Grenze, abbrechen; keine spontane ungebundene Erweiterung. Aktuelle/Trash-/gesperrte Originale und Varianten zählen physisch weiter, bis sie nachweislich gelöscht sind. Nicht auffindbare oder unklar vorhandene Bytes geben keine zusätzliche freie Kapazität.
Ein periodisches Feature „Uploads“ bucht genau nach seiner registrierten Einheit, im Default einmal bei erfolgreicher U3aktivierung. Datei-/Assetbestand, belegte Bytes und Parentattachments sind getrennt. Wiederverwendung eines bestehenden Assets ist kein neuer physischer Upload, kann aber die Attachmentgrenze des Parents beanspruchen. Alle beteiligten Quoten-/Usage-/Fachwrites verwenden denselben U3-Tx; tatsächliche Dateiwirkung bleibt außerhalb und wird durch die Operation gebunden. Nach auditpflichtigem Commitfehler kein Usererfolg und kein unberechtigter Quotenrefund.
Default ist explizite **logische Assetwiederverwendung**, keine globale physische Hashdeduplizierung. Der Benutzer verknüpft nur ein bereits sichtbares, aktives, geeignetes Asset. Identischer Inhalt eines anderen persönlichen Raums wird nicht über Treffer/Timing/IDs offenbart. Bei später wirklich benötigter Bytededuplizierung nur innerhalb derselben Schutz-/Hold-/Retentiondomäne und mit separatem Blob-/Referenzvertrag; kein globales „Hash bekannt, fremdes Asset verknüpfen“.
`attach` prüft in einer UoW Parenteditrecht, Assetleserecht, Scopekompatibilität, active-Status, Rights-/Holdvertrag, erwartete Parent-/Assetversion und Attachmentkapazität. Assetmetadaten ändern verlangt zusätzlich das eigene Assetrecht. `detach` entfernt nur den Parentlink; das Asset kann anderen berechtigten Verknüpfungen weiter dienen. Ordner-/Besitznamen auf der Platte ersetzen diese Prüfungen nicht.
Eine Parentfreigabe veröffentlicht private Medien nicht automatisch. Der erste sichere Default ist: kompatible Assetfreigabe vorher ausdrücklich herstellen oder die Parentpromotion mit `media_visibility_conflict` verweigern. Ein Shinkanproduktadapter kann seinen vorhandenen expliziten Promotionsablauf erhalten, muss aber alle betroffenen Assetrechte, aktuelle Rightsdeclarations und Versionen gemeinsam prüfen. Betreiber-/Superadminrechte verleihen im Familienvertrag kein pauschales Leserecht auf persönliche Kanshō-/Mitai-Dateien.
## 9. Lesen, Download und native Medien
### 9.1 Autorisierter Readplan
Der aktuelle Accessvertrag ist **Parent lesbar AND Asset lesbar AND Link gültig AND konkrete Revision verfügbar**. Ein direkter Assetabruf ohne Parent ist nur im dafür registrierten Archiv-/Ownermodus zulässig und prüft dieselben Assetgrenzen; er ist kein Ausweg aus einer verborgenen Parentreferenz. Listen, Counts, Thumbnail, Original, Varianten, HEAD und Range verwenden denselben Filter. Unsichtbare Medien 404; keine Größe, ETag, Filename oder Holdinformation vor Autorisierung.
R1: kurze UoW löst berechtigten Scope, Parent/Asset/Dateirevision, aktuelle Sessiongeneration und Lifecycle auf. Außerhalb der UoW wird ein gebundenes reguläres Handle auf exakt dieses immutable Storageobjekt geöffnet. R2: kurze UoW prüft die aktuelle Freigabe/Version erneut und erfasst eine begrenzte Readlease. Bei Konflikt Handle schließen und keine Bytes ausgeben. Ein Purgeintent zwischen R1 und R2 verhindert R2. Der Stream hält anschließend keine DBtransaktion/Connection offen.
Konkreter interner Planvertrag V/K; der Storagebezug wird ausschließlich vom autorisierten R1-Adapter erzeugt:
```python
from dataclasses import dataclass
from typing import Protocol
from app.core.context import RequestContext, ResourceRef, Tx
from app.modules.media.models import PublishReceipt
@dataclass(frozen=True, slots=True)
class MediaReadPlan:
subject_id: str
credential_id: str
credential_generation: int
scope_kind: str
scope_id: str
asset_id: str
file_revision: str
attachment_id: str | None
parent: ResourceRef | None
parent_version: int | None
receipt: PublishReceipt
class MediaReadPolicy(Protocol):
def plan(self, tx: Tx, context: RequestContext, *,
asset_id: str, attachment_id: str | None) -> MediaReadPlan: ...
def require_current(self, tx: Tx, context: RequestContext,
plan: MediaReadPlan) -> None: ...
```
Ein fehlender Parent ist ausschließlich im ausdrücklich autorisierten Archiv-/Ownermodus gültig. `require_current` vergleicht Plan, Sessionbindung, Scope, Asset-/Attachment-/Parentstand und Verfügbarkeit; nicht nur die Dateirevision. Die Readlease wird vom Readerkoordinator nach dieser Prüfung in derselben R2-UoW angelegt bzw. erneuert. Ein `MediaReadPlan` ist keine langlebige externe Downloadpermit und kein aus dem Client zu akzeptierendes Objekt.
Längere Streams prüfen die Session-/Scope-/Asset-/Linkfreigabe und Readlease mindestens nach dem festgelegten Zeitbudget erneut, mit kurzen separaten Transaktionen. Defaultrhythmus eine Sekunde, Chunk maximal 64 KiB; bei abgelaufener Lease oder Prüffehler keine weiteren Appchunks senden. Nach bereits gesendeten Headern wird der Stream beendet, kein JSONfehler in Binärdaten gemischt. Bereits an Browser/Netz übergebene Bytes sind nicht rückholbar; Widerruf wird spätestens an der nächsten lokalen Prüfung wirksam. Keine unmögliche rückwirkende Lösch-/Widerrufsgarantie.
Readleases sind Schutz gegen konkurrierenden Purge, kein Ersatz für Nutzerrechte. Sie besitzen feste Ablauf-/Gesamtgrenzen, werden aktuell erneuert und bei EOF/Abbruch geschlossen. Nach Prozessabbruch dürfen abgelaufene Leases verschwinden; ein noch lebender alter Stream darf danach nicht ohne Prüfung fortfahren. Asset- und Purgeservice serialisieren das Erzeugen/Beenden von Readleases am Assetdatensatz.
### 9.2 Fetch/Blob und eng begrenzter nativer Pfad
Für kleine persönliche Medien bleibt der Phase-3.3-Default: zentraler Fetchclient sendet Same-Origin-Cookie **und verifizierte Scopeheader**, prüft Response/MIME/Größe und erzeugt Blob-URLs. Bei Scopewechsel, Logout, Componentunmount und Fehler werden alte Fetches abgebrochen, URLs widerrufen und Viewer geleert. Es gibt keinen öffentlichen statischen `/media`-Mount als Umgehung.
Für benötigtes natives Video mit Range kann ein **einziger registrierter GET/HEAD-Adapter** Scopehinweise `scope_kind/scope_id` und die Dateirevision in der URL akzeptieren. Er verlangt dieselbe aktuelle volle Sessioncookie, verifiziert den ausgewählten Scope und das Zielobjekt serverseitig; der URLhint selbst erteilt keine Rechte. Diese eng definierte Lesroute verwendet überprüfte Same-Origin-Fetch-Metadaten (`Sec-Fetch-Site` und passendes `Sec-Fetch-Dest`) und, soweit vorhanden, exakt geprüften Origin/Referer statt des bei nativen Elementen fehlenden Customheaders. Fehlende/inkompatible Browsermetadaten ergeben geschlossenen nativen Pfad und den Fetchfallback, keinen generellen Auth-/Scopebypass.
Mutationen bleiben unverändert CSRF-/Origin-/Customheadergeschützt. Ein nativer Scopehint wird nicht als allgemeine Queryvariante aller Fachrouten eingeführt. Native Player setzen bei Scopeepochwechsel `src` zurück, beenden Laden/Wiedergabe und übernehmen keine verspätete alte Quelle. Jede neue Rangeanfrage prüft aktuell erneut; persönliche Medien erhalten keine freigebenden CORSantworten an fremde Origins.
Ein separater Cross-Origin-/Drittplayer-Grant wird im ersten Schnitt **nicht implementiert**. Bei echtem späterem Bedarf muss er Asset **und Dateirevision**, Subject, Scope/Parent, Session-ID/-Generation, GET/HEADzweck, kurze Gültigkeit und Widerruf binden; keine DBpasswort-/Defaultschlüsselableitung. Native Rangezugriffe benötigen mehrere Reads und dürfen nicht versehentlich durch einen angeblich einmaligen Downloadgrant gebrochen werden. Die bestehende Shinkan-Grantidee ist Referenz, ihre profilweite Form kein ausreichender Ersatz. Keine volle Session oder gleichwertiger Sessionalias im Querystring.
### 9.3 HTTPbinärvertrag
Alle geschützten Binärantworten und Fehler: `Cache-Control: no-store`, `X-Content-Type-Options: nosniff`, `Referrer-Policy: no-referrer`, konkreter geprüfter MIMEtyp. Bilder und qualifiziertes Video dürfen inline; PDF und sonstige künftig ausdrücklich erlaubte Dokumente im Default `Content-Disposition: attachment`. Dateiname ist längenbegrenzt, ohne Pfad-/Steuerzeichen/CRLF; Headerencoding wird durch einen geprüften Adapter erzeugt. Kein Nutzerdateiname als roher Headerstring.
Für Dokument-/Attachmentantworten ergänzt der Adapter eine restriktive `Content-Security-Policy` ohne Skript-/Netzressourcen und mit Sandbox, soweit der Browser sie verwendet. Das ist eine zusätzliche Auslieferungsgrenze, keine Garantie gegen aktive Inhalte beim späteren Öffnen einer heruntergeladenen Datei in einem anderen Programm.
Für Single-Range gelten die HTTPregeln: HEAD ignoriert Range und sendet keinen Body; GET mit erfüllbarer `bytes=start-end`, offener Endrange oder Suffixrange liefert 206 mit korrekter Länge/Content-Range; eine syntaktisch gültige, nicht erfüllbare Einzelrange liefert nach Autorisierung 416 und `bytes */N`. Unbekannte Rangeeinheit wird ignoriert. Mehrfachranges und syntaktisch defekte Angaben werden im ersten Adapter vollständig ignoriert und als normale 200antwort behandelt; kein stilles Abschneiden auf das erste Segment. `If-Range` mit nicht passendem starken Validator führt zum vollständigen 200inhalt. [RFC 9110, Range](https://www.rfc-editor.org/rfc/rfc9110.html#section-14), [If-Range](https://www.rfc-editor.org/rfc/rfc9110.html#section-13.1.5)
Die Anwendung begrenzt Headerlänge/Ziffernzahl vor Integerkonvertierung. Native Voll- und Rangeantworten bleiben unter Datei-/Deadline-/Parallelitätsgrenzen; Range ist kein grenzenloser Speicher-/CPUverstärker. Kein dynamisches HTTPkomprimieren des Bytestroms, das Offsets/Validatoren ändern würde. Eine 304-/ETagprüfung erfolgt ebenfalls erst nach Autorisierung; no-store bleibt bestehen. ETag ist an unveränderliche ausgelieferte Bytes gebunden, kein privater Contenthash in Logs.
## 10. Rich Text, Markdown und Dokumentreferenzen
### 10.1 Ein begrenzter interner Rendervertrag
Das Produkt behält sein fachliches Speicherformat, z. B. Kanshō-Markdown oder Shinkan-Rich-HTML. Dieser Blueprint verlangt keine Bestandsformatmigration. Ein expliziter `DocumentAdapter` wandelt den gespeicherten Text/Editorinhalt mit Format-/Policyrevision in einen begrenzten internen `RenderDocument`-Baum. Für eine neue Anwendung kann typisiertes Editor-JSON ein Default sein; es ist kein Pflichtformat aller Produkte.
Erlaubter erster Baum: Absätze, begrenzte Überschriften, Text mit fett/kursiv/Code, Listen, Zeilenwechsel, sichere explizite Links und `media_ref`. Kein beliebiges HTML, Skript, CSS, Objektattribute, iframe, SVG/MathML, Templatecode oder durch Daten definierte Reactkomponente. Unbekannte Formate/Nodes werden beim Schreiben mit sicherer Diagnose verweigert, nicht stillschweigend als erfolgreicher leerer Text gespeichert. Ein Readadapter für ausdrücklich markierten Legacyinhalt darf diesen sicher als Literaltext anzeigen und den Formatzustand kenntlich machen.
```json
{
"schema_revision": "render_document.v1",
"nodes": [
{"type": "paragraph", "children": [{"type": "text", "text": "Notiz zum Training."}]},
{"type": "media_ref", "attachment_id": "11111111-1111-4111-8111-111111111111", "size": "medium", "caption": "Bewegungsfolge"}
]
}
```
`attachment_id` ist eine opaque Fachverknüpfung des aktuellen Parents, nicht ein frei gewählter Dateipfad. Ein Kanshōadapter kann seine vorhandene Asset-ID verwenden, wenn er deren Entryzugehörigkeit aktuell prüft; ein Shinkanadapter übersetzt `exercise_media.id`. IDs werden über Adapter kanonisiert, nicht durch Abschneiden von Zeichen. Captions sind begrenzter Text und werden niemals als HTML oder URL ausgewertet.
Beim Speichern werden **alle** Medienreferenzen aus dem tatsächlich geparsten Dokument erfasst. Parenteditrecht und gültiger Link-/Asset-/Scopebezug werden in derselben UoW geprüft wie der Dokumentwrite; erwartete Version verhindert eine verlorene Aktualisierung. Beim Lesen/Rendern werden Referenzen erneut auf Verfügbarkeit und aktuelle Rechte gefiltert. Ein früher erlaubter Link gibt keine dauerhafte Lesebefugnis. Erlaubte fehlende Medien erhalten einen neutralen Platzhalter ohne Fremdmetadaten; ein ungültiger neuer Fremdverweis wird nicht gespeichert.
### 10.2 Rendering und Sanitizer
Bevorzugte Reactausgabe erzeugt Text/Elemente direkt aus dem validierten Baum; Text wird über normales Reactescaping eingefügt. Bestehende Rich-HTML-Adapter behalten eine feste serverseitige Allowlist und unmittelbar vor dem einzigen HTMLsink die Shinkan-nahe DOMPurifykonfiguration. Auch dort nur registrierte Tags/Attribute und überprüfte ID-/Caption-/Größenfelder; kein `dangerouslySetInnerHTML` mit Rohtext.
Nach Sanitizing kein untrusted Markup durch Stringverkettung, Editorplugins oder nachgeschaltete Bibliotheken wieder einfügen. Die DOMPurifydokumentation weist ausdrücklich auf diese Grenze hin. Vertrauenswürdige Medienkomponenten erhalten nur autorisierte IDs/Blobs und validierte Props; sie bauen kein HTML aus Captions. [DOMPurify-Dokumentation](https://github.com/cure53/DOMPurify)
Server-/Browseradapter teilen eine begrenzte semantische Testsuite einschließlich fehlerhaft verschachtelter und mutationsanfälliger HTMLfälle. Eine Bibliotheksbezeichnung allein belegt keine sichere Konfiguration. Keine deaktivierten Sanitizer bei Admininhalten und kein `raw_html=true` für Modellausgaben. Bibliotheks-/Decoderstände werden bei der späteren Implementierung gemeinsam gelockt und qualifiziert; hier keine neuen Versionslinien oder Paketupdates.
Normale Links akzeptieren im Default nur geprüfte absolute HTTP(S)-Ziele ohne Credentials/Steuerzeichen; `javascript:`, `data:`, `file:`, `blob:` aus gespeicherten Daten und protokollrelative Umwege sind geschlossen. `blob:` erzeugt ausschließlich der eigene autorisierte Browseradapter. Externe Textlinks werden erst auf Nutzeraktion geöffnet, mit `noopener/noreferrer`; kein Prefetch oder automatische Linkvorschau. Modell-/Journaltext darf keine Remoteimages nachladen.
## 11. Lokales PDF-/Dokumentrendering
Wenn das Produkt ein PDF benötigt, wird zuerst Mitais strukturierter ReportLabansatz adaptiert: nur registrierte Berichtsblöcke, explizite Typen, begrenzte lokale Diagramme und korrekt escaped Text. Es entsteht kein Universal-HTML-zu-PDFdienst. Aktuelle Fachwerte und erlaubte Bildrefs werden vor dem Rendern in einer kurzen autorisierten Materialisierungs-UoW mit Quellen-/Objektversionen gebunden; der eigentliche Renderer besitzt keine DBverbindung.
```python
from dataclasses import dataclass, field
from typing import Protocol
from app.modules.media.models import PublishReceipt, VerifiedFile
@dataclass(frozen=True, slots=True)
class RenderSnapshot:
operation_id: str
scope_binding: str
document_revision: str
source_bindings: tuple[tuple[str, str], ...]
canonical_document_json: str = field(repr=False)
image_receipts: tuple[PublishReceipt, ...] = field(repr=False)
class DocumentRenderer(Protocol):
def render_pdf(self, snapshot: RenderSnapshot) -> VerifiedFile: ...
```
`PublishReceipt` und `VerifiedFile` stammen aus Abschnitt 4; keine unabhängigen Typduplikate. Der tatsächliche Renderer erhält nur vorbereitete geprüfte Bildbytes/Handles aus diesen Receipts, keinen freien Pfadresolver. `canonical_document_json` ist intern typgeprüft und größenbegrenzt, nicht das freie APIbody. ReportLab-`Paragraph` erhält nur korrekt escaped Nutztext oder vom Adapter fest erzeugte Tags; kein usergesteuertes `
`, Linkmarkup oder Attributfragment. Diagrammfehlermeldungen werden ebenso behandelt wie der normale Textpfad.
Feste Fonts, lokale bereits geprüfte Bilder und explizit begrenzte Charts sind erlaubt. Keine Remote-URL, CSSimporte, Dateisystemsuche, Templateausdrücke, externe Webfonts oder URLfetcher. Links bleiben im ersten PDFadapter gedruckter Text; interaktive externe Aktionen sind kein notwendiger Standard. Rendering läuft mit denselben isolierten Ressourcen-/Zeitgrenzen wie Decoder. Mehrseiten-, Tabellen-, Text-/Bildanzahl- und Gesamtgrößenlimits schützen vor übergroßen Layouts.
Nach der Erstellung Ausgabegröße/Format prüfen, optionaler PDFprüfadapter gemäß Profil. Danach aktuelles Konto/Scope, Quellen-/Dokument-/Assetversion und Ausgabe-/Speicherrecht erneut in U3 prüfen. Ein inzwischen widerrufener Snapshot darf nicht als Datei aktiv werden; ein geändertes Dokument wird nicht still unter alter Beschreibung ausgegeben. Keine Netz-/Dateirenderphase in einer offenen Fach-UoW.
Ein erzeugtes PDF ist ein eigenes geschütztes Asset mit technischen SourceBindings und eigener Retention, kein Livefenster auf spätere Quelländerungen. Zugriff auf ein bereits erzeugtes Dokument richtet sich nach dem konkreten Produktvertrag und aktuellen Leserechten; aus seiner Existenz folgt keine Freigabe fremder Quellen. Diese technische Bindung entscheidet ADR-16 nicht. KIerzeugter Text durchläuft vor einer Übernahme weiterhin den bestehenden Gateway-/Fachvertrag; der PDFrenderer ist kein zusätzlicher Modellaufruf.
## 12. Lifecycle, Löschschutz und physischer Purge
### 12.1 Logische Zustände
| Zustand | Neue Links | Normale vorhandene Anzeige | Bedeutung |
|---|---|---|---|
| `processing` | nein | nein | Upload-/Renderoperation nicht aktiviert |
| `active` | ja, nach allen Rechten | ja, nach allen Rechten | Geprüfte verfügbare Dateirevision |
| `trash_soft` | nein | Produktadapter kann bestehende Links mit Hinweis anzeigen | Shinkan-nahe Auslaufstufe, keine behauptete bereits erfolgte Löschung |
| `trash_hidden` | nein | nein | Versteckt; Wiederherstellung nur ausdrücklich berechtigt |
| `purging` | nein | nein | Verbindlicher Löschintent, irreversibler Dateischritt kann begonnen haben |
| `purged` | nein | nein | Tatsächliche Entfernung bestätigt; minimaler Tombstone |
Availability-/Rightsblock und Hold sind zusätzliche orthogonale Schutzfelder. Ein Hold kann im Shinkanadapter normale Nutzung blockieren und physisches Löschen verhindern. Er verleiht niemandem Zugriff auf den Inhalt. Der hier verwendete technische Löschschutz setzt bestehende Produktentscheidungen um; das Dokument gibt keine neue rechtliche Bewertung oder Fristpflicht vor.
Default für ein benötigtes Shinkan-artiges Archiv sind dessen konfigurierbare 30 Tage soft bis hidden und 90 Tage hidden bis fälligem Purge. Persönliches „verbergen/löschen“ kann nach bestehendem Produktvertrag direkt `trash_hidden` setzen; es darf nicht mit einer weiterhin sichtbaren Datei als vollständig gelöscht beantwortet werden. Wiederherstellung prüft gegen aktuellen Hold-/Rights-/Scope-/Kapazitätsstand, nie pauschal wegen einer Adminrolle. Kein automatisches Wiederaktivieren nach Ende einer Sperre.
### 12.2 Dauerhafter Purgevertrag
1. **P0 vorbereiten:** kurze UoW mit aktueller Management-/Retentionbefugnis, Frist, erwarteter Assetversion, vollständiger Referenzprüfung, Holdstatus und Readleases. Default nur ohne aktive/verbleibende Fachreferenz physisch löschen; bloßes Abnehmen eines einzelnen Links reicht nicht. Ein späterer ausdrücklich beauftragter Löschfall mit mehreren Referenzen muss diese zuvor konsistent entkoppeln/tombstonen, keine stillen Kaskaden im Dateiadapter.
2. **P1 Intent committen:** Assetzeile sperren, Hold/Refs/Readleases erneut prüfen, `purging` und irreversible Operationsbindung samt Storagegeneration/-objekten/Varianten/Audit setzen. Neue Links, Wiederaktivierung und Readleases ab jetzt geschlossen.
3. **P2 physischer Schritt:** außerhalb der UoW ausschließlich die gebundenen Objekte über `delete_verified` entfernen. `already_absent` ist nur bei richtig verifizierter Wurzel/Generation und genauem Key ein Beleg; fehlendes NAS oder falsche Wurzel ist kein Erfolg. Teilerfolg, Timeout oder Zugriffsfehler bleibt `purging` mit sicherem Grund.
4. **P3 bestätigen:** kurze UoW verifiziert dieselbe Operation/Assetversion und alle Deletebelege, schreibt `purged`, beendet Retention-/Referenztombstones nach Vertrag, gibt tatsächlich entfernte Kapazität frei und auditiert. Erst danach ist physischer Purge bestätigt. Repositories/Storagehelfer committen nicht selbst.
Holdsetzen und Purgeentscheidung werden am selben Assetdatensatz serialisiert. Commit des Holds vor P1 verhindert Purge. Nach committed P1 kann ein späterer Hold nicht wahrheitsgemäß „Datei sicher erhalten“ bestätigen; er liefert `purge_in_progress` und verlangt gezielte Recoveryklärung, keine falsche Schutzgarantie. Dasselbe gilt für Restore/Reaktivierung während eines schon gestarteten Purges. Keine offene DBsperre über den Dateilöschaufruf als vermeintliche gemeinsame Transaktion.
Ein Stream mit gültiger Readlease blockiert P1 bis zu seinem begrenzten Ende; ein Hold-/Zugriffswiderruf stoppt weitere Chunks nach Abschnitt 9. Retention wartet oder meldet diesen Zustand, statt unter dem Stream neue Dateinamen aufzulösen. Nach altem Leaseablauf muss ein verbleibender Stream seine Berechtigung erneuern, sonst beenden. Produktweiter Writerfreeze stoppt auch Leser, soweit sie DBleases schreiben oder eine Löschung/Backupaufnahme beeinflussen.
### 12.3 Retention und Reconciliation
Der lokale Retentionentrypoint benötigt keinen erfundenen Nutzerprincipal. Ein eng verdrahteter Maintenance-Service darf ausschließlich fällige, policygebundene Vorgänge des Produkts abarbeiten und unter eigener technischer Auditursache dokumentieren. Kein öffentliches „System=true“-Flag, kein allgemeiner Servicezugang und keine neue Maschinen-SSO-Infrastruktur. Manuelle privilegierte Übergänge behalten aktuelle Auth-/MFA-/Objektrechte.
Reconciliation prüft `publishing`/`purging` anhand tatsächlicher File-/Receiptzustände und der erwarteten Generation. Wiederholen eines lokalen idempotenten Publishes/Deletes ist nur innerhalb genau derselben Operation zulässig. Keine neue freie Operation aus ungeklärtem Dateizustand. Orphans sind zunächst unsichtbar und kapazitätsbelegt; nach positiver Referenz-/Operationsprüfung und einer Gracefrist können sie gebunden gelöscht werden. Dateifunde werden nie anhand Ähnlichkeit von Dateinamen als Nutzerassets veröffentlicht.
Minimalmetadaten und Holds können längere Aufbewahrung als normale private Dateien verlangen; Fristen stammen aus dem Produktvertrag, keine neu erfundene Familienrechtsnorm. Retention ist kein Backup und keine Garantie, dass entfernte Bytes bereits aus jedem älteren Backup verschwunden sind. Das muss der bestehende Backup-/Löschvertrag getrennt behandeln.
## 13. API und sichere Fehler
Default unter `/api/v1`; Fachprodukte können bestehende Pfade über gleiche Serviceverträge adaptieren. Strikte DTOs, sichere Foundation-Problem-Details, opaque IDs, UTC mit `Z`, `expected_version` und aktuelle Scopebindung. JSONmutationen behalten CSRF-/Origin-/Headervertrag; Content-PUT ist eine ausdrücklich registrierte Binärroute mit gleichwertiger Browsergrenze.
| Endpoint | Verhalten |
|---|---|
| `POST /media/uploads` | JSON mit registriertem Parenttyp/-ID, erwarteter Version, bereinigbarem Anzeigedateinamen und Typkandidat; `Idempotency-Key`; 201 mit Upload-ID/Zustand/Version/Contentpfad nach U0 |
| `PUT /media/uploads/{id}/content` | Roher begrenzter Bytestrom; genau ein geclaimter Attempt; 201 mit Asset-/Attachmentrefs erst nach U3; kein frei wählbarer Speicherpfad |
| `GET /media/operations/{id}` | Eigener autorisierter sicherer Status; IDs, Phase, Reasoncode; keine Volltexte/Pfade/Prüfdateien |
| `GET /media/assets/{id}` | Berechtigte Assetmetadaten und Dateirevision; explizite Whitelist |
| `GET/HEAD /media/assets/{id}/content` | Archiv-/Ownermodus oder expliziter Parent-/Attachmentkontext; voller aktueller Readvertrag |
| `POST //{id}/media-links` | Bekanntes sichtbares Asset, erwartete Parent-/Assetversion; aktive kompatible Verknüpfung erstellen |
| `DELETE //{id}/media-links/{link_id}` | Autorisiertes Detach, 204 ohne Body nach Commit; keine implizite Dateilöschung |
| `POST /media/assets/{id}/lifecycle` | Benannte zulässige Transition und `expected_version`; sofortige logische Änderung oder 202 mit Purgeoperation; kein freier Statusstring |
| `POST /documents/{id}/render` | Konkrete Dokument-/Quellversion und registriertes Ausgabeprofil; lokale Renderoperation; begrenzter erster Schnitt synchron, Status trotzdem dauerhaft |
Render- oder Dateioperationen, die den HTTPzeitrahmen überschreiten, benötigen einen explizit persistenten lokalen Runner; kein verlorenes BackgroundTask. Der erste Schnitt hält nur die dafür gewählten kurzen Raster-/PDFprofile offen. Ein neuer universeller Worker-/Orchestrierungsdienst ist keine Voraussetzung. Fachlicher Import/Export erhält später seinen eigenen Blueprint; diese Routen sind kein vollständiger Datenportabilitäts-/Batchvertrag.
| HTTP / Code | Bedeutung |
|---|---|
| 401 `session_required/session_expired` | Keine gültige Identität; keine Datei-/Uploadfreigabe |
| 403 `capability_required/media_blocked/csrf_failed` | Bekannter eigener Kontext, erforderliche Befugnis/Browservoraussetzung fehlt |
| 404 `not_found` | Fremdes/unsichtbares Asset, Parent, Attachment oder nicht verfügbarer Inhalt; keine Existenz-/Größenlecks |
| 409 `version_conflict/upload_in_progress/storage_conflict/media_visibility_conflict/purge_in_progress` | Konkurrierende/inkonsistente Operation; kein automatischer Mutationsretry |
| 409 `media_capacity_exhausted` | Harte Kapazität reicht nicht; keine Teilaktivierung |
| 413 `payload_too_large` | Tatsächlicher Body/Datei-/Ausgabeumfang verletzt Grenze |
| 415 `unsupported_media_type` | Nicht registrierter oder widersprüchlicher Typ/Encoding |
| 422 `media_invalid/document_invalid/media_reference_invalid` | Ungültige Bytes/Struktur/Frames/Referenz, sicherer feldbezogener Code ohne Rohinhalt |
| 416 `range_not_satisfiable` | Nach aktueller Autorisierung gültige, nicht erfüllbare Einzelrange; korrekter Content-Range |
| 429 `media_capacity_busy` | Technische Parallel-/Spoolaufnahmegrenze; keine ungebundene weitere Operation |
| 503 `storage_unavailable/media_profile_unavailable/media_integrity_failed` | Benötigter Mount, Validator, Durability- oder Integritätsnachweis fehlt; kein Ersatzpfad |
Nach begonnenem Stream nur sauber beenden/abbrechen; Fehler nicht in Bild-/Videobytes injizieren. Keine Rohdecoder-/Dateisystem-/PDF-/Proxytracebacks oder Dateiinhalte in Responses/Audit/Logs. Caption und Originaldateiname sind ebenfalls private Metadaten. Logging nennt sichere Operation-/Asset-/Profilrevisionen und begrenzte Reasoncodes; Querys mit möglichen zukünftigen Grants werden am Proxy redigiert.
## 14. Grenzen, Betrieb und Restore
| Technischer Default | Ausgangswert / Bedeutung |
|---|---|
| Rasterupload | Maximal 8 MiB Eingang, 12 Millionen Pixel, maximale Kante 8.192; genau ein Frame |
| Rasterausgabe | Maximal 16 MiB normalisierte Hauptdatei, zusammen maximal 1 MiB Thumbnail; keine ungebundene Neucodierausgabe |
| Physische Aufnahme | Reservation für Rohfile + Ausgabe + Varianten + tatsächliche Publishkopie; Same-FS-Profil ohne Kopie zunächst mindestens 25 MiB pro maximalem Rastervorgang |
| Erweiterungen Video/PDF | Nur registriert/qualifiziert; erster Kandidat Video 64 MiB, PDF 16 MiB; keine automatische Freischaltung |
| Netzwerk | Uploadidle 10 Sekunden; gesamter Uploadrequest einschließlich Verarbeitung/Finalisierung maximal 120 Sekunden; Streamgesamtzeit 120 Sekunden; begrenzte Chunks 64 KiB |
| Client-/Proxybudgets | Spezielle Upload-/Contentrouten Client 130, Proxy 135 Sekunden; begrenzter PDFrequest 45, Client 50, Proxy 55 Sekunden; kein pauschales Erhöhen aller APItimeouts und keine automatischen Writewiederholungen |
| Parallelität | Zwei aktive Upload-/Readvorgänge pro Subject, acht pro Produkt; Shared-Zulassung statt nur prozesslokaler Zähler |
| Decoder / Raster | Lokaler Kindprozess maximal 5 Sekunden, 512 MiB Speicher; keine zusätzlichen Threads/Prozesse nach freier Eingabe |
| PDFadapter | Maximal 30 Sekunden, 512 MiB, 100 Seiten, 256 KiB Dokumenttext, 32 Bildrefs, 16 MiB Ergebnis |
| Rich Text | Maximal 256 KiB UTF-8, 5.000 Nodes, Tiefe 16, 100 Medienrefs; Caption 500 Zeichen, Link 2.048 Zeichen |
| Readlease | Laufend höchstens 15 Sekunden bis Erneuerung, aktuelle Auth-/Verfügbarkeitsprüfung mindestens jede Sekunde; Gesamtrequestlimit bleibt wirksam |
| Temporärdaten | Ungeklärte Aufnahme default nach einer Stunde zur Reconciliation fällig; Orphangrace 24 Stunden; nicht blind während aktiver Operation löschen |
| Archiv-Lifecycle | Bei benötigtem Shinkanprofil 30 Tage soft, danach 90 Tage hidden; keine neu festgelegte gesetzliche Frist |
Die engere Datei-, Request-, Pool-, Quota- oder Produktgrenze gilt. Zahlen sind anpassbar, wirkliche Grenzen bleiben Pflicht. Grenzwerte müssen auch nach Decoder-/Normalisierungsexpansion gelten. Bei fehlendem Storage/DBvalidator keine Freigabe aufgrund eines alten UIstatus.
Der Release-/Recoveryvertrag registriert Upload, Publish, Render, Readleasepflege, Retention, Löschworker, Reconciliation und temporäres Cleanup als Writer bzw. beeinflussende Leser. Vor Backup/Restore: neue Aufnahmen stoppen, Vorgänge begrenzt drainen, ausstehende Operationen in bekanntem Zustand belassen, alle Filewriter einfrieren. Assettabellen, Operations-/Capacityledger und tatsächliche immutable Objekte/Varianten bilden einen gemeinsamen Konsistenzpunkt. Staging-/Orphanobjekte werden entweder bewusst mitmanifestiert oder vor Capture nachvollziehbar entfernt; sie verschwinden nicht implizit aus dem Nachweis.
Restore verwendet die neue DB-/Mediengeneration aus dem vorhandenen Recovery-Blueprint. Asset-/Receipt-/Operationsbezüge werden kontrolliert an die tatsächlich restaurierte Generation gebunden und geprüft, nie durch Umstellen einer globalen Wurzel umgedeutet. Fehlende Bytes, falsche Hashes/Größen und unbekannte Mountidentität blockieren die entsprechende Freigabe. Alte Sessions, Readleases und gegebenenfalls Grants werden invalidiert; offene Purges/Publishes nicht blind erneut ausführen. Ein gelöschtes/gesperrtes Medium wird durch ein älteres Backup nicht automatisch wieder sichtbar.
Neuere Hold-/Lösch-/Rechtezustände aus dem Verlustfenster können im Backup fehlen. Bis die betroffenen Zustände unter dem Recoveryvertrag geklärt sind, bleiben restaurierte Medien quarantänisiert bzw. ihr Lesen/Löschen blockiert. Eine Hashprüfung allein rekonstruiert diese aktuelle Befugnis nicht. Der Quotenadapter behält erforderliche Recoveryblocked-Zustände; tatsächlicher Speicherbestand und wiederhergestellte Zähler werden vor neuer Hardaufnahme abgeglichen.
## 15. Automatisierte Sicherheits- und Negativtests
Diese Matrix ist **V/K – Implementierungsauftrag**, kein ausgeführter Produktnachweis. Synthetische Fixtures: persönliche Räume A/B, Clubs 1/2, mehrere Parent-/Assetkombinationen, Operator ohne private Leserechte, zwei Sessiongenerationen, kontrollierte Uhr und zwei unabhängige DBconnections. Für Storage eigene temporäre Testwurzel, Mount-/Generation-/Deletefehlerfakes und echte sichere Testfiles; keine Produktdaten oder Live-Dateilöschung.
| ID | Prüfung | Erwartung |
|---|---|---|
| MFR-01 | Fremde/fehlende Session, Scopeheader oder manipulierter Parent/Owner | Kein Upload-/Read-/Linkrecht; keine Profil-/Clubfallbacks |
| MFR-02 | CSRF/Originfehler auf JSON-/Binär-/Multipartmutation | Ablehnung vor Bodyverarbeitung/Spooling; kein ungültiger Freispeicherverbrauch |
| MFR-03 | Lügenhafte Content-Length, chunked Übergröße, gzip, Slowbody, Disconnect | Tatsächliche harte Byte-/Idle-/Gesamtgrenzen; kontrollierter unsichtbarer Teilfile |
| MFR-04 | Doppelte Uploadaufnahme und paralleler Content-PUT | Eine Operation/ein aktueller Attempt; keine gegenseitige Überschreibung |
| MFR-05 | Endung/MIME/Signatur widersprüchlich, Bild mit Anhängsel/defektem Container | Validierung oder frische kanonische Ausgabe; keine ungeprüften Originalbytes |
| MFR-06 | Pixelbombe, übergroße Dimensionen, Animation, Decoderhang | Harte Limits/Prozessabbruch; kein bloßer Threadtimeout oder stilles Framewegwerfen |
| MFR-07 | EXIF/XMP/GPS/Textchunks/Kommentare und Orientation | Definiertes Ausgabeprofil ohne fremde Metadaten; korrekte Orientierung; keine Anonymitätsbehauptung |
| MFR-08 | Metadatumsdatum und Dateizeit ohne sicheren Zeitzonenbezug | Begrenzte Herkunft/Kandidatenkennzeichnung, keine erfundene fachliche Sicherheit |
| MFR-09 | Nicht qualifiziertes Video/PDF/SVG/HTML/Archiv | Profil geschlossen; kein Erlauben allein aufgrund Endung oder Adminrolle |
| MFR-10 | Decoder versucht Netz, freie Pfade, Unterprozess oder Zugriff auf Secrets | Qualifizierte Sandbox verweigert; sichere Fehler ohne Rohdaten |
| MFR-11 | Traversal, absolute/UNC/Laufwerk-/ADS-/Symlink-/Reparsepfade aus Client und DB | Nur registrierte Generation/Keys; kein Lesen/Schreiben außerhalb der Wurzel |
| MFR-12 | NAS ungemountet, Marker falsch, Konfiguration fehlt | storage_unavailable; kein lokales Fallbackverzeichnis |
| MFR-13 | Storagekonfigurationswechsel bei vorhandenem Asset | Alte gebundene Generation unverändert; kein Umleiten alter Keys |
| MFR-14 | Crash nach U0, während U1, nach U2, nach Publish vor U3 | Nie ungeprüft auslieferbar; Reconcile nutzt genaue Operation und echte Receipts |
| MFR-15 | U3-Audit-/Quota-/Link-/Commitfehler | Kein Asseterfolg; Dateiwirkung bleibt unsichtbar und kapazitätsbelegt bis Klärung |
| MFR-16 | Rechteentzug, Sessionrotation, Parentänderung oder Hold zwischen U0 und U3 | Keine ungeprüfte Aktivierung; nur ausdrücklich zulässiger gleicher Rebind |
| MFR-17 | publish_once wiederholt: gleiche und andere Bytes am selben Key | Gleicher verifizierter Vorgang idempotent; andere Bytes Konflikt ohne Overwrite |
| MFR-18 | Parallele letzte Kapazität, Decoderexpansion, Publishkopie und nur teilweise bereinigter Rohspool | Vollständiger Worstcase belegt; Freigabe nur belegbar entfernter Objektbytes, keine ungeplante Zusatzbelegung |
| MFR-19 | Gleicher Inhalt in fremdem Privat-/Clubraum | Kein fremder Deduptreffer/Assetlink/Hashleak |
| MFR-20 | Wiederverwendung eines sichtbaren Assets, Detach eines von zwei Links | Gültiger neuer Link; anderes Parent bleibt unverändert, kein Dateipurge |
| MFR-21 | Parent sichtbar, Asset fremd/gesperrt; Asset sichtbar, Parent fremd | Schnittmenge verweigert; keine indirekte Dateifreigabe |
| MFR-22 | Thumbnail, Liste, Count, Original, HEAD, 206 und 416 für fremde Datei | Einheitliche Autorisierung vor Metadaten/Größe/ETag; sichere 404 |
| MFR-23 | Asset/Linkwechsel zwischen Readplan, Open und R2 | Gebundenes Handle/Version oder Verweigerung; keine Dateiaustauschlücke |
| MFR-24 | Konto-/Mitgliedschafts-/Session-/Holdentzug während Stream | Nächste lokale Prüfung stoppt neue Chunks; keine Connection über gesamte Streamphase |
| MFR-25 | EOF, Disconnect, Streamtimeout, Leaseverlust | Handles/Leases geschlossen bzw. Ablauf wirksam; kein Weiterstreamen mit abgelaufener Lease |
| MFR-26 | Scopewechsel im UI bei Blob-/Nativevideo-/Fehler-/401antwort | Alte Epoch verworfen, URLs widerrufen, src/Viewer geleert |
| MFR-27 | Nativer GET ohne Customheader, aber manipuliertem Scopehint/Origin/Fetchnachweis | Nur eng registrierter Adapter mit voller aktueller Session; sonst geschlossen/Fetchfallback |
| MFR-28 | Volle Session oder profilweiter Sessionalias als URLparameter | Nicht akzeptiert; kein ungeprüfter Grant-/Secretsfallback |
| MFR-29 | GET Einzelranges, Suffix/offene Range, HEAD, If-Range | Dokumentierte 200/206/416 und korrekte Länge; HEAD ohne Body |
| MFR-30 | Multi-/defekte/unknown-unit-/extrem lange Range | Bewusster ganzer 200fall bzw. frühe Headergrenze; kein stilles erstes Segment oder Parserüberlauf |
| MFR-31 | Filename CRLF/Quotes/Pfad/Unicode und falscher gespeicherter MIME | Sicherer Header, geprüfter Inhaltstyp, nosniff/no-store; kein Headerinjection |
| MFR-32 | Script/Eventhandler/iframe/SVG/MathML/CSS in Rich HTML/Markdown | Begrenzter Baum/sicheres Literal; kein ausführbarer Browserinhalt |
| MFR-33 | Fehlerhafte HTMLverschachtelung, Mutation-XSS und nachträgliches Markup | Server-/Browserfallkorpus wirksam; kein untrusted Nachbearbeiten nach Sanitizing |
| MFR-34 | Fremde/fehlende Medien-ID, gültige Syntax ohne Parentlink, manipulierte Caption | Schreibpfad verweigert; Readplatzhalter ohne Fremdmetadaten; Caption Text |
| MFR-35 | javascript/data/file/protokollrelative URL, externe Bilder oder Linkpreview | Keine automatische Ausleitung/Dateiauflösung; nur sichere explizite Textlinks |
| MFR-36 | Admin-/KIinhalt mit HTMLpayload | Gleicher Schutz wie Nutzerinhalt; keine trusted-content-Abkürzung |
| MFR-37 | Richtext-/Node-/Tiefe-/Caption-/Referenzgrenzen | Vor teurer Verarbeitung/Write begrenzt; keine stille Inhaltsänderung |
| MFR-38 | PDFusertext mit ReportLabmarkup und eingebetteter URL-/Dateianforderung | Textescaped, keine freien Ressourcen/DB-/Netzzugriffe |
| MFR-39 | PDF-/Chartlayoutbombe, Renderhang, zu große Ausgabe | Kindprozess-/Seiten-/Bytegrenzen wirksam; kein unbeschränktes RAMrendern |
| MFR-40 | Quelle/Dokument/Assetrecht ändert sich zwischen Materialisieren und Ausgabe | Kein U3erfolg unter veraltetem Snapshot; keine fremde Datei |
| MFR-41 | Promotion Parent ohne entsprechende Assetfreigabe/Rightsdeckung | Konflikt oder expliziter gleichwertiger Produktadapter; keine stille Privatveröffentlichung |
| MFR-42 | active/soft/hidden, neue/alte Links, Recovery und Operatorprivatdatei | Definierte Verfügbarkeit und getrennte Manage-/Leserechte |
| MFR-43 | Hold vor P1 gegenüber Hold nach committed P1 | Vorher kein Purge; danach kein falscher Erhaltungsnachweis, klarer Konflikt |
| MFR-44 | Noch referenziertes Asset, laufende Readlease, gleichzeitiges Attach/Retention | Kein unzulässiger Purge; gemeinsame Assetserialisierung |
| MFR-45 | Crash vor/nach tatsächlichem Delete, Teilverlust einer Variante, Deletefehler | purging bleibt bis echten Belegen; keine falsche Lösch-/Quotaerfolgsmeldung |
| MFR-46 | already_absent bei richtigem Key vs. fehlendem Mount/falscher Generation | Nur echter Abwesenheitsnachweis abschließbar |
| MFR-47 | Cleanup neben aktivem Upload/Render/Read, Orphan ohne sichere Operationsbindung | Kein blindes Entfernen; Grace/Receipts/CAS wirksam |
| MFR-48 | Backupfreeze während Publish/Purge/Readleasepflege | Alle beeinflussenden Prozesse eingefroren; konsistentes DB-/Medienmanifest |
| MFR-49 | Restore vor neuerer Löschung/Hold/Rechteänderung oder mit fehlenden Bytes | Quarantäne/Recoveryblock; keine automatische Wiederveröffentlichung oder neuer Purge |
| MFR-50 | Logging/Problem-/Status-/Preview mit privaten Canarydaten | Keine Datei-/Prompt-/Caption-/Originalnamen-/Cookie-/Keyvolltexte in technischen Ausgaben |
| MFR-51 | API-/Modulimport bei fehlender DB/Storage | Keine Seiteneffekte; fehlender benötigter Adapter bleibt geschlossen |
| MFR-52 | Persönliche API/Medien mit ServiceWorker/CDN-/Browsercache und fremdem CORS | no-store und Scopegrenzen tatsächlich wirksam; kein Cross-Origin-Bypass |
DB-/Link-/Quota-/Hold-/Leasekonkurrenz und atomare Fachwrites später gegen isoliertes echtes PostgreSQL prüfen; Dateieffekte zusätzlich mit echter temporärer Testwurzel und injizierten Fehlern. Nicht nur Mockmethoden zählen. Testberichte nennen Fall-ID, Quell-/Buildstand, Umgebung, ausgeführte Assertions und verbleibende K-Punkte. Kein bestandener Dokumentcheck ersetzt diese Tests.
Vorhandene Testquellen I: Shinkan [Downloadzugriff](C:/Dev/shinkan-jinkendo/backend/tests/test_exercise_media_download.py:31), [Archiv/Lifecycle](C:/Dev/shinkan-jinkendo/backend/tests/test_media_assets_archive.py:44), [Rightsdeclarations](C:/Dev/shinkan-jinkendo/backend/tests/test_media_rights_declaration.py:1), [Hold](C:/Dev/shinkan-jinkendo/backend/tests/test_p11_legal_hold.py:1), [serverseitiger Richtext](C:/Dev/shinkan-jinkendo/backend/tests/test_exercise_rich_text.py:18), [Browser-Sanitizer](C:/Dev/shinkan-jinkendo/frontend/src/utils/exerciseRichTextSanitize.test.js:1), [Storagekonfiguration](C:/Dev/shinkan-jinkendo/backend/tests/test_platform_media_storage.py:27); Kanshō [Journalbodytest](C:/Dev/Kansho/backend/tests/test_journal_body.py:1). Letzterer besitzt einen eigenen `main`-/`expect`-Pfad; bloßes pytest-Dateisammeln belegt dessen Assertions nicht. Diese Quellen wurden hier nicht ausgeführt.
## 16. Implementierungsanweisung für Cursor und verbleibende Themen
1. **Zielprodukt und ersten Dateifall festlegen.** Rasterupload zu genau einem vorhandenen Parenttyp, persönlichem oder Clubscope. Bestehende Produkt-/Agentenregeln bei der tatsächlichen Umsetzung lesen. Shinkanarchive, Mitai-Fotos und Kanshō-Journalmedien über Adapter wiederverwenden; kein Familien-Dateidienst.
2. **Ports anschließen.** Foundation v0.3, aktuelle Auth-/Scope-/AccessPolicy, Entitlements und lokale Kapazitätsports verdrahten. Native Medienroute nur bei konkretem Videobedarf und mit dem engen Vertrag, nicht als allgemeine Authausnahme.
3. **Reine Profile/Modelle bauen.** Strikte Operation-/Asset-/Link-/Read-/Render-DTOs, eingefrorene Typregistry, sichere Keys/Storagegeneration und begrenzte Dokumentadapter. Zuerst Fremdzugriff, Syntax-/Dateityp-/HTML-/URL-/Grenzfälle testen.
4. **Dauerhafte Operationen und SQLmigration ergänzen.** Nur benötigte Tabellen, FKs/Uniqueconstraints, erwartete Versionen, Operationsfences, Idempotenz/HMAC und Audit. Authlockordnung behalten: Account/Session/Scope/Mitgliedschaft, Parents/Assets stabil sortiert, danach nötige Entitlement-/Capacitysubjekte. Maintenancejobs sperren Assets und laden danach keine Nutzerzeilen nach.
5. **U0–U3 mit lokalem Storage implementieren.** Begrenzt aufnehmen, Quarantäne/Normalizer ohne UoW, Publishintent, echter Receipt, aktuelle Aktivierung und gemeinsame Link-/Usage-/Auditbuchung. Kein allumfassender `FileResponse(path)`-/`save(file)`-Helper mit versteckten Commits.
6. **Readpfad und Darstellung qualifizieren.** Parent/Asset als Schnittmenge, gebundenes Handle, R2/Readlease, Logout-/Scopewechsel, Header und gegebenenfalls Range. Medienrefs im Dokument beim Schreiben und Lesen verifizieren, sichere Renderer statt Roh-HTML.
7. **Lifecycle/Purge separat beweisen.** Hold-/Referenz-/Readrace, dauerhafter Intent, echter Deleteabschluss, Kapazität erst nach tatsächlicher Löschung frei. Shinkans funktionale Stufen erhalten, ohne dessen internen Commit-/Unlinkablauf ungeprüft zu kopieren.
8. **Erweiterung nur für den echten Fachbedarf.** PDF zuerst mit Mitais begrenzten strukturierten Blöcken und vollständigem Escaping; Video erst mit qualifiziertem lokalem Prüf-/Normalisierungsprofil. Kein freier URLfetcher, externer Klartext-/Medien-KIpfad oder neuer zentraler Dienst.
9. **Betrieb/Restore einbinden.** Writerinventory/-freeze, Generation-/Mountprüfung, Quarantäne/Reconciliation, fehlende Bytes und neuere Hold-/Löschzustände testen. Beide ADR-11-Buildvarianten behalten Gates und menschliche Produktionsfreigabe; keine neuen CI/CDsysteme verlangen.
10. **Nachweis abliefern und stoppen.** Tatsächlich ausgeführte MFRfälle mit Umgebung/Revision und verbleibenden K-Punkten dokumentieren. Kein Live-Rollout oder Umbau bestehender Produkte durch den Blueprintauftrag.
Abnahme des ersten implementierten Fachfalls verlangt **aktuelle Session + Scope + Parentrecht → begrenzte Aufnahme → nachgewiesene Normalisierung → immutable Publish → atomare Asset-/Link-/Quoten-/Auditaktivierung → aktuell autorisierte Anzeige → nachvollziehbare Löschung/Recovery**, einschließlich aller kritischen Crash- und Fremdzugriffsfälle. Ein funktionierendes Bild im Browser reicht nicht.
| Weiteres Thema nach diesem Dokument | Einordnung |
|---|---|
| **Import, Export & Batch-Verarbeitung** | Weiterer sinnvoller offener Ergänzungsblueprint: Mitais CSVregistry/-Executor und vorhandene Exportpfade sind konkrete Referenzen. Zustands-/Duplikat-/Fehler-/Transaktionsverträge fehlen als vollständiger gemeinsamer Blueprint. Hier nicht nebenbei erstellt. |
| **Quellen und persönliche Ableitungen** | Fachliche Grundentscheidung ADR-16 weiter offen; technische Versionsbezüge aus bestehenden Blueprints entscheiden sie nicht. Kein vorgezogener universeller Quellen-/Wahrheitsdienst. |
| **Maschinenzugriffe** | Begrenzte Anschlusspunkte vorhanden. Vollständiger Blueprint erst bei konkretem ausführendem Produktfall; keine vorsorgliche Agenten-/SSOplattform. |
## 17. Prüfstand dieser Lieferung
Gezieltes Nachlesen registrierter Mechanismen, keine neue Repositoryinventur oder Reife-/Governanceanalyse. Ergänzend wurden ausschließlich drei Primärreferenzen für Rangeverhalten, Decodergrenzen und Sanitizergrenzen geprüft; keine umfassende Recherche oder Versionsmigration. Es wurde genau dieses Markdowndokument in einem neuen Ergebnisverzeichnis erstellt. Bestehende Anwendungen und bisherige Ergebnisdokumente bleiben unverändert.
**T – mechanischer Dokumentcheck am 16.10.2026:** 44 lokale Dateiverweise einschließlich angegebener Zeilen geprüft; drei Pythonbeispiele erfolgreich als AST geparst und ein JSONbeispiel erfolgreich gelesen; 52 eindeutige, lückenlos nummerierte Testspezifikationen erfasst; 29 Quellhashes gegen die vorhandenen Dateien geprüft. Alle 54 vor Erstellung zur Kontrolle erfassten Bestandsdateien sind unverändert. Das Ergebnisverzeichnis enthält genau dieses Markdowndokument. Es wurde kein Beispiel als Anwendung ausgeführt; die 52 Sicherheitsszenarien sind weder implementiert noch ausgeführt. Die Quellhashes unten sind kein Beleg produktiver Konformität.
### 17.1 Lokaler Quellstand
SHA-256 der gezielt verwendeten Implementierungs-, Test- und Produktdokumentquellen; Pfade relativ zu `C:/Dev`. Testquellen wurden nicht ausgeführt.
| Quelle | SHA-256 |
|---|---|
| `shinkan-jinkendo/backend/media_grant.py` | `2de9f849324bebd21a4ff82c0b1c287affe5234d31c394572517c712b966f5ca` |
| `shinkan-jinkendo/backend/media_storage.py` | `b555b035079f0e7fecaa22c1b66bcde3ebd1b25e158db9606888730d6b90a5bd` |
| `shinkan-jinkendo/backend/media_lifecycle.py` | `7b73bd5d28dd7fbb1af6387bca2e3a9fc913a83346cbf869a981b7fc4bb9baf8` |
| `shinkan-jinkendo/backend/media_legal_hold.py` | `423946ca491a2c66183712e5c74d088791be58a2919b053565097108b90018a3` |
| `shinkan-jinkendo/backend/media_rights.py` | `f76ab9a336c454d2b63d126a898a7f6139edf722bf3d5474e50b4698748ef31b` |
| `shinkan-jinkendo/backend/exercise_rich_text.py` | `af818008ac4c1dcecd967cedf2706fb2d51d511639a7bb67f983ed3cbae68844` |
| `shinkan-jinkendo/backend/routers/exercises.py` | `db5c2c5c0906f95e091edcee794d6ea6a65993773914b49a24ddac0e1528fc53` |
| `shinkan-jinkendo/backend/routers/media_assets.py` | `b268a26ac9f78ae17b142503ac1b3228ca7e5b61edd798e6a57a082d391150ea` |
| `shinkan-jinkendo/backend/scripts/media_retention_job.py` | `b73ba786b08a22c1cd65df079a8f7123249cefb9a95a958e0af31fc90392c406` |
| `shinkan-jinkendo/frontend/src/utils/exerciseRichTextSanitize.js` | `808c077cc59fc27d0a4fdb1c0f525d924bf295d31cb8effd1ed815d6a611683c` |
| `shinkan-jinkendo/frontend/src/utils/exerciseRichTextSanitize.test.js` | `c636969aca99e1e9facd0b397472777d6cd1477c00cd816f845fb264e8d51002` |
| `shinkan-jinkendo/backend/tests/test_exercise_media_download.py` | `a0a72757c153053070721323b8f71a4c0b3273e3602f2e890e7529f93d214696` |
| `shinkan-jinkendo/backend/tests/test_media_assets_archive.py` | `5ca7d8a4bdb34da1ae4230afa7abdf533e4e5a732bc938aca8c44ac7a7d61c05` |
| `shinkan-jinkendo/backend/tests/test_media_rights_declaration.py` | `2b29152453de8938c7cf9c43185dfaee07350b4bf178da0a4e87e3e0c1c04270` |
| `shinkan-jinkendo/backend/tests/test_p11_legal_hold.py` | `cd53ec9c0457688112384b1d4c691e554568c8d9cca41e490022c5592c9517a2` |
| `shinkan-jinkendo/backend/tests/test_exercise_rich_text.py` | `acf98ea48aacd3ad843a9c14436928a4e9b30f0dbabf6d90337db34e1f3e4212` |
| `shinkan-jinkendo/backend/tests/test_platform_media_storage.py` | `0d20d32743ffc97cb96a20ab219d468ca17f1892f8a253b38e293728ae8f5baf` |
| `shinkan-jinkendo/.claude/docs/technical/MEDIA_ASSETS_AND_ARCHIVE_SPEC.md` | `4dcccfcf66a3c077a5a38c27c69933265639f5f89aed7718b82718f2b2436017` |
| `shinkan-jinkendo/.claude/docs/technical/MEDIA_UPLOAD_SPEC.md` | `8e61086c8f627dca0cb6cc66fdd27e4d9ab70bc9cb6c7e11d920c88a71f83527` |
| `mitai-jinkendo/backend/routers/photos.py` | `794298b690b54300af6644d0919bedc72b64960c1314b0a8f8ce35b22b0398cf` |
| `mitai-jinkendo/backend/report_pdf_render.py` | `fbb51d82382b87513a4aff3a250045d6d4688ac0528d085cf3acc9359029851e` |
| `Kansho/AGENTS.md` | `d21fb90d51a5b3a2dc9064bef7118381eee5462bf622ef2adf1fb13bb1f1f19b` |
| `Kansho/backend/media_store.py` | `fac2d9593af15dd6df13d3f3ffe461dd0051bcb34b1a217e97de3409125340fb` |
| `Kansho/frontend/src/journal/KanshoMedia.jsx` | `a185224d9abf76ed6148a4a41fd0859a05d7959df9d907b37349218d0c50c5dc` |
| `Kansho/frontend/src/journal/document.js` | `f9fdfe038670c7db24364237a7f9fb6fc356c9c893c8e3dd96adc35814fcb1ba` |
| `Kansho/backend/tests/test_journal_body.py` | `9150aaaf5e4e87509921ac67590a6ca49fa4436ef3fafd57fc1cacf671496f9e` |
| `Kansho/docs/architecture/functional/documentation_index.md` | `af4035d05d03b401bfbb8ed1e07731106723418db90dfe0d3ef4290d7e6eb6d0` |
| `Kansho/docs/architecture/functional/guardrails.md` | `deadd95b5019fe807026616f6ff74a2467d9d951702c032573d59f27c125dc4b` |
| `Kansho/docs/architecture/technical/voice_and_media.md` | `83db25e53f82ed2149f91869f37fdfeed02b3525deab70f9984af13ea9aeb279` |