Files
tsumugu/docs/reference/Jinkendo_Media_Files_Safe_Rendering_Blueprint.md
T
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

78 KiB
Raw Blame History

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:

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, Uploadspec, Assetrouter 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, Downloadpfad 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 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, 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, Browser-Sanitizer, 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, Purge, Hold, Retentionjob, 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, Pfadauflösung, 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, 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, Metadatenbehandlung, 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, Editor-Mediennode, 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, Kontextindex und Guardrails 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

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.

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

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:

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, If-Range

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.

{
  "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

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.

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 <img>, 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 /<parent>/{id}/media-links Bekanntes sichtbares Asset, erwartete Parent-/Assetversion; aktive kompatible Verknüpfung erstellen
DELETE /<parent>/{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, Archiv/Lifecycle, Rightsdeclarations, Hold, serverseitiger Richtext, Browser-Sanitizer, Storagekonfiguration; Kanshō Journalbodytest. 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