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>
This commit is contained in:
1 parent
c29bd29f34
commit
eb58dce4cd
20 files changed
+1071
-244
No files matched your search
@@ -0,0 +1,92 @@
|
||||
# 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](README.md)) · **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](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](../../backend/app/ops.py#L519-L545): `delete_case` und `delete_matter` verlangen weiter nur `edit` |
|
||||
| R-02 Detach/Anmerkung ohne Kontextbindung | Hoch | **offen** | [ops.py:956-989](../../backend/app/ops.py#L956-L989): `detach_binding` vergleicht nur die Kontext**art**; `_binding_in_page` (Zeile 371) wird nicht verwendet |
|
||||
| R-03 Aktive Inhalte `inline` | Hoch | **offen** | [api/sources.py:105](../../backend/app/api/sources.py#L105) und [:207](../../backend/app/api/sources.py#L207): Paperless-Original und Mail-Anlage `inline` mit Absender-MIME; keine Sandbox-CSP |
|
||||
| R-04 Web-Bootstrap, keine MFA | Hoch | **offen** | [routes.py:292-300](../../backend/app/api/routes.py#L292-L300) |
|
||||
| R-05 Secrets im Klartext | Mittel | **offen, jetzt dokumentiert** | `connectors.secret` unverändert; [sourceport.py:77](../../backend/app/sourceport.py#L77) 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](../../backend/app/sources.py#L467-L471)); `_paperless_get` und `_paperless_metadata` ([:501](../../backend/app/sources.py#L501), [:577](../../backend/app/sources.py#L577)) 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](../../backend/app/core/settings.py#L27) 336 h; [routes.py:163](../../backend/app/api/routes.py#L163) Login-Zähler im Prozessspeicher; [security.py:23-27](../../backend/app/auth/security.py#L23-L27) kein Dummy-Vergleich |
|
||||
| R-09 Gemeinsame DB-Zugangsdaten, Migrator ohne Lock | Mittel | **offen** | [docker-compose.yml:30-34](../../docker-compose.yml#L30-L34), [migrate.py](../../backend/app/db/migrate.py): kein Advisory-Lock, keine Fehlend-Prüfung |
|
||||
| R-10 Quelle über Zugang des Betrachters | Mittel | **behoben** | [sourceaccess.py](../../backend/app/sourceaccess.py), [sourcebind.py](../../backend/app/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](../../backend/app/api/routes.py#L1358-L1389) (`LIMIT 200`), Suche `LIMIT 100` ([:1450](../../backend/app/api/routes.py#L1450)) |
|
||||
| R-12 Zweite Teilvorgangsebene durch Verschieben | Mittel | **offen** | [ops.py:558-596](../../backend/app/ops.py#L558-L596): 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](../../backend/app/mailpack.py#L330) fängt `LookupError`; [sources.py:960](../../backend/app/sources.py#L960) ruft `decode_transfer` ohne Schutz auf, und `decode_transfer` selbst ([mailpack.py:178](../../backend/app/mailpack.py#L178)) wirft bei unbekanntem Zeichensatz |
|
||||
| R-21 P7 fehlt | Hoch | **offen** | [deploy-prod.yml](../../.gitea/workflows/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](../../backend/app/sourceaccess.py#L29) 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](../../backend/app/api/deps.py#L30-L43) 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](../../frontend/src/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](../../.gitea/workflows/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](../product/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](../../backend/app/sourceaccess.py#L67-L68): `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](../../backend/app/api/sources.py#L207) ü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](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.
|
||||
Reference in new issue
Block a user