# 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.