Files
tsumugu/docs/review/01_METHODIK_UND_QUELLEN.md
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

4.8 KiB
Raw Permalink Blame History

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.