Das Modul liefert ein Feldmanifest und validiert es; ein leeres Geheimnisfeld behält das gespeicherte. Die Oberfläche rendert die Felder generisch in einer Detailansicht je Zugang mit Prüfstand, Fähigkeiten und Verwendung. Die providerspezifischen Formulare in Sources.jsx entfallen, die flachen API-Felder bleiben als Kompatibilität. Das Standardfach eines IMAP-Kontos öffnet der Picker zuerst. Die Backend-Tests wurden in der Entwicklungsumgebung nicht ausgeführt; der Lauf auf develop steht aus. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
11 KiB
10 – Nachprüfung gegen Richtlinien und Blueprints
Stand: 20.10.2026 · Geprüfter Code: Branch develop, Commit c29bd29 · Vorgänger: Review vom 18.10.2026 auf Commit f21c64a (README) · Art: statische Nachprüfung, keine Codeänderung
Umfang und Grenzen
Seit f21c64a kamen 33 Commits hinzu (rund 17 900 Zeilen). Geprüft wurde:
- Ob die 31 Befunde R-01 bis R-31 aus 06_BEFUNDE.md im aktuellen Code noch bestehen.
- Ob die neuen Connector-Module (
sourceaccess.py,sourcebind.py,sourceport.py,sourceregistry.py,media/port.py, Frontendsources/) den Connector-/Storage-Vertrag v0.1 und die Blueprints indocs/referenceeinhalten.
Ausgeführt wurde: npm ci und vite build (erfolgreich). Nicht ausgeführt wurden die Backend-Tests und py_compile: Auf diesem Rechner ist kein Python installiert, und es gibt keine PostgreSQL-Instanz. Die Aussagen zu Backend-Verhalten beruhen auf Codelektüre. Die Node-Tests lieferten keine auswertbare Ausgabe und sind nicht bewertet. Die Nachprüfung deckt die Stellen ab, die in den Befunden genannt sind, und die neuen Module. Sie ist keine zweite Vollprüfung aller 17 900 Zeilen.
1. Stand der früheren Befunde
| ID | Früher | Jetzt | Beleg im aktuellen Code |
|---|---|---|---|
| R-01 Bearbeiter löschen Akte/Vorgang | Hoch | offen | ops.py:519-545: delete_case und delete_matter verlangen weiter nur edit |
| R-02 Detach/Anmerkung ohne Kontextbindung | Hoch | offen | ops.py:956-989: detach_binding vergleicht nur die Kontextart; _binding_in_page (Zeile 371) wird nicht verwendet |
R-03 Aktive Inhalte inline |
Hoch | offen | api/sources.py:105 und :207: Paperless-Original und Mail-Anlage inline mit Absender-MIME; keine Sandbox-CSP |
| R-04 Web-Bootstrap, keine MFA | Hoch | offen | routes.py:292-300 |
| R-05 Secrets im Klartext | Mittel | offen, jetzt dokumentiert | connectors.secret unverändert; sourceport.py:77 führt das Profil legacy-plaintext ausdrücklich (Vertrag v0.1, Abschnitt 7 erlaubt das als Legacy-Zustand) |
| R-06 SSRF / Redirect mit Token | Mittel | teilweise | Dateiabruf prüft den Zielhost nach Redirect (sources.py:467-471); _paperless_get und _paperless_metadata (:501, :577) folgen Redirects weiter mit Authorization-Header. Keine Host-Allowlist |
| R-07 Vorgangsausnahmen wirken nicht auf Inhalte | Mittel | nicht neu geprüft | policy.py geändert (64 Zeilen), Befund nicht gezielt nachverfolgt |
| R-08 Session-/Login-Härtung | Hoch | offen | settings.py:27 336 h; routes.py:163 Login-Zähler im Prozessspeicher; security.py:23-27 kein Dummy-Vergleich |
| R-09 Gemeinsame DB-Zugangsdaten, Migrator ohne Lock | Mittel | offen | docker-compose.yml:30-34, migrate.py: kein Advisory-Lock, keine Fehlend-Prüfung |
| R-10 Quelle über Zugang des Betrachters | Mittel | behoben | sourceaccess.py, sourcebind.py: Referenz ist an connector_id gebunden, Abruf über den Owner-Zugang (mediated_source_owner), kein Fallback auf den zuletzt angelegten Zugang, Audit source_read_mediated |
R-11 LIMIT vor Rechteprüfung |
Hoch | offen | routes.py:1358-1389 (LIMIT 200), Suche LIMIT 100 (:1450) |
| R-12 Zweite Teilvorgangsebene durch Verschieben | Mittel | offen | ops.py:558-596: nur Zyklusprüfung, keine Ebenenprüfung |
| R-13 Bezugsziele blockieren Export | Mittel | nicht neu geprüft | exporting.py stark verändert (787 Zeilen) |
| R-14 bis R-19 | – | nicht neu geprüft | – |
| R-20 Unbekannter Zeichensatz | Niedrig | teilweise | mailpack.py:330 fängt LookupError; sources.py:960 ruft decode_transfer ohne Schutz auf, und decode_transfer selbst (mailpack.py:178) wirft bei unbekanntem Zeichensatz |
| R-21 P7 fehlt | Hoch | offen | deploy-prod.yml: Push auf main baut und startet ohne Gate; kein Backup/Restore |
| R-22 Externe Aufrufe in offener Transaktion | Mittel | teilweise behoben | release_for_external in sourceaccess.py:29 und complete_borrow mit erneuter Rechteprüfung sind der richtige Schnitt; die Restpunkte stehen unter 2.1 |
| R-23 Commit-Zeitpunkt | Mittel | offen | deps.py:30-43 unverändert, FastAPI 0.115.6 gepinnt |
| R-24 Request-ID, Problem-Typen | Niedrig | offen | keine X-Request-ID im Code |
| R-25 Frontend-Transport ohne Timeout/Abbruch | Niedrig | offen | api.js enthält weder AbortController noch Timeout |
| R-26 Abhängigkeiten | Niedrig | offen | requirements.txt ohne Hashes; Vite/pdfjs-dist wie zuvor |
| R-27 CI | Mittel | offen | test.yml: zwei Auslöser, feste tsumugu_test, pip install im Laufzeitimage, Tests nicht Gate für Prod |
| R-31 Uploads ohne Normalisierung | Hoch | offen | keine Bildbibliothek in requirements.txt |
Fazit: Alle acht hohen Befunde aus dem Review vom 18.10. sind unverändert offen (R-01, R-02, R-03, R-04, R-08, R-11, R-21, R-31). Die Arbeit der letzten drei Tage ging fast vollständig in den Connector-Umbau. Dort wurde R-10 geschlossen und R-22 zur Hälfte.
2. Neue Befunde aus der Nachprüfung
2.1 N-01 – Externe Abrufe laufen teils weiter in der Fachtransaktion (Mittel)
Der Nacharbeitsbericht TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md nennt vier Restpunkte, davon betrifft Punkt 1 genau Medien-Blueprint und Vertrag Abschnitt 7 („externe Aufrufe außerhalb offener Fachtransaktionen“). In dieser Nachprüfung nicht erneut gegen den Code belegt, aber Commit c29bd29 („verspätete Quellenantworten“) behandelt nur Punkt 4 erkennbar. Vor der Abnahme prüfen, ob Punkt 1 (IMAP-Lesepfad, Export, Versandfassung) und Punkt 2 (Markdown-Renderer) geschlossen sind.
2.2 N-02 – complete_borrow committet bei Fehlern nur im Audit-Fall (Niedrig)
sourceaccess.py:67-68: audit_mediated committet bei outcome != "ok" mitten im Request. Das ist gewollt, damit das Audit eines abgelehnten Abrufs den folgenden Rollback übersteht, bricht aber die Regel „ein Transaktionskontext je Anwendungsfall“ (A3) und verlässt sich darauf, dass der Aufrufer danach nichts Unfertiges in der Transaktion hält. Bitte im Code kommentieren und mit einem Test absichern.
2.3 N-03 – Download der Mail-Anlage liefert inline für jede Anlage (Hoch, Teil von R-03)
api/sources.py:207 übergibt inline=True für jede Anlage, ohne Allowlist. Der neue media_type stammt weiter aus der E-Mail. Eine text/html- oder image/svg+xml-Anlage wird damit im App-Origin angezeigt. Das ist nach dem Datei-Blueprint 9.3 ein Vertragsverstoß und sollte vor der Anbindung echter Postfächer geschlossen werden.
3. Abgleich mit den Blueprints
Die Vertragstabellen in 05_REFERENZARCHITEKTUR_BLUEPRINTS.md gelten weiter. Änderungen durch die neuen Module:
| Blueprint | Vorgabe | Status | Bemerkung |
|---|---|---|---|
| Datei-Blueprint 7 | Storage hinter Port, opake Referenzen | ✅ verbessert | media/port.py (Adapter, adapter_for), Migration source_storage |
| Datei-Blueprint 7.2 | Keine behauptete Atomarität, Reconciliation | 🟡 | discard_stored räumt nach Commit/Rollback auf; weiter kein dauerhafter Intent und kein Reconciler |
| Datei-Blueprint 9.3 | Dokumente als attachment, restriktive CSP |
❌ | siehe R-03, N-03 |
| A2 | Router → Service → Repository | 🟡 | neue Schnitte (Source-Port, Registry, Bind) sind sauber; sources.py hat 1 653 Zeilen, ops.py 1 594, routes.py 1 886, correspondence.py 1 636, exporting.py 1 416 |
| A3 | Externe Kommunikation außerhalb der Transaktion | 🟡 | release_for_external neu, nicht überall angewendet (siehe 2.1) |
| A5 | Migrationen mit Ledger, Lock, Fehlend-Prüfung | 🟡 | unverändert |
| A8 | Fail-closed Zugriff | ✅ | borrow_original verweigert ohne mediated_source_owner, prüft nach dem Abruf erneut (_recheck) |
| Connector-Vertrag 4 | Fähigkeiten je Quelle, nicht unterstützte Filter melden | ✅ | sourceport.py: CAPABILITIES, unsupported_filters |
| Connector-Vertrag 4 | Kein Fallback auf die zuletzt angelegte Verbindung | ✅ | sourcebind.resolve_for_read, ambiguous verlangt bewusste Zuordnung |
| Connector-Vertrag 7 | Schutzprofil, Legacy-Klartext ausdrücklich | ✅ | protection_profiles in capability_payload |
| Connector-Vertrag 5 | Registrierte Komponenten statt Quellverzweigungen in Fachseiten | 🟡 | sources/registry.jsx ordnet Medien Lesernamen zu; ReadingPane.jsx und NoteEditor bleiben fest verdrahtet (Nacharbeitsbericht Punkt 3) |
| KI-/Prompt-/Entitlement-Blueprints | nur als Grenze | ✅ | keine KI-Bibliothek, keine Provider-Anbindung im Code |
4. Empfohlene Reihenfolge
Die Reihenfolge folgt dem Risiko für echte Daten, nicht der ID.
- Vor jedem Echtbetrieb: R-21 (Prod-Gate, Backup), R-03/N-03 (Auslieferung), R-01/R-02 (Rechte), R-11 (Übersicht verliert Einträge). Alle vier sind klein bis mittel im Aufwand und haben im Review vom 18.10. bereits konkrete Empfehlungen.
- Auth: R-04 und R-08 gemeinsam als eigenes Paket (Bootstrap, Sessionlaufzeit, Dummy-Vergleich, persistente Begrenzung).
- Connector-Abschluss: Restpunkte 1 bis 3 des Nacharbeitsberichts, R-06 (Redirects), R-20 (
sources.py:960). - Struktur: die fünf großen Module aufteilen, bevor weitere Funktionen dazukommen.
- Betrieb/CI: R-27, R-23, R-09, R-24, R-25, R-26.
5. Nicht geprüft
- Backend-Tests (82 laut Abschlussmatrix) wurden nicht ausgeführt, kein Python, keine PostgreSQL-Instanz.
- Befunde R-07, R-13 bis R-19, R-28 bis R-30 sind nicht gegen den aktuellen Code abgeglichen.
- Das Frontend wurde nur gebaut, nicht in einem Browser bedient.
- Keine echte Paperless- oder IMAP-Quelle angesprochen.