Files
tsumugu/docs/review/10_NACHPRUEFUNG_2026-10-20.md
T
LarsandClaude Sonnet 5.5 eb58dce4cd
Deploy Development / deploy (push) Successful in 40s
Test Suite / pytest-backend (push) Successful in 3m12s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 21s
Führe die Konfigurationsansicht der Connectoren ein, damit Paperless und IMAP ihre Felder selbst deklarieren.
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>
2026-10-20 09:34:37 +02:00

11 KiB
Raw Blame History

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:

  1. Ob die 31 Befunde R-01 bis R-31 aus 06_BEFUNDE.md im aktuellen Code noch bestehen.
  2. Ob die neuen Connector-Module (sourceaccess.py, sourcebind.py, sourceport.py, sourceregistry.py, media/port.py, Frontend sources/) den Connector-/Storage-Vertrag v0.1 und die Blueprints in docs/reference einhalten.

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.

  1. 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.
  2. Auth: R-04 und R-08 gemeinsam als eigenes Paket (Bootstrap, Sessionlaufzeit, Dummy-Vergleich, persistente Begrenzung).
  3. Connector-Abschluss: Restpunkte 1 bis 3 des Nacharbeitsberichts, R-06 (Redirects), R-20 (sources.py:960).
  4. Struktur: die fünf großen Module aufteilen, bevor weitere Funktionen dazukommen.
  5. 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.