Files
tsumugu/docs/review/01_METHODIK_UND_QUELLEN.md
T
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

66 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.