Halte Anlagen und Versand als eigene Verwendung fest, damit die uebermittelte Fassung und ihre Nachweise spaeter nicht still mit der Arbeitsfassung verschmelzen.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
f21c64a944
commit
3c190c87b4
27 files changed
+3953
-71
No files matched your search
@@ -0,0 +1,195 @@
|
||||
# Tsumugu – API-Referenz (Ist-Stand)
|
||||
|
||||
**Stand:** 18.10.2026. Erstellt im Code-Review aus `backend/app/main.py`, `api/routes.py`, `api/sources.py`, `api/export.py` und `api/correspondence.py`.
|
||||
|
||||
Diese Datei beschreibt die tatsächlich registrierten Endpunkte. Die Sollfassung steht in der [technischen Spezifikation, Abschnitt 6.2](TSUMUGU_TECHNICAL_SPEC.md). OpenAPI ist in allen Umgebungen abgeschaltet (`docs_url=None`, `openapi_url=None`). Diese Datei ist deshalb die einzige Übersicht. Sie wird bei jeder Routenänderung mitgepflegt.
|
||||
|
||||
## Gemeinsame Regeln
|
||||
|
||||
| Thema | Regel im Code |
|
||||
|---|---|
|
||||
| Sitzung | Cookie `__Host-jinkendo-session` (Produktion, HTTPS) bzw. `jinkendo-session` (Development über HTTP). Gültigkeit `SESSION_TTL_HOURS`, Default 336 h |
|
||||
| Schreibschutz | Alle Methoden außer GET/HEAD/OPTIONS unter `/api/` verlangen einen `Origin` aus `ALLOWED_ORIGINS` (Middleware) und den Header `X-CSRF-Token` der Session |
|
||||
| Datenraum | Fachrouten verlangen `X-Scope-Kind` (`personal` oder `organization`) und `X-Scope-Id`. Beide müssen mit dem in der Session bestätigten Raum übereinstimmen, die Mitgliedschaft wird je Request geprüft |
|
||||
| Handlungskontext | Lesend als Query `context_kind` und `context_id` (`case`/`matter` + UUID), schreibend als `context: {kind, id}` im JSON. Ohne Kontext gelten nur Owner und direkte Grants |
|
||||
| Eingaben | JSON ohne unbekannte Felder (`extra="forbid"`); Upload als Multipart |
|
||||
| Fehler | `application/problem+json` mit `type`, `title`, `status`, `detail`, `instance`, `code`. 401 keine Session, 403 fehlendes Recht bei sichtbarem Objekt, 404 unsichtbar oder nicht vorhanden, 409 Versionskonflikt, 422 ungültige Eingabe, 429 Login-Begrenzung, 503 Speicher nicht verfügbar |
|
||||
| Versionen | Ändernde Aufrufe tragen `expected_version` des geänderten Ankers (Akte, Vorgang, Element, Aufgabe, Frist). Kapitel- und Ordnungsänderungen erhöhen die Version des Behälters |
|
||||
| Listen | Antwort `{items, next_cursor}`. `next_cursor` ist außer in der Chronologie immer `null` |
|
||||
|
||||
Legende Spalte „Auth“: **–** öffentlich, **S** gültige Session, **S+R** Session und Datenraum-Header, **B** Betreiber (`is_superadmin`), **M** Verwalter des Raums. Alle Tabellen ohne Spalte „Auth“ verlangen **S+R**; die Objektrechte prüft danach die Rechteauswertung ([RECHTEMODELL_IST.md](RECHTEMODELL_IST.md)).
|
||||
|
||||
## Betrieb
|
||||
|
||||
| Methode | Pfad | Auth | Zweck |
|
||||
|---|---|---|---|
|
||||
| GET | `/api/health` | – | `{status, app}`; 503 bei DB-Fehler |
|
||||
| GET | `/health/live` | – | Prozess lebt |
|
||||
| GET | `/health/ready` | – | DB antwortet |
|
||||
|
||||
## Anmeldung, Session, Konten
|
||||
|
||||
| Methode | Pfad | Auth | Zweck |
|
||||
|---|---|---|---|
|
||||
| POST | `/api/v1/auth/login` | – | E-Mail, Passwort → Session-Sicht und Cookie. 8 Versuche je IP+E-Mail in 10 min (Prozessspeicher) |
|
||||
| POST | `/api/v1/auth/logout` | S | Session widerrufen, Cookie löschen, 204 |
|
||||
| GET | `/api/v1/auth/session` | S | Konto, bestätigter Datenraum, Räume, CSRF-Token, Epoche |
|
||||
| POST | `/api/v1/auth/session/scope` | S | Datenraum wechseln (`kind`, `id`); erhöht die Epoche |
|
||||
| GET | `/api/v1/auth/bootstrap` | – | `{available: true}`, solange kein Betreiber existiert, sonst 404 |
|
||||
| POST | `/api/v1/auth/bootstrap` | – | erstes Konto als Betreiber anlegen, nur ohne vorhandenen Betreiber |
|
||||
| GET | `/api/v1/auth/demo` | – | Beispielkonten; nur Development mit Datenbank `*_test` und `SEED_DEMO=true`, sonst 404 |
|
||||
| GET | `/api/v1/accounts` | S+R, B | aktive Betreiberkonten (`origin='operator'`) |
|
||||
| POST | `/api/v1/accounts` | S+R, B | Konto mit Passwort anlegen, erhält persönlichen Raum |
|
||||
| GET | `/api/v1/principals?email=` | S+R | aktives Konto per E-Mail auflösen (ID, Anzeigename) |
|
||||
| POST | `/api/v1/invitations` | S+R, M | Einladung in einen gemeinsamen Raum; Antwort enthält das Token einmalig. Keine Oberfläche |
|
||||
| POST | `/api/v1/invitations/{id}/accept` | – | Token, Anzeigename, Passwort → Konto, Mitgliedschaft, Session |
|
||||
|
||||
## Datenräume
|
||||
|
||||
| Methode | Pfad | Auth | Zweck |
|
||||
|---|---|---|---|
|
||||
| GET | `/api/v1/rooms` | S+R | wählbare Räume |
|
||||
| POST | `/api/v1/rooms` | S+R | gemeinsamen Raum anlegen, Anlegende Person wird Verwalter |
|
||||
| GET | `/api/v1/rooms/{id}/members` | S+R, M | Mitglieder |
|
||||
| POST | `/api/v1/rooms/{id}/members` | S+R, M | bestehendes Konto als `member` oder `manager` aufnehmen |
|
||||
| DELETE | `/api/v1/rooms/{id}/members/{subject_id}` | S+R, M | Mitgliedschaft beenden; letzter Verwalter bleibt. Keine Oberfläche |
|
||||
|
||||
## Akten
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| GET | `/api/v1/cases` | lesbare Akten und Unterakten |
|
||||
| POST | `/api/v1/cases` | Akte anlegen (`title`, optional `parent_case_id`, `rights_mode`, `home_scope_id`) |
|
||||
| GET | `/api/v1/cases/{id}` | Akte mit Trail, Kapiteln, Unterakten, Vorgangsbaum, direkten Einbindungen, `contained` (Inhalte zugeordneter Vorgänge), Aufgaben, Fristen, Grants (für Freigebende) |
|
||||
| PATCH | `/api/v1/cases/{id}` | Titel, Status `open`/`closed` |
|
||||
| POST | `/api/v1/cases/{id}/delete` | Akte löschen (`deleted_at`); nur ohne Unterakten und Vorgangszuordnungen. Verlangt `edit` (siehe Review R-01) |
|
||||
| POST | `/api/v1/cases/{id}/grants` | Grant per E-Mail (`can_read`, `can_edit`, `can_share`) |
|
||||
| POST | `/api/v1/cases/{id}/chapters` | Kapitel anlegen, optional `parent_chapter_id`, `document_on` |
|
||||
| POST | `/api/v1/cases/{id}/chapters/order` | Geschwisterreihenfolge |
|
||||
| PATCH | `/api/v1/cases/{id}/content-order` | Ordnungsart `date`/`position`, Richtung |
|
||||
| POST | `/api/v1/cases/{id}/bindings/order` | eigene Reihenfolge der sichtbaren Einbindungen |
|
||||
| POST | `/api/v1/cases/{id}/bindings/chapters` | mehrere Einbindungen in ein Kapitel |
|
||||
| GET | `/api/v1/cases/{id}/course` | fachlicher Verlauf |
|
||||
| GET | `/api/v1/cases/{id}/chronology?cursor=` | Änderungsprotokoll, 40 Einträge je Seite |
|
||||
|
||||
## Vorgänge
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| GET | `/api/v1/matters` | lesbare Vorgänge mit lesbaren Kontexten |
|
||||
| POST | `/api/v1/matters` | Vorgang oder Teilvorgang (`parent_matter_id`, `context`) |
|
||||
| GET | `/api/v1/matters/{id}` | Vorgang mit Trail, Zuordnungen (`placements`, `case_links`), Teilvorgängen, Querverweisen, Einbindungen, Aufgaben, Fristen |
|
||||
| PATCH | `/api/v1/matters/{id}` | Titel, Status |
|
||||
| POST | `/api/v1/matters/{id}/delete` | Vorgang löschen; nur ohne Teilvorgänge. Verlangt `edit` (Review R-01) |
|
||||
| POST | `/api/v1/matters/{id}/move` | Akte wechseln (`case_id`), Elternvorgang setzen oder lösen |
|
||||
| POST | `/api/v1/matters/{id}/case-links` | Akte zuordnen; Freigaberecht am Vorgang und Bearbeitungsrecht an der Akte |
|
||||
| DELETE | `/api/v1/matter-case-links/{id}` | Zuordnung lösen |
|
||||
| POST | `/api/v1/matters/{id}/cross-links` | Querverweis (`target_matter_id`, `target_context`) |
|
||||
| DELETE | `/api/v1/matter-cross-links/{id}` | Querverweis lösen |
|
||||
| POST | `/api/v1/matters/{id}/grants` | Grant am Vorgang |
|
||||
| POST | `/api/v1/matters/{id}/chapters` | Kapitel (Kontext als Query) |
|
||||
| POST | `/api/v1/matters/{id}/chapters/order` | Geschwisterreihenfolge |
|
||||
| PATCH | `/api/v1/matters/{id}/content-order` | Ordnungsart |
|
||||
| POST | `/api/v1/matters/{id}/bindings/order` | eigene Reihenfolge |
|
||||
| POST | `/api/v1/matters/{id}/bindings/chapters` | mehrere Einbindungen in ein Kapitel |
|
||||
| GET | `/api/v1/matters/{id}/course` | fachlicher Verlauf |
|
||||
| GET | `/api/v1/matters/{id}/chronology?cursor=` | Änderungsprotokoll |
|
||||
|
||||
## Kapitel
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| PATCH | `/api/v1/chapters/{id}` | Kapiteldatum |
|
||||
| PATCH | `/api/v1/chapters/{id}/title` | umbenennen |
|
||||
| POST | `/api/v1/chapters/{id}/parent` | umhängen, `parent_chapter_id: null` = oberste Ebene |
|
||||
| POST | `/api/v1/chapters/{id}/delete` | auflösen; Inhalte und Kinder rücken eine Ebene nach oben |
|
||||
|
||||
## Inhalte und Einbindungen
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| POST | `/api/v1/notes` | Notiz mit Einbindung (`context`, optional `placement`, `chapter_id`, `dates`, `communication_direction`) |
|
||||
| PATCH | `/api/v1/notes/{id}` | gemeinsamen Text ändern; Antwort mit `visible_bindings` und `notice` |
|
||||
| POST | `/api/v1/files` | Datei hochladen (Multipart: `title`, `context_kind`, `context_id`, `upload`, optional Platzierung, Kapitel, Daten, Richtung); PDF, PNG, JPEG, WebP bis 20 MiB |
|
||||
| GET | `/api/v1/files/{id}/content` | Datei als `attachment`, `no-store` |
|
||||
| POST | `/api/v1/external-refs` | externe Referenz (`paperless`, `imap`, `url`) mit `detail` |
|
||||
| POST | `/api/v1/sources/link` | wie oben, nur `paperless`/`imap` (doppelter Weg, siehe Connectoren-Befund) |
|
||||
| GET | `/api/v1/elements` | eigene, nicht eingebundene Elemente (max. 100) |
|
||||
| POST | `/api/v1/elements/{id}/delete` | überall löschen; nur Element-Owner |
|
||||
| PATCH | `/api/v1/elements/{id}/title` | Titel |
|
||||
| PATCH | `/api/v1/elements/{id}/summary` | Kurzbeschreibung (≤ 400 Zeichen) |
|
||||
| PATCH | `/api/v1/elements/{id}/dates` | Dokument-, Versand-, Zugangsdatum |
|
||||
| POST | `/api/v1/elements/{id}/references` | Bezug auf eine andere Unterlage (zyklusfrei) |
|
||||
| DELETE | `/api/v1/elements/{id}/references/{target}` | Bezug lösen |
|
||||
| POST | `/api/v1/bindings` | Element in weiteren Kontext einbinden (`share` an der Quelle, `edit` am Ziel) |
|
||||
| DELETE | `/api/v1/bindings/{id}` | Einbindung lösen |
|
||||
| PATCH | `/api/v1/bindings/{id}/chapter` | Kapitel einer Einbindung |
|
||||
| PATCH | `/api/v1/bindings/{id}/communication` | Richtung `in`/`out`/`local`/`null` |
|
||||
| POST | `/api/v1/bindings/{id}/annotations` | kontextbezogene Anmerkung |
|
||||
| PUT | `/api/v1/exceptions` | Kontextausnahme am Element, Vorgang, Aufgabe oder Frist setzen bzw. löschen; nur Owner |
|
||||
| DELETE | `/api/v1/grants/{id}` | Grant entziehen |
|
||||
|
||||
## Aufgaben, Fristen, Übersichten, Suche
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| POST | `/api/v1/tasks` | Aufgabe, optional mit Vorgang und Kontext |
|
||||
| PATCH | `/api/v1/tasks/{id}` | Titel, Arbeitstermin, Status `open`/`done` |
|
||||
| POST | `/api/v1/tasks/{id}/assignee` | zuweisen (E-Mail) oder lösen; legt begrenztes Grant an. Keine Oberfläche |
|
||||
| POST | `/api/v1/tasks/{id}/deadline-links` | Frist verknüpfen |
|
||||
| PUT | `/api/v1/tasks/{id}/elements` | verknüpfte Inhalte ersetzen (max. 40) |
|
||||
| POST | `/api/v1/tasks/{id}/dependencies` | Abhängigkeit von anderer Aufgabe (zyklusfrei) |
|
||||
| DELETE | `/api/v1/tasks/{id}/dependencies/{other}` | Abhängigkeit lösen |
|
||||
| POST | `/api/v1/deadlines` | Frist |
|
||||
| PATCH | `/api/v1/deadlines/{id}` | Titel, Datum |
|
||||
| POST | `/api/v1/deadlines/{id}/fulfill` | als erfüllt kennzeichnen |
|
||||
| GET | `/api/v1/views/open-tasks` | offene sichtbare Aufgaben (siehe Review R-11) |
|
||||
| GET | `/api/v1/views/open-deadlines` | offene sichtbare Fristen (siehe Review R-11) |
|
||||
| GET | `/api/v1/views/recent-matters` | acht zuletzt geänderte sichtbare Vorgänge |
|
||||
| GET | `/api/v1/placement-targets` | bearbeitbare Akten und Vorgänge als Ziele |
|
||||
| GET | `/api/v1/search?q=` | Akten, Vorgänge, Elemente (Titel und Notiztext), max. 50 |
|
||||
|
||||
## Quellen
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| GET | `/api/v1/connectors` | eigene Zugänge ohne Secret |
|
||||
| POST | `/api/v1/connectors` | Paperless (überschreibt den vorhandenen) oder IMAP anlegen |
|
||||
| DELETE | `/api/v1/connectors/{id}` | Zugang löschen |
|
||||
| POST | `/api/v1/connectors/{id}/probe` | Zugang prüfen |
|
||||
| GET | `/api/v1/sources/paperless/documents?q=` | Paperless-Suche (letzter eigener Zugang) |
|
||||
| GET | `/api/v1/sources/imap/mailboxes?connector_id=` | IMAP-Fächer |
|
||||
| GET | `/api/v1/sources/imap/messages?connector_id=&mailbox=&q=&before=` | Nachrichtenliste, 30 je Seite |
|
||||
| GET | `/api/v1/sources/imap/message?connector_id=&mailbox=&uid=` | Vorschau vor dem Übernehmen |
|
||||
| GET | `/api/v1/external-refs/{id}/content` | Paperless-Datei zum Ansehen (`inline`) |
|
||||
| GET | `/api/v1/external-refs/{id}/mail` | vollständige E-Mail als JSON, Identität per Message-ID geprüft |
|
||||
| GET | `/api/v1/external-refs/{id}/mail/original` | EML |
|
||||
| GET | `/api/v1/external-refs/{id}/mail/attachments/{index}` | Anlage (`inline`, siehe Review R-03) |
|
||||
|
||||
Quelleninhalte werden mit den Zugängen der **anfragenden** Person geladen (Review R-10).
|
||||
|
||||
## Übergabepaket
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| GET | `/api/v1/matters/{id}/export-tree` | Auswahlbaum mit `exportable` und Grund |
|
||||
| POST | `/api/v1/matters/{id}/export/review` | Prüfung: `ready`, `issues`, `notices`, `entries` mit Paketpfaden |
|
||||
| POST | `/api/v1/matters/{id}/export` | ZIP nur bei `ready`; Audit `export_created`. Knoten `attachment`, `dispatch-item` und `evidence` gehören zur Auswahl |
|
||||
|
||||
## Anlagen und Versand
|
||||
|
||||
Alle schreibenden Aufrufe prüfen den Handlungskontext, `expected_version` und den Behälter (`placement`, sonst der Kontext). Fremde oder unlesbare IDs antworten mit 404. Ohne Bearbeitungsrecht mit 403.
|
||||
|
||||
| Methode | Pfad | Zweck |
|
||||
|---|---|---|
|
||||
| POST | `/api/v1/elements/{id}/attachments` | Anlagen zuordnen, optional nur als Anlagenansicht |
|
||||
| POST | `/api/v1/elements/{id}/attachments/order` | Reihenfolge |
|
||||
| POST | `/api/v1/elements/{id}/attachments/{attachment_id}/detach` | nur diese Zuordnung lösen |
|
||||
| PATCH | `/api/v1/bindings/{id}/fold` | Vorkommen als Anlage, Nachweis oder wieder eigenständig |
|
||||
| POST | `/api/v1/elements/{id}/dispatches` | Versand dokumentieren und Fassung sichern oder als Lücke kennzeichnen |
|
||||
| POST | `/api/v1/dispatches/{id}/evidence` | Nachweis ergänzen |
|
||||
| POST | `/api/v1/dispatches/{id}/correct` | Weg, Datum oder Gegenüber berichtigen |
|
||||
| GET | `/api/v1/dispatches/{id}` | Manifest, Nachweise, Berichtigungen |
|
||||
| GET | `/api/v1/dispatches/{id}/items/{item_id}/content` | gesicherte Bytes; eine Lücke liefert 404 und nicht die aktuelle Datei |
|
||||
|
||||
Eingabe für beide POST-Aufrufe: `{context, selected: [Knoten-IDs], assignments: {Knoten-ID: connector_id}}`.
|
||||
@@ -0,0 +1,114 @@
|
||||
# Tsumugu – Datenmodell (Ist-Stand)
|
||||
|
||||
**Stand:** 18.10.2026, nach den Migrationen in `backend/migrations/` (letzte: `20261018T090000Z_correspondence.sql`). Erstellt im Code-Review.
|
||||
|
||||
Die Sollfassung steht in der [technischen Spezifikation, Abschnitt 4](TSUMUGU_TECHNICAL_SPEC.md). Diese Datei beschreibt, was tatsächlich angelegt ist. Bei jeder neuen Migration nachziehen.
|
||||
|
||||
## Migrationsverfahren
|
||||
|
||||
- Dateien `YYYYMMDDTHHMMSSZ_name.sql`, lexikalisch sortiert.
|
||||
- Ledger `schema_migrations(version, checksum, applied_at)`; eine geänderte angewandte Datei bricht den Start ab.
|
||||
- Jede Datei läuft mit ihrem Ledger-Eintrag in einer Transaktion.
|
||||
- Danach legt `migrate` die Rolle `tsumugu_runtime` an bzw. aktualisiert sie: `LOGIN NOSUPERUSER NOCREATEDB NOCREATEROLE NOINHERIT`, DML auf alle Tabellen, kein `CREATE` im Schema, kein Zugriff auf `schema_migrations`. Das Passwort ist das des Owners (siehe Review R-09).
|
||||
- Aufruf beim Containerstart (`app.entrypoint`) und über `python -m app.cli migrate`.
|
||||
|
||||
## Identität und Räume
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `auth_accounts` | `id`, `email` (unique), `display_name`, `password_hash` (bcrypt), `status` (`active`/`disabled`), `is_superadmin`, `origin` (`operator`/`fixture`) | Konten mit `origin='fixture'` entfernt der Start in jeder Umgebung |
|
||||
| `auth_sessions` | `id`, `account_id`, `secret_hash` (SHA-256, unique), `csrf_token`, `scope_kind`, `scope_id`, `epoch`, `expires_at`, `revoked_at` | der bestätigte Datenraum steht in der Session |
|
||||
| `auth_invitations` | `email`, `room_id`, `token_hash`, `invited_by`, `expires_at`, `accepted_at` | 7 Tage gültig |
|
||||
| `data_rooms` | `id`, `kind` (`personal`/`organization`), `name`, `status` (`active`/`archived`), `created_by` | persönlicher Raum: `id = account_id` |
|
||||
| `room_memberships` | PK (`room_id`, `subject_id`), `role` (`member`/`manager`), `status` (`active`/`removed`) | – |
|
||||
|
||||
## Struktur
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `cases` | Anker¹, `title`, `parent_case_id`, `rights_mode` (`inherit_parent`/`explicit`), `record_status` (`open`/`closed`), `content_order` (`date`/`position`), `content_order_dir`, `content_view` (`structure`/`chronology`) | Wurzelakte immer `explicit`; Composite-FK (`parent_case_id`, `home_scope_id`); Anwendung erlaubt eine Unteraktenebene. `content_view` ist nur die Arbeitsansicht |
|
||||
| `matters` | Anker¹, `title`, `parent_matter_id`, `record_status`, `content_order`, `content_order_dir`, `content_view` | Composite-FK für den Elternvorgang im selben Raum; Anwendung erlaubt beim Anlegen eine Teilvorgangsebene |
|
||||
| `matter_case_links` | `matter_id`, `case_id`, `created_by` | unique (`matter_id`, `case_id`); Vererbungskontext |
|
||||
| `case_link_blocks` | PK (`link_id`, `element_id`) | Inhalte, die die zuordnende Person nicht freigeben durfte; im Aktenkontext unsichtbar. Kaskade beim Lösen der Zuordnung |
|
||||
| `matter_cross_links` | `from_matter_id`, `to_matter_id` | kein Selbstverweis, unique |
|
||||
| `chapters` | `home_scope_id`, genau eines von `case_id`/`matter_id`, `title`, `position`, `document_on`, `parent_chapter_id` | Composite-FKs zum Behälter; Trigger `chapters_parent_guard`: gleiches Objekt, gleicher Raum, kein Zyklus, höchstens 32 Ebenen |
|
||||
|
||||
¹ Anker: `id`, `home_scope_id`, `owner_subject_id`, `created_by`, `version`, `created_at`, `updated_at`, `deleted_at`.
|
||||
|
||||
## Inhalte
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `elements` | Anker¹, `title`, `kind` (`note`/`file`/`external_ref`), `summary` (≤ 400) | gemeinsamer Inhaltsträger |
|
||||
| `note_bodies` | `element_id`, `document_json`, `version` | ein Text je Notiz; Format `{version: 1, blocks: [...]}` mit Absatz- oder einem Markdown-Block |
|
||||
| `correspondence_dates` | `element_id`, `document_on`, `sent_on`, `received_on` | getrennte Datumssachen; Erfassung = `elements.created_at` |
|
||||
| `external_references` | `element_id`, `source` (`paperless`/`url`/`imap`), `external_id`, `detail` (JSON) | IMAP: Message-ID als `external_id`, `connector_id`, `mailbox`, `uid` im JSON; kein Eindeutigkeitsindex |
|
||||
| `bindings` | `element_id`, `context_kind` (`case`/`matter`), `context_id`, `chapter_id`, `position`, `communication_direction` (`in`/`out`/`local`/NULL), `direction_explicit`, `list_fold` (`attachment`/`evidence`/NULL) | unique (`element_id`, `context_kind`, `context_id`); kein FK auf den Kontext (polymorph). `list_fold` gilt nur für dieses Vorkommen |
|
||||
| `attachment_uses` | Behälter, `host_element_id`, `attachment_element_id`, `position`, optionales `label` | flache Zuordnung je Hauptschriftstück und Behälter; keine Dateikopie; kein Selbstbezug |
|
||||
| `dispatches` | Behälter, `host_element_id`, `channel`, `sent_on`, `counterpart`, `completeness`, `provenance`, `version` | mehrere Versände je Schreiben; `sent_on` leer bleibt undatiert |
|
||||
| `dispatch_items` | Rolle `host`/`attachment`, Titel, Dokumentdatum, `source_state` `snapshot`/`gap`, Hash, optionales Notiz-JSON | Manifest der übermittelten Fassung; Lücke ersetzt nicht die Arbeitsdatei |
|
||||
| `dispatch_snapshots` | Bytes, Hash, Dateiname | Datei unter `MEDIA_ROOT/dispatch/<id>`; fällt in den Löschpfad des Elements |
|
||||
| `dispatch_evidence` | `element_id`, Rolle `email`/`submission`/`delivery`/`other`, Identitätsprüfung, `comparisons` | manuelle Zuordnung; Einlieferung ist keine Zustellung |
|
||||
| `dispatch_corrections` | Zeitpunkt, Zusammenfassung | Berichtigung ohne stilles Umschreiben der Bytes |
|
||||
| `context_annotations` | `binding_id`, `body` (≤ 4 000), `author_subject_id` | Kaskade mit der Einbindung |
|
||||
| `element_references` | PK (`element_id`, `refers_to_element_id`) | kein Selbstbezug; Zyklusprüfung in der Anwendung; FK-Kaskade greift nur bei physischem Löschen, Elemente werden aber nur markiert (Review R-13) |
|
||||
| `media_assets` | `id`, `element_id` (unique), Owner, Heimatraum, `original_filename`, `content_type`, `byte_size`, `sha256`, `revision`, `status` (`active`/`purging`/`purged`) | Bytes unter `MEDIA_ROOT/<asset_id>` |
|
||||
| `media_operations` | `element_id`, `asset_id`, `phase`, `status` | derzeit reines Protokoll |
|
||||
|
||||
## Rechte
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `access_grants` | `grantee_subject_id` (NULL bei Kontextausnahme), `resource_kind` (`case`/`matter`/`element`/`task`/`deadline`), `resource_id`, `context_kind`/`context_id`, `can_read/edit/share/delete`, `is_exception` | Grant: `is_exception=false`, ohne Kontext. Ausnahme: `is_exception=true`, Kontext gesetzt, die Flags bedeuten „entfernt“. Eindeutigkeitsindex über Ressource, Empfänger, Kontext und Art |
|
||||
|
||||
## Nachverfolgung
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `tasks` | Anker¹, `title`, `matter_id`, `assignee_subject_id`, `due_on`, `task_status` (`open`/`done`) | ohne Vorgang ist die Aufgabe selbst der Rechteanker |
|
||||
| `deadlines` | Anker¹, `title`, `matter_id`, `element_id` (ungenutzt), `assignee_subject_id`, `due_on`, `deadline_status` (`open`/`fulfilled`), `fulfilled_at` | – |
|
||||
| `task_deadline_links` | PK (`task_id`, `deadline_id`) | keine Statuskopplung |
|
||||
| `task_element_links` | PK (`task_id`, `element_id`) | nicht in der Spezifikation |
|
||||
| `task_dependencies` | PK (`task_id`, `depends_on_task_id`) | kein Selbstbezug, Zyklusprüfung in der Anwendung; nicht in der Spezifikation |
|
||||
|
||||
## Quellen und Audit
|
||||
|
||||
| Tabelle | Wesentliche Spalten | Regeln |
|
||||
|---|---|---|
|
||||
| `connectors` | `owner_id`, `kind` (`paperless`/`imap`), `name`, `settings` (JSON), `secret` (Klartext, Review R-05) | Paperless höchstens einmal je Konto (in der Anwendung) |
|
||||
| `domain_events` | `actor_subject_id`, `scope_id`, `action`, `resource_kind`, `resource_id`, `context_kind/id`, `occurred_on`, `occurred_at`, `result` | append-only; Grundlage von Chronologie und fachlichem Verlauf |
|
||||
|
||||
## Nicht angelegt (bewusst)
|
||||
|
||||
`compilations`, `release_state`, Finanztabellen (`invoices`, `payments`, …), `external_field_states`, `retain_until`, Auth-Tabellen für Flows, MFA, Recovery-Codes und Rate-Limits. Sie gehören zu späteren Paketen bzw. zu offenen Befunden.
|
||||
|
||||
## Beziehungen
|
||||
|
||||
```mermaid
|
||||
erDiagram
|
||||
auth_accounts ||--|| data_rooms : "persoenlicher Raum"
|
||||
auth_accounts }o--o{ data_rooms : "room_memberships"
|
||||
data_rooms ||--o{ cases : "Heimat"
|
||||
data_rooms ||--o{ matters : "Heimat"
|
||||
data_rooms ||--o{ elements : "Heimat"
|
||||
cases ||--o{ cases : "Unterakte"
|
||||
matters ||--o{ matters : "Teilvorgang"
|
||||
matters }o--o{ cases : "matter_case_links"
|
||||
matters }o--o{ matters : "matter_cross_links"
|
||||
cases ||--o{ chapters : "Gliederung"
|
||||
matters ||--o{ chapters : "Gliederung"
|
||||
chapters ||--o{ chapters : "Unterkapitel"
|
||||
elements ||--o{ bindings : "Einbindung"
|
||||
bindings ||--o{ context_annotations : "Anmerkung"
|
||||
elements ||--o| note_bodies : "Text"
|
||||
elements ||--o| correspondence_dates : "Daten"
|
||||
elements ||--o| external_references : "Referenz"
|
||||
elements ||--o| media_assets : "Datei"
|
||||
elements }o--o{ elements : "element_references"
|
||||
matters ||--o{ tasks : "optional"
|
||||
matters ||--o{ deadlines : "optional"
|
||||
tasks }o--o{ deadlines : "task_deadline_links"
|
||||
tasks }o--o{ elements : "task_element_links"
|
||||
tasks }o--o{ tasks : "task_dependencies"
|
||||
auth_accounts ||--o{ connectors : "Zugang"
|
||||
```
|
||||
@@ -6,6 +6,10 @@
|
||||
|
||||
**Technische Grundlagen:** Jinkendo-Referenzarchitektur A/B/C v0.3 vom 16.10.2026 sowie die Blueprints Auth/Session/Scope, Release/Betrieb/Recovery und Medien/Dateien. KI-Gateway, Prompt-/Workflow-Laufzeit und Entitlements gelten nur als Grenze, nicht als MVP-Pflicht.
|
||||
|
||||
### Hinweis zum Ist-Stand (Code-Review 18.10.2026)
|
||||
|
||||
Diese Fassung ist der Entwurf vom 16.10.2026 mit späteren punktuellen Ergänzungen (Ordnung, Richtung, Unterkapitel). Abschnitt 1.3 („keine Fachanwendung“) und der Satz in Abschnitt 8, der erste Auftrag solle nur P0 umfassen, beschreiben den damaligen Ausgangspunkt. Die Anwendung umfasst inzwischen P0–P3, P4a und P5a sowie die Folgeaufträge F-06 bis F-08. P7 fehlt. Den tatsächlichen Stand beschreiben [API_REFERENZ.md](API_REFERENZ.md), [DATENMODELL_IST.md](DATENMODELL_IST.md) und [RECHTEMODELL_IST.md](RECHTEMODELL_IST.md). Abweichungen zwischen dieser Spezifikation und dem Code stehen im [Code-Review](../review/04_TECHNISCHE_SPEZIFIKATION.md).
|
||||
|
||||
### Änderungsnotiz 0.3
|
||||
|
||||
F-05a bestätigt die erste benutzbare Lieferung „Organisieren und Nachverfolgen“. Finanzfunktionen und bidirektionaler Paperless-Abgleich folgen anschließend, ohne gestrichen zu werden. Die zuvor kombinierten Pakete P4 und P5 sind dafür in unabhängig lieferbare Teile aufgeteilt; P7 sichert schon den ersten echten Betrieb ab. Die technische Präzisierung des Akten-Handlungskontexts ist in Abschnitt 6.2 ergänzt. Diese Angleichung ist keine pauschale Freigabe der offenen Rechte-/Löschvorschläge und kein Implementierungsauftrag.
|
||||
@@ -217,7 +221,9 @@ Gemeinsame Spalten der fachlichen Ankerobjekte `cases`, `matters`, `elements`, `
|
||||
|
||||
Auth-Tabellen `auth_accounts` und `auth_sessions` folgen dem Auth-Blueprint. Ein Anzeigename ist kein Identitätsbeweis.
|
||||
|
||||
Akten und Vorgänge speichern `content_order` (`date` oder `position`) und `content_order_dir` (`asc` oder `desc`). Bestehende Zeilen bleiben auf `position`, damit eine schon gesetzte Einbindungsreihenfolge nicht ersetzt wird. Neue Akten und Vorgänge beginnen mit fachlichem Datum aufsteigend. `bindings.position` gehört zur Einbindung. Die Datumssortierung schreibt sie nicht um. `PATCH /api/v1/cases/{id}/content-order` und `POST /api/v1/cases/{id}/bindings/order` sowie die gleichen Pfade unter `matters` prüfen das Bearbeitungsrecht im Handlungskontext und `expected_version`. Der fachliche Verlauf liest die Datumsfelder der sichtbaren Unterlagen einmal je Element. Das Änderungsprotokoll bleibt `GET .../chronology`, seitenweise über `cursor`. Der Breadcrumb eines Vorgangs ist der Objektpfad `Vorgänge` und gegebenenfalls der lesbare Elternvorgang; lesbare Aktenzuordnungen stehen separat in `placements` und wechseln den Handlungskontext nur bei bewusster Auswahl. `elements.summary` ist eine optionale gemeinsame Kurzbeschreibung. Ein Textauszug entsteht nur aus vorhandenem Notiztext. Bild- und PDF-Vorschauen verwenden denselben berechtigten Dateiabruf wie das Öffnen.
|
||||
Akten und Vorgänge speichern `content_order` (`date` oder `position`) und `content_order_dir` (`asc` oder `desc`). Bestehende Zeilen bleiben auf `position`, damit eine schon gesetzte Einbindungsreihenfolge nicht ersetzt wird. Neue Akten und Vorgänge beginnen mit fachlichem Datum aufsteigend. `bindings.position` gehört zur Einbindung. Die Datumssortierung schreibt sie nicht um. `PATCH /api/v1/cases/{id}/content-order` und `POST /api/v1/cases/{id}/bindings/order` sowie die gleichen Pfade unter `matters` prüfen das Bearbeitungsrecht im Handlungskontext und `expected_version`. Der fachliche Verlauf liest die Datumsfelder der sichtbaren Unterlagen einmal je Element. Das Änderungsprotokoll bleibt `GET .../chronology`, seitenweise über `cursor`. `content_view` ist `structure` oder `chronology` und nur eine Darstellung. Sie schreibt Kapitel, Positionen und Datumssortierung nicht um. Der Breadcrumb eines Vorgangs ist der Objektpfad `Vorgänge` und gegebenenfalls der lesbare Elternvorgang; lesbare Aktenzuordnungen stehen separat in `placements` und wechseln den Handlungskontext nur bei bewusster Auswahl. `elements.summary` ist eine optionale gemeinsame Kurzbeschreibung. Ein Textauszug entsteht nur aus vorhandenem Notiztext. Bild- und PDF-Vorschauen verwenden denselben berechtigten Dateiabruf wie das Öffnen.
|
||||
|
||||
Anlagen, Versand und Nachweise sind eigene Verwendungen im Behälter der Einbindung, nicht im geerbten Aktenkontext. `attachment_uses` ordnet ein vorhandenes Element einem Hauptschriftstück zu, mit eigener Reihenfolge je Behälter und ohne Dateikopie. `bindings.list_fold` blendet nur dieses Vorkommen als Anlage oder Nachweis aus; andere Einbindungen bleiben. `dispatches` hält Weg, Versanddatum, Gegenüber, Vollständigkeit und Herkunft (`captured` oder `reconstructed`). `dispatch_items` ist das Manifest. Eine sicherbare Fassung liegt als Bytes unter `MEDIA_ROOT/dispatch/<id>` in `dispatch_snapshots`, bei Notizen zusätzlich als JSON im Manifest. Eine fehlende historische Fassung bleibt `gap` und wird nicht durch die aktuelle Arbeitsdatei ersetzt. `dispatch_evidence` verknüpft einen vorhandenen Beleg in der Rolle E-Mail, Einlieferung, Zustellung oder sonstiger Nachweis. Einlieferung setzt keinen Zustellstatus. Berichtigungen stehen in `dispatch_corrections` und ändern die gesicherten Bytes nicht. Löschen eines Elements entfernt die Bytes seiner Versandfassungen über denselben Löschpfad wie die Arbeitsdatei. Lesen des Hauptschriftstücks öffnet keine gesperrte Anlage. Exportknoten `attachment`, `dispatch_item` und `evidence` unterscheiden Arbeitsstand, gesicherte Fassung und Nachweis. Eine unvollständige Auswahl ist ein Auszug. Eine ausgewählte E-Mail bleibt das vollständige Original.
|
||||
|
||||
### 4.3 Überblick
|
||||
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Tsumugu – Erste Lieferung: vollständiges Übergabepaket
|
||||
|
||||
**Erweiterung vom 18.10.2026:** [Schreiben/Anlagen/Versand/Nachweise](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md) erweitert den vorhandenen Export um Rollen, Ereignisse und konkrete übermittelte Fassungen. Die vollständige EML-Anlagenregel und die Auswahl nach Vorkommen bleiben erhalten; bewusste Auszüge eines Versandstands werden als solche bezeichnet. Die unten beschriebene erste Liefergrenze ist historisch.
|
||||
|
||||
Stand: 17.10.2026. Fachliches Lieferpaket und vorbereiteter Cursor-Auftrag. Führend für die bestätigten Entscheidungen ist die Produktspezifikation 0.32, F-07a–c. Neue Bestandsänderungen sind vor Umsetzung erneut abzugleichen. Dieser Dokumentationsauftrag beginnt keine Umsetzung.
|
||||
|
||||
## Ziel
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Tsumugu – kompakte Inhaltsliste und Bezüge
|
||||
|
||||
**Spätere Erweiterung, 18.10.2026:** [Schreiben mit Anlagen, Versand und Nachweisen](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md) ergänzt ausdrückliche Inhaltsrollen und Chronologie. Die kompakte Darstellung bleibt; Anlagen dürfen am Hauptschriftstück gezielt geöffnet werden, allgemeine Bezüge bleiben ohne Umordnung. Der neue Auftrag präzisiert zusätzlich Kapitelgrenzen und Nachweisdarstellung.
|
||||
|
||||
**Stand:** 17.10.2026 · **Fassung:** 1.0 · **Ziel:** deutlich mehr Vorgangsinhalt auf einen Blick, direkt bedienbare Kommunikationszeichen und kompakte Beziehungen.
|
||||
|
||||
## 1. Geltung und Befund
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Tsumugu – Fachliche Produktspezifikation
|
||||
|
||||
**Stand:** 17.10.2026 · **Arbeitsstand:** 0.37, Unterkapitel als reine verschachtelte Gliederung; kompakte Inhaltsliste und Exportlieferung bleiben erhalten.
|
||||
**Stand:** 18.10.2026 · **Arbeitsstand:** 0.38, Anforderungen zu Schreiben mit Anlagen, Versand/Nachweisen, Chronologie und Kapitelgrenzen zusammengestellt.
|
||||
**Status:** Führende fachliche Arbeitsdatei; noch keine freigegebene Gesamtspezifikation.
|
||||
|
||||
**Aktuelle Ergänzung:** [Bedienung, Orientierung und Aktenordnung im MVP](TSUMUGU_UX_MVP_ERGAENZUNG.md). Sie sichert den Nutzerbedarf aus der Prüfung der inzwischen bestehenden Anwendung und konkrete Umsetzungsvorgaben für deren Überarbeitung. Bestätigter Bedarf und empfohlene Ausgestaltung sind dort getrennt; die historischen Etappenbeschreibungen dieser Datei bleiben als solche erhalten.
|
||||
@@ -418,6 +418,20 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
|
||||
|
||||
**Auswirkungen auf Fachmodell und MVP:** Jedes Kapitel hat höchstens ein Elternkapitel im selben Objekt. Direkte Inhalte eines Kapitels bleiben von den Inhalten seiner Unterkapitel unterscheidbar. Geschwister haben eine eigene Reihenfolge; die Eintragsreihenfolge bleibt die des jeweiligen Kapitels. Umhängen bleibt im selben Objekt und gibt nichts frei. Auflösen einer Kapitelgliederung löscht keine Inhalte oder Originaldateien: direkte Einbindungen und direkte Unterkapitel rücken unter das bisherige Elternkapitel, bei einem Wurzelkapitel auf die oberste Ebene. Der vorhandene Export stellt die Struktur als Verzeichnisse dar. F-07c bleibt unverändert. Eine technische Schutzgrenze von 32 Ebenen verhindert Zyklen und unbegrenzte Tiefe; sie ist keine fachliche Produktgrenze. Auftrag und Abnahme: [Unterkapitel](TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md).
|
||||
|
||||
### F-08b – Schreiben mit Anlagen und erkennbare Kapitelgrenzen: 18.10.2026
|
||||
|
||||
**Nutzerbedarf und Auftrag:** Unterkapitel werden ersatzweise verwendet, um ein Schriftstück mit seinen Anlagen zusammenzuhalten. Die Abgrenzung von Vorgang, Kapitel und Unterkapitel ist in der Oberfläche zu schwach; chronologische Einordnung und konkrete Anlagenzuordnung werden nicht ausreichend ausgedrückt. Der Nutzer benennt Anlagen ausdrücklich als neue fachliche Funktion und beauftragt Anforderungen und Cursor-Prompt für den besprochenen Ausbau.
|
||||
|
||||
**Konkrete Ausgestaltung:** Vorhandenes Hauptschriftstück mit ausdrücklicher, geordneter Anlagenverwendung ergänzen. Kapitel bleiben thematische Gliederung ohne eigene Rechte; allgemeine Antwort-/Belegbezüge bleiben eigenständig. Ein Inhalt kann Anlage mehrerer Schreiben sein, ohne Kopie zur bloßen Organisation und ohne neue Zugriffsrechte. Anlagen als kompakte, bei Bedarf öffnende Einheit darstellen. Klare Kapitelgrenzen, keine unmittelbare doppelte Überschrift und verständliche direkte/Gesamtzähler. Bestandsunterkapitel nicht automatisch umdeuten; vorhandene Belege gesammelt bewusst zuordnen. Gliederung und durchgehende Chronologie als verständliche Arbeitsansichten erhalten; Dokumentdaten nicht durch Versanddaten überschreiben.
|
||||
|
||||
### F-08c – Versand, Nachweise und übermittelte Fassung: 18.10.2026
|
||||
|
||||
**Nutzerbedarf:** Selbst erstellte Schreiben wurden per Post oder E-Mail verschickt. Einlieferungsbeleg oder E-Mail sollen als Nachweis dienen. Eine eigenständige Nachweis-E-Mail in der Struktur führt durch ihre Anhänge zu redundanten Informationen und erschwert die Übersicht. Der Nutzer beauftragt die Zusammenstellung des besprochenen fachlichen Lösungsansatzes.
|
||||
|
||||
**Konkrete Ausgestaltung:** Versandereignis mit Zeitpunkt, Kanal, Gegenüber, konkretem Inhaltsstand und zugeordneten Nachweisen dokumentieren; mehrere Versände desselben Schreibens bleiben möglich. Die tatsächliche übermittelte Fassung bleibt abrufbar und verändert sich nicht still durch spätere Bearbeitung. Fehlende historische Originale als Lücke/Rekonstruktion ausweisen. E-Mail als Nachweis vollständig erhalten, auf Wunsch im aktiven Kontext kompakt am Versand darstellen statt eine zweite sichtbare Anlagenzusammenstellung zu erzeugen. Fachlich eigenständige E-Mails bleiben weiterhin eigenständige Kommunikation. Eine Einlieferung ist keine automatisch bestätigte Zustellung. Keine echte Versandfunktion, automatische Nachweisbewertung oder neue allgemeine Versionsplattform erforderlich.
|
||||
|
||||
**Lieferung und Grenzen zu F-08b/c:** Der gemeinsame [Anforderungs- und Cursor-Auftrag vom 18.10.2026](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md) konkretisiert Anlage-/Nachweisrollen, gesicherte Fassungen, Listen-/Chronologiedarstellung, Bestandsübergang, Kontextrechte und Export einschließlich vollständiger EML gemäß F-07c. Er ersetzt die historische Zurückstellung eines Hauptdokuments/Dokumentpakets für diese neue Lieferung; F-08a bleibt als Kapitelmodell erhalten. Detailregeln des Auftrags sind die aktuelle Umsetzungsausgestaltung, keine Behauptung bereits implementierter oder früher einzeln bestätigter Funktionen. Dieses Dokumentationspaket ändert keine Anwendung, Datenbank oder Bereitstellung.
|
||||
|
||||
## 6. Fortschreibung
|
||||
|
||||
16.10.2026, Arbeitsstand 0.1: Recovery vollständig gelesen, Repository-Unterlagen gezielt abgeglichen, ursprüngliche Nutzernachrichten geprüft und Ergänzungen gesichert. Historische Baseline unverändert übernommen.
|
||||
@@ -494,4 +508,8 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
|
||||
|
||||
17.10.2026, Arbeitsstand 0.37: F-08a bestätigt Unterkapitel als verschachtelte Gliederung ohne eigene Rechte, Ownership oder Status. Die frühere Zurückstellung ist historisch. Kein Sammler und keine Freigabezusammenstellung. Der Auftrag liegt unter [TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md](TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md). Prüfergebnis und Grenzen: [TSUMUGU_UNTERKAPITEL_PRUEFBERICHT_2026-10-17.md](TSUMUGU_UNTERKAPITEL_PRUEFBERICHT_2026-10-17.md).
|
||||
|
||||
18.10.2026, Arbeitsstand 0.38: F-08b/c aus der aktuellen Besprechung gesichert und gemeinsamen Auftrag erstellt: Schreiben mit Anlagen, Versandereignisse mit vollständigen Nachweisen/konkreten Fassungen, klare Kapitelgrenzen und getrennte Gliederungs-/Chronologieansicht. Bestand und vollständiger E-Mail-Export bleiben berücksichtigt. Historische Beschränkung der Unterkapitellieferung wird gezielt erweitert. Keine Änderungen an Anwendungscode, Datenbanken, Commit/Push oder Deployment durch diesen Anforderungsauftrag.
|
||||
|
||||
18.10.2026, Arbeitsstand 0.39: F-08b/c lokal umgesetzt. Anlagenverwendung, dokumentierte Versände mit gesicherter oder ausdrücklich fehlender Fassung, Nachweisrollen und die getrennte Gliederungs-/Chronologieansicht sind in der Anwendung. Bestehende Unterkapitel werden nicht umgedeutet. Der Export unterscheidet Arbeitsstand, Versandfassung und vollständige E-Mail.
|
||||
|
||||
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.
|
||||
@@ -0,0 +1,134 @@
|
||||
# Tsumugu – Schreiben, Anlagen, Versand und klare Kapitelgrenzen
|
||||
|
||||
**Stand:** 18.10.2026 · **Fassung:** 1.0 · **Ergebnis:** zusammenhängender Ausbau des vorhandenen MVP bis zur lokal prüfbaren Umsetzung.
|
||||
|
||||
## 1. Ziel, Herkunft und Vorrang
|
||||
|
||||
Der Nutzer verwendet Unterkapitel bislang ersatzweise, um ein Schriftstück mit seinen Anlagen zusammenzuhalten. Kapitelgrenzen sind in der Vorgangsseite zu wenig erkennbar. Die zeitliche Einordnung sowie die Zuordnung von Belegen zu einem konkreten Schriftstück werden dadurch nicht ausreichend ausgedrückt. Eine versendete E-Mail oder ein Einlieferungsbeleg soll außerdem als Nachweis zum Schreiben gehören, ohne durch die E-Mail-Anhänge eine zweite sichtbare Dokumentzusammenstellung aufzubauen. Der Nutzer beauftragt die Zusammenstellung dieser Anforderungen und eines Cursor-Prompts.
|
||||
|
||||
Die folgenden Regeln sind die konkrete Ausgestaltung dieses Ausbaus. Sie sind keine Behauptung, die Funktion sei bereits vorhanden. **Anlagenzuordnung und Versand mit Nachweisen sind neue fachliche Funktionen**, kein bloßer CSS-Umbau. Bestehende Originale, Kapitel, Unterkapitel, Bezüge, Kontextrechte und der vollständige Export sind weiterzuverwenden.
|
||||
|
||||
Führend: [Produktspezifikation](TSUMUGU_PRODUCT_SPEC.md), F-08a–c. Ergänzend: [kompakte Liste](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md), [Unterkapitel](TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md) und [Export](TSUMUGU_EXPORT_NAECHSTE_LIEFERUNG_2026-10-17.md). Historische Beschränkungen „kein Hauptdokument/kein Dokumentpaket“ gelten für die frühere Unterkapitellieferung; sie verhindern den jetzt beauftragten Ausbau nicht. Virtuelle Freigabezusammenstellungen und dynamische Sichten bleiben eigenständige Begriffe.
|
||||
|
||||
## 2. Fachliche Trennung und minimaler Umfang
|
||||
|
||||
| Begriff | Bedeutung und Grenze |
|
||||
|---|---|
|
||||
| Kapitel / Unterkapitel | Thematische Gliederung des aktiven Fachobjekts, weiterhin ohne eigene Rechte oder Status. |
|
||||
| Schreiben mit Anlagen | Vorhandenes Hauptschriftstück mit ausdrücklich zugeordneten, geordneten Anlagen. Keine zusätzliche Vorgangsebene und kein künstliches Kapitel erforderlich. |
|
||||
| Versand | Konkrete Übermittlung eines bestimmten Stands an ein Gegenüber, zu einem Datum und über einen Kanal. Mehrere Versände desselben Schreibens sind möglich. |
|
||||
| Nachweis | Vorhandene E-Mail, Einlieferungsbeleg, Zustellbestätigung oder anderes geeignetes Element, gezielt einem Versand zugeordnet. |
|
||||
| Allgemeiner Bezug | Antwort, spätere Bestätigung oder sonstiger Zusammenhang zwischen eigenständigen Einträgen. Er macht einen Beleg nicht automatisch zur versendeten Anlage. |
|
||||
|
||||
Minimal liefern: Anlagen zuordnen/ordnen/lösen, Versand manuell dokumentieren, bestehende Nachweise zuordnen, redundant eingebundene Nachweise bewusst kompakt darstellen, konkrete übermittelte Fassungen erhalten, Gliederung und Chronologie verständlich anzeigen und den vorhandenen Export erweitern. E-Mail-Versand, Postversand, Tracking-Automatik, juristische Nachweisbewertung, OCR/KI-Klassifizierung, allgemeines Versionsverwaltungssystem und Connector-Gesamtumbau sind nicht erforderlich.
|
||||
|
||||
## 3. Schreiben mit Anlagen
|
||||
|
||||
- Ein bestehendes lesbares Dokument bzw. eine geeignete vorhandene E-Mail kann Hauptschriftstück sein. Die Zuordnung ergänzt das vorhandene Inhaltsmodell; sie kopiert nicht zur bloßen Organisation die ganze Datei und ersetzt keine Akten-/Vorgangshierarchie.
|
||||
- Über „Anlagen zuordnen“ vorhandene zugängliche Elemente einzeln oder gesammelt auswählen. Zieldokument, aktiver Vorgang/Teilvorgang und geprüfter Handlungskontext sind klar. Bei Quellenübernahme den vorhandenen Auswahlweg mit eindeutigem Ziel wiederverwenden.
|
||||
- Anlagen erhalten eine eigene Reihenfolge innerhalb des Schreibens. Dokumenttitel und ursprüngliche fachliche Daten bleiben erhalten. Optional vorhandene Anlagenbezeichnungen nutzen; kein Pflichtformular je Anlage.
|
||||
- Dasselbe Element darf Anlage mehrerer Schreiben sein. Reihenfolge, Rolle und Zuordnung gehören zur jeweiligen Verwendung. Eine Änderung im Vorgang A darf keine Zuordnung in B überschreiben. Keine Kopie des gemeinsamen Inhalts zur bloßen Mehrfachverwendung.
|
||||
- „Anlage lösen“ entfernt nur diese Zuordnung. Original, andere Einbindungen und dokumentierte frühere Versände werden nicht still geändert. Kein globales Löschen über eine Anlagenaktion.
|
||||
- Keine Selbstzuordnung, Zyklen oder versehentliche doppelte Zuordnung desselben Vorkommens. Für diesen Ausbau genügt eine flache Anlagenliste pro Hauptschriftstück. Keine rekursiven Anlagenbäume oder neue allgemeine Beziehungssprache als Voraussetzung.
|
||||
- Ein Zustellvermerk, der später erstellt wurde, ist zunächst ein eigenständiger Nachweis/Bezug; er wird nicht nachträglich zur ursprünglich versendeten Anlage erklärt. Ebenso ist ein unterstützender Beleg nicht automatisch tatsächlich mitgesendet worden. Die Rolle wird bewusst gewählt.
|
||||
|
||||
## 4. Versand und Nachweise
|
||||
|
||||
### 4.1 Benutzbarer Ablauf
|
||||
|
||||
1. Beim Hauptschriftstück „Versand dokumentieren“ öffnen.
|
||||
2. Kanal „E-Mail“, „Post“ oder „Sonstiger Weg“, tatsächliches Versanddatum und Gegenüber erfassen. Bestehende Kontaktdaten wiederverwenden; ein lesbarer Freitext ist ausreichend, kein neues Parteienregister bauen. Fehlende Einzelangaben als unbekannt belassen statt erfinden. Ein unbekannter Versandtag bleibt als undatiert kenntlich; der Erfassungszeitpunkt ersetzt ihn nicht.
|
||||
3. Hauptschriftstück und tatsächlich mitversendete Anlagen einschließlich Reihenfolge prüfen. Die aktuelle Anlagenliste ist ein Vorschlag, keine automatische Behauptung über einen früheren Versand.
|
||||
4. Vorhandene E-Mail bzw. Belege als Nachweise auswählen, alternativ zunächst ohne Nachweis dokumentieren. „Vom Nutzer dokumentiert“ und „Nachweis vorhanden“ bleiben unterscheidbar. Speichern führt keinen echten Versand aus und behauptet keinen automatisch geprüften Erfolg.
|
||||
5. Einen späteren Versand desselben Schreibens, etwa nach E-Mail zusätzlich per Post, als weiteres Ereignis dokumentieren. Eigener Zeitpunkt, Kanal, Gegenüber, Inhaltsstand und Nachweise; kein Überschreiben des ersten Versands.
|
||||
|
||||
Ein Versand kann mehrere Nachweise haben, etwa Einlieferungsbeleg und spätere Zustellbestätigung. Die Rolle des Nachweises ist verständlich benannt: E-Mail/Versanddokumentation, Einlieferung, Zustellung oder sonstiger Nachweis. Eine Einlieferung wird nicht automatisch als Zustellung angezeigt. Neue Aufgaben, Fristen oder Erledigungsstände werden daraus nicht automatisch abgeleitet.
|
||||
|
||||
### 4.2 E-Mail als Nachweis ohne doppelte sichtbare Inhalte
|
||||
|
||||
- Gezielte Aktion „Als Versandnachweis zuordnen …“ an einem vorhandenen Element oder im vorhandenen Quellen-Auswahldialog. Hauptschriftstück und konkreten vorhandenen Versand auswählen oder den Versand in demselben Ablauf anlegen.
|
||||
- Die vollständige E-Mail mit Nachrichtentext, Headern und ursprünglichen Anhängen erhalten. Ein unverändertes Original bleibt direkt erreichbar. Keine Anhänge aus der EML entfernen, keine Originale umschreiben und keine Dateien allein wegen gleicher Namen zusammenführen.
|
||||
- Im Standard der Liste zeigt das Schreiben eine kompakte Angabe, etwa „8 Anlagen · per E-Mail · Nachweis“. Die E-Mail-Anhänge erscheinen hier nicht nochmals als zweite vollständig aufgeklappte Anlagenliste. Im Nachweis-Leser bleibt die vollständige Nachricht einschließlich Anhängen zugänglich.
|
||||
- Ist die E-Mail bereits eigenständig im selben Kontext eingebunden, ausdrücklich anbieten: „Hier als Nachweis darstellen“ oder „Zusätzlich als eigenständigen Eintrag behalten“. Keine automatische Entfernung, kein globales Verstecken und kein Löschen. Andere Einbindungen bleiben unverändert. Eine reine Nachweisdarstellung muss in den Details erkennbar und wieder als eigenständiges Vorkommen darstellbar sein.
|
||||
- Enthält die E-Mail zusätzliche fachliche Aussagen, muss sie als eigenständige Kommunikation erhalten bleiben können und trotzdem Nachweis sein. Nicht nach Betreff, Dateityp oder Vorhandensein von Anhängen automatisch als bloßes Transportmittel einstufen.
|
||||
- Anhänge dürfen auf bereits bekannte Unterlagen verweisen. Zuverlässiger Inhaltsvergleich, etwa vollständiger Hash mit exakter Quellenidentität, kann einen Vorschlag liefern; gleiches Dateimaterial beweist nicht allein dieselbe fachliche Rolle oder denselben Versand. Eine manuelle Zuordnung ist möglich und als solche unterscheidbar. Abweichende Fassungen sichtbar belassen.
|
||||
- Keine vorgetäuschte Speicher-Deduplizierung: Original-EML enthält ihre Anhänge weiterhin. Ziel ist eine verständliche Darstellung und explizite Identitäts-/Verwendungszuordnung.
|
||||
|
||||
## 5. Übermittelten Stand nachvollziehbar erhalten
|
||||
|
||||
- Ein dokumentierter Versand hält Hauptschriftstück, Anlagenbestand, Reihenfolge und konkrete Fassungen fest. Spätere Bearbeitung der Arbeitsunterlagen, neue Paperless-Fassungen, geänderte Titel oder gelöste Anlagenzuordnungen ändern diesen Stand nicht still.
|
||||
- Minimal eine unveränderliche Versandfassung mit Manifest und tatsächlich wieder abrufbaren Inhalten sichern. Eine vorhandene nachweislich unveränderliche Quellen-/Dateiversion darf referenziert werden; bei veränderlicher Quelle ist ein geschützter Stand der übermittelten Daten erforderlich. Ein Hash oder eine unversionierte Paperless-ID allein erhält den Inhalt nicht. Für unveränderliche Originaldateien vorhandene Speicherung wiederverwenden.
|
||||
- Nachricht und Anhänge eines Nachweis-Originals ebenso konkret identifizieren. Beim Zuordnen einer bestehenden E-Mail bekannte Quelle und Nachricht eindeutig prüfen; keinen beliebigen Zugang oder ähnlich benannten Anhang verwenden.
|
||||
- Nicht vorhandene historische Fassungen nicht nachträglich erfinden. Ein später rekonstruierter Versand bleibt als rekonstruierter/manuell zugeordneter Stand erkennbar. Dokumentation ohne verfügbare Originalfassung darf gespeichert werden, aber keinen vollständigen gesicherten Inhaltsstand vortäuschen. Lücken klar anzeigen; vollständiger Export meldet sie.
|
||||
- Nachträgliche Korrekturen als nachvollziehbare Berichtigung mit Zeitpunkt festhalten. Bestehende Rechte-/Löschregeln gelten weiter, auch für gespeicherte Versandfassungen; daraus keine neue unbegrenzte Aufbewahrung oder undeletbare Parallelablage ableiten. Der technische Entwurf muss Schutz, Speicherung und vorhandenen Löschpfad konkret beschreiben.
|
||||
- Keine starre Kopie zu jedem UI-Klick. Sichern beim bewussten Dokumentieren des Versands, atomar bzw. mit eindeutigem unvollständigem Zustand bei Abruffehlern. Bestehende Arbeitsunterlagen bleiben normal bearbeitbar.
|
||||
|
||||
## 6. Darstellung: Kapitel, Einheit und Chronologie
|
||||
|
||||
### 6.1 Kapitelgrenzen
|
||||
|
||||
- Kapitelköpfe durch zurückhaltend abgesetzte Fläche und eindeutige Typografie von Dokumentzeilen unterscheiden. Unterkapitel mit konsistenter Einrückung und erkennbarem Ende des jeweiligen Bereichs. Keine breiten Karten und großen Leerflächen als Ersatz für Struktur.
|
||||
- Im ausgewählten Kapitel dessen Überschrift nicht unmittelbar darunter identisch wiederholen. Vorgangstitel und ausgewähltes Kapitel eindeutig benennen; Breadcrumbs und tatsächlicher Handlungskontext bleiben erhalten.
|
||||
- Zähler verständlich machen: etwa „2 direkt · 8 in Unterkapiteln“ oder nachvollziehbare Gesamtzahl. Nie eine unbeschriftete direkte Anzahl neben einer sichtbar größeren Gesamtmenge. Sichtbare Zählwerte berücksichtigen Rechte, Filter und die gewählte Darstellung; ausgeblendete Original-/Nachweisvorkommen nicht als vermeintlich sichtbare Zeilen zählen.
|
||||
- Kapitel und Unterkapitel bleiben reine Gliederung. „Einzelbelege“ darf weiterhin ein thematisches Unterkapitel sein, belegt aber keine Anlagen- oder Versandzuordnung.
|
||||
|
||||
### 6.2 Schreiben als kompakte Einheit
|
||||
|
||||
- Hauptschriftstück in einer kompakten Zeile mit Kennzeichnungen „Anlagen n“, „Versand n“ bzw. passendem Kanal und „Nachweise n“. Nur vorhandene Angaben zeigen. Keine dauerhaft aufgeklappten Anlagen-, Versand- und Nachweislisten pro Eintrag.
|
||||
- „Anlagen“ öffnet die geordnete Liste bzw. den bestehenden Leserbereich. Eintrag, Dateityp und ursprüngliches Datum bleiben erkennbar; mobile Navigation nutzt dieselbe Einheit ohne verkleinerte Mehrspaltenansicht. Anlagen sind ausdrücklich als solche benannt und sehen nicht wie Unterkapitel aus.
|
||||
- Derselbe Inhalt wird innerhalb einer gewählten Ansicht nicht ungefragt mehrfach als scheinbar unabhängige Zeile dargestellt. Ein ausdrücklich gewünschtes eigenständiges Vorkommen bleibt möglich und wird als dieselbe Unterlage kenntlich gemacht. Suche, Filter und Direktöffnung können den Inhalt weiterhin auffinden; benötigte Herkunft bleibt erreichbar.
|
||||
- Das Zusammenfassen erfolgt durch die neue ausdrückliche Anlagen-/Nachweisrolle. Allgemeine Antwortbezüge bleiben beim kompakten Bezugsauslöser und verschieben keine Zwischenstücke. Keine verbindenden Klammern über die Chronologie.
|
||||
|
||||
### 6.3 Zwei verständliche Arbeitsansichten
|
||||
|
||||
- **Gliederung:** Kapitel/Unterkapitel und ihre gespeicherte eigene oder fachliche Ordnung bleiben. Schreiben mit Anlagen erscheinen als Einheit. Die bestehende Ordnung nicht beim Erfassen eines Versands umschreiben.
|
||||
- **Chronologie:** Datierte Kommunikation, dokumentierte Versände und eigenständige Notizen/Ereignisse innerhalb des gewählten Vorgangs-/Kapitelbereichs bilden eine durchgehende zeitliche Folge. Datumsgruppen sind möglich, thematische Kapitel unterbrechen die Folge nicht. Kein gleichzeitig daneben angezeigter zweiter Verlauf. Auf-/absteigende Sortierung anbieten und undatierte Einträge kenntlich behandeln.
|
||||
- Ein dokumentierter Versand erscheint am tatsächlichen Versanddatum und verweist auf die gesicherte Fassung des Schreibens mit Anlagen. Er erscheint einmal pro Versand; Hauptschriftstück und reine Nachweis-E-Mail erzeugen dafür nicht zusätzlich identische Ausgangsereignisse. Ein weiterer echter Versand bleibt ein eigenes Ereignis. Eigenständige fachliche E-Mails/Notizen bleiben eigene Ereignisse.
|
||||
- Vorhandene Unterlagen ohne Versand behalten ihre fachliche Datierung. Dokumentdatum, Versanddatum, Zugangsdatum, Nachweisdatum und Erfassungszeitpunkt nicht gleichsetzen. Eine beigefügte Rechnung aus 2023 verschiebt das 2026 versendete Schreiben nicht nach 2023; das Rechnungsdatum bleibt am Inhalt sichtbar.
|
||||
- Ein späterer Zustellvermerk bleibt mit seinem eigenen Datum nachvollziehbar. Ein Nachweis kann aus dem Versand erreichbar sein und zugleich ein eigenständiges Ereignis dokumentieren. Doppelte Darstellung desselben Ereignisses vermeiden; Informationsrolle bewusst erhalten.
|
||||
- Wechsel der Arbeitsansicht ist eine Darstellungswahl, keine Migration der Einträge. Kapitelzuordnung, manuelle Reihenfolge, gewählter Kontext und Rückkehr aus dem Leser bleiben erhalten. Vorhandene geeignete Auswahl-/Sortierbedienung erweitern statt neue verstreute Schalter zu bauen.
|
||||
|
||||
## 7. Kontext, Bestand und bestehende Quellen
|
||||
|
||||
- Alle neuen Beziehungen und Versandverwendungen im geprüften Akten-/Vorgangskontext führen. Kapitel erzeugen keine Rechte; Anlage oder Nachweis sein erzeugt ebenso keine neue Freigabe, Ownership oder Einsicht in Herkunftsvorgänge.
|
||||
- Hauptschriftstück allein lesen zu dürfen verleiht keinen Zugriff auf gesperrte Anlagen/Nachweise. Titel, Vorschau, Parteien, Zähler und gespeicherte Versandfassungen dürfen keine Inhaltsausnahmen umgehen. Lesen, Bearbeiten und Weitergeben/Exportieren weiterhin unterscheiden.
|
||||
- Richtung je Einbindung bleibt erhalten. Das Zuordnen eines lokalen Belegs als Anlage ändert nicht seine eigene Richtung oder die Richtung anderer Dokumente. Der konkrete Ausgangsversand ist ein zusätzliches fachliches Ereignis.
|
||||
- Bestandsmigration additiv und rückwärtskompatibel. Keine vorhandenen Kapitel anhand von Namen automatisch in Schreiben/Anlagen umwandeln und keine Anlage allein wegen Reihenfolge/Unterkapitelposition erkennen.
|
||||
- Für den bestehenden Umgehungsfall einen manuellen Sammelablauf anbieten: im Unterkapitel Unterlagen auswählen, Hauptschriftstück wählen, Anlagen zuordnen und Reihenfolge prüfen. Danach ausdrücklich wählen, ob die zusätzlichen Vorkommen dort bestehen bleiben oder nur die Anlagenansicht verwendet werden soll. Keine stillen Löschungen. Ein überflüssiges Kapitel kann anschließend separat mit der vorhandenen, erklärten Funktion aufgelöst werden.
|
||||
- Paperless bleibt Quelle/Archiv. Neue Manifest-/Versanddaten sind Tsumugu-Fachdaten; kein bidirektionaler Metadatenabgleich als Vorbedingung. Den bestehenden vollständigen E-Mail-/Dateiabruf wiederverwenden und gezielt erweitern.
|
||||
|
||||
## 8. Export als Teil derselben Lieferung
|
||||
|
||||
- Bestehendes Übergabepaket um Anlagenrollen, Versandereignisse, Nachweise und gesicherte Fassungen ergänzen. HTML-/Markdown-Übersicht erklärt Kapitelzugehörigkeit und „Schreiben → Anlagen → Versand → Nachweise“ mit relativen Links, Datumsarten und Herkunft der Fassung. Dateinamen dürfen sich nicht überschreiben.
|
||||
- Die Auswahl zeigt, welche Anlagen/Nachweise beim gewählten Schreiben bzw. Versand enthalten sind. Für einen vollständigen Versandstand müssen die tatsächlich dazugehörenden Bestandteile mitgegeben werden. Bewusstes Abwählen bleibt nach der bisherigen Auswahl nach Vorkommen möglich, kennzeichnet die Ausgabe aber als Auszug dieses Versands; Vollständigkeit nicht behaupten.
|
||||
- Die bestehende Regel F-07c bleibt: Eine ausgewählte E-Mail enthält das vollständige Original mit sämtlichen ursprünglichen Anhängen. Ein separat abgewähltes Anlage-Vorkommen entfernt den Anhang nicht aus der EML. Die Auswahl/Prüfübersicht weist darauf hin. Eine ausgeblendete Nachweiszeile darf den Nachweis nicht versehentlich vom Export ausschließen; der Nutzer muss seine Aufnahme erkennen und wählen können.
|
||||
- Zugriffs- und bestehende Weitergabebefugnisse auch für Nachweise, Anlagen und gespeicherte Fassungen prüfen. Kein Export einer unveränderten vollständigen EML, wenn dessen vollständiger Inhalt im Exportkontext nicht freigegeben ist; verständlich melden statt ungeprüft redigieren oder heimlich auslassen.
|
||||
- Quellenlücken, fehlende historische Fassungen und fehlgeschlagene Abrufe ausdrücklich in der Vollständigkeitsprüfung behandeln. Gesicherte alte Fassungen und aktuelle Arbeitsstände unterscheidbar exportieren; keine aktuelle Datei als historische Versandfassung ausgeben.
|
||||
|
||||
## 9. Technische Umsetzung und Liefergrenze
|
||||
|
||||
Vor Änderungen `AGENTS.md`, aktuellen technischen Entwurf und vorhandene Dokumentation zum Ist-Datenmodell/API/Rechten lesen. Aktuelle Änderungen erhalten. Bestehende Elemente, Einbindungen, Quellidentitäten, Media-Speicherung, Audit/Versionskonflikte, Leser und Export nutzen. Die konkrete Speicherung entscheidet der Coder im Bestand; keine Tabellenstruktur aus diesem Fachauftrag blind übernehmen.
|
||||
|
||||
Zuerst knapp festhalten, welche vorhandenen Modelle erweitert werden und wie Anlagenverwendung, Versandmanifest, wiederabrufbare Fassung und Nachweisrolle voneinander getrennt werden. Technischen Entwurf/API-Dokumentation gezielt aktualisieren und anschließend den gesamten Ablauf implementieren. Nicht nach Spezifikation, leeren Tabellen oder bloßen UI-Attrappen aufhören. Kleine umsetzbare Schritte sind sinnvoll, das Ergebnis muss alle hier beschriebenen Hauptabläufe abdecken.
|
||||
|
||||
Neue API-Mutationen müssen Kontextrechte, fremde IDs, Zyklus-/Doppelzuordnung, Validierung und gleichzeitige Änderungen behandeln. Abruffehler dürfen keinen als vollständig markierten halben Versand erzeugen. Dateien und vertrauliche Daten nicht in öffentlichen Assets oder Logs ablegen. Betrieb, Backup und bestehende Löschpfade müssen die neuen gespeicherten Fassungen einschließen.
|
||||
|
||||
Die kompakte Gestaltung einschließlich vorhandener Symbole, Punkt/Kasten, Aktion über das Richtungszeichen und mobiler Auszüge beibehalten. Keine neue Symbolfamilie oder frei erfundene Logos. Bestehende Funktionsicons verwenden.
|
||||
|
||||
## 10. Abnahme mit synthetischen Daten
|
||||
|
||||
1. Ein Schreiben, drei Anlagen mit verschiedenen Dokumentdaten und ein thematisches Unterkapitel. Anlagen gesammelt zuordnen, ordnen und eine lösen. Nach Neuladen stimmt alles; andere Einbindungen bleiben unverändert.
|
||||
2. Dasselbe Dokument ist Anlage eines zweiten Schreibens in anderem Kontext. Rollen/Reihenfolgen bleiben unabhängig; keine zusätzlichen Rechte und keine Dateikopie zur bloßen Organisation.
|
||||
3. Schreiben per E-Mail dokumentieren, vorhandene vollständige E-Mail als Nachweis zuordnen. Das Original hat dieselben drei Anhänge sowie einen weiteren, abweichenden Anhang. Gleiche Namen und unterschiedliche Inhalte gesondert prüfen. Kein automatisches falsches Zusammenführen, Original vollständig erreichbar und Abweichung sichtbar.
|
||||
4. Bereits eigenständige E-Mail bewusst in reine Nachweisdarstellung überführen und zurück. Andere Einbindung und Original bleiben erhalten. E-Mail mit fachlichem Zusatzinhalt eigenständig belassen und dennoch zuordnen.
|
||||
5. Nach dokumentiertem Versand Arbeitsdokument ändern, Anlagenliste ändern und externe aktuelle Fassung austauschen. Erster Versand bleibt in ursprünglicher Fassung lesbar/exportierbar. Fehlende alte Originale werden als Lücke behandelt, nicht durch aktuelle Dateien ersetzt.
|
||||
6. Zweiten Versand per Post mit anderem Datum, anderer Anlagenzusammenstellung und Einlieferungsbeleg dokumentieren. Spätere Zustellbestätigung ergänzen. Beide Versände und alle Nachweisrollen sind eindeutig; kein automatischer Status „zugestellt“ allein durch Einlieferung.
|
||||
7. Gliederung/Chronologie wechseln. 2023er Anlage in 2026er Versand verschiebt diesen nicht. Späterer Nachweis und eigenständige Rückfrage bleiben datiert. Mehrere unabhängige Zwischenstücke bleiben in Reihenfolge, keine Klammern und keine doppelten Ausgangsereignisse. Filter, Kontext, Rückkehr und eigene Ordnung erhalten.
|
||||
8. In einem Kapitel mit zwei direkten Einträgen und acht Unterkapitel-Inhalten Grenzen und Zähler prüfen. Keine doppelte Kapitelüberschrift. Auf 1280px, 390px und kurz 360px prüfen: klare Hierarchie, kompakte geschlossene Einheiten, Leser/Anlagen/Nachweise per Touch und Tastatur erreichbar. Größere Schrift darf umbrechen.
|
||||
9. Gesperrte Anlage und Nachweis in fremdem Kontext prüfen: weder Inhalt noch Metadaten/Zähler werden offengelegt, neue Fassungen umgehen die Einschränkung nicht. Lesender Nutzer kann keine Zuordnung oder Versanddaten ändern. Fremde IDs serverseitig abweisen.
|
||||
10. Vollständigen historischen Versand und einen bewussten Auszug exportieren. Manifest/Fassungen/Nachweise stimmen, vollständige EML bleibt einschließlich aller Anhänge erhalten; separat abgewählte Vorkommen ändern dies nicht. Fehlende Quellen/Fassungen/Rechte führen zu erklärten Lücken oder gezieltem Abbruch.
|
||||
11. Bestehende Bestandseinträge und Unterkapitel bleiben ohne automatische Umwandlung erhalten. Sammelzuordnung als Anlagen funktioniert; selbst erstellte Schriftstücke ohne Versand sind weiter nutzbar. Allgemeine Bezüge und vorhandenes Exportpaket regressionsprüfen.
|
||||
|
||||
Relevante Backend-/Interaktionsprüfungen für Rollen, gesicherte Fassungen, Kontexte, Export und Fehlerfälle sowie den vorhandenen Frontend-Build ausführen. Vorhandene Tests wiederverwenden und gezielt ergänzen; keine bloßen CSS-/Implementierungs-Abbildtests. Tatsächliche Bedienung und Screenshots synthetischer Beispiele liefern. Geplante, bestandene und blockierte Prüfungen trennen; alte Prüfberichte belegen keinen aktuellen Stand.
|
||||
|
||||
**Übergabepunkt:** lokal prüfbar implementiert, Migration und relevante Doku aktualisiert, Hauptabläufe getestet, Einschränkungen benannt. Kein Commit, Push oder Deployment durch diesen Auftrag. Ein Push auf `develop` startet Development; Production bleibt separat. Keine Nachricht an andere Chats oder externe Empfänger versenden.
|
||||
@@ -1,5 +1,7 @@
|
||||
# Auftrag an Cursor: Unterkapitel in Tsumugu
|
||||
|
||||
**Spätere fachliche Erweiterung, 18.10.2026:** [Schreiben mit Anlagen und Versand/Nachweisen](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md), Produkt F-08b/c. Der folgende Ausschluss eines Hauptdokuments/Dokumentpakets bezeichnet die damalige Liefergrenze. Der neue Auftrag ergänzt diese Funktion gezielt; die Kapitel bleiben unabhängig davon reine Gliederung. Keine automatische Umwandlung bestehender Unterkapitel.
|
||||
|
||||
Stand: 17.10.2026. Vorbereiteter Umsetzungsauftrag nach fachlicher Abstimmung. Dieser Chat hat keine Anwendung implementiert. Der Auftrag wird durch die Übergabe an Cursor erteilt.
|
||||
|
||||
## 1. Ziel und bestätigte Fachentscheidung
|
||||
|
||||
@@ -1,6 +1,8 @@
|
||||
# Tsumugu – Ergänzung zur Bedienung, Orientierung und Aktenordnung im MVP
|
||||
|
||||
**Stand:** 17.10.2026 · **Fassung:** 0.8, Unterkapitel in der bestehenden Gliederung; Fassung 0.7 zur kompakten Liste bleibt erhalten.
|
||||
**Stand:** 18.10.2026 · **Fassung:** 0.9, klare Kapitelgrenzen, Schreiben mit Anlagen und Versand/Nachweise.
|
||||
|
||||
**Aktueller Ausbau F-08b/c:** [Schreiben, Anlagen, Versand und Kapitelgrenzen – gemeinsamer Auftrag](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md). Anlagen sind eine neue ausdrückliche Inhaltsverwendung; Unterkapitel bleiben thematische Gliederung. Schreiben werden mit ihren Anlagen kompakt dargestellt, Versand mit konkretem übermitteltem Stand und vollständigen Nachweisen dokumentiert. E-Mails bleiben vollständig erhalten, ihre reine Nachweisdarstellung kann redundante Einträge im aktiven Kontext vermeiden. Gliederung und durchgehende Chronologie unterscheiden; keine stillen Datumsänderungen oder Umdeutung allgemeiner Bezüge. Kapitel/Unterkapitel durch Flächen/Typografie/Einrückung abgrenzen, doppelte Überschrift und unklare Zählwerte korrigieren. Kompakte Liste, bestehende Symbole und Kontextrechte bleiben erhalten. Der Auftrag legt die neue Darstellung gegenüber widersprechenden älteren Vorgaben fest; keine Umsetzung wird hiermit als bereits fertig behauptet.
|
||||
|
||||
**Neuester Auftrag F-06f:** [Kompakte Inhaltsliste – vollständige Anforderungen und Cursor-Auftrag](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md). Diese spätere Präzisierung ersetzt widersprechende ältere Darstellungsvorgaben in diesem Dokument: dauerhaftes Richtungs-Dropdown, nicht anklickbare Richtungsgrafik, fehlendes Zeichen für bewusst Lokal, Kapitelwiederholung und aufgeklappte Bezugskarten/Beziehungsleisten. Richtung direkt über das Zeichen wählen, Lokal als Punkt, Keine Angabe als leerer umrandeter Kasten ohne Checkbox-Semantik, Bezüge nur als kompakter Auslöser. Kapitel-/Vorgangsköpfe und mobile Auszüge verkürzen, Inhaltstypen, Reihenfolge, Rechte und ausführlichen Leser erhalten.
|
||||
|
||||
@@ -309,6 +311,8 @@ Ein Push auf `develop` löst laut Repository einen Development-Deploy aus. Der r
|
||||
|
||||
## 15. Fortschreibung
|
||||
|
||||
- **0.9:** F-08b/c: Hauptschriftstück und Anlagen ausdrücklich zuordnen; Versand mit Nachweisen und abrufbarem übermitteltem Stand. Redundante Nachweis-E-Mails bewusst kompakt darstellen; Original vollständig bewahren. Klare Kapitelgrenzen/Zähler und durchgehende Chronologie präzisiert. Gemeinsamer Auftrag und Abnahmefälle verlinkt.
|
||||
|
||||
- **0.8:** F-08a: verschachtelte Kapitel ohne eigene Rechte. Pfad, Mehrfachauswahl, Umhängen und Auflösen in der bestehenden Navigation und im vorhandenen Export. Teilvorgänge bleiben eigene Objekte.
|
||||
|
||||
- **0.7:** F-06f: konsolidierter Auftrag zur Reduktion der Eintrags- und Kopfhöhe; Richtungszeichen als direkte Bedienung und Punkt für Lokal. Bezugsdetails erst bei Bedarf, keine Klammern/Leisten oder zusätzliche Reihenfolgeänderung. Abnahme mit mehreren unabhängigen Zwischenstücken und vergleichbaren Zeilenhöhen.
|
||||
|
||||
@@ -10,6 +10,8 @@ Die ausgewählte Tsumugu-Oberfläche wird im vorhandenen Produkt umgesetzt. Dara
|
||||
|
||||
## 2. Führende Quellen und gezielte Lesereihenfolge
|
||||
|
||||
**Aktueller Auftrag vom 18.10.2026, Produkt 0.38 / UX 0.9:** [Schreiben mit Anlagen, Versand/Nachweise und Kapitelgrenzen](TSUMUGU_SCHREIBEN_ANLAGEN_VERSAND_AUFTRAG_2026-10-18.md). Der Nutzer beauftragt die Anforderungen und den Cursor-Prompt nach Besprechung der fachlichen Lücke. Anlagenzuordnung und Versand/Nachweise sind neue Funktionen. Hauptschriftstück mit geordneten Anlagen, konkrete übermittelte Fassung, E-Mail/Einlieferungsbeleg als Nachweis, bewusste kompakte Nachweisdarstellung, verständliche Gliederung/Chronologie und bestehender vollständiger Export bilden den nächsten zusammenhängenden Ausbau. Historische Beschränkung „kein Hauptdokument/kein Sammler“ der Unterkapitellieferung ist keine Blockade dieses neuen Auftrags. Unterkapitel, Kontextrechte und ursprüngliche E-Mails bleiben erhalten. Keine Umsetzung, Migration oder Bereitstellung durch diesen Dokumentationsauftrag.
|
||||
|
||||
**Unterkapitel, Produkt 0.37:** [Auftrag Unterkapitel](TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md) und F-08a. Unterkapitel sind reine verschachtelte Gliederung ohne eigene Rechte. Die frühere Zurückstellung ist historisch. Kein zusätzlicher Sammler und keine Freigabezusammenstellung.
|
||||
|
||||
**Neueste Präzisierung, Produkt 0.36 / UX 0.7:** [Kompakte Inhaltsliste und Bezüge](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md) ist der aktuelle UI-Auftrag. Richtung direkt am Zeichen ändern, Lokal als Punkt, Keine Angabe als leerer Kasten. Keine permanenten Dropdowns, Kapitelwiederholungen oder aufgeklappten Bezugskarten. Bezüge bleiben an ihren Listenpositionen und werden erst auf Anforderung aufgefächert; keine Verbindungsklammern/Beziehungsleisten über unabhängige Zwischenstücke. Symbolpaket 1.4 liefert die neuen Einzeldateien. Frühere Versionsangaben und Live-Befunde unten beschreiben den vorherigen Stand; zuletzt war das Notizmotiv korrekt eingebunden. Die fachliche Exportplanung bleibt erhalten.
|
||||
|
||||
Reference in new issue
Block a user