Files
tsumugu/docs/review/07_TESTS_UND_CI.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

5.2 KiB
Raw Permalink Blame History

07 – Tests und CI

1. Bestand

Datei Tests Schwerpunkt
test_accounts.py 2 401 ohne Session; Bootstrap einmalig, Betreiber legt Konten an
test_boundary.py 8 Testdatenbank-Wächter, unbekannte Umgebung, Seed nie auf Dev/Prod, Produktion verweigert SEED_DEMO, Import ohne DB, kleine Health-Antwort, Runtime-Rolle ohne DDL, Fixture-Bereinigung
test_chapters.py 4 flache Bestandskapitel, drei Ebenen, Mehrfacheinordnung, Umhängen, Auflösen, Zyklen, Tiefe 32, Teilvorgangskapitel
test_direction.py 4 Richtung je Einbindung, bewusstes Leeren, keine Ableitung aus Daten, Umbenennen/Verschieben
test_element_title.py 1 Titel ändern
test_export.py 5 Anlagenidentität, Paperless-Original statt Vorschau, Auswahl, Lücken und verborgene Gegenstücke, verschachtelter Export
test_mailboxes.py 5 Fächer, Seiten, fremdes Postfach, übergroße Nachricht, vollständige Übernahme
test_order.py 13 Datums- und eigene Ordnung, Positionen je Container, Kapitel und Vorgänge, Verlauf ≠ Audit, Reorder-Rechte, Breadcrumbs, Vorschau-Rechte
test_paperless_files.py 2 Archivlesen, Pfadausbruch
test_references.py 1 Bezug und Lücke
test_rights.py 7 Manager liest nichts Persönliches, T-ISO, T-SHARE, T-CONTEXT, T-DETACH, T-GRANT, Vorgang in zwei Akten
test_tracking.py 2 T-DL, T-ANCHOR-01
Backend gesamt 54
frontend/src/list-meta.test.mjs 4 Metadatenzeile der Liste (Node Test Runner)

Die Tests arbeiten über HTTP mit echtem PostgreSQL und echten Cookies. Das entspricht B4: keine SQLite-Attrappe, keine Allow-all-Schalter. Positiv: Negativfälle für Rechte und Konflikte sind breit vorhanden.

2. Ergebnis in diesem Review

Prüfung Ergebnis
Backend-Suite nicht ausgeführt: keine PostgreSQL-Instanz verfügbar
Frontend-Build erfolgreich
list-meta.test.mjs 4/4 bestanden
py_compile erfolgreich

Übernommene Angaben: Der Unterkapitel-Prüfbericht nennt 52 bestandene Tests auf e438026. Seitdem kamen zwei Commits hinzu. Ein aktueller Lauf liegt dem Review nicht vor.

3. Lücken gegenüber den geplanten Nachweisen

Technische Spezifikation 8.1

Alle Nachweise des ersten Schnitts sind vorhanden (siehe 04, Abschnitt 6). T-DETACH-01 prüft nur den Positivfall; der Gegenfall „fremde Einbindung über eigenen Kontext“ fehlt (R-02).

Fehlende Negativtests zu den Befunden

Befund Fehlender Test
R-01 Bearbeiter löscht Akte bzw. Vorgang → 403
R-02 Detach und Anmerkung mit Einbindung aus fremdem Kontext → 404
R-07 Vorgangsausnahme remove_read im Aktenkontext → Datei, Notiz und Referenz des Vorgangs 404
R-11 Mehr als 200 offene Fremdaufgaben → eigene Aufgabe bleibt in der Übersicht
R-12 Verschieben unter einen Teilvorgang bzw. mit eigenen Teilvorgängen → 422
R-13 Globales Löschen eines Bezugsziels → Export weiter möglich, kein Hinweis
R-15 Frist eines Teilvorgangs im Elternkontext lesbar
R-23 Commit-Fehler ergibt keinen 2xx

Auth-Blueprint 14

Die Pflichtmatrix S01–S08, B01–B08, A01–A02, P01–P05, R01–R06, M01–M11 ist nur zu einem kleinen Teil abgedeckt (401 ohne Session, Originprüfung implizit, Runtime ohne DDL). Es fehlen insbesondere: Cookie-Attribute (B01), fremder Origin und Suffixtricks (B02), CSRF anderer Session (B03), Fristen und Ablauf (S03), Logout mit falschem CSRF (S06), konkurrierende Logins und Rotation (R01–R03).

Frontend

Keine Komponenten- oder Browsertests (A9/B4 sieht Vitest und wenige Playwright-Läufe vor). Drag-and-drop, Scopewechsel mit verspäteter Antwort und Dirty-Form-Schutz sind nicht automatisiert geprüft. list-meta.test.mjs ist nicht in package.json registriert und läuft nicht in CI.

4. CI-Workflows

Workflow Beobachtung Bewertung
deploy-dev.yml Checkout, .env anlegen, build --no-cache, up --wait, Health-Smoke funktioniert als Dev-Pfad; keine Artefaktkennung
deploy-prod.yml wie Dev, ausgelöst durch Push auf main; keine Tests, kein Backup vor Migration verletzt ADR-11 und den Release-Blueprint (R-21)
test.yml Auslöser Push und workflow_run nach dem Dev-Deploy → zwei Läufe je Push; beide verwerfen und erzeugen tsumugu_test neu; Pytest im laufenden Backend-Image mit pip install; Frontend-Build im Deploy-Verzeichnis Doppellauf und gemeinsame DB machen Ergebnisse unzuverlässig (R-27)

Positiv: Der Workflow schreibt nie in tsumugu_dev oder tsumugu; der Wächter in conftest.py verweigert andere Datenbanknamen; der Live-Smoke ist rein lesend.

5. Empfehlungen

  1. test.yml auf einen Auslöser reduzieren, Concurrency-Gruppe setzen und Testdatenbanken je Lauf benennen (tsumugu_test_<run>).
  2. Pytest gegen das gebaute Image ausführen; Testwerkzeuge in einem getrennten Testimage.
  3. npm test mit node --test registrieren und in CI ausführen.
  4. Negativtests aus Abschnitt 3 ergänzen, bevor die Befunde behoben werden. So wird der Fehler zuerst sichtbar und danach die Korrektur belegt.
  5. Ein Gate vor deploy-prod: Testlauf grün für exakt den Tree von main.