66 lines
4.8 KiB
Markdown
66 lines
4.8 KiB
Markdown
# 01 – Methodik, Quellen und Grenzen
|
||
|
||
## Gegenstand
|
||
|
||
Repository `C:\Dev\tsumugu`, Branch `develop`, Commit `f21c64a` („Ziehe die Struktur enger …“). Ungetrackt im Arbeitsverzeichnis lagen die Testhilfsordner `backend/.pytest-tmp/` und `backend/.pytest-export-tmp/` (nicht bewertet) sowie der Ordner `docs/reference/` mit Referenzarchitektur und Blueprints. Er ist Grundlage dieses Reviews, aber noch nicht versioniert.
|
||
|
||
## Gelesene Anforderungs- und Referenzquellen
|
||
|
||
| Bereich | Dokumente | Umfang |
|
||
|---|---|---|
|
||
| Produkt | `TSUMUGU_PRODUCT_SPEC.md` (0.37), `TSUMUGU_UX_MVP_ERGAENZUNG.md` (0.8), Aufträge zu Export, Unterkapitel, Kommunikationsrichtung, kompakter Liste, Symbolen/Logo-Rahmen und Ensō-Animation, Connectoren-Befund, Weiterplanungs-Übergabe, Prüfberichte Export und Unterkapitel, `TECHNICAL_SPEC_HANDOFF.md` | vollständig |
|
||
| Produkt, historisch | `Tsumugu_Product_Recovery_Baseline_v0.1.md` | nur eingeordnet; durch die Fachspec präzisiert |
|
||
| Architektur | `TSUMUGU_TECHNICAL_SPEC.md` (0.3), `ARCHITECTURE_DISCOVERY.md` | vollständig |
|
||
| Design | `docs/design/LIEFERUNG_2026-10-17.md` | vollständig. Das eigentliche Designkonzept (`C:/Dev/jinkendo-app-design-2026-10-17/…`) liegt außerhalb des Repositorys und war nicht Gegenstand des Reviews |
|
||
| Betrieb | `README.md`, `docs/DEPLOYMENT.md`, `docs/MVP_ANNAHMEN.md`, `AGENTS.md` | vollständig |
|
||
| Referenzarchitektur | A, B, C v0.3 | vollständig |
|
||
| Blueprints | Auth/Session/Scope | vollständig |
|
||
| | Medien/Dateien/sicheres Rendering | Abschnitte 1–14 vollständig, Testmatrix überblickt |
|
||
| | Release/Betrieb/Recovery | Abschnitte 1–4, 7, 10–13 vollständig, übrige überblickt |
|
||
| | KI-Gateway, Prompt/Workflow, Entitlements | Gliederung und Verträge; laut technischer Spezifikation nur Grenze, keine MVP-Pflicht |
|
||
|
||
## Gelesener Code
|
||
|
||
Vollständig gelesen: alle Backend-Module (`backend/app/**`), alle elf Migrationen, `conftest.py`, `support.py`, ausgewählte Tests, Dockerfiles, Compose-Dateien, Gitea-Workflows, `frontend/nginx.conf`, `nginx/*.conf`.
|
||
|
||
Frontend: vollständig `api.js`, `App.jsx`, `main.jsx`, `session.js`, `environment.js`, `sw.js`, `markdown.jsx`, `content-symbol.mjs`, `Login.jsx`, `Settings.jsx`, `Users.jsx`, `Rooms.jsx`. Gezielt geprüft (Rendering-Senken, Rechteanzeige, Drag-and-drop, Ansichten, Endpunktnutzung): `ReadingPane.jsx`, `content.jsx`, `Cases.jsx`, `Matters.jsx`, `Shell.jsx`, `widgets.jsx`, `ExportPackage.jsx`. `styles.css` wurde nicht inhaltlich geprüft.
|
||
|
||
## Ausgeführte Prüfungen
|
||
|
||
| Prüfung | Befehl | Ergebnis |
|
||
|---|---|---|
|
||
| Frontend-Produktionsbuild | `npx --no-install vite build --outDir %TEMP%/tsumugu-review-dist` | erfolgreich, 66 Module, kein Fehler. Ausgabe außerhalb des Repositorys |
|
||
| Frontend-Unit-Tests | `node --test src/list-meta.test.mjs` | 4 von 4 bestanden |
|
||
| Python-Syntax | `python -I -m py_compile` über alle getrackten Backend-Module | erfolgreich |
|
||
|
||
**Nicht ausgeführt:** Die Backend-Suite (`pytest`) verlangt eine PostgreSQL-Datenbank `*_test`. Im Review stand keine zur Verfügung. Die übernommenen Ergebnisse der Prüfberichte (46 bzw. 52 bestandene Tests) sind kein Nachweis dieses Reviews. Browserbedienung, Drag-and-drop, Paperless und IMAP wurden nicht live geprüft. Kein Deploy, kein Zugriff auf laufende Systeme.
|
||
|
||
## Nachweiskennzeichnung
|
||
|
||
In den Abgleichstabellen gilt:
|
||
|
||
| Kennzeichen | Bedeutung |
|
||
|---|---|
|
||
| ✅ umgesetzt | Code vorhanden und statisch nachvollzogen; wo genannt, durch einen Testfall abgedeckt |
|
||
| 🟡 teilweise | Kernfunktion vorhanden, Teile fehlen oder weichen ab |
|
||
| ❌ fehlt | nicht umgesetzt, obwohl für den jeweiligen Lieferstand gefordert |
|
||
| ⏸ zurückgestellt | laut Fachspec bewusst später; kein Mangel des Lieferstands |
|
||
| ❔ ohne Nachweis | Umsetzung wahrscheinlich, aber im Review nicht prüfbar (z. B. Browserinteraktion) |
|
||
|
||
## Schweregrade der Befunde
|
||
|
||
| Schwere | Kriterium |
|
||
|---|---|
|
||
| Kritisch | unmittelbare Gefahr für vertrauliche Daten oder Datenverlust ohne besondere Voraussetzung |
|
||
| Hoch | verletzt einen verbindlichen Vertrag (Rechte, Datenraum, Transaktion, Release, Privacy) oder führt im normalen Gebrauch zu falschem Ergebnis bzw. Datenverlust |
|
||
| Mittel | Abweichung mit begrenzter Ausnutzbarkeit, Robustheits- oder Betriebsrisiko, deutliche Funktionslücke |
|
||
| Niedrig | Qualitäts-, Konsistenz- oder Wartbarkeitsmangel ohne direkte Fehlwirkung |
|
||
| Hinweis | Beobachtung ohne Handlungszwang |
|
||
|
||
## Grenzen
|
||
|
||
- Statisches Review. Rechtsfehler wurden durch Nachvollziehen der Codepfade belegt, nicht durch Ausführen.
|
||
- Pixelgenaue Darstellungsvorgaben (Zeilenhöhen, Dreiecksgrößen, Farben) wurden nicht gemessen.
|
||
- Host-Konfiguration auf dem Raspberry Pi und dem Synology-Proxy (HSTS, Timeouts, `.env`) wurde nicht eingesehen.
|
||
- Ob die Produktion bereits echte personenbezogene Daten hält, ist dem Review nicht bekannt. Die Bewertung von R-21 hängt davon ab.
|