28 KiB
06 – Befunde
Schweregrade siehe 01. Fundstellen beziehen sich auf Commit f21c64a. Die Reihenfolge folgt der ID, nicht der Schwere.
Übersicht
| ID | Schwere | Bereich | Kurzbeschreibung |
|---|---|---|---|
| R-01 | Hoch | Rechte | Bearbeiter löschen Akten und Vorgänge |
| R-02 | Hoch | Rechte | Detach und Anmerkung ohne Prüfung der Einbindung gegen den Handlungskontext |
| R-03 | Hoch | Sicherheit | Aktive Inhalte werden inline aus dem App-Origin ausgeliefert |
| R-04 | Hoch | Auth | Betreiber per öffentlichem Web-Bootstrap, keine Betreiber-MFA |
| R-05 | Mittel | Secrets | Paperless-Token und IMAP-Passwörter im Klartext in der Fach-DB |
| R-06 | Mittel | Sicherheit | SSRF und Token-Weitergabe bei frei wählbaren Quellenadressen |
| R-07 | Mittel | Rechte | Vorgangsausnahmen wirken nicht auf die Inhalte des Vorgangs |
| R-08 | Hoch | Auth | Session- und Login-Härtung unter dem Blueprint-Vertrag |
| R-09 | Mittel | Datenbank | Gemeinsame Zugangsdaten für Runtime und Migration, Migrator ohne Lock |
| R-10 | Mittel | Quellen | Quelleninhalte werden über den Zugang des Betrachters geladen |
| R-11 | Hoch | Korrektheit | LIMIT vor der Rechteprüfung in Übersicht und Suche |
| R-12 | Mittel | Korrektheit | Verschieben erzeugt eine zweite Teilvorgangsebene |
| R-13 | Mittel | Export | Gelöschte oder unsichtbare Bezugsziele blockieren das Übergabepaket |
| R-14 | Mittel | Daten | Gelöschte Akte oder gelöschter Vorgang lässt Inhalte unauffindbar zurück |
| R-15 | Niedrig | Rechte | Fristen eines Teilvorgangs im Elternkontext ohne Rechte |
| R-16 | Niedrig | Frontend | „Überall löschen“ an Behälter- statt Element-Owner gebunden |
| R-17 | Hinweis | Dokumentation | Funktionen über die Spezifikation hinaus ohne Fachpunkt |
| R-18 | Mittel | Audit | Auditlücken, fehlende Labels, falscher Kontext |
| R-19 | Niedrig | Suche | Volltextsuche trifft JSON-Schlüssel |
| R-20 | Niedrig | Robustheit | Unbekannter Zeichensatz in E-Mails führt zu 500 |
| R-21 | Hoch | Betrieb | P7 fehlt: Backup, Restore, Release-Gate, RLS |
| R-22 | Mittel | Transaktion | Externe Aufrufe in offener DB-Transaktion, Export vollständig im Speicher |
| R-23 | Mittel | Transaktion | Commit-Zeitpunkt hängt an der FastAPI-Version |
| R-24 | Niedrig | API | Keine Request-ID, generische Problem-Typen, flache Readiness |
| R-25 | Niedrig | Frontend | Transportclient ohne Timeout und Abbruch, kein Data Router |
| R-26 | Niedrig | Abhängigkeiten | Keine Hash-Locks, Vite 5 außerhalb des Supports |
| R-27 | Mittel | CI | Doppelte Testläufe auf derselben DB, Tests im Laufzeitimage |
| R-28 | Niedrig | Rand | Nginx reicht X-Forwarded-Proto des Clients durch |
| R-29 | Mittel | Funktion | Verwaltungsfunktionen fehlen in Oberfläche oder API |
| R-30 | Hinweis | Hygiene | Testhilfsordner nicht in .gitignore |
| R-31 | Hoch | Privacy | Uploads ohne Normalisierung, EXIF/GPS bleibt erhalten |
R-01 – Bearbeiter löschen Akten und Vorgänge (Hoch)
Fundstelle: ops.py:518–544, Matters.jsx:500
delete_case und delete_matter verlangen nur das Recht edit. Die Rollentabelle der technischen Spezifikation (5.2) gibt „Löschen des Behälters“ ausschließlich dem Owner. Die Oberfläche zeigt „Löschen“ jedem Bearbeiter (canEdit).
Szenario: Ada teilt die Akte „Mietstreit“ mit Ben zum Bearbeiten. Der Vorgang „Mängelanzeige“ ist dieser Akte und zusätzlich Adas privater Akte zugeordnet. Ben öffnet den Vorgang im Aktenkontext und löscht ihn. Der Vorgang verschwindet auch aus Adas privater Akte, obwohl Ben dort keine Rechte hat. Die Ownership des Vorgangs spielt keine Rolle.
Empfehlung: Behälter löschen nur für owner_subject_id == actor (alternativ can_delete aus einem expliziten Grant). Oberfläche an is_owner koppeln. Negativtest ergänzen: Bearbeiter erhält 403.
R-02 – Detach und Anmerkung ohne Kontextbindung (Hoch)
Fundstelle: ops.py:937–953, ops.py:956–979
detach_binding prüft das Bearbeitungsrecht am Element im übergebenen Kontext. Es vergleicht aber nur die Kontextart der Einbindung (case/matter), nicht deren ID. add_annotation lässt im Aktenkontext jede Vorgangs-Einbindung zu, ohne zu prüfen, ob dieser Vorgang der Akte zugeordnet ist. Die korrekte Hilfsfunktion _binding_in_page existiert bereits und wird für die Kommunikationsrichtung verwendet.
Szenario: Eine Notiz ist in Akte A (nur Ada) und Akte B (Ben bearbeitet) eingebunden. Ben ruft DELETE /api/v1/bindings/{ID der Einbindung in A}?context_kind=case&context_id={B} auf. Die Rechteprüfung läuft gegen B und ist erfolgreich. Gelöscht wird die Einbindung in A samt ihren Anmerkungen. Voraussetzung ist die Kenntnis der UUID; die Oberfläche gibt sie für A nicht heraus. Es bleibt ein Verstoß gegen F-01d und das Prinzip „fremde IDs gewähren keinen Zugriff“.
Empfehlung: In beiden Funktionen _binding_in_page(conn, binding, action_context) verlangen, sonst 404. Negativtest mit fremder Einbindungs-ID ergänzen.
R-03 – Aktive Inhalte aus dem App-Origin (Hoch)
Fundstelle: api/sources.py:176–195, api/sources.py:79–88, sources.py:264–273, ReadingPane.jsx:532, ReadingPane.jsx:582
E-Mail-Anlagen werden mit Content-Disposition: inline und dem Medientyp aus der E-Mail ausgeliefert. Diesen Typ bestimmt der Absender. Paperless-Inhalte gelten als anzeigbar, sobald der Typ mit image/ beginnt; das schließt image/svg+xml ein. Die Oberfläche öffnet nicht darstellbare Blobs per Link in einem neuen Tab. Ein Blob aus einer Same-Origin-Antwort trägt den Origin der App. Eine HTML- oder SVG-Anlage läuft dann im App-Origin. Die Nginx-CSP mit script-src 'self' blockiert Inline-Skripte, nicht aber Skripte von derselben Origin und nicht Phishing-Formulare.
Empfehlung: Laut Datei-Blueprint 9.3: Anlagen und Fremddokumente als attachment ausliefern; inline nur für eine Allowlist (PDF, PNG, JPEG, WebP), SVG ausschließen; Binärantworten zusätzlich mit Content-Security-Policy: sandbox; default-src 'none'. Im Frontend Blob-Links nur für erlaubte Typen anbieten, sonst Download erzwingen.
R-04 – Web-Bootstrap des Betreibers, keine MFA (Hoch)
Fundstelle: routes.py:292–310, Login.jsx:73–91
Solange kein Betreiber existiert, kann jeder, der die öffentliche Adresse erreicht, über die Anmeldeseite das Betreiberkonto anlegen. Der Auth-Blueprint (11.3, ADR-05) und die technische Spezifikation (3.1) verlangen eine lokale CLI und verpflichtende MFA für Betreiberaktionen. Eine CLI existiert (python -m app.cli create-account). Sie macht das erste Konto zum Betreiber, ohne MFA. Betreiberrechte erlauben Kontoanlage mit frei gesetztem Passwort.
Szenario: Eine neue Umgebung wird deployt, zum Beispiel nach einem Datenbankverlust oder ein neues Dev-Volume hinter der öffentlichen Dev-Domain. Bis zur ersten Anmeldung kann ein Fremder das Betreiberkonto übernehmen.
Empfehlung: Web-Bootstrap entfernen oder an einen einmaligen, auf dem Host erzeugten Token binden. Betreiber-MFA (TOTP) nach Blueprint 11 ergänzen. Bis dahin die Abweichung in DEPLOYMENT.md als bewusstes Risiko führen (im Review ergänzt).
R-05 – Quellen-Geheimnisse im Klartext (Mittel)
Fundstelle: Migration connectors, sources.py:27–52
connectors.secret speichert Paperless-API-Token und IMAP-Passwörter unverschlüsselt. Jeder DB-Dump enthält sie. A6 verlangt, dass nur der Secret-Adapter Rohwerte kennt. Der Auth-Blueprint nennt für wieder lesbare Secrets einen lokalen Fernet-Cipher mit separat bereitgestelltem Schlüssel.
Empfehlung: Secrets mit einem lokal bereitgestellten Schlüssel verschlüsseln (Key-ID in der Zeile). Für Backups dokumentieren, dass der Schlüssel getrennt gesichert wird.
R-06 – SSRF und Token-Weitergabe (Mittel)
Fundstelle: sources.py:182–190, sources.py:276–292, sources.py:352–363, sources.py:373–388
Jede angemeldete Person kann eine beliebige Paperless-Adresse und einen beliebigen IMAP-Host eintragen. Das Backend verbindet sich aus dem Heimnetz dorthin und meldet Erfolg oder Fehler zurück. Damit lassen sich interne Dienste ansprechen. _paperless_get und _paperless_metadata folgen Weiterleitungen mit gesetztem Authorization-Header. Nur der Dateiabruf prüft den Zielhost nach der Weiterleitung.
Empfehlung: Weiterleitungen für alle Paperless-Aufrufe abschalten oder auf denselben Host begrenzen. Optional eine Allowlist erlaubter Hosts in der Betriebskonfiguration.
R-07 – Vorgangsausnahmen wirken nicht auf Inhalte (Mittel)
Fundstelle: policy.py:313–328
element_rights im Aktenkontext verwendet die Aktenrechte abzüglich einer Elementausnahme. Eine Ausnahme am Vorgang in diesem Aktenkontext (PUT /exceptions mit resource_kind=matter) wird für dessen Inhalte nicht berücksichtigt. Das gilt auch für Teilvorgänge. Die Aktenansicht blendet den gesperrten Vorgang aus. Element-Endpunkte wie GET /files/{id}/content?context_kind=case&context_id=…, GET /external-refs/{id}/… oder PATCH /notes/{id} mit Aktenkontext liefern bzw. ändern den Inhalt weiter.
Szenario: Ada sperrt den Vorgang „Interne Strategie“ in der mit Ben geteilten Akte für das Lesen. Ben kennt die Element-ID einer Datei aus einem früheren Aufruf. Er lädt die Datei weiter im Aktenkontext.
Empfehlung: In element_rights für Einbindungen, die nur über einen Vorgang die Akte erreichen, zusätzlich matter_rights(…, Ctx("case", …)) des tragenden Vorgangs bzw. Teilvorgangs schneiden. Negativtest ergänzen.
R-08 – Session- und Login-Härtung (Hoch)
Fundstelle: settings.py:27, routes.py:163–238, routes.py:544–549, deps.py:46–68
- Sessions gelten 336 Stunden ohne Leerlaufablauf, ohne Rotation, mit unveränderlichem CSRF-Token. Der Blueprint nennt 30 Minuten Leerlauf und 12 Stunden absolut als Default; eine Begründung für die Abweichung fehlt.
- Die Login-Begrenzung ist ein Dictionary im Prozessspeicher (
_login_attempts). Es wächst mit jedem neuen Schlüssel, wird nie aufgeräumt und gilt nicht über Neustarts. Der Blueprint verlangt eine persistente Begrenzung. - Für unbekannte Konten läuft kein bcrypt-Dummyvergleich. Die Antwortzeit verrät, ob ein Konto existiert.
GET /api/v1/principals?email=liefert jeder angemeldeten Person ID und Anzeigenamen beliebiger Konten.- Es gibt keinen Passwortwechsel, kein Logout-all und keine Kontosperre über die Oberfläche oder API.
- Der CSRF-Vergleich ist nicht konstantzeitlich.
Empfehlung: Leerlaufablauf und Rotation nach Blueprint 7 einführen oder die längere Laufzeit begründet im Produktauftrag festhalten. Begrenzung in die DB verlagern (auth_attempt_windows). Dummy-Vergleich. Kontoauflösung auf Raummitglieder bzw. exakte Treffer ohne ID begrenzen. Passwortwechsel und Logout-all mit Widerruf aller Sessions. secrets.compare_digest für CSRF.
R-09 – Gemeinsame Zugangsdaten, Migrator ohne Lock (Mittel)
Fundstelle: migrate.py:20–90, entrypoint.py, docker-compose.yml
Der Backend-Container erhält Owner-Zugangsdaten (DB_USER/DB_PASSWORD), migriert damit beim Start und legt die Runtime-Rolle mit demselben Passwort an. Der laufende Prozess kennt damit DDL-Zugang. Der Migrator setzt keinen Advisory-Lock, erkennt angewandte, aber fehlende Dateien nicht und schreibt keine build_revision.
Empfehlung: Eigenes Passwort für die Runtime-Rolle (DB_RUNTIME_PASSWORD). Migration als eigener Compose-Schritt mit Owner-Zugang; das Backend erhält nur Runtime-Zugang. Advisory-Lock und Fehlend-Prüfung nach A5 ergänzen.
R-10 – Quellen über den Zugang des Betrachters (Mittel)
Fundstelle: api/sources.py:78, api/sources.py:144, sources.py:197–209
Die Paperless-Vorschau lädt mit dem zuletzt angelegten Paperless-Zugang der ansehenden Person. Die E-Mail-Ansicht verlangt einen Zugang dieser Person. Ben sieht eine von Ada eingebundene Paperless-Referenz deshalb entweder gar nicht oder mit einem eigenen Paperless-Zugang. Ist dort zufällig dieselbe Dokumentnummer vergeben, zeigt Tsumugu ein anderes Dokument. Ein von Ada übernommenes E-Mail kann Ben nie öffnen. Der Export nutzt ebenfalls nur Zugänge der exportierenden Person.
Empfehlung: Zugang fest an die Referenz binden (connector_id als Spalte, wie im Connectoren-Befund vorgeschlagen). Den Abruf über den Zugang des Element-Owners führen, nachdem das Leserecht im Kontext geprüft ist. Bis dahin die Grenze in der Oberfläche benennen.
R-11 – LIMIT vor der Rechteprüfung (Hoch) – behoben am 23.10.2026
Stand: Übersicht (offene Aufgaben und Fristen) und Suche lesen die Kandidaten jetzt in Blöcken von 200 in der Reihenfolge der Abfrage, prüfen je Zeile die Rechte und hören auf, sobald genug sichtbare Einträge da sind (_scan in routes.py). Fremde Zeilen verdrängen eigene nicht mehr. Die Arbeit ist bei sehr großen Beständen auf 20 000 gelesene Zeilen begrenzt; eine Vorfilterung im SQL und Cursor-Seiten bleiben eine spätere Optimierung. Test: tests/test_views_scan.py. Der Befund unten beschreibt den früheren Zustand.
Fundstelle: routes.py:1328–1359, routes.py:1412–1423
/views/open-tasks und /views/open-deadlines lesen die ersten 200 offenen Einträge aller Konten und filtern danach auf die sichtbaren. Die Suche liest die ersten 100 passenden Elemente aller Konten. Mit wachsendem Datenbestand mehrerer Personen fehlen eigene offene Aufgaben, Fristen oder Treffer stillschweigend. F-05a verlangt eine zentrale Übersicht offener Arbeit.
Szenario: Ada hat 250 offene Aufgaben mit frühem Termin. Ben legt eine Aufgabe an. Bens zentrale Übersicht bleibt leer, weil seine Aufgabe nicht unter den ersten 200 ist.
Empfehlung: Kandidaten im SQL auf eigene, zugewiesene, per Grant oder über lesbare Vorgänge erreichbare Objekte vorfiltern und danach seitenweise mit Cursor ausliefern.
R-12 – Zweite Teilvorgangsebene durch Verschieben (Mittel)
Fundstelle: ops.py:557–595, vgl. ops.py:352–355
create_matter verbietet einen Teilvorgang unter einem Teilvorgang. move_matter prüft das nicht: Ein Vorgang mit eigenen Teilvorgängen lässt sich unter einen anderen Vorgang hängen, und ein Ziel, das selbst Teilvorgang ist, wird akzeptiert. Die Rechtefunktionen (matter_rights, _matter_reaches_case, element_rights) kennen nur eine Ebene. Enkel sind über den Aktenkontext nicht mehr erreichbar.
Empfehlung: In move_matter dieselbe Regel wie beim Anlegen erzwingen: Ziel ist Wurzelvorgang, der verschobene Vorgang hat keine Teilvorgänge.
R-13 – Bezugsziele blockieren den Export (Mittel)
Fundstelle: exporting.py:422–444, ops.py:1044–1059
Ist ein Bezugsziel global gelöscht oder für die exportierende Person nicht lesbar, meldet die Prüfung „Ein Antwortbezug lässt sich nicht auflösen“ und gibt kein Paket frei. delete_element entfernt element_references nicht; der Fremdschlüssel kaskadiert nur beim physischen Löschen, das nie stattfindet. Die Oberfläche blendet den toten Bezug aus und bietet kein Lösen an. Das Paket bleibt dauerhaft gesperrt. Bei unsichtbarem Ziel verrät die Meldung zudem, dass ein Bezug existiert. Der Exportauftrag sagt: Gegenstücke außerhalb der Auswahl werden nicht benannt.
Empfehlung: Beim globalen Löschen Bezüge entfernen. Unsichtbare oder gelöschte Ziele im Export still auslassen, ohne Hinweis.
R-14 – Inhalte gelöschter Behälter (Mittel)
Fundstelle: ops.py:518–544, Matters.jsx:251
Das Löschen setzt nur deleted_at. Einbindungen, Kapitel, Aufgaben und Fristen bleiben am gelöschten Behälter. Inhalte, die nur dort eingebunden waren, erscheinen in keiner Liste mehr; auch GET /elements (nicht eingebundene Elemente) findet sie nicht, weil die Einbindung formal noch besteht. Der Bestätigungsdialog sagt „Inhalte bleiben erhalten“. Eine Wiederherstellung gibt es nicht.
Empfehlung: Beim Löschen Einbindungen lösen, sodass die Elemente beim Owner unter „nicht eingebunden“ auftauchen, oder eine Wiederherstellung anbieten. Dialogtext an die tatsächliche Wirkung anpassen.
R-15 – Fristen eines Teilvorgangs im Elternkontext (Niedrig)
Fundstelle: policy.py:382 gegenüber policy.py:389–413
task_rights hat einen Zweig für den Kontext „Elternvorgang“, deadline_rights nicht. Fristen eines Teilvorgangs sind im Elternkontext ohne Rechte, Aufgaben dagegen sichtbar.
Empfehlung: Zweig angleichen und testen.
R-16 – „Überall löschen“ an falsche Ownership gekoppelt (Niedrig)
Fundstelle: content.jsx:941, Cases.jsx:522, Matters.jsx:470
Die Schaltfläche erscheint, wenn die Person Owner der Akte bzw. des Vorgangs ist. Das Backend erlaubt das globale Löschen dem Owner des Elements. Die Owner einer Akte sehen eine Aktion, die mit 404 scheitert; Element-Owner in fremden Akten sehen sie nicht.
Empfehlung: element.owner_subject_id === session.account.id verwenden.
R-17 – Funktionen ohne Fachpunkt (Hinweis)
Aufgabenabhängigkeiten, Aufgaben-Inhaltsverknüpfungen, Verschieben von Vorgängen, Löschen von Behältern und direkte Kontoanlage durch den Betreiber sind umgesetzt, aber in Fach- und technischer Spezifikation nicht beschrieben (siehe 02, Abschnitt 4). Empfehlung: als Fachpunkt nachtragen oder bestätigen lassen.
R-18 – Auditlücken (Mittel)
Fundstelle: ops.py, routes.py, present.py:929–964, ops.py:1483
Ohne Audit bleiben: Titel- und Statusänderung von Akte und Vorgang (patch_case, patch_matter), Friständerung (patch_deadline), Zuweisung (assign_task), Ausnahmen (set_exception), Querverweis löschen, Raum anlegen, Mitgliedschaft ändern, Konto anlegen, Login, Logout und Scopewechsel. Der Auth-Blueprint (13.2) verlangt Pflichtereignisse für Session, Scopewahl und privilegierte Änderungen. Mehrere protokollierte Aktionen haben kein Label (chapter_renamed, chapter_deleted, communication_direction, matter_moved, matter_deleted, case_deleted) und erscheinen als „Ereignis“. update_dates schreibt ohne Kontext ein Ereignis mit Ctx("matter", element_id), also einer Element-ID als Vorgangskontext.
Empfehlung: Fehlende Ereignisse in derselben Transaktion ergänzen, Labels nachziehen, in update_dates den echten Kontext oder None verwenden.
R-19 – Suche über JSON-Schlüssel (Niedrig)
Fundstelle: routes.py:1418
Die Suche vergleicht document_json::text. Begriffe wie „text“, „type“, „blocks“, „markdown“ oder „paragraph“ treffen jede Notiz.
Empfehlung: Nur die Textwerte der Blöcke durchsuchen (zum Beispiel per jsonb_path_query), langfristig Volltextindex.
R-20 – Unbekannter Zeichensatz (Niedrig)
Fundstelle: mailpack.py:145–167, sources.py:672–678
bytes.decode(charset, errors="replace") wirft LookupError, wenn eine E-Mail einen unbekannten Zeichensatz deklariert. Leser und Export brechen mit 500 ab.
Empfehlung: LookupError abfangen und auf UTF-8 mit replace zurückfallen.
R-21 – P7 fehlt (Hoch)
Fundstelle: deploy-prod.yml, technische Spezifikation 8, Release-Blueprint 1, 7, 10–13
Es gibt kein Backup von Datenbank und Medien, keinen geprobten Restore, kein Release-Gate vor der Produktion, keine Artefaktzuordnung, keine RLS-Prüfung und keinen HSTS-Nachweis. Ein Push auf main baut auf dem Host neu und startet die Produktion. Die Tests laufen nur auf develop und erst nach dem Dev-Deploy. Die technische Spezifikation 8.2 sagt: Produktion mit echten Akten wartet auf P7.
Empfehlung: Bis P7 in der Produktion nur synthetische Daten führen oder die Produktion anhalten. P7 nach Release-Blueprint umsetzen, mindestens: verschlüsseltes Backup von DB und Medien mit unabhängiger Kopie, ein geprobter Restore, Gate „Tests grün für genau diesen Tree“ vor deploy-prod.
R-22 – Externe Aufrufe in offener Transaktion, Export im Speicher (Mittel)
Fundstelle: deps.py:30–43, api/sources.py, api/export.py, exporting.py:806–815
Jede Route hält eine Pool-Verbindung mit offener Transaktion für die gesamte Laufzeit, auch während Paperless- und IMAP-Aufrufen mit 12–30 Sekunden Timeout und während einer Ordnersuche über alle IMAP-Fächer. Der Pool hat zehn Verbindungen. A3 und die technische Spezifikation 6 schließen externe Kommunikation bei offener Transaktion aus. Der Export baut das ZIP vollständig im Speicher; jedes Original darf 80 MiB groß sein, eine Gesamtgrenze fehlt. Auf dem Raspberry Pi kann ein großes Paket den Prozess beenden.
Empfehlung: Für Quellen- und Exportrouten die Rechteprüfung in einer kurzen Transaktion abschließen und externe Abrufe danach ohne Verbindung ausführen. Export als Stream (zipfile auf temporäre Datei oder StreamingResponse) mit Gesamtgrenze.
R-23 – Commit-Zeitpunkt hängt an der FastAPI-Version (Mittel)
Fundstelle: deps.py:30–43, requirements.txt
Der Commit steht im Exit-Teil einer yield-Dependency. In FastAPI 0.115 läuft er vor dem Senden der Antwort. Spätere Versionen haben diese Reihenfolge wieder geändert. Ein Upgrade kann stillschweigend dazu führen, dass der Client 2xx erhält, obwohl der Commit scheitert. A3 verbietet den Commit nach der Antwort. Auch das Löschen der Dateien „nach Commit“ hängt an diesem Ablauf.
Empfehlung: Transaktion im Use-Case explizit öffnen und committen (UoW nach B2), oder die Dependency mit scope="function" festlegen und einen Test „Commit-Fehler ergibt keinen 2xx“ ergänzen.
R-24 – Request-ID, Problem-Typen, Readiness (Niedrig)
Fundstelle: main.py, errors.py
Keine X-Request-ID, type immer about:blank, /health/ready prüft nur SELECT 1 ohne Migrationsstand. OpenAPI ist auch in Development aus; es entsteht kein Vertragsartefakt für einen API-Diff in CI.
Empfehlung: Request-ID-Middleware, stabile urn:jinkendo:problem:*-Typen, Readiness mit Ledger-Abgleich, OpenAPI in Development und als CI-Artefakt.
R-25 – Frontend-Transport und Router (Niedrig)
Fundstelle: api.js:38–68, main.jsx
Der Transportclient hat keinen Timeout und bricht laufende Requests beim Datenraumwechsel nicht ab. Eine Nicht-JSON-Fehlerantwort (zum Beispiel ein 502 von Nginx) führt in JSON.parse zu einem unbehandelten Fehler. Statt eines Data Routers mit Loadern und einer Modulregistry (A7/B3) gibt es BrowserRouter mit Effekten je Seite. Ein 401 leert die Session-Variablen, der React-Zustand bleibt aber angemeldet.
Empfehlung: Timeout und AbortController, robustes Fehlerparsing, bei 401 den Session-Kontext zurücksetzen. Der Wechsel zum Data Router ist ein eigener Auftrag.
R-26 – Abhängigkeiten (Niedrig)
Fundstelle: requirements.txt, package.json, frontend/Dockerfile
Python-Pins ohne Hashes, pdfjs-dist und sharp mit ^, Vite 5 (laut A1 ohne Support), Node 22 im Build-Image gegenüber Node 24 in A1, Basisimages ohne Digest.
Empfehlung: pip-compile --generate-hashes, exakte npm-Versionen, Basisimages mit Digest. Versionssprung als eigener Auftrag.
R-27 – CI (Mittel)
Fundstelle: test.yml
test.yml startet bei jedem Push auf develop und nach dem erfolgreichen Dev-Deploy. Zwei Läufe arbeiten dann parallel auf derselben Datenbank tsumugu_test; einer verwirft sie, während der andere testet. Der Export-Prüfbericht nennt genau diese Fehlerquelle. Pytest läuft im Laufzeitimage nach pip install und gegen den eingehängten Checkout, nicht gegen das gebaute Image. Der Node-Test list-meta.test.mjs läuft in CI nicht. Ein roter Testlauf hält weder Dev noch Prod auf.
Empfehlung: Nur einen Auslöser verwenden, Testdatenbank je Lauf benennen oder kurzlebige Postgres-Instanz starten, Concurrency-Gruppe setzen, Node-Tests ergänzen, Testlauf zum Gate vor deploy-prod machen.
R-28 – Durchgereichtes X-Forwarded-Proto (Niedrig)
Fundstelle: frontend/nginx.conf:24, security.py:43
Der Frontend-Nginx übernimmt X-Forwarded-Proto vom Client. Das Backend wählt in Development danach den Cookie-Namen und das Secure-Attribut. Ein Client über HTTP kann so ein __Host--Cookie anfordern, das der Browser verwirft. Eine Sicherheitslücke entsteht daraus nicht, aber eine schwer erklärbare fehlgeschlagene Anmeldung.
Empfehlung: Den Header nur vom bekannten Synology-Proxy übernehmen.
R-29 – Fehlende Verwaltungsfunktionen (Mittel)
Einladung (POST /invitations) und Aufgabenzuweisung (POST /tasks/{id}/assignee) haben keine Oberfläche. Mitglieder lassen sich nur als „Mitglied“ hinzufügen, nicht entfernen oder zum Verwalter machen (API vorhanden, Oberfläche fehlt). Konten lassen sich weder deaktivieren noch löschen; ein Passwortwechsel fehlt in API und Oberfläche. Die technische Spezifikation nennt Zuweisung und Einladung als Teil von P1 bzw. P4a.
Empfehlung: Kleine Verwaltungsdialoge ergänzen, Kontosperre mit Widerruf aller Sessions.
R-30 – .gitignore (Hinweis)
backend/.pytest-tmp/ und backend/.pytest-export-tmp/ erscheinen als ungetrackt. Empfehlung: in .gitignore aufnehmen.
R-31 – Uploads ohne Normalisierung (Hoch)
Fundstelle: media/storage.py:19–28, ops.py:999–1041
Uploads werden nur an den ersten Bytes erkannt und unverändert gespeichert und ausgeliefert. Fotos behalten EXIF-Daten einschließlich GPS-Position und Gerätedaten. Diese Daten erreichen alle, mit denen der Inhalt geteilt wird, und das Übergabepaket für den Anwalt. Der Datei-Blueprint (6.1, 6.3) sieht für Rasterbilder ein Neukodieren ohne fremde Metadaten vor. Angehängte Bytes hinter einem gültigen Bildkopf werden ebenfalls übernommen.
Empfehlung: Rasterbilder serverseitig mit Pillow neu kodieren (Pixel- und Größengrenzen, Orientierung anwenden, Metadaten verwerfen). Falls das Original fachlich erhalten bleiben muss, beide Fassungen kennzeichnen und die bereinigte für Anzeige und Freigabe verwenden.