71 lines
6.8 KiB
Markdown
71 lines
6.8 KiB
Markdown
# Code-Review Tsumugu – Gesamtbericht
|
||
|
||
**Stand:** 18.10.2026 · **Geprüfter Code:** Branch `develop`, Commit `f21c64a` · **Art:** statisches Review mit Build- und Syntaxprüfung, ohne Codeänderung
|
||
|
||
Dieser Ordner enthält den vollständigen Review-Bericht. Geprüft wurde, ob die Anforderungen aus `docs/product`, `docs/architecture` und `docs/design` umgesetzt sind und ob der Code die Referenzarchitektur A/B/C v0.3 und die Spezial-Blueprints aus `docs/reference` einhält. Zusätzlich wurde die Dokumentation auf Vollständigkeit geprüft und ergänzt.
|
||
|
||
## Dokumente dieses Reviews
|
||
|
||
| Datei | Inhalt |
|
||
|---|---|
|
||
| [01_METHODIK_UND_QUELLEN.md](01_METHODIK_UND_QUELLEN.md) | Vorgehen, gelesene Quellen, ausgeführte Prüfungen, Grenzen, Bewertungsskala |
|
||
| [02_ANFORDERUNGEN_PRODUKT.md](02_ANFORDERUNGEN_PRODUKT.md) | Abgleich mit der Produktspezifikation (F-01 bis F-08, S-01, F-05a-Abnahme) |
|
||
| [03_ANFORDERUNGEN_UX_UND_AUFTRAEGE.md](03_ANFORDERUNGEN_UX_UND_AUFTRAEGE.md) | Abgleich mit UX-Ergänzung 0.8 (UX-01 bis UX-21) und den Einzelaufträgen (Symbole, Richtung, kompakte Liste, Export, Unterkapitel, Ensō) |
|
||
| [04_TECHNISCHE_SPEZIFIKATION.md](04_TECHNISCHE_SPEZIFIKATION.md) | Abgleich mit der technischen Spezifikation 0.3: Pakete P0–P7, Datenmodell, Invarianten, API-Verzeichnis, Nachweise T-* |
|
||
| [05_REFERENZARCHITEKTUR_BLUEPRINTS.md](05_REFERENZARCHITEKTUR_BLUEPRINTS.md) | Vertragsweiser Abgleich mit A/B/C v0.3, Auth/Session/Scope, Medien/Dateien, Release/Betrieb/Recovery sowie den Grenzen KI, Prompt, Entitlements |
|
||
| [06_BEFUNDE.md](06_BEFUNDE.md) | Alle Code-Befunde mit ID, Schweregrad, Fundstelle, Szenario und Empfehlung |
|
||
| [07_TESTS_UND_CI.md](07_TESTS_UND_CI.md) | Testabdeckung gegen die geplanten Nachweise, CI-Workflows, Lücken |
|
||
| [08_DOKUMENTATION.md](08_DOKUMENTATION.md) | Inventar, Widersprüche, im Review ergänzte Dokumente, verbleibende Lücken |
|
||
| [09_MASSNAHMENPLAN.md](09_MASSNAHMENPLAN.md) | Priorisierte Maßnahmen mit Reihenfolge und Abnahme |
|
||
|
||
## Gesamtbewertung
|
||
|
||
Die erste Lieferung „Organisieren und Nachverfolgen“ (F-05a) ist fachlich weitgehend vollständig umgesetzt. Hinzu kommen die späteren Aufträge: UX-Überarbeitung, Typ-Symbole, Antwortbezüge, Kommunikationsrichtung, kompakte Liste, Übergabepaket (F-07a–c) und Unterkapitel (F-08a). Das kontextbezogene Rechtemodell ist sorgfältig gebaut. Unsichtbare Objekte werden in Listen, Suche, Chronologie und Export weggelassen, ohne Titel und ohne Anzahl. Die Backend-Suite deckt die wichtigsten fachlichen Prüfszenarien der technischen Spezifikation ab (T-ISO, T-SHARE, T-CONTEXT, T-DETACH, T-GRANT, T-DL, T-ANCHOR-01). Bewusst zurückgestellte Fähigkeiten sind nicht stillschweigend gestrichen: Finanzen, Paperless-Abgleich, virtuelle Zusammenstellungen, gespeicherte Sichten, KI und Anwaltszugang.
|
||
|
||
Die Schwächen liegen in drei Bereichen:
|
||
|
||
1. **Rechte- und Datenintegrität an Einzelstellen.** Bearbeiter können ganze Akten und Vorgänge löschen, obwohl laut Rollentabelle nur der Owner Behälter löschen darf. Das Lösen einer Einbindung prüft nicht, ob sie zum Handlungskontext gehört. Vorgangsausnahmen wirken nicht auf die Inhalte des Vorgangs. Die zentrale Übersicht und die Suche begrenzen die Treffer vor der Rechteprüfung, sodass bei wachsendem Datenbestand eigene Einträge stillschweigend fehlen.
|
||
2. **Abweichungen von verbindlichen Blueprint-Verträgen.** Das Betreiberkonto entsteht über eine öffentliche Web-Route statt über die lokale CLI mit MFA. Betreiber-MFA fehlt. Sessions laufen 14 Tage ohne Leerlaufablauf und ohne Rotation. Runtime und Migration nutzen dieselben DB-Zugangsdaten. Quellen-Geheimnisse liegen im Klartext in der Datenbank. Externe Aufrufe zu Paperless und IMAP laufen bei offener DB-Transaktion. E-Mail-Anlagen werden `inline` mit vom Absender bestimmtem Medientyp ausgeliefert.
|
||
3. **Betrieb mit echten Daten.** Paket P7 fehlt vollständig: Backup, Restore, Release-Gate, RLS-Prüfung und HSTS-Nachweis. Ein Merge nach `main` deployt trotzdem direkt in die Produktion, ohne vorgelagerten Test. Laut technischer Spezifikation 8.2 wartet Produktion mit echten Akten auf P7.
|
||
|
||
Nichts davon verlangt einen Umbau. Die meisten Punkte lassen sich gezielt im Bestand beheben (siehe [Maßnahmenplan](09_MASSNAHMENPLAN.md)).
|
||
|
||
## Kennzahlen
|
||
|
||
| Bereich | Ergebnis |
|
||
|---|---|
|
||
| Bestätigte Fachentscheidungen der ersten Lieferung (F-01a–f, S-01a–d, F-04a, F-05a) | umgesetzt; Einzellücken unter R-01, R-02, R-07 |
|
||
| Spätere Aufträge F-06a–f, F-07a–c, F-08a | umgesetzt; Einschränkungen unter R-13, R-22 |
|
||
| Zurückgestellt laut F-05a/F-07a (Finanzen, P6, P5b, Anwaltszugang, KI) | nicht umgesetzt, wie vorgesehen |
|
||
| UX-Abnahmekriterien UX-01 bis UX-21 | 17 statisch belegt, 2 teilweise (UX-10, UX-18), 2 ohne Nachweis (UX-13 Bedienung, UX-17 echtes Drag-and-drop mit Zeiger) |
|
||
| Befunde | 31 insgesamt: 0 kritisch, 8 hoch, 13 mittel, 8 niedrig, 2 Hinweise |
|
||
| Backend-Tests | 54 Testfunktionen in 12 Dateien; nicht ausgeführt (keine PostgreSQL-Instanz im Review) |
|
||
| Frontend | Produktionsbuild erfolgreich; 4 von 4 Node-Tests bestanden |
|
||
| Python | `py_compile` aller Module erfolgreich |
|
||
|
||
## Wichtigste Befunde
|
||
|
||
| ID | Schwere | Kurzbeschreibung |
|
||
|---|---|---|
|
||
| R-21 | Hoch | P7 fehlt: kein Backup/Restore, kein Release-Gate, keine RLS-Prüfung. `main` deployt ohne vorgelagerte Tests nach Produktion |
|
||
| R-01 | Hoch | Bearbeiter dürfen Akte und Vorgang löschen. Laut Rollentabelle darf das nur der Owner |
|
||
| R-02 | Hoch | `DELETE /bindings/{id}` prüft die Zugehörigkeit der Einbindung zum Handlungskontext nicht |
|
||
| R-03 | Hoch | E-Mail-Anlagen und Paperless-Bilder (auch SVG) werden `inline` aus dem App-Origin ausgeliefert |
|
||
| R-04 | Hoch | Betreiberkonto über eine öffentliche Web-Route, ohne MFA (Abweichung von ADR-05 und Auth-Blueprint 11.3) |
|
||
| R-11 | Hoch | Offene Aufgaben, Fristen und Suche: `LIMIT` vor der Rechteprüfung. Sichtbare Treffer fallen weg |
|
||
| R-08 | Hoch | Sessions 14 Tage ohne Leerlaufablauf und Rotation, Login-Begrenzung nur im Prozessspeicher, kein Passwortwechsel |
|
||
| R-31 | Hoch | Hochgeladene Fotos behalten EXIF- und GPS-Metadaten, es gibt keine Normalisierung |
|
||
|
||
Die vollständige Liste steht in [06_BEFUNDE.md](06_BEFUNDE.md).
|
||
|
||
## Im Review ergänzte Dokumentation
|
||
|
||
- [docs/README.md](../README.md): Dokumentationslandkarte
|
||
- [docs/architecture/API_REFERENZ.md](../architecture/API_REFERENZ.md): tatsächlich registrierte Endpunkte
|
||
- [docs/architecture/DATENMODELL_IST.md](../architecture/DATENMODELL_IST.md): Schema nach allen Migrationen
|
||
- [docs/architecture/RECHTEMODELL_IST.md](../architecture/RECHTEMODELL_IST.md): implementierte Rechteauswertung
|
||
- [docs/ENTWICKLUNG_UND_TESTS.md](../ENTWICKLUNG_UND_TESTS.md): lokaler Start, Tests, Builds
|
||
- Korrekturen in `README.md`, `docs/DEPLOYMENT.md` und ein Ist-Hinweis in `docs/architecture/TSUMUGU_TECHNICAL_SPEC.md`
|
||
|
||
Anwendungscode, Migrationen, Workflows und Konfiguration wurden nicht verändert.
|