4.8 KiB
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.