Files
tsumugu/docs/review/06_BEFUNDE.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

295 lines
28 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 06 – Befunde
Schweregrade siehe [01](01_METHODIK_UND_QUELLEN.md#schweregrade-der-befunde). 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](../../backend/app/ops.py#L518-L544), [Matters.jsx:500](../../frontend/src/pages/Matters.jsx#L500)
`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](../../backend/app/ops.py#L937-L953), [ops.py:956–979](../../backend/app/ops.py#L956-L979)
`detach_binding` prüft das Bearbeitungsrecht am Element im übergebenen Kontext. Es vergleicht aber nur die Kontext**art** 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](../../backend/app/api/sources.py#L176-L195), [api/sources.py:79–88](../../backend/app/api/sources.py#L79-L88), [sources.py:264–273](../../backend/app/sources.py#L264-L273), [ReadingPane.jsx:532](../../frontend/src/pages/ReadingPane.jsx#L532), [ReadingPane.jsx:582](../../frontend/src/pages/ReadingPane.jsx#L582)
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](../../backend/app/api/routes.py#L292-L310), [Login.jsx:73–91](../../frontend/src/pages/Login.jsx#L73-L91)
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](../../backend/migrations/20261016T222500Z_connectors.sql), [sources.py:27–52](../../backend/app/sources.py#L27-L52)
`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](../../backend/app/sources.py#L182-L190), [sources.py:276–292](../../backend/app/sources.py#L276-L292), [sources.py:352–363](../../backend/app/sources.py#L352-L363), [sources.py:373–388](../../backend/app/sources.py#L373-L388)
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](../../backend/app/access/policy.py#L313-L328)
`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](../../backend/app/core/settings.py#L27), [routes.py:163–238](../../backend/app/api/routes.py#L163-L238), [routes.py:544–549](../../backend/app/api/routes.py#L544-L549), [deps.py:46–68](../../backend/app/api/deps.py#L46-L68)
- 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](../../backend/app/db/migrate.py#L20-L90), [entrypoint.py](../../backend/app/entrypoint.py), [docker-compose.yml](../../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](../../backend/app/api/sources.py#L78), [api/sources.py:144](../../backend/app/api/sources.py#L144), [sources.py:197–209](../../backend/app/sources.py#L197-L209)
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)
**Fundstelle:** [routes.py:1328–1359](../../backend/app/api/routes.py#L1328-L1359), [routes.py:1412–1423](../../backend/app/api/routes.py#L1412-L1423)
`/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](../../backend/app/ops.py#L557-L595), vgl. [ops.py:352–355](../../backend/app/ops.py#L352-L355)
`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](../../backend/app/exporting.py#L422-L444), [ops.py:1044–1059](../../backend/app/ops.py#L1044-L1059)
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](../../backend/app/ops.py#L518-L544), [Matters.jsx:251](../../frontend/src/pages/Matters.jsx#L251)
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](../../backend/app/access/policy.py#L382) gegenüber [policy.py:389–413](../../backend/app/access/policy.py#L389-L413)
`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](../../frontend/src/pages/content.jsx#L941), [Cases.jsx:522](../../frontend/src/pages/Cases.jsx#L522), [Matters.jsx:470](../../frontend/src/pages/Matters.jsx#L470)
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](02_ANFORDERUNGEN_PRODUKT.md#4-umsetzung-über-die-spezifikation-hinaus)). Empfehlung: als Fachpunkt nachtragen oder bestätigen lassen.
## R-18 – Auditlücken (Mittel)
**Fundstelle:** [ops.py](../../backend/app/ops.py), [routes.py](../../backend/app/api/routes.py), [present.py:929–964](../../backend/app/present.py#L929-L964), [ops.py:1483](../../backend/app/ops.py#L1483)
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](../../backend/app/api/routes.py#L1418)
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](../../backend/app/mailpack.py#L145-L167), [sources.py:672–678](../../backend/app/sources.py#L672-L678)
`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](../../.gitea/workflows/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](../../backend/app/api/deps.py#L30-L43), [api/sources.py](../../backend/app/api/sources.py), [api/export.py](../../backend/app/api/export.py), [exporting.py:806–815](../../backend/app/exporting.py#L806-L815)
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](../../backend/app/api/deps.py#L30-L43), [requirements.txt](../../backend/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](../../backend/app/main.py), [errors.py](../../backend/app/core/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](../../frontend/src/api.js#L38-L68), [main.jsx](../../frontend/src/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](../../backend/requirements.txt), [package.json](../../frontend/package.json), [frontend/Dockerfile](../../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](../../.gitea/workflows/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](../../frontend/nginx.conf#L24), [security.py:43](../../backend/app/auth/security.py#L43)
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](../../backend/app/media/storage.py#L19-L28), [ops.py:999–1041](../../backend/app/ops.py#L999-L1041)
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.