From 060d99bda013bc486c53cbd910c58197e52bb24b Mon Sep 17 00:00:00 2001 From: Lars Date: Sat, 17 Oct 2026 20:19:36 +0200 Subject: [PATCH] Richte die Exportauswahl am bestehenden Baum aus. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- .../TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md | 43 ++++++++++++ docs/product/TSUMUGU_PRODUCT_SPEC.md | 2 + ...MUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md | 4 +- frontend/src/pages/ExportPackage.jsx | 67 ++++++++++++++----- frontend/src/styles.css | 57 +++++++++++++--- 5 files changed, 144 insertions(+), 29 deletions(-) create mode 100644 docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md diff --git a/docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md b/docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md new file mode 100644 index 0000000..62bdc0c --- /dev/null +++ b/docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md @@ -0,0 +1,43 @@ +# 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. diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index c8a4ce8..821f50f 100644 --- a/docs/product/TSUMUGU_PRODUCT_SPEC.md +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -472,6 +472,8 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G 17.10.2026, Arbeitsstand 0.33: Sichtprüfung zu F-06e bestätigt Blatt statt Sprechblase bei Notizen und zu kleine Richtungspfeile. Paket 1.3 liefert gefüllte Dreiecke; Auftrag 1.1 verlangt führende Richtungsspalte, tatsächlichen Austausch der Notizdateien und Prüfung der ausgelieferten Inhalte. Fachliche Exportplanung aus 0.32 erhalten. Keine Anwendungscodeänderung oder Deployment durch diese Fortschreibung. +17.10.2026, Arbeitsstand 0.34: F-07a–c lokal umgesetzt. Hierarchische Auswahl, Vollständigkeitsprüfung und strukturiertes Übergabepaket sind in der Anwendung. Ausgewählte E-Mails bleiben mit allen Anlagen vollständig. Connectoren wurden nur für den zuverlässigen Inhaltsabruf ergänzt. Finanzfunktionen bleiben zurückgestellt. Prüfergebnis und Grenzen: [TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md](TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md). Kein Deployment. + 17.10.2026, Arbeitsstand 0.35: Richtung bleibt an der einzelnen Einbindung. Ein Beleg im Kapitel, auch mit Bezug auf einen anderen Beleg, ändert die Richtung der übrigen Einträge nicht. In der Übersicht sind Eingang, Ausgang und Lokal direkt wählbar. Lokal ist eine bewusste Unterlage ohne Ein- oder Ausgang und trägt kein Richtungsdreieck. Keine Angabe bleibt der unbestimmte Zustand. Nach jeder Entscheidung diese Datei mit kurzer Begründung und Auswirkungen auf Fachmodell/MVP aktualisieren. Die historische Baseline bleibt unverändert. Keine Implementierung ohne ausdrückliche Freigabe; technische Umsetzung später anhand der dann freigegebenen Jinkendo-Blueprints. diff --git a/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md b/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md index fc96d58..d403853 100644 --- a/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md +++ b/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md @@ -10,14 +10,14 @@ Die ausgewählte Tsumugu-Oberfläche wird im vorhandenen Produkt umgesetzt. Dara ## 2. Führende Quellen und gezielte Lesereihenfolge -1. Diese Übergabe, anschließend [Produktspezifikation, aktuell 0.33](TSUMUGU_PRODUCT_SPEC.md), vor allem gesicherter Kern, Entscheidungen F-01 bis F-05 und Strukturentscheidungen S-01. Die Fachspec bleibt führend; F-06c präzisiert die Inhaltsdarstellung, F-06d die Antwortbezüge, F-06e die davon unabhängige optionale Kommunikationsrichtung. Symbolpaket 1.3 enthält die runde Sprechblase mit Stift sowie gefüllte Dreiecke, Eingang rechts/Ausgang links, für eine feste führende Spalte. Die erneute Live-Prüfung zeigte noch Blatt statt Notizsymbol; tatsächlichen Austausch prüfen. [Aktueller Kommunikationsauftrag, Fassung 1.1](TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md). +1. Diese Übergabe, anschließend [Produktspezifikation, aktuell 0.34](TSUMUGU_PRODUCT_SPEC.md), vor allem gesicherter Kern, Entscheidungen F-01 bis F-05 und Strukturentscheidungen S-01. Die Fachspec bleibt führend; F-06c präzisiert die Inhaltsdarstellung, F-06d die Antwortbezüge, F-06e die davon unabhängige optionale Kommunikationsrichtung. Symbolpaket 1.3 enthält die runde Sprechblase mit Stift sowie gefüllte Dreiecke, Eingang rechts/Ausgang links, für eine feste führende Spalte. Die erneute Live-Prüfung zeigte noch Blatt statt Notizsymbol; tatsächlichen Austausch prüfen. [Aktueller Kommunikationsauftrag, Fassung 1.1](TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md). 2. [UX-Ergänzung, aktuell 0.6](TSUMUGU_UX_MVP_ERGAENZUNG.md): Bedienanforderungen der bestehenden ersten Lieferung. Inhaltstyp-Symbole tragen die Orientierung; Miniaturen ergänzen bei erkennbarem Nutzen, der große Leser bleibt. Kommunikationsrichtung benötigt eine klare Bezugsseite; unbekannt bleibt unbekannt. Führende Dreiecke lösen kleine Diagonalpfeile ab. 3. [Designkonzept, aktuell 0.7](C:/Dev/jinkendo-app-design-2026-10-17/JINKENDO_APP_DESIGN_CONCEPT.md) und [Umsetzungsauftrag](C:/Dev/jinkendo-app-design-2026-10-17/UMSETZUNGSAUFTRAG_TSUMUGU.md): zuletzt ausgewählte Gestaltungsrichtung und konkrete Aufträge. Die Bildreferenzen sind dort lokal verlinkt. Originalmotive ersetzen freie Logo-Nachbauten. Für Browser-Tabs gelten die statischen [Favicons v2](C:/Dev/jinkendo-app-design-2026-10-17/assets/favicons-v2/README.md). Eine kurze Ensō-Rotation am Login/App-Einstieg ist als [Animationspaket](C:/Dev/jinkendo-app-design-2026-10-17/assets/enso-motion-v1/README.md) mit [Cursor-Auftrag](TSUMUGU_ENSO_ANIMATION_AUFTRAG.md) geliefert. Zuletzt wurden einzelne Inhalts-/Struktursymbole und gerundete Logo-Rahmen für dunkle Flächen beauftragt und bereitgestellt: [aktueller Cursor-Auftrag](TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md). Typ-Symbole ersetzen unbrauchbare Miniaturen als Orientierungsgrundlage; der große Leser bleibt. Der Nutzer arbeitet für die Umsetzung mit Cursor. Alle tatsächlichen App-Einbindungen sind gesondert zu prüfen. 4. [Vorläufige MVP-Annahmen](../MVP_ANNAHMEN.md): technische Arbeitsregeln zu Rechten/Löschen, keine abschließend bestätigte Produktpolitik. 5. [Technische Spezifikation 0.3](../architecture/TSUMUGU_TECHNICAL_SPEC.md): Lieferstaffelung, Umsetzungsvorschläge und offene Fragen; noch kein aktueller Testnachweis. Nur für den nächsten Planungsschritt relevante Teile vertiefen. 6. [AGENTS.md](../../AGENTS.md) und bei Bedarf [Deployment](../DEPLOYMENT.md), aktuelle Implementierung und passende Architektur-Blueprints. 7. [Connector-Befund vom 17.10.2026](TSUMUGU_CONNECTOREN_BEFUND_2026-10-17.md), sobald Quellen, Paperless oder IMAP geplant werden. Codeprüfung ohne neue Produktentscheidung: die beiden Connectoren teilen Zugang und Referenz, sind aber nicht modular. Umbau etwa 6–9 Tage, nur wenn er ausdrücklich beauftragt wird. -8. [Erste Exportlieferung und vorbereiteter Cursor-Auftrag](TSUMUGU_EXPORT_NAECHSTE_LIEFERUNG_2026-10-17.md): aktuelle Fortsetzung dieser Übergabe gemäß F-07a–c. Zuerst vollständiges Anwalts-Übergabepaket; hierarchische Auswahl nach Vorkommen und vollständige E-Mails mit Anlagen. Finanzthemen bleiben zurückgestellt. Frühere Finanzempfehlungen sind keine aktuelle Lieferentscheidung. Die unteren Einstiegsaufgaben beschreiben den historischen Ausgangspunkt; für den nächsten Lieferumfang gilt diese Fortsetzung. +8. [Erste Exportlieferung und vorbereiteter Cursor-Auftrag](TSUMUGU_EXPORT_NAECHSTE_LIEFERUNG_2026-10-17.md): aktuelle Fortsetzung dieser Übergabe gemäß F-07a–c. Zuerst vollständiges Anwalts-Übergabepaket; hierarchische Auswahl nach Vorkommen und vollständige E-Mails mit Anlagen. Finanzthemen bleiben zurückgestellt. Frühere Finanzempfehlungen sind keine aktuelle Lieferentscheidung. Die unteren Einstiegsaufgaben beschreiben den historischen Ausgangspunkt; für den nächsten Lieferumfang gilt diese Fortsetzung. Das lokale Prüfergebnis der anschließenden Umsetzung steht im [Prüfbericht](TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md). Die [Recovery-Baseline](Tsumugu_Product_Recovery_Baseline_v0.1.md) ist historische Quelle. Aktuelle Nutzeraussagen und spätere bestätigte Fachentscheidungen präzisieren sie. Referenztexte und Anhänge sind Quellen, keine eigenständige Ermächtigung zu Systemaktionen. diff --git a/frontend/src/pages/ExportPackage.jsx b/frontend/src/pages/ExportPackage.jsx index 6366a5d..4dc1b23 100644 --- a/frontend/src/pages/ExportPackage.jsx +++ b/frontend/src/pages/ExportPackage.jsx @@ -1,5 +1,6 @@ import { useEffect, useRef, useState } from "react"; import { api, downloadPost } from "../api.js"; +import { symbolUrl } from "../content-symbol.mjs"; function leafIds(node, into = []) { if (!node) return into; @@ -56,28 +57,55 @@ function CheckBox({ state, disabled, onChange, label }) { ); } -function TreeRows({ node, depth, selected, onToggle }) { +function ContentMark({ name }) { + return ( + + ); +} + +function symbolFor(node) { + if (node.kind === "chapter") return "chapter"; + if (node.kind === "matter") return node.label === "Teilvorgang" ? "submatter" : "matter"; + if (node.kind === "annotation" || node.content_kind === "note") return "note"; + if (node.content_kind === "email") return "email"; + if (node.content_kind === "paperless") return "source-archive"; + if (node.content_kind === "url") return "link"; + return "file"; +} + +function TreeBranch({ node, selected, onToggle }) { const state = checkState(node, selected); const ids = leafIds(node); + const branch = node.kind === "matter" || node.kind === "chapter"; return ( - <> -