Files
tsumugu/docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md
LarsandCursor 060d99bda0
Deploy Development / deploy (push) Successful in 25s
Richte die Exportauswahl am bestehenden Baum aus.
Kleine Kaestchen, linksbündige Zeilen und die Inhaltssymbole machen die Auswahl lesbar. Der Pruefbericht haelt das Ergebnis der ersten Exportlieferung fest.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-17 20:19:36 +02:00

4.7 KiB
Raw Permalink Blame History

Prüfbericht – erste Exportlieferung

Stand: 17.10.2026. Nachweis zur Umsetzung von F-07a–c. Kein Push und kein Deployment.

Aufwand

Die technischen Lücken vor der Umsetzung waren real: Paperless lieferte zuerst eine Vorschau und nahm bei mehreren Zugängen den zuletzt angelegten; IMAP kürzte große Nachrichten und prüfte die Nachrichtenidentität nicht. Der geschätzte Connector-Umbau von 6–9 Tagen war der vollständige Umbau und ist nicht Bestandteil dieser Lieferung. Der hier nötige zuverlässige Inhaltsabruf samt Auswahl, Prüfung und ZIP entspricht etwa vier bis fünf Umsetzungstagen. Dieser Umfang ist lokal umgesetzt.

Bestandene Prüfungen

Die Backend-Suite tests ist auf der Wegwerfdatenbank tsumugu_export_test vollständig durchgelaufen: 46 Tests, Ergebnis grün. Darin die neuen Exportprüfungen zu Auswahl, vollständigen Anlagen, Quellenidentität, Rechten, ZIP-Struktur und Fehlerfällen. Frühere Fehlschläge auf tsumugu_local_test entstanden durch eine gleichzeitige zweite Suite auf derselben Datenbank, nicht durch die Exportlogik. Die zwei Paperless-Dateitests, die auf diesem Windows-Profil sonst am gesperrten Temp-Verzeichnis scheitern, sind in diesem Lauf mit eigenem Temp-Verzeichnis mitgelaufen und bestanden.

Bedienabnahme mit synthetischen Daten, ohne Nutzer- oder Produktionsdaten:

  • Desktop: Anmeldung, Vorgang mit zwei Kapiteln, Teilvorgang, Notizen, Dateien, Antwortbezug und einer unerreichbaren E-Mail. Alle Inhalte zunächst gewählt. Kapitel abgewählt, der Vorgang zeigt den Zwischenzustand, die Datei im Kapitel ist mit abgewählt. Dieselbe Datei wieder gewählt. Eine Notiz einzeln abgewählt. Prüfung mit der unerreichbaren E-Mail nennt die Lücke „Für diese Quelle ist kein Zugang vorhanden“ und bietet kein irreführend vollständiges Paket an. Nach Abwahl dieser E-Mail ist die Prüfung vollständig. Die Übersicht nennt die bestätigten Pfade, darunter 01 Vertrag/, 02 Schriftwechsel/schreiben.pdf und 03 Nebenpunkt/Teilnotiz.md. Die abgewählte Notiz und die unerreichbare E-Mail fehlen. „Paket herunterladen“ lieferte HTTP 200 und die Bestätigung, dass das Paket den Stand dieses Zeitpunkts festhält.
  • Schmale Breite 390 px: dieselbe Prüfansicht bleibt lesbar, die Aktionsknöpfe stehen untereinander, die Pfade umbrechen, die Bestätigung bleibt sichtbar.

Durch Tests belegte Fälle, die die Bedienabnahme nicht erneut mit echten Postfächern nachgestellt hat

Es lief kein Paperless- und kein IMAP-Server. Diese Fälle stehen in backend/tests/test_export.py und sind in der grünen Suite enthalten:

  • Ausgewählte E-Mail bleibt mit beiden Anlagen vollständig, auch wenn dasselbe Anhangsvorkommen separat abgewählt ist. Der Hinweis erscheint nur bei übereinstimmendem SHA-256, nicht beim bloßen Dateinamen.
  • Zwei gleichnamige Anlagen bleiben beide erhalten.
  • Eine Nachricht über der Exportgrenze wird als zu groß benannt. Eine gekürzte Vorschau wird nicht als vollständiges Original ausgegeben.
  • Paperless-Original kommt nur über den Download, nie über die Vorschau.
  • Fehlende Freigabe blockiert die Ausgabe. Ein verborgenes Gegenstück wird weder betitelt noch gezählt. Eine nicht auflösbare Referenz wird an dem ausgewählten Inhalt benannt.
  • Nach der Ausgabe geänderter oder neu hinzugefügter Inhalt verändert das bereits erzeugte Paket nicht und gelangt nur durch eine neue bestätigte Auswahl in eine weitere Ausgabe.

Festgehaltene Präzisierungen

  • Exportgrenze 80 MiB. Größere Originale werden als Lücke benannt.
  • Eine Webadresse ohne abrufbares Original blockiert das Paket.
  • Identität einer E-Mail-Anlage mit einem separaten Dateivorkommen ist der SHA-256 des Dateiinhalts. Das Fachmodell speichert keine Teile-Identität.
  • Genau ein passender Zugang darf verwendet werden. Mehrere Zugänge verlangen eine bewusste Zuordnung. Ein beliebiger zuletzt angelegter Zugang wird nicht gewählt.
  • Eine verschobene IMAP-Nachricht darf nur verwendet werden, wenn die Message-ID genau einen Treffer hat.
  • Leere Kapitel erscheinen nicht im Baum. Querverweise sind keine Eltern und wählen ihre Ziele nicht mit aus.
  • Tiefere Teilvorgänge als die bestehende Rechteebene werden nicht neu freigegeben.
  • Das Paket wird nicht auf dem Server gespeichert. Die Ausgabe ist die heruntergeladene Datei.
  • Lesefassung und Original bleiben unterscheidbar. Die bestehende Leseansicht ist unverändert.

Verbleibende Grenzen

Finanzfunktionen, der vollständige Connector-Umbau, gespeicherte Auswahlen und der Vergleich zweier Ausgaben sind nicht Teil dieser Lieferung. Ein Empfänger erhält keine Quellenzugangsdaten. Die Bedienabnahme hat die E-Mail-Vollständigkeit nicht gegen ein lebendes Postfach wiederholt; dafür gilt die genannte Testsuite.