From e4380261fc26dc4d12a2d88ab7f0c76f5c4d177b Mon Sep 17 00:00:00 2001 From: Lars Date: Sat, 17 Oct 2026 21:13:21 +0200 Subject: [PATCH] Verkuerze die Inhaltsliste und fuehre Unterkapitel ein, damit Richtung, Bezuge und Struktur ohne Zusatzzeilen bedienbar bleiben. Co-authored-by: Cursor --- backend/app/api/routes.py | 98 +- backend/app/api/schemas.py | 14 + backend/app/exporting.py | 64 +- backend/app/ops.py | 230 ++++- backend/app/present.py | 4 +- .../20261017T210000Z_chapter_parent.sql | 54 ++ backend/tests/test_chapters.py | 338 +++++++ backend/tests/test_export.py | 177 ++++ docs/architecture/TSUMUGU_TECHNICAL_SPEC.md | 3 +- .../TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md | 4 +- .../TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md | 79 ++ docs/product/TSUMUGU_PRODUCT_SPEC.md | 26 +- .../TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md | 2 + ...TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md | 107 +++ docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md | 9 +- ...MUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md | 6 +- .../dark/communication-local.svg | 1 + .../dark/communication-unspecified.svg | 1 + .../light/communication-local.svg | 1 + .../light/communication-unspecified.svg | 1 + frontend/src/content-symbol.mjs | 4 + frontend/src/list-meta.mjs | 33 + frontend/src/list-meta.test.mjs | 38 + frontend/src/pages/Cases.jsx | 65 +- frontend/src/pages/Matters.jsx | 44 +- frontend/src/pages/Shell.jsx | 30 +- frontend/src/pages/chapters.js | 82 ++ frontend/src/pages/content.jsx | 898 +++++++++++++----- frontend/src/pages/workspace.jsx | 112 ++- frontend/src/styles.css | 289 ++++-- 30 files changed, 2384 insertions(+), 430 deletions(-) create mode 100644 backend/migrations/20261017T210000Z_chapter_parent.sql create mode 100644 backend/tests/test_chapters.py create mode 100644 docs/product/TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md create mode 100644 docs/product/TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md create mode 100644 frontend/public/ui/content-symbols-v1/dark/communication-local.svg create mode 100644 frontend/public/ui/content-symbols-v1/dark/communication-unspecified.svg create mode 100644 frontend/public/ui/content-symbols-v1/light/communication-local.svg create mode 100644 frontend/public/ui/content-symbols-v1/light/communication-unspecified.svg create mode 100644 frontend/src/list-meta.mjs create mode 100644 frontend/src/list-meta.test.mjs create mode 100644 frontend/src/pages/chapters.js diff --git a/backend/app/api/routes.py b/backend/app/api/routes.py index 0ac6cba..18a8b1c 100644 --- a/backend/app/api/routes.py +++ b/backend/app/api/routes.py @@ -44,6 +44,8 @@ from app.api.schemas import ( CasePatch, ChapterDateIn, ChapterDeleteIn, + ChapterParentIn, + BindingChaptersIn, ChapterTitleIn, CommunicationIn, MatterMoveIn, @@ -126,6 +128,8 @@ from app.ops import ( patch_task, revoke_grant, move_binding_chapter, + move_bindings_chapter, + move_chapter_parent, move_matter, reorder_bindings, rename_chapter, @@ -174,6 +178,16 @@ def _ctx_model(value) -> Ctx | None: return None if value is None else Ctx(value.kind, value.id) +def _chapter_payload(row) -> dict: + return { + "id": str(row["id"]), + "title": row["title"], + "position": row["position"], + "document_on": dump_date(row["document_on"]), + "parent_chapter_id": str(row["parent_chapter_id"]) if row["parent_chapter_id"] else None, + } + + def _session_body(conn, account_id: UUID, scope_kind: str, scope_id: UUID, csrf: str, epoch: int) -> dict: account = conn.execute( "SELECT id, email, display_name, is_superadmin FROM auth_accounts WHERE id = %s", @@ -588,10 +602,20 @@ def post_case_chapter( principal: Principal = Depends(get_principal), conn: Connection = Depends(get_conn), ): - row = create_chapter(conn, principal.account_id, "case", case_id, body.title, body.position, None, body.document_on) + row = create_chapter( + conn, + principal.account_id, + "case", + case_id, + body.title, + body.position, + None, + body.document_on, + body.parent_chapter_id, + ) return _created( f"/api/v1/cases/{case_id}/chapters/{row['id']}", - {"id": str(row["id"]), "title": row["title"], "position": row["position"], "document_on": dump_date(row["document_on"])}, + _chapter_payload(row), ) @@ -678,11 +702,19 @@ def post_matter_chapter( ): context = parse_query_context(context_kind, context_id) row = create_chapter( - conn, principal.account_id, "matter", matter_id, body.title, body.position, context, body.document_on + conn, + principal.account_id, + "matter", + matter_id, + body.title, + body.position, + context, + body.document_on, + body.parent_chapter_id, ) return _created( f"/api/v1/matters/{matter_id}/chapters/{row['id']}", - {"id": str(row["id"]), "title": row["title"], "position": row["position"], "document_on": dump_date(row["document_on"])}, + _chapter_payload(row), ) @@ -725,6 +757,24 @@ def post_delete_chapter( return {"version": version} +@router.post("/api/v1/chapters/{chapter_id}/parent") +def post_chapter_parent( + chapter_id: UUID, + body: ChapterParentIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + version = move_chapter_parent( + conn, + principal.account_id, + chapter_id, + body.expected_version, + body.parent_chapter_id, + _ctx_model(body.context), + ) + return {"version": version, "parent_chapter_id": str(body.parent_chapter_id) if body.parent_chapter_id else None} + + @router.post("/api/v1/cases/{case_id}/delete") def post_delete_case( case_id: UUID, @@ -1426,6 +1476,26 @@ def post_case_binding_order( return {"version": version} +@router.post("/api/v1/cases/{case_id}/bindings/chapters") +def post_case_binding_chapters( + case_id: UUID, + body: BindingChaptersIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + version = move_bindings_chapter( + conn, + principal.account_id, + "case", + case_id, + body.expected_version, + body.binding_ids, + body.chapter_id, + None, + ) + return {"version": version} + + @router.patch("/api/v1/matters/{matter_id}/content-order") def patch_matter_order( matter_id: UUID, @@ -1465,6 +1535,26 @@ def post_matter_binding_order( return {"version": version} +@router.post("/api/v1/matters/{matter_id}/bindings/chapters") +def post_matter_binding_chapters( + matter_id: UUID, + body: BindingChaptersIn, + principal: Principal = Depends(get_principal), + conn: Connection = Depends(get_conn), +): + version = move_bindings_chapter( + conn, + principal.account_id, + "matter", + matter_id, + body.expected_version, + body.binding_ids, + body.chapter_id, + _ctx_model(body.context), + ) + return {"version": version} + + @router.patch("/api/v1/elements/{element_id}/dates") def patch_element_dates( element_id: UUID, diff --git a/backend/app/api/schemas.py b/backend/app/api/schemas.py index df58f25..d7e678a 100644 --- a/backend/app/api/schemas.py +++ b/backend/app/api/schemas.py @@ -79,6 +79,7 @@ class ChapterIn(APIModel): title: str = Field(min_length=1, max_length=200) position: int | None = Field(default=None, ge=0, le=10000) document_on: date | None = None + parent_chapter_id: UUID | None = None class ChapterOrderIn(APIModel): @@ -104,6 +105,19 @@ class ChapterDeleteIn(APIModel): context: ContextIn | None = None +class ChapterParentIn(APIModel): + expected_version: int = Field(ge=1) + parent_chapter_id: UUID | None = None + context: ContextIn | None = None + + +class BindingChaptersIn(APIModel): + expected_version: int = Field(ge=1) + binding_ids: list[UUID] = Field(min_length=1, max_length=500) + chapter_id: UUID | None = None + context: ContextIn | None = None + + class RecordDeleteIn(APIModel): expected_version: int = Field(ge=1) context: ContextIn | None = None diff --git a/backend/app/exporting.py b/backend/app/exporting.py index a3b07d5..9686872 100644 --- a/backend/app/exporting.py +++ b/backend/app/exporting.py @@ -252,22 +252,7 @@ def _matter_node(conn, actor, matter, page: Ctx, root: bool) -> ExportNode: for binding in bindings: grouped.setdefault(binding.get("chapter_id"), []).append(binding) children: list[ExportNode] = [] - for chapter in chapters: - items = grouped.get(chapter["id"], []) - if not items: - continue - children.append( - ExportNode( - id=f"chapter:{chapter['id']}", - kind="chapter", - title=chapter["title"], - exportable=True, - reason=None, - content_kind=None, - children=[_binding_node(item) for item in items], - label="Kapitel", - ) - ) + children.extend(_chapter_nodes(chapters, grouped)) for binding in grouped.get(None, []): children.append(_binding_node(binding)) rows = conn.execute( @@ -290,6 +275,35 @@ def _matter_node(conn, actor, matter, page: Ctx, root: bool) -> ExportNode: ) +def _chapter_nodes(chapters: list[dict], grouped: dict[str | None, list]) -> list[ExportNode]: + by_parent: dict[str | None, list[dict]] = {} + for chapter in chapters: + by_parent.setdefault(chapter.get("parent_chapter_id"), []).append(chapter) + + def build(parent_id: str | None) -> list[ExportNode]: + nodes: list[ExportNode] = [] + for chapter in by_parent.get(parent_id, []): + nested = build(chapter["id"]) + items = [_binding_node(item) for item in grouped.get(chapter["id"], [])] + if not items and not nested: + continue + nodes.append( + ExportNode( + id=f"chapter:{chapter['id']}", + kind="chapter", + title=chapter["title"], + exportable=True, + reason=None, + content_kind=None, + children=[*items, *nested], + label="Unterkapitel" if parent_id else "Kapitel", + ) + ) + return nodes + + return build(None) + + def _binding_node(binding: dict) -> ExportNode: element = binding["element"] rights = binding["rights"] @@ -454,7 +468,7 @@ def _layout(root, chosen, loaded, notices, generated: str): numbers = {child.id: index + 1 for index, child in enumerate(folders)} for child in node.children: if child.id in numbers: - folder = prefix + [f"{numbers[child.id]:02d} {_segment(child.title)}"] + folder = prefix + [_folder_name(child.title, numbers[child.id], prefix)] if child.kind == "binding" and child.content_kind == "email": _emit_email(child, folder, add, rewrite, entries, loaded, notice_for, generated) else: @@ -726,7 +740,7 @@ def _recorded(node: ExportNode) -> str | None: return node.dates.get("recorded_at") -def _segment(value: str) -> str: +def _segment(value: str, limit: int = 80) -> str: cleaned = [] for char in value or "": if char in '\\/:*?"<>|' or ord(char) < 32: @@ -734,7 +748,19 @@ def _segment(value: str) -> str: else: cleaned.append(char) text = " ".join("".join(cleaned).split()).strip(" .") - return (text or "Inhalt")[:80] + if text in {"", ".", ".."}: + text = "Inhalt" + return text[:limit] + + +def _folder_name(title: str, number: int, prefix: list[str]) -> str: + """Keep a readable directory name inside a bounded path. The overview keeps the full title.""" + limit = 80 + while True: + name = f"{number:02d} {_segment(title, limit)}" + if len("/".join([*prefix, name])) <= 180 or limit <= 24: + return name + limit -= 8 def _file_segment(value: str) -> str: diff --git a/backend/app/ops.py b/backend/app/ops.py index 7019157..1332601 100644 --- a/backend/app/ops.py +++ b/backend/app/ops.py @@ -37,6 +37,8 @@ from app.core.errors import forbidden, not_found, unprocessable from app.core.timeutil import utcnow from app.media.storage import asset_path, display_filename, sha256, sniff, write_bytes +MAX_CHAPTER_DEPTH = 32 + def _ctx(value) -> Ctx | None: if value is None: @@ -121,6 +123,105 @@ def patch_case(conn, actor: UUID, case_id: UUID, expected: int, title: str | Non return updated +def _chapter_column(kind: str) -> str: + return "case_id" if kind == "case" else "matter_id" + + +def _parent_chain(conn, chapter_id: UUID | None) -> list[UUID]: + chain: list[UUID] = [] + current = chapter_id + seen: set[UUID] = set() + while current and current not in seen: + seen.add(current) + chain.append(current) + row = conn.execute("SELECT parent_chapter_id FROM chapters WHERE id = %s", (current,)).fetchone() + current = row["parent_chapter_id"] if row else None + return chain + + +def _subtree_height(conn, chapter_id: UUID) -> int: + rows = conn.execute("SELECT id FROM chapters WHERE parent_chapter_id = %s", (chapter_id,)).fetchall() + if not rows: + return 1 + return 1 + max(_subtree_height(conn, row["id"]) for row in rows) + + +def _assert_chapter_parent( + conn, + kind: str, + container_id: UUID, + parent_id: UUID | None, + moving_id: UUID | None = None, +) -> None: + if parent_id is None: + return + if moving_id is not None and parent_id == moving_id: + raise unprocessable("Ein Kapitel kann nicht unter sich selbst stehen.") + column = _chapter_column(kind) + parent = conn.execute( + f"SELECT id FROM chapters WHERE id = %s AND {column} = %s", + (parent_id, container_id), + ).fetchone() + if parent is None: + raise unprocessable("Das Elternkapitel gehört nicht zu diesem Kontext.") + if moving_id is not None and moving_id in _parent_chain(conn, parent_id): + raise unprocessable("Diese Zuordnung würde einen Kreis erzeugen.") + extra = _subtree_height(conn, moving_id) if moving_id is not None else 1 + if len(_parent_chain(conn, parent_id)) + extra > MAX_CHAPTER_DEPTH: + raise unprocessable( + f"Die Kapiteltiefe überschreitet die technische Schutzgrenze von {MAX_CHAPTER_DEPTH} Ebenen." + ) + + +def _sibling_ids(conn, kind: str, container_id: UUID, parent_id: UUID | None) -> list[UUID]: + column = _chapter_column(kind) + if parent_id is None: + rows = conn.execute( + f""" + SELECT id FROM chapters + WHERE {column} = %s AND parent_chapter_id IS NULL + ORDER BY position, id + """, + (container_id,), + ).fetchall() + else: + rows = conn.execute( + f""" + SELECT id FROM chapters + WHERE {column} = %s AND parent_chapter_id = %s + ORDER BY position, id + """, + (container_id, parent_id), + ).fetchall() + return [row["id"] for row in rows] + + +def _renumber_chapters(conn, chapter_ids: list[UUID]) -> None: + for index, chapter_id in enumerate(chapter_ids): + conn.execute("UPDATE chapters SET position = %s WHERE id = %s", (index, chapter_id)) + + +def _next_sibling_position(conn, kind: str, container_id: UUID, parent_id: UUID | None) -> int: + column = _chapter_column(kind) + if parent_id is None: + row = conn.execute( + f""" + SELECT COALESCE(MAX(position), -1) + 1 AS pos FROM chapters + WHERE {column} = %s AND parent_chapter_id IS NULL + """, + (container_id,), + ).fetchone() + else: + row = conn.execute( + f""" + SELECT COALESCE(MAX(position), -1) + 1 AS pos FROM chapters + WHERE {column} = %s AND parent_chapter_id = %s + """, + (container_id, parent_id), + ).fetchone() + return int(row["pos"]) + + def create_chapter( conn, actor: UUID, @@ -130,33 +231,30 @@ def create_chapter( position: int | None, context: Ctx | None, document_on: date | None = None, + parent_chapter_id: UUID | None = None, ) -> dict: if kind == "case": container, _rights = require_case(conn, actor, container_id, "edit") else: container, _rights = require_matter(conn, actor, container_id, context, "edit") + _assert_chapter_parent(conn, kind, container_id, parent_chapter_id) if position is None: - column = "case_id" if kind == "case" else "matter_id" - current = conn.execute( - f"SELECT COALESCE(MAX(position), -1) + 1 AS pos FROM chapters WHERE {column} = %s", - (container_id,), - ).fetchone() - position = int(current["pos"]) + position = _next_sibling_position(conn, kind, container_id, parent_chapter_id) if kind == "case": row = conn.execute( """ - INSERT INTO chapters (home_scope_id, case_id, title, position, document_on) - VALUES (%s, %s, %s, %s, %s) RETURNING * + INSERT INTO chapters (home_scope_id, case_id, title, position, document_on, parent_chapter_id) + VALUES (%s, %s, %s, %s, %s, %s) RETURNING * """, - (container["home_scope_id"], container_id, title.strip(), position, document_on), + (container["home_scope_id"], container_id, title.strip(), position, document_on, parent_chapter_id), ).fetchone() else: row = conn.execute( """ - INSERT INTO chapters (home_scope_id, matter_id, title, position, document_on) - VALUES (%s, %s, %s, %s, %s) RETURNING * + INSERT INTO chapters (home_scope_id, matter_id, title, position, document_on, parent_chapter_id) + VALUES (%s, %s, %s, %s, %s, %s) RETURNING * """, - (container["home_scope_id"], container_id, title.strip(), position, document_on), + (container["home_scope_id"], container_id, title.strip(), position, document_on, parent_chapter_id), ).fetchone() audit(conn, actor, container["home_scope_id"], "chapter_created", kind, container_id, context) return row @@ -182,16 +280,28 @@ def reorder_chapters( if not rights.edit: raise forbidden() version = bump_version(conn, table, container_id, expected) - rows = conn.execute(f"SELECT id FROM chapters WHERE {column} = %s", (container_id,)).fetchall() - existing = [row["id"] for row in rows] + rows = conn.execute( + f"SELECT id, parent_chapter_id FROM chapters WHERE {column} = %s", + (container_id,), + ).fetchall() + existing = {row["id"]: row["parent_chapter_id"] for row in rows} if len(chapter_ids) != len(set(chapter_ids)): raise unprocessable("Dasselbe Kapitel steht mehrfach in der Ordnung.") - if any(item not in set(existing) for item in chapter_ids): + if any(item not in existing for item in chapter_ids): raise not_found() - if set(chapter_ids) != set(existing): + if not chapter_ids: + if existing: + raise unprocessable("Die Kapitelordnung ist unvollständig. Bitte neu laden.") + audit(conn, actor, container["home_scope_id"], "chapters_reordered", kind, container_id, context) + return version + parents = {existing[item] for item in chapter_ids} + if len(parents) != 1: + raise unprocessable("Die Kapitelordnung mischt verschiedene Ebenen.") + parent_id = next(iter(parents)) + siblings = {item for item, parent in existing.items() if parent == parent_id} + if set(chapter_ids) != siblings: raise unprocessable("Die Kapitelordnung ist unvollständig. Bitte neu laden.") - for index, chapter_id in enumerate(chapter_ids): - conn.execute("UPDATE chapters SET position = %s WHERE id = %s", (index, chapter_id)) + _renumber_chapters(conn, chapter_ids) audit(conn, actor, container["home_scope_id"], "chapters_reordered", kind, container_id, context) return version @@ -315,14 +425,96 @@ def rename_chapter(conn, actor: UUID, chapter_id: UUID, expected: int, title: st def delete_chapter(conn, actor: UUID, chapter_id: UUID, expected: int, context: Ctx | None) -> int: + """Dissolve one chapter. Direct bindings and direct children move to its parent.""" chapter, container, kind = _chapter_container(conn, actor, chapter_id, context) version = bump_version(conn, "cases" if kind == "case" else "matters", container["id"], expected) - conn.execute("UPDATE bindings SET chapter_id = NULL WHERE chapter_id = %s", (chapter["id"],)) + parent_id = chapter["parent_chapter_id"] + children = _sibling_ids(conn, kind, container["id"], chapter["id"]) + siblings = _sibling_ids(conn, kind, container["id"], parent_id) + merged: list[UUID] = [] + for item in siblings: + if item == chapter["id"]: + merged.extend(children) + else: + merged.append(item) + if children: + conn.execute( + "UPDATE chapters SET parent_chapter_id = %s WHERE parent_chapter_id = %s", + (parent_id, chapter["id"]), + ) + _renumber_chapters(conn, merged) + conn.execute("UPDATE bindings SET chapter_id = %s WHERE chapter_id = %s", (parent_id, chapter["id"])) conn.execute("DELETE FROM chapters WHERE id = %s", (chapter["id"],)) audit(conn, actor, container["home_scope_id"], "chapter_deleted", kind, container["id"], context) return version +def move_chapter_parent( + conn, + actor: UUID, + chapter_id: UUID, + expected: int, + parent_id: UUID | None, + context: Ctx | None, +) -> int: + """Reparent one chapter inside its own container. The subtree stays together.""" + chapter, container, kind = _chapter_container(conn, actor, chapter_id, context) + if chapter["parent_chapter_id"] == parent_id: + return bump_version(conn, "cases" if kind == "case" else "matters", container["id"], expected) + _assert_chapter_parent(conn, kind, container["id"], parent_id, chapter["id"]) + version = bump_version(conn, "cases" if kind == "case" else "matters", container["id"], expected) + old_siblings = [item for item in _sibling_ids(conn, kind, container["id"], chapter["parent_chapter_id"]) if item != chapter["id"]] + _renumber_chapters(conn, old_siblings) + position = len(_sibling_ids(conn, kind, container["id"], parent_id)) + conn.execute( + "UPDATE chapters SET parent_chapter_id = %s, position = %s WHERE id = %s", + (parent_id, position, chapter["id"]), + ) + audit(conn, actor, container["home_scope_id"], "chapter_moved", kind, container["id"], context) + return version + + +def move_bindings_chapter( + conn, + actor: UUID, + kind: str, + container_id: UUID, + expected: int, + binding_ids: list[UUID], + chapter_id: UUID | None, + context: Ctx | None, +) -> int: + """Move visible bindings inside one container. One failure leaves every binding in place.""" + if kind == "case": + container, rights = require_case(conn, actor, container_id, "edit") + table = "cases" + page = Ctx("case", container_id) + else: + container, rights = require_matter(conn, actor, container_id, context, "edit") + table = "matters" + page = context or Ctx("matter", container_id) + if not rights.edit: + raise forbidden() + if len(binding_ids) != len(set(binding_ids)): + raise unprocessable("Dieselbe Einbindung steht mehrfach in der Auswahl.") + chapter_for(conn, chapter_id, kind, container_id) + rows = conn.execute( + "SELECT id, element_id FROM bindings WHERE context_kind = %s AND context_id = %s", + (kind, container_id), + ).fetchall() + by_id = {row["id"]: row for row in rows} + for binding_id in binding_ids: + row = by_id.get(binding_id) + if row is None: + raise not_found() + require_element(conn, actor, row["element_id"], page, "read") + version = bump_version(conn, table, container_id, expected) + for binding_id in binding_ids: + conn.execute("UPDATE bindings SET chapter_id = %s WHERE id = %s", (chapter_id, binding_id)) + audit(conn, actor, container["home_scope_id"], "binding_chapter", kind, container_id, page) + return version + + def delete_case(conn, actor: UUID, case_id: UUID, expected: int) -> None: case, rights = require_case(conn, actor, case_id, "edit") if not rights.edit: diff --git a/backend/app/present.py b/backend/app/present.py index 7ab2bbc..9fba596 100644 --- a/backend/app/present.py +++ b/backend/app/present.py @@ -33,7 +33,7 @@ def rights_dict(rights) -> dict: def _chapters(conn, kind: str, container_id: UUID, mode: str = "position", direction: str = "asc") -> list[dict]: column = "case_id" if kind == "case" else "matter_id" rows = conn.execute( - f"SELECT id, title, position, document_on FROM chapters WHERE {column} = %s", + f"SELECT id, title, position, document_on, parent_chapter_id FROM chapters WHERE {column} = %s", (container_id,), ).fetchall() items = [ @@ -42,6 +42,7 @@ def _chapters(conn, kind: str, container_id: UUID, mode: str = "position", direc "title": row["title"], "position": row["position"], "document_on": dump_date(row["document_on"]), + "parent_chapter_id": str(row["parent_chapter_id"]) if row["parent_chapter_id"] else None, } for row in rows ] @@ -956,6 +957,7 @@ LABELS = { "binding_chapter": "In ein Kapitel eingeordnet", "chapters_reordered": "Kapitelreihenfolge geändert", "chapter_dated": "Kapiteldatum geändert", + "chapter_moved": "Kapitel umgehängt", "content_order": "Ordnungsart geändert", "content_reordered": "Eigene Reihenfolge geändert", } diff --git a/backend/migrations/20261017T210000Z_chapter_parent.sql b/backend/migrations/20261017T210000Z_chapter_parent.sql new file mode 100644 index 0000000..43ed897 --- /dev/null +++ b/backend/migrations/20261017T210000Z_chapter_parent.sql @@ -0,0 +1,54 @@ +ALTER TABLE chapters + ADD COLUMN parent_chapter_id uuid; + +ALTER TABLE chapters + ADD CONSTRAINT chapters_not_self + CHECK (parent_chapter_id IS NULL OR parent_chapter_id <> id); + +ALTER TABLE chapters + ADD CONSTRAINT chapters_parent_fk + FOREIGN KEY (parent_chapter_id) REFERENCES chapters (id); + +CREATE INDEX chapters_parent ON chapters (parent_chapter_id); + +CREATE FUNCTION chapters_parent_guard() RETURNS trigger +LANGUAGE plpgsql AS $$ +DECLARE + parent chapters%ROWTYPE; + current_id uuid; + seen uuid[] := ARRAY[]::uuid[]; + depth integer := 1; +BEGIN + IF NEW.parent_chapter_id IS NULL THEN + RETURN NEW; + END IF; + SELECT * INTO parent FROM chapters WHERE id = NEW.parent_chapter_id; + IF NOT FOUND THEN + RAISE EXCEPTION 'Kapiteleltern ungültig'; + END IF; + IF NEW.case_id IS DISTINCT FROM parent.case_id + OR NEW.matter_id IS DISTINCT FROM parent.matter_id + OR NEW.home_scope_id IS DISTINCT FROM parent.home_scope_id THEN + RAISE EXCEPTION 'Kapiteleltern ungültig'; + END IF; + current_id := NEW.parent_chapter_id; + WHILE current_id IS NOT NULL LOOP + IF current_id = NEW.id OR current_id = ANY (seen) THEN + RAISE EXCEPTION 'Kapiteleltern ungültig'; + END IF; + seen := array_append(seen, current_id); + depth := depth + 1; + IF depth > 32 THEN + RAISE EXCEPTION 'Kapiteleltern ungültig'; + END IF; + SELECT parent_chapter_id INTO current_id FROM chapters WHERE id = current_id; + END LOOP; + RETURN NEW; +END; +$$; + +CREATE TRIGGER chapters_parent_guard + BEFORE INSERT OR UPDATE OF parent_chapter_id, case_id, matter_id, home_scope_id + ON chapters + FOR EACH ROW + EXECUTE FUNCTION chapters_parent_guard(); diff --git a/backend/tests/test_chapters.py b/backend/tests/test_chapters.py new file mode 100644 index 0000000..c209230 --- /dev/null +++ b/backend/tests/test_chapters.py @@ -0,0 +1,338 @@ +"""Nested chapters stay outline only: same object, no rights, no partial moves.""" + +from __future__ import annotations + +import psycopg +import pytest + +from tests.support import Actor, binding_for, case_of, document, grant, matter_of, register + + +def _note(actor: Actor, title: str, matter: dict, chapter_id: str | None = None) -> dict: + body = { + "title": title, + "document": document(title), + "context": {"kind": "matter", "id": matter["id"]}, + } + if chapter_id: + body["chapter_id"] = chapter_id + return actor.request("POST", "/api/v1/notes", json=body, status=201) + + +def _detail(actor: Actor, matter_id: str) -> dict: + return actor.request("GET", f"/api/v1/matters/{matter_id}") + + +def _by_title(detail: dict) -> dict[str, dict]: + return {item["title"]: item for item in detail["chapters"]} + + +def test_flat_chapters_keep_identity_order_and_bindings(client, db): + ada = Actor(client, "ada-flach@example.test", "Ada Flach") + register(db, ada.email, ada.name) + ada.login() + matter = matter_of(ada, "Bestehender Vorgang") + first = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Schriftverkehr", "document_on": "2024-02-02"}, + status=201, + ) + second = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Nachweise", "document_on": "2024-01-01"}, + status=201, + ) + _note(ada, "Altes Schreiben", matter, first["id"]) + detail = _detail(ada, matter["id"]) + assert [item["id"] for item in detail["chapters"]] == [second["id"], first["id"]] + assert all(item["parent_chapter_id"] is None for item in detail["chapters"]) + assert binding_for(detail, "Altes Schreiben")["chapter_id"] == first["id"] + ada.login() + again = _detail(ada, matter["id"]) + assert [(item["id"], item["title"], item["parent_chapter_id"]) for item in again["chapters"]] == [ + (second["id"], "Nachweise", None), + (first["id"], "Schriftverkehr", None), + ] + assert binding_for(again, "Altes Schreiben")["chapter_id"] == first["id"] + + +def test_three_levels_bulk_move_reorder_reparent_and_dissolve(client, db): + ada = Actor(client, "ada-nest@example.test", "Ada Nest") + register(db, ada.email, ada.name) + ada.login() + matter = matter_of(ada, "Nebenkostenabrechnung") + root = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Nebenkostenabrechnung 2025"}, + status=201, + ) + sent = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Übermittelte Abrechnungsunterlagen", "parent_chapter_id": root["id"]}, + status=201, + ) + receipts = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Einzelbelege", "parent_chapter_id": sent["id"]}, + status=201, + ) + sibling = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Weiterer Ordner", "parent_chapter_id": root["id"]}, + status=201, + ) + _note(ada, "Anschreiben", matter, sent["id"]) + _note(ada, "Abrechnung", matter, sent["id"]) + _note(ada, "Rückfrage zur Abrechnung", matter, root["id"]) + _note(ada, "Antwort des Vermieters", matter, root["id"]) + for index in range(8): + ada.request( + "POST", + "/api/v1/external-refs", + json={ + "title": f"Beleg {index + 1}", + "source": "paperless", + "external_id": str(700 + index), + "context": {"kind": "matter", "id": matter["id"]}, + "chapter_id": root["id"], + }, + status=201, + ) + detail = _detail(ada, matter["id"]) + chapters = _by_title(detail) + assert chapters["Übermittelte Abrechnungsunterlagen"]["parent_chapter_id"] == root["id"] + assert chapters["Einzelbelege"]["parent_chapter_id"] == sent["id"] + assert binding_for(detail, "Rückfrage zur Abrechnung")["chapter_id"] == root["id"] + assert binding_for(detail, "Anschreiben")["chapter_id"] == sent["id"] + receipt_ids = [binding_for(detail, f"Beleg {index + 1}")["id"] for index in range(8)] + moved = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/bindings/chapters", + json={"expected_version": detail["version"], "binding_ids": receipt_ids, "chapter_id": receipts["id"]}, + ) + detail = _detail(ada, matter["id"]) + assert detail["version"] == moved["version"] + assert all(binding_for(detail, f"Beleg {index + 1}")["chapter_id"] == receipts["id"] for index in range(8)) + assert binding_for(detail, "Rückfrage zur Abrechnung")["chapter_id"] == root["id"] + assert binding_for(detail, "Anschreiben")["chapter_id"] == sent["id"] + stale = detail["version"] + ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/bindings/chapters", + json={ + "expected_version": stale, + "binding_ids": [receipt_ids[0], "00000000-0000-4000-8000-000000000099"], + "chapter_id": root["id"], + }, + status=404, + ) + detail = _detail(ada, matter["id"]) + assert detail["version"] == stale + assert binding_for(detail, "Beleg 1")["chapter_id"] == receipts["id"] + + ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters/order", + json={"expected_version": detail["version"], "chapter_ids": [sibling["id"], sent["id"]]}, + ) + detail = _detail(ada, matter["id"]) + ordered = [item["id"] for item in detail["chapters"] if item["parent_chapter_id"] == root["id"]] + assert ordered == [sibling["id"], sent["id"]] + assert _by_title(detail)["Einzelbelege"]["parent_chapter_id"] == sent["id"] + ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters/order", + json={"expected_version": detail["version"], "chapter_ids": [root["id"], sent["id"]]}, + status=422, + ) + + stale_parent = detail["version"] + ada.request( + "POST", + f"/api/v1/chapters/{receipts['id']}/parent", + json={"expected_version": stale_parent, "parent_chapter_id": root["id"]}, + ) + detail = _detail(ada, matter["id"]) + assert _by_title(detail)["Einzelbelege"]["parent_chapter_id"] == root["id"] + assert all(binding_for(detail, f"Beleg {index + 1}")["chapter_id"] == receipts["id"] for index in range(8)) + ada.login() + detail = _detail(ada, matter["id"]) + assert _by_title(detail)["Einzelbelege"]["parent_chapter_id"] == root["id"] + assert [item["id"] for item in detail["chapters"] if item["parent_chapter_id"] == root["id"]][:2] == [ + sibling["id"], + sent["id"], + ] + ada.request( + "POST", + f"/api/v1/chapters/{sent['id']}/parent", + json={"expected_version": stale_parent, "parent_chapter_id": receipts["id"]}, + status=409, + ) + other = matter_of(ada, "Fremder Vorgang") + foreign = ada.request("POST", f"/api/v1/matters/{other['id']}/chapters", json={"title": "Fremd"}, status=201) + detail = _detail(ada, matter["id"]) + ada.request( + "POST", + f"/api/v1/chapters/{sent['id']}/parent", + json={"expected_version": detail["version"], "parent_chapter_id": foreign["id"]}, + status=422, + ) + ada.request( + "POST", + f"/api/v1/chapters/{sent['id']}/parent", + json={"expected_version": detail["version"], "parent_chapter_id": sent["id"]}, + status=422, + ) + ada.request( + "POST", + f"/api/v1/chapters/{root['id']}/parent", + json={"expected_version": detail["version"], "parent_chapter_id": sent["id"]}, + status=422, + ) + detail = _detail(ada, matter["id"]) + assert _by_title(detail)["Übermittelte Abrechnungsunterlagen"]["parent_chapter_id"] == root["id"] + + dissolved = ada.request( + "POST", + f"/api/v1/chapters/{sent['id']}/delete", + json={"expected_version": detail["version"]}, + ) + detail = _detail(ada, matter["id"]) + assert detail["version"] == dissolved["version"] + assert "Übermittelte Abrechnungsunterlagen" not in _by_title(detail) + assert binding_for(detail, "Anschreiben")["chapter_id"] == root["id"] + assert binding_for(detail, "Abrechnung")["chapter_id"] == root["id"] + assert binding_for(detail, "Rückfrage zur Abrechnung")["chapter_id"] == root["id"] + assert _by_title(detail)["Einzelbelege"]["parent_chapter_id"] == root["id"] + assert binding_for(detail, "Beleg 8")["chapter_id"] == receipts["id"] + + +def test_reclassifying_one_context_leaves_the_other_and_hidden_rows_alone(client, db): + ada = Actor(client, "ada-zwei@example.test", "Ada Zwei") + ben = Actor(client, "ben-zwei@example.test", "Ben Zwei") + register(db, ada.email, ada.name) + register(db, ben.email, ben.name) + ada.login() + case = case_of(ada, "Wohnung") + left = matter_of(ada, "Vorgang A") + right = matter_of(ada, "Vorgang B") + ada.request("POST", f"/api/v1/matters/{left['id']}/case-links", json={"case_id": case["id"]}, status=201) + chapter_a = ada.request("POST", f"/api/v1/matters/{left['id']}/chapters", json={"title": "Lage A"}, status=201) + other_a = ada.request("POST", f"/api/v1/matters/{left['id']}/chapters", json={"title": "Ziel A"}, status=201) + chapter_b = ada.request("POST", f"/api/v1/matters/{right['id']}/chapters", json={"title": "Lage B"}, status=201) + shared = _note(ada, "Gemeinsame Notiz", left, chapter_a["id"]) + ada.request( + "POST", + "/api/v1/bindings", + json={ + "element_id": shared["id"], + "source_context": {"kind": "matter", "id": left["id"]}, + "target": {"kind": "matter", "id": right["id"]}, + "chapter_id": chapter_b["id"], + }, + status=201, + ) + hidden = _note(ada, "Verborgene Strategie", left, chapter_a["id"]) + reply = _note(ada, "Antwort", left, chapter_a["id"]) + ada.request( + "POST", + f"/api/v1/elements/{reply['id']}/references", + json={"refers_to_element_id": shared["id"], "context": {"kind": "matter", "id": left["id"]}}, + status=204, + ) + detail = _detail(ada, left["id"]) + ada.request( + "POST", + f"/api/v1/matters/{left['id']}/bindings/chapters", + json={ + "expected_version": detail["version"], + "binding_ids": [binding_for(detail, "Gemeinsame Notiz")["id"], binding_for(detail, "Antwort")["id"]], + "chapter_id": other_a["id"], + }, + ) + left_view = _detail(ada, left["id"]) + right_view = _detail(ada, right["id"]) + assert binding_for(left_view, "Gemeinsame Notiz")["chapter_id"] == other_a["id"] + assert binding_for(right_view, "Gemeinsame Notiz")["chapter_id"] == chapter_b["id"] + assert binding_for(left_view, "Gemeinsame Notiz")["element"]["excerpt"] == "Gemeinsame Notiz" + assert binding_for(right_view, "Gemeinsame Notiz")["element"]["excerpt"] == "Gemeinsame Notiz" + assert binding_for(left_view, "Antwort")["element"]["refers_to"][0]["title"] == "Gemeinsame Notiz" + grant(ada, case["id"], ben.email, edit=False, share=False) + ada.request( + "PUT", + "/api/v1/exceptions", + json={ + "resource_kind": "element", + "resource_id": hidden["id"], + "context": {"kind": "case", "id": case["id"]}, + "remove_read": True, + }, + ) + ben.login() + visible = ben.request("GET", f"/api/v1/matters/{left['id']}?context_kind=case&context_id={case['id']}") + titles = [item["element"]["title"] for item in visible["bindings"]] + assert "Verborgene Strategie" not in titles + assert "Gemeinsame Notiz" in titles + assert "Lage B" not in str(visible) + ben.request("GET", f"/api/v1/matters/{right['id']}", status=404) + + +def test_child_matter_keeps_its_own_chapters_and_depth_is_guarded(client, db): + ada = Actor(client, "ada-tiefe@example.test", "Ada Tiefe") + register(db, ada.email, ada.name) + ada.login() + parent = matter_of(ada, "Hauptvorgang") + child = ada.request( + "POST", + "/api/v1/matters", + json={"title": "Belegeinsicht", "parent_matter_id": parent["id"]}, + status=201, + ) + own = ada.request("POST", f"/api/v1/matters/{child['id']}/chapters", json={"title": "Nur hier"}, status=201) + parent_view = _detail(ada, parent["id"]) + child_view = _detail(ada, child["id"]) + assert parent_view["chapters"] == [] + assert child_view["chapters"][0]["id"] == own["id"] + assert child_view["chapters"][0]["parent_chapter_id"] is None + + case = case_of(ada, "Akte") + outer = ada.request("POST", f"/api/v1/cases/{case['id']}/chapters", json={"title": "Aktenkapitel"}, status=201) + inner = ada.request( + "POST", + f"/api/v1/cases/{case['id']}/chapters", + json={"title": "Unterlagen", "parent_chapter_id": outer["id"]}, + status=201, + ) + case_view = ada.request("GET", f"/api/v1/cases/{case['id']}") + assert {item["title"]: item["parent_chapter_id"] for item in case_view["chapters"]} == { + "Aktenkapitel": None, + "Unterlagen": outer["id"], + } + + current = None + for level in range(1, 33): + body = {"title": f"Ebene {level}"} + if current: + body["parent_chapter_id"] = current + created = ada.request("POST", f"/api/v1/matters/{parent['id']}/chapters", json=body, status=201) + current = created["id"] + ada.request( + "POST", + f"/api/v1/matters/{parent['id']}/chapters", + json={"title": "Ebene 33", "parent_chapter_id": current}, + status=422, + ) + stored = _detail(ada, parent["id"]) + assert len(stored["chapters"]) == 32 + root_id = next(item["id"] for item in stored["chapters"] if item["title"] == "Ebene 1") + with pytest.raises(psycopg.Error): + db.execute( + "UPDATE chapters SET parent_chapter_id = %s WHERE id = %s", + (current, root_id), + ) diff --git a/backend/tests/test_export.py b/backend/tests/test_export.py index 2346c2b..882fc95 100644 --- a/backend/tests/test_export.py +++ b/backend/tests/test_export.py @@ -600,3 +600,180 @@ def test_export_names_gaps_and_hides_unreadable_counterparts(client, db, monkeyp ) assert "GeheimtitelXQ" not in json.dumps(missing) assert "unbekannten oder nicht sichtbaren" in missing["detail"] + + +def test_nested_chapter_export_keeps_path_and_complete_mail(client, db, monkeypatch): + raw = _eml( + "", + "Die Antwort bleibt vollständig.", + [("lage.pdf", PDF_A), ("konto.pdf", PDF_B)], + ) + monkeypatch.setattr("app.retrieval.pull_rfc822", lambda *args, **kwargs: raw) + ada = Actor(client, "ada-nested-export@example.test", "Ada Verschachtelt") + register(db, ada.email, ada.name) + ada.login() + matter = ada.request("POST", "/api/v1/matters", json={"title": "Nebenkosten"}, status=201) + root = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Nebenkostenabrechnung 2025"}, + status=201, + ) + sent = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Übermittelte Abrechnungsunterlagen", "parent_chapter_id": root["id"]}, + status=201, + ) + receipts = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "Einzelbelege", "parent_chapter_id": sent["id"]}, + status=201, + ) + skipped = ada.request( + "POST", + f"/api/v1/matters/{matter['id']}/chapters", + json={"title": "../Nicht/mitnehmen", "parent_chapter_id": root["id"]}, + status=201, + ) + ada.request( + "POST", + "/api/v1/notes", + json={ + "title": "Anschreiben", + "document": document("Anschreiben bleibt"), + "context": {"kind": "matter", "id": matter["id"]}, + "chapter_id": sent["id"], + }, + status=201, + ) + ada.request( + "POST", + "/api/v1/files", + data={ + "title": "Heizkostenbeleg", + "context_kind": "matter", + "context_id": matter["id"], + "chapter_id": receipts["id"], + }, + files={"upload": ("heiz.pdf", PDF_A, "application/pdf")}, + status=201, + ) + ada.request( + "POST", + "/api/v1/files", + data={ + "title": "Hausmeisterbeleg", + "context_kind": "matter", + "context_id": matter["id"], + "chapter_id": receipts["id"], + }, + files={"upload": ("haus.pdf", PDF_C, "application/pdf")}, + status=201, + ) + ada.request( + "POST", + "/api/v1/notes", + json={ + "title": "Rückfrage", + "document": document("Direkt im Elternkapitel"), + "context": {"kind": "matter", "id": matter["id"]}, + "chapter_id": root["id"], + }, + status=201, + ) + ada.request( + "POST", + "/api/v1/notes", + json={ + "title": "Ausgelassen", + "document": document("Geschwister bleibt draussen"), + "context": {"kind": "matter", "id": matter["id"]}, + "chapter_id": skipped["id"], + }, + status=201, + ) + ada.request( + "POST", + "/api/v1/files", + data={ + "title": "Gespiegelte Anlage", + "context_kind": "matter", + "context_id": matter["id"], + "chapter_id": skipped["id"], + }, + files={"upload": ("konto.pdf", PDF_B, "application/pdf")}, + status=201, + ) + mailbox = ada.request( + "POST", + "/api/v1/connectors", + json={ + "kind": "imap", + "name": "Postfach", + "host": "mail.example.test", + "username": "ada", + "password": "secret-pass", + }, + status=201, + ) + ada.request( + "POST", + "/api/v1/external-refs", + json={ + "title": "Antwort des Vermieters", + "source": "imap", + "external_id": "", + "context": {"kind": "matter", "id": matter["id"]}, + "chapter_id": root["id"], + "detail": {"connector_id": mailbox["id"], "mailbox": "INBOX", "uid": 4}, + }, + status=201, + ) + tree = ada.request("GET", f"/api/v1/matters/{matter['id']}/export-tree")["tree"] + flat = list(_walk(tree)) + parents = _parents(tree) + einzel = next(node for node in flat if node["title"] == "Einzelbelege") + assert einzel["label"] == "Unterkapitel" + assert parents[einzel["id"]]["title"] == "Übermittelte Abrechnungsunterlagen" + leaves = [node["id"] for node in flat if node["kind"] in {"binding", "annotation"} and node["exportable"]] + hidden = { + node["id"] + for node in flat + if node["kind"] in {"binding", "annotation"} + and ( + _under(node["id"], "Einzelbelege", parents) + or _under(node["id"], "../Nicht/mitnehmen", parents) + ) + } + kept = next(node["id"] for node in flat if node["title"] == "Heizkostenbeleg") + selected = [item for item in leaves if item not in hidden or item == kept] + body = {"context": {"kind": "matter", "id": matter["id"]}, "selected": selected} + review = ada.request("POST", f"/api/v1/matters/{matter['id']}/export/review", json=body) + assert review["ready"] is True + reviewed = [item["title"] for item in review["entries"]] + assert "Heizkostenbeleg" in reviewed + assert "Hausmeisterbeleg" not in reviewed + assert "Ausgelassen" not in reviewed + assert "Anschreiben" in reviewed + assert any("bleibt Bestandteil" in item["message"] for item in review["notices"]) + response = _post_zip(ada, matter["id"], body) + assert response.status_code == 200, response.text + names = _archive(response.content).namelist() + heating = next(name for name in names if name.endswith("/heiz.pdf")) + assert heating.startswith( + "01 Nebenkostenabrechnung 2025/02 Übermittelte Abrechnungsunterlagen/01 Einzelbelege/" + ) + assert any( + name.startswith("01 Nebenkostenabrechnung 2025/01 ") and "Antwort des Vermieters" in name + for name in names + ) + assert not any("Hausmeister" in name or name.endswith("/haus.pdf") for name in names) + assert not any(name.startswith("02 ") and "Nicht" in name for name in names) + assert any("Antwort des Vermieters" in name and name.endswith("/anlagen/lage.pdf") for name in names) + assert any("Antwort des Vermieters" in name and name.endswith("/anlagen/konto.pdf") for name in names) + overview = _archive(response.content).read("inhalt.md").decode("utf-8") + assert overview.index("Anschreiben") < overview.index("Heizkostenbeleg") + assert "Hausmeisterbeleg" not in overview + assert "Ausgelassen" not in overview diff --git a/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md index 5dc1a08..9606f46 100644 --- a/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md +++ b/docs/architecture/TSUMUGU_TECHNICAL_SPEC.md @@ -44,7 +44,7 @@ Tsumugu bleibt ein universeller Vorgangs- und Informationsmanager. Mietangelegen F-05a bestätigt den Schwerpunkt „Organisieren und Nachverfolgen“. Die erste Lieferung umfasst: - Persönlicher Datenraum je Konto und ausdrücklich angelegte gemeinsame Datenräume mit Mitgliedschaft. -- Akte, eine Ebene Unterakte, eigenständiger Vorgang, eine Ebene Teilvorgang, Kapitel nur als Gliederung. +- Akte, eine Ebene Unterakte, eigenständiger Vorgang, eine Ebene Teilvorgang, Kapitel nur als Gliederung. Kapitel können innerhalb desselben Objekts verschachtelt sein (F-08a); eine technische Schutzgrenze von 32 Ebenen ist keine fachliche Tiefengrenze. Die eine Unterakten- und Teilvorgangsebene bleibt davon unberührt. - Zuordnung eines Vorgangs zu keiner, einer oder mehreren Akten, ohne Ownership zu verschieben. - Gemeinsame Notizen, kontextbezogene Anmerkungen, eigene Dateien und manuell erfasste externe Referenzen. - Kontextbezogene Rechte: Lesen, Bearbeiten, Freigeben, Ownership, Löschen; Aktenvererbung mit ausdrücklichen Ausnahmen; gezielte Freigabe über Datenraumgrenzen am selben Element. @@ -166,6 +166,7 @@ Alle fachlichen IDs sind UUIDs. `version` ist eine monotone ganze Zahl für 409- | Konto und gemeinsamer Datenraum | n:m über Mitgliedschaft | Bewusste Mitgliedschaft. Sie öffnet nicht den persönlichen Raum eines anderen. | | Akte und Unterakte | 1:n, im MVP eine Ebene | Unterakte ist eine Akte mit abweichenden Rechten. Bestätigt S-01d. | | Kapitel und Akte oder Vorgang | n:1 | Gliederung ohne Status und ohne eigene Rechte. Bestätigt S-01d. | +| Kapitel und Elternkapitel | n:0..1 | Dasselbe Akten- oder Vorgangsobjekt, kein Zyklus. Unterkapitel bleiben Gliederung. Bestätigt F-08a. Technische Schutzgrenze: 32 Ebenen. | | Vorgang und Akte | n:m über Zuordnung | Auch null Akten. Dieselbe Vorgangsversion überall. Zuordnung ändert Ownership nicht. Bestätigt S-01b. Die Rechtewirkung der Zuordnung ist in Abschnitt 4.5 als Vorschlag ausgearbeitet. | | Teilvorgang und Elternvorgang | n:1 | Genau ein fachlicher Elternvorgang. Bestätigt S-01c. | | Teilvorgang und weiterer Vorgang | n:m Querverweis | Referenz, keine zweite Elternschaft und keine Kopie. Bestätigt S-01c. | diff --git a/docs/product/TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md b/docs/product/TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md index cdc8ee8..1b5ba68 100644 --- a/docs/product/TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md +++ b/docs/product/TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md @@ -1,6 +1,8 @@ # Tsumugu: Kommunikationsrichtung – Spezifikation und Cursor-Auftrag -**Stand:** 17.10.2026 · **Fassung:** 1.1 · **Umfang:** sichtbare Symbole tatsächlich ersetzen und Kommunikationsrichtung in der Zeile hervorheben; bestehende Fachlogik erhalten. +**Stand:** 17.10.2026 · **Fassung:** 1.2 · **Umfang:** Kommunikationsrichtung im bestehenden MVP. + +**Vorrangige aktuelle Darstellung:** [Kompakte Inhaltsliste, Auftrag 1.0](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md). Das Richtungssymbol ist nun ausdrücklich das Bedienelement und öffnet die Auswahl erst beim Tippen. Kein permanentes zusätzliches Dropdown. Bestehendes `local` erhält einen kleinen gefüllten Punkt; der leere Datenwert bleibt Keine Angabe und erhält auf ausdrücklichen Nutzerwunsch einen leeren umrandeten Kasten als sichtbaren Auswahl-Einstieg. Keine Checkbox-Semantik. Symbolpaket 1.4 liefert beide neuen Zeichen. Die folgenden älteren Verbote einer Buttondarstellung sowie „Lokal ohne Zeichen“ sind damit ersetzt. Fachliche Richtung je Einbindung, Rechte, bewusste Korrektur und Persistenz bleiben erhalten. Der neueste Auftrag umfasst auch die damit zusammenhängende Verdichtung von Zeilen und Bezügen; nicht unabhängig eine zweite Oberfläche bauen. **Aktuelle Korrektur nach Live-Prüfung:** Die sichtbare Notiz verwendet weiterhin ein Blatt. Im Projekt ist `frontend/public/ui/content-symbols-v1/light/note.svg` ebenfalls noch eine Datei-Kontur, während die gelieferte Quelle die Sprechblase mit Stift enthält. Der Austausch ist daher ausdrücklich auszuführen, nicht nur die URL beizubehalten. Der vorhandene 16px-Diagonalpfeil im Metadatentext entspricht der alten Größenvorgabe, ist aber zu unscheinbar. Diese Fassung ersetzt Position, Form und Größe verbindlich durch führende gefüllte Dreiecke. Keine neue fachliche Grundlagenrunde. diff --git a/docs/product/TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md b/docs/product/TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md new file mode 100644 index 0000000..8ff94e8 --- /dev/null +++ b/docs/product/TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md @@ -0,0 +1,79 @@ +# Tsumugu – kompakte Inhaltsliste und Bezüge + +**Stand:** 17.10.2026 · **Fassung:** 1.0 · **Ziel:** deutlich mehr Vorgangsinhalt auf einen Blick, direkt bedienbare Kommunikationszeichen und kompakte Beziehungen. + +## 1. Geltung und Befund + +Dieser Auftrag fasst die jüngsten Nutzeranforderungen zusammen. Er präzisiert F-06d–f der Produktspezifikation und ersetzt widersprechende ältere Darstellungsvorgaben: permanente Richtungs-Dropdowns, nicht anklickbare Richtungszeichen, leere Darstellung für bewusst Lokal, zusätzliche Kapitelzeilen und vollständig aufgeklappte Bezugskarten in der Liste. Fachliche Bezugs-, Rechte- und Ordnungsregeln bleiben erhalten. + +Bei der letzten lesenden Live-Prüfung waren die fünf Einträge im untersuchten Vorgang am Desktop (1280px) etwa 122–189px hoch, am Handy (390px) etwa 230–305px. Bezogene Einträge lagen bei etwa 189px bzw. 303–305px. Auf dem ersten Handybildschirm war noch kein Eintrag sichtbar. Die Notiz hatte inzwischen das korrekte Sprechblasen-/Stiftmotiv. Diese Werte sind ein Befund des damaligen Bildschirms, kein aktueller Testnachweis nach Umsetzung. + +Die Nutzer wollen insbesondere weniger Leerraum, Richtungsänderung durch Antippen des Zeichens, einen Punkt für Lokal, kompakte Aktionen oben, keine redundante Kapitelangabe und kurze mobile Auszüge. Bezüge können weit auseinanderliegende Einträge mit mehreren unabhängigen Zwischenstücken verbinden. Eine Klammer vor einer Zeile erklärt diese Beziehung nicht zuverlässig. + +## 2. Eintragsaufbau und Platzverbrauch + +- Eine kompakte Zeile je Eintrag, auch bei bestehenden Beziehungen. Führendes Kommunikationszeichen, Inhaltstyp, Textbereich und ein Aktionsmenü oben rechts. Bedienelemente dürfen nicht den Titel auf eine eigene breite Bildschirmzeile verdrängen. +- Titel am Desktop möglichst eine, bei Bedarf höchstens zwei Zeilen; mobil höchstens zwei Zeilen. Vollständiger Titel und Inhalt bleiben durch Öffnen des Eintrags erreichbar. Keine feste Höhe, die Text oder Fokus abschneidet. +- Eine kompakte Metadatenzeile mit fachlichem Datum, Typ und erforderlicher Gegenpartei. Auf dem Handy keine vollständigen E-Mail-Header und Adressketten; bevorzugt lesbarer Name des relevanten Gegenübers. Vollständige Absender-/Empfängerangaben und Anlagen bleiben im Leser erhalten. +- Beschreibung/Auszug am Desktop höchstens zwei Zeilen, mobil höchstens eine. Nur vorhandenen sinnvollen Auszug zeigen; keine Leerzeile für fehlende Beschreibung, Quelle oder Vorschau. Keine automatische KI-Zusammenfassung beauftragt. +- Vertikale Innenabstände und Zwischenräume reduzieren, vorhandene Jinkendo-Typografie und lesbare Schriftgrößen erhalten. Kompaktheit durch weniger dauerhafte Bedienfelder und Dopplungen erreichen. Keine verkleinerten Touchziele als Ersatz. +- **Gestaltungsziel für gewöhnliche Einträge:** ungefähr 80–110px am Desktop und 100–140px am Handy bei normalem Zoom und den beschriebenen Beispielinhalten. Das sind Vergleichsziele, keine starre Pixelhöhe; Zoom, größere Schrift und lange Titel dürfen den Eintrag vergrößern. Gegenüber der geprüften mobilen Fassung ungefähr halb so hohe Standardzeilen anstreben. + +## 3. Kommunikationszeichen direkt bedienen + +| Zustand | Zeichen in der führenden Spalte | +|---|---| +| Eingang | Gefülltes Dreieck nach rechts, hinein in die Zeile | +| Ausgang | Gefülltes Dreieck nach links, heraus aus der Zeile | +| Lokal | Kleiner gefüllter Punkt, ca. 10–12px, an derselben Stelle zentriert | +| Keine Angabe | Leerer, umrandeter Kasten als sichtbarer Auswahl-Einstieg; zugänglicher Name „Kommunikationsrichtung festlegen – keine Angabe“ | + +- **Ein einziges Bedienelement:** Zeichen ist bei Änderungsrecht die Schaltfläche. Das permanent sichtbare Dropdown daneben entfällt. Tippen/Klicken öffnet eine kleine Auswahl mit „Eingang“, „Ausgang“, „Lokal“ und „Keine Angabe“; aktueller Zustand ist markiert. Erst eine bewusste Auswahl speichert, kein blindes Durchschalten beim Tippen. +- Vorhandene Einbindungswerte `in`, `out`, `local` und leer sowie die bestehende Speicherfunktion wiederverwenden. Lokal ist bewusst gesetzt; unbekannt bleibt ein anderer Zustand. Keine automatische Klassifizierung von Notizen als lokal, keine Übertragung auf benachbarte oder bezogene Einträge. +- Dreiecke wie geliefert ca. 24–28px, Punkt kleiner; feste schmale Spalte, gleiche Ausrichtung aller Titel. Antippbare Fläche mobil mindestens 44x44px, ohne zusätzliche ganze Bedienzeile. Auf Desktop geeignete kompakte Fläche und sichtbarer Tastaturfokus. +- Richtung zusätzlich als kurze lesbare Angabe in der bestehenden Metadatenzeile erhalten, ohne eigene Zeile oder zweites Auswahlfeld. Auswahl auch mit Tastatur bedienbar; Escape/außerhalb schließen ohne Änderung, danach Fokus zum Auslöser zurück. Der Klick darf nicht zugleich den Leser öffnen oder Drag-and-drop starten. +- Während Speichern Mehrfachauslösung verhindern; Fehler verständlich anzeigen und den letzten gespeicherten Zustand wiederherstellen. Manuelles Leeren bleibt gespeichert. Lesende Nutzer sehen das Zeichen ohne aktive Änderungsfunktion. Rechteprüfung bleibt serverseitig im konkreten Kontext. + +## 4. Bezüge ohne zusätzliche Zeilenhöhe + +- **Keine verbindende Klammer, linke Beziehungsleiste oder zusätzliche Einrückung in der Inhaltsliste.** Vorhandene Dekoration aus `.preview-row--linked` und der Bezugskarten entfernen, soweit sie ohne sichtbares Gegenstück einen Zusammenhang suggeriert. Auswahl-/Fokusmarkierungen behalten ihre eigenständige Bedeutung. +- Beziehungen führen zu keinem Zusammenschieben, Umordnen, Duplizieren oder automatischen Gruppieren. A und B bleiben an ihrer Position; unabhängige Zwischenstücke bleiben sichtbar. Das gilt bei fachlicher und eigener Reihenfolge, über Kapitelgrenzen hinweg und bei Filtern. +- Statt aller Bezugskarten genau **eine kompakte Schaltfläche**, etwa Verknüpfungssymbol mit „Bezüge 2“, in der vorhandenen Metadatenzeile. Kein eigener Absatz und keine Mindesthöhe wegen Beziehungen. Auf schmalen Ansichten dieselbe Funktion platzsparend erhalten. Keine leere Anzeige ohne Bezüge. +- Tippen öffnet ein kleines Popover bzw. eine für das Handy passende vorübergehende Ansicht. Darin unterscheidbar „Bezug auf“ und „Darauf bezogen“, jeweils Datum und Titel. Nicht jede Beziehung ist fachlich automatisch eine Antwort. Mehrere Ziele begrenzt scrollbar darstellen; keine permanente Expansion der gesamten Liste. +- Ein Ziel muss von dort direkt im vorhandenen Leser geöffnet werden können, auch wenn es außerhalb des sichtbaren Ausschnitts oder im aktuellen Filter nicht enthalten ist. Einen geeigneten bestehenden Navigationsweg verwenden. Aktuellen Akten-/Rechtekontext beachten; keine Berechtigungen aus fremden Einbindungen übernehmen. +- Rückkehr zum Ausgangseintrag erhält Filter, Sortierung, Kapitelauswahl und möglichst die Scrollposition. Kein stilles Zurücksetzen der Arbeitsansicht. Der ausführliche Schriftwechsel bleibt im Leser verfügbar und treibt nicht die Höhe jeder Listenzeile. +- Vorhandene Beziehungen bleiben gespeichert. Anlegen/Lösen über das Aktionsmenü erhalten. Titel, Datum und Zählwerte nur für im aktuellen Kontext lesbare Gegenstücke anzeigen; keine vertraulichen Bezugshinweise über einen Zähler offenlegen. + +## 5. Aktionen, Kapitel und Vorgangskopf + +- Pro Eintrag oben rechts ein erreichbares Menü für Bezug setzen/lösen, Kapitelzuordnung, Entfernen und bestehende weitere Aktionen. Keine dauerhaft separate untere Aktionszeile. Im eigenen Ordnungsmodus bleibt ein kompakter Ziehgriff; „Nach oben/unten“ sind als Tastatur-/Touchalternative im Menü erreichbar. Die Richtung hat ihr eigenes direktes Zeichen, kein zweites Richtungsmenü daneben. +- Kapitelname innerhalb eines bereits sichtbaren Kapitels aus dem Eintrag entfernen. In zusammengeführten Ansichten notwendige Herkunft nur dann knapp anzeigen, wenn sie nicht aus einer Gruppenüberschrift hervorgeht. Kapitel-/Aktenzuordnung nicht aus dem Datenmodell entfernen. +- Kapitelkopf kompakt mit Titel, Anzahl und Menü. Bestehendes Kapiteldatum bei Bedarf knapp als Text; Datumsfeld, Umbenennen, Löschen und Sortieraktionen erst beim gezielten Bearbeiten/über das Menü. Keine ständig sichtbare mehrzeilige Kapitel-Verwaltung. +- Auch Objektaktionen im Vorgangskopf zusammenziehen: Hauptaktion „Inhalt hinzufügen“ sichtbar; weitere Aktionen in kompakter oberer Leiste bzw. vorhandenem Menü. Umbenennen, Archivieren, Verschieben und Löschen benötigen keine dauerhaft eigene Werkzeugzeile. Bestehendes Übergabepaket und Struktur bleiben auffindbar. +- Mobil Suche über ein Suchsymbol öffnen statt dauerhafter eigener Suchzeile. Lange Hierarchiepfade platzsparend zeigen und vollständig aufklappbar halten. Aktiver Vorgang, notwendiger Handlungskontext, Navigation und stabile Pfade bleiben verständlich. Nicht pauschal alle Kontextangaben entfernen. + +## 6. Umsetzung im Bestand und Assets + +`AGENTS.md`, Produkt- und UX-Spezifikation beachten. Keine neue gemeinsame Plattform oder Grundlagenrunde. Gezielte Änderungen an vorhandenen Komponenten: + +- `frontend/src/pages/content.jsx`: `DirectionColumn`, `DirectionChoice`, `saveRowDirection`, `BezugLines`, `BezugLink` und Eintragsaktionen prüfen. Vorhandene Persistenz und Kontextübergabe wiederverwenden. +- `frontend/src/styles.css`: `.preview-row`, `.preview-row__main`, `.preview-row__actions`, `.preview-row__origin`, `.preview-row--linked`, `.bezug`/`.bezug__link` und responsive Regeln prüfen. Gegenläufige doppelte Regeln bereinigen, nicht immer weitere Ausnahmen aufstapeln. +- Betroffene Kapitel-, Objektkopf-, mobile Such- und Leserkomponenten gezielt anpassen. Datenmodell nur ändern, wenn eine konkrete fehlende Funktion es erfordert; zuerst vorhandene `local`-Unterstützung nutzen. +- Originale Typ-Symbole und Logos erhalten. Symbolpaket **1.4** unter `C:/Dev/jinkendo-app-design-2026-10-17/assets/content-symbols-v1/` enthält zusätzlich `light/communication-local.svg` und `dark/communication-local.svg` als gefüllten Punkt sowie `communication-unspecified.svg` in beiden Farbvarianten als leeren umrandeten Kasten; entsprechende PNGs liegen bei. Die Dreiecke und Sprechblase bleiben unverändert. Gelieferte echte Lucide-Geometrien verwenden, keine Emoji-Zeichen. Der Kasten ist das Richtungsfeld ohne Angabe, keine Checkbox für Auswahl/Erledigung; keine Häkchen- oder Checkbox-Semantik vergeben. +- Tatsächlich verwendete Dateien übernehmen, Cache-Aktualisierung und geladene URLs prüfen. Kleine Zeichen mit großzügiger Trefferfläche kombinieren. Bedienelemente nicht allein bei Hover zeigen. + +## 7. Abnahme und Übergabe + +Mit synthetischen Daten dieselbe Liste bei 1280px und 390px prüfen, zusätzlich kurze Prüfung bei 360px. Standardfall mit fünf Einträgen und mehreren Kapiteln; Titel, Beschreibung, E-Mail-Gegenüber und eine fehlende Beschreibung abdecken. + +1. Eingang/Ausgang/Lokal/Keine Angabe direkt über das Zeichen wählen; kein permanentes Dropdown. Nach Neuladen korrekt, bei Fehler kein vorgetäuschter Erfolg. Menü öffnet keinen Leser. Tastatur-/Touchbedienung und reiner Lesezugriff prüfen. +2. A, mindestens drei unabhängige Zwischenstücke und B; B bezieht sich auf A. Beide behalten ihre Listenposition, keine Klammern/Leisten und keine aufgeklappten Bezugskarten. Kompakter Bezugsauslöser funktioniert an beiden Enden. +3. Mehrere Bezüge und Bezug über Kapitel-/Filtergrenzen prüfen. Gegenstück öffnen und zum Ausgangspunkt zurückkehren, ohne Arbeitskontext oder Ordnung zu verlieren. Nicht lesbare Ziele liefern weder Details noch verräterische Zählwerte. +4. Vergleichbare Zeilen mit null/einem/mehreren Bezügen bleiben im geschlossenen Standardzustand ungefähr gleich hoch. Der Bezugsauslöser beansprucht keine zusätzliche ganze Zeile; Zielwerte aus Abschnitt 2 prüfen und Abweichungen anhand tatsächlichen Inhalts begründen. +5. Keine Kapitelwiederholung innerhalb des Kapitels, keine Leerzeilen für fehlende Inhalte, mobil maximal eine Auszugszeile. Der vollständige Leser und ausführliche Schriftwechsel bleiben erreichbar. +6. Aktionen oben kompakt, keine untere Werkzeugzeile; Kapitel-/Vorgangskopf deutlich kürzer. Auf dem Handy ist bei normalem Zoom im geprüften Standardfall bereits ein erster Eintrag ohne Scrollen erkennbar. Größere Schrift/Zoom bleiben nutzbar, keine festen Höhen oder horizontales Abschneiden. +7. Bestehende Datei-/E-Mail-Öffnung, Bezüge, Einbindungsrechte und eigene Reihenfolge einschließlich Drag-and-drop sowie Alternative über Menü prüfen. Relevante Verhaltenstests und Frontend-Build ausführen; keine bloßen Tests von CSS-Klassennamen als Qualitätsnachweis. + +Vorher-/Nachher-Zeilenhöhen und Screenshots derselben synthetischen Beispiele liefern: Desktop, Handy, mehrere Bezüge und geöffnete Richtungsauswahl. Ausgeführte und nicht ausführbare Prüfungen trennen. Keine vertraulichen Bestandsinhalte in die Übergabe übernehmen. + +**Arbeite bis zur lokal prüfbaren Umsetzung.** Bestehende laufende Änderungen erhalten. Kein Commit, Push oder Deployment durch diesen Auftrag; `develop`-Push startet Development. Keine weiteren Funktionspakete oder erneute Designgrundlagen als Vorbedingung. Betroffene Dateien, Prüfergebnisse und tatsächliche Einschränkungen knapp übergeben. diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 821f50f..dd26d8e 100644 --- a/docs/product/TSUMUGU_PRODUCT_SPEC.md +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -1,6 +1,6 @@ # Tsumugu – Fachliche Produktspezifikation -**Stand:** 17.10.2026 · **Arbeitsstand:** 0.33, sichtbarer Symbolaustausch und führende Kommunikationsdreiecke präzisiert; nächste Exportlieferung bleibt gesichert. +**Stand:** 17.10.2026 · **Arbeitsstand:** 0.37, Unterkapitel als reine verschachtelte Gliederung; kompakte Inhaltsliste und Exportlieferung bleiben erhalten. **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. @@ -25,7 +25,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Universeller Vorgangs- und Informationsmanager. Akten bilden dauerhafte fachliche Zusammenhänge, Vorgänge konkrete bearbeitbare Sachverhalte mit eigenem Verlauf und Abschluss. Mietfälle und Erstattungen validieren das Modell, begrenzen es aber nicht (Begriffstrennung S-01a bestätigt). - Eigenständiger MVP; Multiuser- und Familienfähigkeit von Beginn an; eigene persönliche und ausdrücklich gemeinsame Datenräume. -- Akten und Vorgänge sind logische fachliche Zusammenstellungen. Ein Element kann in mehreren Zusammenstellungen vorkommen; eine einzige physische Ablagehierarchie bestimmt nicht alle Zusammenhänge. Kapitel gliedern Inhalte ohne eigenen Status oder eigene Rechte. Unterakten sind eigenständige fachliche Bereiche innerhalb einer Akte und können abweichende Rechte tragen (S-01d bestätigt). +- Akten und Vorgänge sind logische fachliche Zusammenstellungen. Ein Element kann in mehreren Zusammenstellungen vorkommen; eine einzige physische Ablagehierarchie bestimmt nicht alle Zusammenhänge. Kapitel gliedern Inhalte ohne eigenen Status oder eigene Rechte. Unterkapitel sind dieselbe Gliederung und können verschachtelt werden (F-08a). Unterakten sind eigenständige fachliche Bereiche innerhalb einer Akte und können abweichende Rechte tragen (S-01d bestätigt). - Ein Teilvorgang ist ein untergeordneter Vorgang mit denselben Grundfähigkeiten. Sichten sind gespeicherte dynamische Auswahlen nach Kriterien; virtuelle Zusammenstellungen gezielt ausgewählte und angeordnete Verweise auf vorhandene Inhalte (S-01a bestätigt). Welche Objekte jeweils einbindbar sind und wie die Strukturen zusammenhängen, bleibt zu klären. - Ein Vorgang kann eigenständig bestehen und keiner, einer oder mehreren Akten zugeordnet werden. Es bleibt derselbe Vorgang mit gemeinsamem Bearbeitungsstand; eine führende Akte ist nicht verpflichtend, zusätzliche Zuordnung überträgt keine Ownership (S-01b bestätigt). - Ein Teilvorgang hat genau einen fachlich übergeordneten Vorgang. Derselbe Teilvorgang kann in weiteren Vorgängen referenziert werden, ohne eine zweite fachliche Hauptzuordnung oder Kopie zu erzeugen (S-01c bestätigt). @@ -210,7 +210,7 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Begründung:** Keine zusätzliche Rechteebene für reine Gliederungsabschnitte. Für einen ganzen Bereich mit abweichenden Rechten wird eine Unterakte verwendet, für einen eigenständig bearbeitbaren Sachverhalt ein Vorgang/Teilvorgang. -**Auswirkungen auf Fachmodell und MVP:** Ein Kapitel erzeugt keine eigene fachliche Status-/Rechteverwaltung; Unterakten und Teilvorgänge nutzen die Grundfähigkeiten ihres jeweiligen Typs. Fachliches Prüfszenario: Gliedern nach Kapiteln verändert keine Inhaltsrechte; Einschränkungen einzelner Elemente bleiben wirksam. Unteraktenhierarchie, Kapitel in virtuellen Zusammenstellungen und die genaue Bedienung bleiben offen. +**Auswirkungen auf Fachmodell und MVP:** Ein Kapitel erzeugt keine eigene fachliche Status-/Rechteverwaltung; Unterakten und Teilvorgänge nutzen die Grundfähigkeiten ihres jeweiligen Typs. Fachliches Prüfszenario: Gliedern nach Kapiteln verändert keine Inhaltsrechte; Einschränkungen einzelner Elemente bleiben wirksam. Historisch blieb in dieser Entscheidung offen, ob Kapitel selbst verschachtelt werden. Diese Zurückstellung ist durch F-08a überholt. Unteraktenhierarchie und Kapitel in virtuellen Zusammenstellungen bleiben offen. ### S-01e – Virtuelle Zusammenstellung als gezielt freigegebenes Paket: bestätigt am 16.10.2026 @@ -384,6 +384,14 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Lieferung:** Symbolpaket 1.3 enthält die korrigierten Richtungsdreiecke und die klar unterscheidbare Notizform. Fachliche Details, gezielte technische Einstiegspunkte und Abnahme stehen in [TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md](TSUMUGU_KOMMUNIKATIONSRICHTUNG_AUFTRAG.md), Fassung 1.1. Der Beziehungsausbau F-06d wird erhalten; die Richtungsregeln werden durch diesen späteren Auftrag präzisiert. +### F-06f – Kompakte Inhaltsliste und platzsparende Bezüge: 17.10.2026 + +**Nutzerbedarf:** Die Einträge wachsen durch Leerraum, permanente Auswahlfelder, Kapitelwiederholung und Beziehungen zu stark. Gewünscht sind Richtungsänderung durch Tippen auf die Grafik, ein Punkt für bewusst Lokal, kompakte Aktionen oben, entfallende redundante Kapitelinformation und wesentlich kürzere mobile Auszüge. Bezogene Einträge können durch mehrere unabhängige Zwischenstücke getrennt sein. Verbindungsklammern sind nicht erforderlich und können diese Zusammenhänge unübersichtlich darstellen. + +**Konkrete Umsetzung:** Kompakte Zeilen mit Richtung, Typ-Symbol, Titel, knappen Metadaten und kurzem Auszug. Richtungsschaltfläche öffnet eine vorübergehende Auswahl; das permanente Dropdown entfällt. Lokal erhält einen Punkt, Keine Angabe auf ausdrücklichen Nutzerwunsch einen leeren umrandeten Kasten als Auswahl-Einstieg. Der Kasten ist keine Checkbox. Vorhandene Werte und Einbindungsrechte bleiben erhalten. Bezüge erscheinen als einzelner kompakter Auslöser mit Anzahl im vorhandenen Metadatenbereich; Details und Gegenstücke öffnen erst auf Anforderung. Keine Verbindungsklammern, Beziehungsleisten, zusätzlichen Einrückungen, automatische Gruppierung oder Umordnung. Auch Zeilen mit mehreren Bezügen bleiben im geschlossenen Zustand vergleichbar hoch. Der ausführliche Leser/Schriftwechsel bleibt verfügbar. + +**Umsetzungsempfehlung und Abnahme:** Kleines Auswahlmenü am Zeichen, „Bezüge n“ öffnet Gegenstücke, Aktionen oben rechts im Menü, kompakte Kapitel-/Vorgangsköpfe und zurückgenommene mobile Suche. Keine starre Zeilenhöhe zulasten von Zoom/Lesbarkeit. Der verbindliche Auftrag einschließlich Größenvergleich, Beispielen mit weit entfernten Bezügen und Rechteprüfung steht in [TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md). Er ersetzt widersprechende frühere UI-Vorgaben, nicht die bestehenden fachlichen Beziehungs-, Richtungs- oder Ordnungsregeln. + ### F-07a – Nächste Phase: vollständiges Übergabepaket für den Anwalt: 17.10.2026 **Nutzerbedarf und Lieferentscheidung:** Vorgänge oder gezielt ausgewählte Teile sollen mit ihrer Struktur und den enthaltenen Dokumenten, E-Mails und Anlagen an den Anwalt übergeben werden können. Auf Nachfrage genügt für die unmittelbar nächste Lieferung zunächst ein vollständiges Übergabepaket. Ein laufender Lese-/Downloadzugang und eine Kombination beider Wege bleiben mögliche spätere Ausbauschritte. Rechnungen, Arztrechnungen, Zahlungen, Erstattungen und Einreichungen werden vorerst weiter zurückgestellt, nicht gestrichen. Die konkrete Reihenfolge dieser Phase präzisiert F-05a; die frühere technische Paketnummerierung legt keine andere Rangfolge fest. @@ -396,7 +404,7 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Beschluss:** Die Auswahl ist auf jeder Hierarchieebene des Exportumfangs möglich. Auf oberster Ebene können alle Inhalte an- oder abgewählt werden; dasselbe gilt auf jeder darunterliegenden Ebene bis zum einzelnen Inhalt beziehungsweise zur Einzeldatei. Eine übergeordnete Auswahl wirkt auf alle untergeordneten Vorkommen. Danach sind einzelne Unterauswahlen möglich; teilweise ausgewählte Ebenen erhalten einen eindeutigen Zwischenzustand. -**Auswirkungen:** Notizen und kontextbezogene Anmerkungen folgen derselben Auswahlregel; die zuvor vorgeschlagene Sonderregel einer ausschließlich separaten Auswahl wird dadurch ersetzt. Auswahl wirkt auf die jeweilige Einbindung beziehungsweise das Vorkommen, nicht als globale Sperre des gemeinsamen Inhalts. Die E-Mail-Einheit ist in F-07c präzisiert. Neue Hierarchietiefen, Unterkapitel oder eine automatische Aufnahme von Querverweiszielen werden hierdurch nicht beschlossen. +**Auswirkungen:** Notizen und kontextbezogene Anmerkungen folgen derselben Auswahlregel; die zuvor vorgeschlagene Sonderregel einer ausschließlich separaten Auswahl wird dadurch ersetzt. Auswahl wirkt auf die jeweilige Einbindung beziehungsweise das Vorkommen, nicht als globale Sperre des gemeinsamen Inhalts. Die E-Mail-Einheit ist in F-07c präzisiert. F-07b selbst beschließt keine neue Hierarchietiefe und keine automatische Aufnahme von Querverweiszielen. Die spätere Unterkapitelentscheidung steht in F-08a und ändert diese Auswahlregel nicht. ### F-07c – Ausgewählte E-Mail enthält ihre vollständigen Anlagen: bestätigt am 17.10.2026 @@ -404,6 +412,12 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **Auswirkungen:** Das unveränderte vollständige E-Mail-Original darf nicht wegen einer separat abgewählten Anlage reduziert werden. Eine vollständige E-Mail und separat eingebundene Anlage-Vorkommen bleiben in der Auswahl unterscheidbar. Ein Dateiname allein genügt nicht für eine behauptete Identität. Dies korrigiert ausdrücklich den zwischenzeitlichen Assistentenvorschlag, abgewählte Anlagen aus einer E-Mail zu entfernen. +### F-08a – Unterkapitel als reine Gliederung: bestätigt am 17.10.2026 + +**Beschluss:** Kapitel dürfen innerhalb desselben Akten-, Vorgangs- oder Teilvorgangsobjekts verschachtelt werden. Unterkapitel sind keine zusätzlichen Vorgänge, Sammler oder Freigabezusammenstellungen. Sie haben kein eigenes Recht, keine Ownership und keinen eigenen Status. Die Einordnung gilt für die jeweilige Einbindung. Frühere Aussagen, Unterkapitel blieben offen oder würden nicht ergänzt, gelten als historischer Stand der früheren Lieferungen und sind durch diesen Beschluss präzisiert. + +**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). + ## 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. @@ -476,4 +490,8 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G 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. +17.10.2026, Arbeitsstand 0.36: Nutzerauftrag F-06f gesichert: kompakte Zeilen und Köpfe, direkte Richtungsauswahl über das Zeichen, Punkt für Lokal, kurze mobile Auszüge und kompakter Bezugsauslöser. Keine Klammern/Leisten über unabhängige Zwischenstücke, Reihenfolge bleibt erhalten. Konsolidierten Cursor-Auftrag erstellt; keine Änderung an Anwendungscode oder Deployment durch diese Dokumentationsfortschreibung. + +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). + 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_SYMBOLS_LOGOFRAME_AUFTRAG.md b/docs/product/TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md index a3894a3..d1b8983 100644 --- a/docs/product/TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md +++ b/docs/product/TSUMUGU_SYMBOLS_LOGOFRAME_AUFTRAG.md @@ -1,5 +1,7 @@ # Cursor-Auftrag: Inhalts-Symbole und Logo auf dunklen Flächen +**Aktuelle Ergänzung:** Der [Auftrag zur kompakten Inhaltsliste](TSUMUGU_KOMPAKTE_INHALTSLISTE_AUFTRAG.md) gilt für die jetzige Umsetzung vorrangig. Symbolpaket 1.4 umfasst inzwischen 28 Motive einschließlich gefülltem Punkt für Lokal und leerem Kasten für Keine Angabe. Richtungszeichen sind direkt antippbar, das zusätzliche permanente Dropdown entfällt. Die Unterscheidung von Notiz und Dokument sowie die Logo-Regeln dieses Auftrags bleiben erhalten. + **Stand:** 17.10.2026 · **Ziel:** Vorhandene Einträge ohne brauchbare Miniatur verständlich darstellen und das Logo in der dunkelgrünen Navigation sauber einbinden. Die Dateien sind fertig; keine weitere Symbol-/Logo-Erfindung. ## Fertige Lieferungen lesen und verwenden diff --git a/docs/product/TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md b/docs/product/TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md new file mode 100644 index 0000000..e64c125 --- /dev/null +++ b/docs/product/TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md @@ -0,0 +1,107 @@ +# Auftrag an Cursor: Unterkapitel in Tsumugu + +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 + +Ergänze verschachtelbare Kapitel in der bestehenden Anwendung. Der konkrete Bedarf: Ein Kapitel „Nebenkostenabrechnung 2025“ enthält Anschreiben, Abrechnung, zahlreiche gemeinsam übermittelte Einzelbelege und anschließende Korrespondenz. Diese Inhalte müssen weiter gegliedert werden können, ohne daraus zusätzliche Vorgänge zu machen. + +Der Nutzer hat der Umsetzung von Unterkapiteln als nächstem Ausbau zugestimmt. Kapitel und Unterkapitel sind reine Gliederung im jeweils aktiven Fachobjekt. Sie erhalten keine eigenen Rechte, Ownership oder Status. Gemeinsame Inhalte bleiben dieselben Elemente; ihre Einordnung gilt für die jeweilige Einbindung. + +Ein gesonderter Sammler für ein Dokumentpaket mit eigenen Angaben wie gemeinsamem Zugangsdatum oder Hauptdokument ist nicht Teil dieses Auftrags. Virtuelle Zusammenstellungen für gezielte Freigaben bleiben davon getrennt. Die Verwendung einer Freigabezusammenstellung als Ersatz für die innere Kapitelgliederung wurde verworfen. Dynamische Sichten bleiben ebenfalls ein eigener Begriff. + +Historische Aussagen „Unterkapitel bleiben offen“ oder „keine Unterkapitel ergänzen“ bezogen sich auf frühere Lieferungen. Sie werden durch die aktuelle Entscheidung für diesen Ausbau präzisiert. Andere bestätigte Fach- und Designentscheidungen bleiben gültig. + +## 2. Führende Quellen und aktueller Befund + +Lies den aktuellen Stand, einschließlich inzwischen hinzugekommener Änderungen: + +- C:/Dev/tsumugu/AGENTS.md +- C:/Dev/tsumugu/docs/product/TSUMUGU_PRODUCT_SPEC.md – zuletzt gelesen: 0.33, insbesondere S-01d und F-07a–c. +- C:/Dev/tsumugu/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md +- C:/Dev/tsumugu/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md +- C:/Dev/tsumugu/docs/product/TSUMUGU_EXPORT_NAECHSTE_LIEFERUNG_2026-10-17.md +- C:/Dev/tsumugu/docs/product/TSUMUGU_EXPORT_PRUEFBERICHT_2026-10-17.md +- C:/Dev/tsumugu/docs/MVP_ANNAHMEN.md +- C:/Dev/jinkendo-app-design-2026-10-17/JINKENDO_APP_DESIGN_CONCEPT.md + +Die gelesenen Migrationen speichern Kapitel ohne fachlichen Kapitel-Elternbezug. Kapitelanlage und Reihenfolge in `backend/app/ops.py` behandeln bisher alle Kapitel eines Containers als eine Liste. Die vorhandene Umbenennungs- und Löschfunktion ist zu erhalten und für die neue Struktur korrekt zu erweitern. Die Navigation verwendet bereits Baumkomponenten; diese wiederverwenden, sofern geeignet. + +Der vorhandene Export liegt unter `backend/app/exporting.py` und `backend/app/api/export.py`. Sein Prüfbericht nennt 46 bestandene Tests und eine lokale Bedienabnahme. Das ist ein übernommener Bericht, kein in diesem Planungschat wiederholter Testnachweis; er belegt keinen aktuellen Deploymentstand. Prüfe die heutigen Dateien und führe die betroffenen Prüfungen selbst aus. + +## 3. Benutzbarer Ablauf + +Im bestehenden Vorgang muss folgende Struktur anlegbar sein: + +```text +Kapitel: Nebenkostenabrechnung 2025 + Unterkapitel: Übermittelte Abrechnungsunterlagen + Anschreiben + Abrechnung + Unterkapitel: Einzelbelege + Heizkostenbeleg + Hausmeisterbeleg + Rückfrage zur Abrechnung + Antwort des Vermieters +``` + +Lieferumfang: + +1. Unter einem ausgewählten Kapitel ein Unterkapitel anlegen. Zielobjekt und Elternkapitel im Dialog klar benennen. Nach Speichern das neue Kapitel auswählen; neue Inhalte werden dort vorausgewählt. +2. Kapitelbaum ein- und ausklappen, Kapitel eindeutig auswählen und den Kapitelpfad anzeigen. Kapitel, Unterkapitel und Teilvorgang bleiben unterscheidbar. Objektpfad und Handlungskontext bleiben erhalten. +3. Bereits vorhandene Inhalte einzeln oder per Mehrfachauswahl in ein anderes Kapitel desselben Fachobjekts einordnen. Das muss den beschriebenen Bestand mit vielen Belegen praktisch bearbeitbar machen. Die Einordnung ändert nur die betreffenden Einbindungen. +4. Vorhandene Kapitel mit ihrem gesamten Unterbaum innerhalb desselben Fachobjekts umhängen können, einschließlich Rückkehr auf die oberste Kapitelebene. Kein containerübergreifendes Umhängen und keine stillen Freigaben. +5. Geschwisterkapitel und direkte Einträge ordnen. Gespeicherte Reihenfolgen und bestehende Datumsmodi bleiben erhalten. +6. Die verschachtelte Struktur im bestehenden Export auswählen und als Verzeichnisse mit verständlicher Übersicht ausgeben. + +Die Lösung darf nicht nur ein Unterkapitel unter der Wurzel ermöglichen: Der konkrete Abnahmefall benötigt drei Kapitelebenen einschließlich „Einzelbelege“. Daraus folgt keine abschließende allgemeine Produkttiefengrenze. Verwende ein rekursives Kapitelmodell; dokumentiere erforderliche technische Schutzgrenzen und tatsächlich geprüfte Tiefen. + +## 4. Konkrete Bedien- und Ordnungsregeln + +Die folgenden Regeln konkretisieren die Umsetzung dieses Auftrags; sie sind keine älteren Interviewbeschlüsse: + +- Jedes Kapitel hat höchstens ein Elternkapitel. Eltern und Kind gehören immer zu demselben aktiven Akten-/Vorgangsobjekt, einschließlich Teilvorgang. Selbstzuordnung, Zyklen und fremde Container-IDs werden serverseitig abgewiesen. +- Akten, Vorgänge und Teilvorgänge nutzen dieselbe Kapitelmechanik. Eine Kapitelhierarchie verändert nicht die bestehende fachliche Vorgangs- oder Aktenhierarchie. +- Der gewählte Kapitelbereich zeigt seine direkten Inhalte und die Unterkapitel mit erkennbaren Grenzen. Unterkapitelinhalte dürfen nicht unbemerkt als direkte Einträge des Elternkapitels erscheinen. In einer Gesamtsicht bleibt die Herkunft erkennbar; jede Einbindung erscheint nur einmal pro gewähltem Kontext. +- Eigene Kapitelreihenfolge gilt jeweils unter demselben Elternkapitel. Eintragsreihenfolge gilt im jeweiligen Kapitel. Eine Änderung der Reihenfolge darf keine andere Hierarchieebene oder Einbindung verändern. Datumsordnung respektiert die bestehenden fachlichen Datumsregeln, erfindet keine Daten und zerstört keine gespeicherte eigene Reihenfolge. +- Reihenfolgeänderung funktioniert per Drag-and-drop und über eine zugängliche Tastatur-/Touchalternative. Umhängen in ein anderes Elternkapitel ist eine davon getrennte, eindeutig benannte Aktion; es muss nicht zusätzlich per Drag-and-drop erfolgen. +- Bei reinem Ein-/Ausklappen bleiben Auswahl, ungesicherte Eingaben und Kontext erhalten. Rückkehr aus dem Leser, Browser-Zurück und Neuladen erhalten das gültige Kapitel und den Handlungskontext. Objektwechsel übernehmen keine fremde Kapitelauswahl. +- Bestehendes Umbenennen bleibt möglich. Beim Entfernen einer Kapitelgliederung werden keine Inhalte oder Originaldateien gelöscht. Konkrete Ausgestaltung: Die Aktion löst nur das ausgewählte Kapitel auf; direkte Einbindungen und direkte Unterkapitel rücken unter das bisherige Elternkapitel, bei einem Wurzelkapitel auf die oberste Ebene. Die Unterbäume bleiben zusammenhängend. Wirkung vor Ausführung benennen, Reihenfolge deterministisch erhalten und Auswahl danach auf ein gültiges Ziel setzen. +- Gleichzeitige Änderungen verwenden die vorhandene Versions-/Konfliktbehandlung. Ein fehlgeschlagener Vorgang darf keinen halben Umzug oder Verlust von Einbindungen hinterlassen. + +## 5. Export und bestehende Schutzregeln + +Erweitere den vorhandenen Export, statt einen zweiten Exportweg zu bauen: + +- An-/Abwahl eines Kapitels wirkt auf alle darunterliegenden auswählbaren Vorkommen. Einzelne Nachkommen lassen sich anschließend abweichend auswählen; die Vorfahren zeigen den Zwischenzustand. +- Die notwendige Verzeichnisfolge zu ausgewählten Inhalten bleibt erhalten. Nicht ausgewählte Geschwister werden nicht exportiert. Die bisherige Behandlung leerer Kapitel muss nicht um eine neue Exportoption erweitert werden; leere Kapitel bleiben in der normalen Bearbeitungsoberfläche dennoch zugänglich. +- Geschwisterreihenfolge, Unterkapitel und Dokumentpfade stimmen zwischen Auswahlbaum, Prüfübersicht, ZIP und HTML-/Markdown-Übersicht überein. Namen dürfen keine Pfadausbrüche oder Überschreibungen ermöglichen; lange Kapitelpfade müssen verständlich behandelt werden. +- F-07c bleibt unverändert: Eine ausgewählte E-Mail enthält sämtliche Anlagen, auch wenn dieselbe Datei als separates Vorkommen in einem anderen Kapitel abgewählt ist. Bewahre den bestehenden Hinweis und die zuverlässige Identitätsprüfung. +- Umgliederung ändert keine Leserechte, Weiterfreigaberechte, Ownership, Quellenreferenzen, Antwortbezüge oder Inhalte anderer Einbindungen. Vorhandene Inhaltsausnahmen bleiben wirksam, auch bei Baumknoten, Zählern, Gesamtsichten und Export. + +## 6. Migration und betroffene Funktionen + +Erweitere das bestehende Kapitelmodell gezielt. Ein Elternbezug am Kapitel ist eine naheliegende Umsetzung, keine vorgeschriebene neue Architektur. Bisherige Kapitel werden Wurzelkapitel desselben Fachobjekts; Titel, IDs, Fachdaten, Einbindungen und ihre relativen Reihenfolgen bleiben erhalten. Keine Reset-/Seed-Lösung für bestehende Daten. + +Prüfe mindestens Kapitelanlage, Kapitelprüfung bei Einordnung, Detailantworten, Navigation, Inhaltsdarstellung, sämtliche Auswahlfelder für Kapitel, Geschwistersortierung, Umhängen/Auflösen und Exportbaum. Nicht nur die Baumdarstellung ändern. Fremde laufende Änderungen bewahren; vorhandene geeignete Komponenten verwenden. + +Nach Übernahme dieses Auftrags die bestätigte Entscheidung gezielt als neuen Fachpunkt in der führenden Produktspezifikation sichern, etwa F-08a, sofern die ID noch frei ist. Die frühere Unterkapitel-Zurückstellung als historischen Stand kenntlich machen. Verlinke den Auftrag in der Planungsübergabe und aktualisiere technische Beschreibung und UX-Ergänzung nur an betroffenen Stellen. Keine neue vollständige Grundlagen-Spezifikation. + +## 7. Abnahme + +Mit synthetischen Daten prüfen und Ergebnis dokumentieren: + +1. Einen bestehenden flachen Vorgang nach der Migration unverändert öffnen. Kapitel-IDs, Inhalte und bisherige Reihenfolgen sind erhalten. +2. Den Beispielbaum aus Abschnitt 3 anlegen. Anschreiben, Abrechnung und mindestens acht Belege, darunter mehrere Paperless-Referenzen sowie eine E-Mail und eine Notiz, gezielt einordnen. Mehrfachauswahl für die Belege tatsächlich bedienen. +3. Direkte Korrespondenz bleibt im Elternkapitel sichtbar. Kinder lassen sich auf- und zuklappen; ihre Inhalte sind verständlich zugeordnet. Beim Wechsel zum Teilvorgang erscheinen dessen eigene Kapitel. +4. Kapitel unter denselben Eltern neu ordnen und einen Unterbaum umhängen. Nach Neuladen bleiben Elternbezüge und Reihenfolgen erhalten. Manipulierte Zyklen, fremde Eltern und konkurrierende Änderungen werden abgewiesen. +5. Dasselbe Element in zwei Kontexten verwenden. Umgliedern in A verändert weder B noch gemeinsame Inhalte und Antwortbezüge. Ein eingeschränkter Nutzer kann keine verborgenen Inhalte oder fremden Herkunftskontexte erschließen. +6. Ein Kapitel auflösen. Direkte Inhalte und Kinder rücken wie angekündigt auf; Unterbäume, Originale und andere Einbindungen bleiben erhalten. +7. Im Export oben alles wählen, ein Unterkapitel abwählen und eine Datei darin wieder anwählen. Zwischenzustände, Prüfübersicht und ZIP stimmen überein; der Verzeichnispfad bleibt erhalten. Die vollständige E-Mail-Anlagenregel gesondert nachprüfen. +8. Reader-Rückkehr, Browser-Zurück, Neuladen und ungesicherte Formulare prüfen. Desktop und 390/360 px, Tastatur und Touchalternative einbeziehen. Lange Kapitelnamen und Pfade bleiben lesbar; die ausgewählte Gestaltung bleibt erhalten. + +Verwende vorhandene Tests und ergänze aussagekräftige Prüfungen für Migration, Elternbezug, Zyklen, Mehrfachumordnung, Konflikte, Rechte und rekursiven Export. Betroffene Backend-Prüfungen und Frontend-Build ausführen; Browserbedienung zusätzlich tatsächlich prüfen. Testdatenbanken getrennt von Development-Nutzerdaten und Production halten. Bericht mit geprüftem Versionsstand, tatsächlichen Ergebnissen und verbleibenden Grenzen liefern. Übernommene historische Testergebnisse nicht als eigenen aktuellen Lauf darstellen. + +## 8. Übergabepunkt und Umfangsgrenze + +Führe die Umsetzung bis zum lokal integrierten, reviewbaren und geprüften Stand durch. Keine Implementierung anderer Sammler, Freigabezusammenstellungen, Finanzfunktionen, einer neuen Rechteebene oder eines vollständigen Connector-Umbaus. Kein Push, Deployment oder Versand von Inhalten durch diesen Auftrag. Halte nur bei echten fachlichen Widersprüchen oder technischen Blockaden Rücksprache; Routineentscheidungen im bestehenden Produkt lösen. diff --git a/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md b/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md index 5f9ed86..0790d55 100644 --- a/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md +++ b/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md @@ -1,6 +1,8 @@ # Tsumugu – Ergänzung zur Bedienung, Orientierung und Aktenordnung im MVP -**Stand:** 17.10.2026 · **Fassung:** 0.6, tatsächlicher Notizsymbol-Austausch und führende gefüllte Richtungsdreiecke +**Stand:** 17.10.2026 · **Fassung:** 0.8, Unterkapitel in der bestehenden Gliederung; Fassung 0.7 zur kompakten Liste bleibt erhalten. + +**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. **Zweck:** Referenz für die Überarbeitung der bestehenden MVP-Anwendung durch den Coding-Agenten. **Bezug:** [Fachliche Produktspezifikation](TSUMUGU_PRODUCT_SPEC.md), insbesondere S-01a–d, F-04a und F-05a; [technischer Entwurf](../architecture/TSUMUGU_TECHNICAL_SPEC.md). @@ -101,6 +103,7 @@ Akten, Unterakten, Vorgänge, Teilvorgänge, Kapitel und Querverweise dürfen op - Direkteinstieg und Rücknavigation funktionieren ohne vorherigen Besuch einer Akte. Breadcrumbs dürfen keine unbekannten oder unberechtigten Herkunftsnamen offenlegen. Eine Darstellungskorrektur eröffnet keinen bisher unzulässigen Direktzugriff. - Unterakten und Teilvorgänge sind als untergeordnete Objekte erkennbar. Querverweise werden als zusätzliche Verknüpfungen kenntlich gemacht und verändern keine fachliche Hauptzuordnung. - Kapitel erscheinen als Gliederungsüberschriften innerhalb der Inhalte und in der Gliederung des zugehörigen Containers, auch wenn sie noch leer sind. Sie erhalten weder eigene Rechte noch einen eigenen Bearbeitungsstatus. Ein Kapitel gehört zur Akte, zum Vorgang oder zum Teilvorgang, in dem es angelegt wird, und bleibt an diesem Objekt, unabhängig vom Einstieg. Dieselbe Unterlage kann in einem anderen Container anders eingeordnet sein; die Zuordnung ändert weder Inhalt noch Freigabe. Reihenfolge und Kapitelzuordnung sind getrennte Aktionen. +- Unterkapitel (F-08a) sind dieselbe Gliederung, eingerückt und als Unterkapitel benannt, nicht als Teilvorgang. Der Kapitelpfad bleibt im Verlauf und im Zieldialog sichtbar. Ein- und Ausklappen ändert die Auswahl nicht. Unter einem gewählten Kapitel legt „Unterkapitel“ die nächste Ebene an; der Dialog nennt Zielobjekt und Elternkapitel. Direkte Einträge und Unterkapitel bleiben getrennt. Mehrere Einträge lassen sich gemeinsam in ein anderes Kapitel desselben Objekts einordnen. Geschwister verschieben sich per Ziehen und über „Nach oben/unten“. „Umhängen“ ist eine eigene Aktion und wechselt das Elternkapitel, auch zurück auf die oberste Ebene. „Auflösen“ nennt vorher die Wirkung: direkte Inhalte und direkte Unterkapitel rücken eine Ebene nach oben, Dateien bleiben. Neben der zentralen Inhaltsfläche steht auf Desktop eine kompakte Gliederungsnavigation mit den relevanten Unterakten, Vorgängen und Kapiteln. Die Auswahl ist sichtbar markiert und bestimmt den betrachteten Bereich. Sie enthält keine zweite Dokumentliste. Auf schmalen Displays wird diese Navigation als ausklappbare Bereichsauswahl angeboten. Kein ständig vollständig aufgeklappter Gesamtbaum aller Akten erforderlich. @@ -306,6 +309,10 @@ Ein Push auf `develop` löst laut Repository einen Development-Deploy aus. Der r ## 15. Fortschreibung +- **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. + - **0.6:** Erneute Prüfung: Notiz erscheint weiterhin als Blatt; 16px-Diagonalpfeile sind zu unauffällig. Führende feste Richtungsspalte mit gefüllten Dreiecken und tatsächlich ersetzte Notiz-Assets verbindlich. SVG-/PNG-Dateien und Cache-Aktualisierung prüfen. Keine Änderung der Kommunikationsbedeutung. - **0.5:** F-06e: optionale Kommunikationsrichtung unabhängig von Format/Quelle, stabile Bezugsseite, sichtbare Zeichen mit Text und keine falschen Standardwerte. Symbolpaket 1.2 und gesonderter Cursor-Auftrag verlinkt. Beziehungsausbau aus 0.4 bleibt erhalten. diff --git a/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md b/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md index d403853..858c38b 100644 --- a/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md +++ b/docs/product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md @@ -10,6 +10,10 @@ Die ausgewählte Tsumugu-Oberfläche wird im vorhandenen Produkt umgesetzt. Dara ## 2. Führende Quellen und gezielte Lesereihenfolge +**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. + 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. @@ -28,7 +32,7 @@ Die [Recovery-Baseline](Tsumugu_Product_Recovery_Baseline_v0.1.md) ist historisc - Vorgänge können ohne Akte bestehen oder mehreren Akten zugeordnet sein. Rechte entstehen grundsätzlich aus dem jeweiligen Aktenkontext mit expliziten Ausnahmen; keine Rechtevereinigung über unsichtbare Kontexte. - Gemeinsame Notizen haben gemeinsamen Inhalt. Änderungen durch Berechtigte sind in den Einbindungen sichtbar. Vorgangsspezifische Anmerkungen und Reihenfolgen sind lokal. Ein Zugriff auf ein Element in B eröffnet keinen Zugriff auf Herkunft A oder dessen übrige Inhalte. - Ersteller/Owner, Bearbeiten, Freigeben, Ownership-Übertragung und Löschen sind unterscheidbar. Freigeben ist nicht automatisch durch Bearbeiten erlaubt. Entfernen einer Einbindung ist nicht globales Löschen. Die Handhabung soll einfach bleiben, auch außerhalb der Familie. -- Kapitel gliedern das jeweils aktive Akten-/Vorgangsobjekt einschließlich Teilvorgang. Keine eigenen Rechte oder Status. Gemeint waren zuletzt die Kapitel des aktiven Objekts, nicht verschachtelte Unterkapitel. Unterkapitelbedarf bleibt offen. +- Kapitel gliedern das jeweils aktive Akten-/Vorgangsobjekt einschließlich Teilvorgang. Keine eigenen Rechte oder Status. Die frühere Aussage, Unterkapitel blieben offen, ist historisch. F-08a verschachtelt sie als dieselbe Gliederung. Auftrag: [TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md](TSUMUGU_UNTERKAPITEL_AUFTRAG_2026-10-17.md). - Eigene Dateien und Notizen ergänzen externe Referenzen. Paperless bleibt Archiv seiner Dokumentdateien. Dokumentanzeige/Referenzierung ist vom späteren bidirektionalen Metadatenabgleich zu unterscheiden. - Aufgaben und Fristen sind unabhängig. Eine erledigte Vorbereitungsaufgabe belegt keine Fristeinhaltung. Keine automatische juristische Fristberechnung beschlossen. - Sichten sind dynamische Auswahlen. Virtuelle Zusammenstellungen ordnen ausgewählte Verweise bewusst an. Späterer gezielter Zugang für einen Anwalt ist gewünscht; Herkunftsbestände bleiben geschützt. Neue Inhalte einer geteilten Zusammenstellung erfordern zusätzliche ausdrückliche Freigabe. diff --git a/frontend/public/ui/content-symbols-v1/dark/communication-local.svg b/frontend/public/ui/content-symbols-v1/dark/communication-local.svg new file mode 100644 index 0000000..56e7c58 --- /dev/null +++ b/frontend/public/ui/content-symbols-v1/dark/communication-local.svg @@ -0,0 +1 @@ +Kommunikation: Lokal diff --git a/frontend/public/ui/content-symbols-v1/dark/communication-unspecified.svg b/frontend/public/ui/content-symbols-v1/dark/communication-unspecified.svg new file mode 100644 index 0000000..7975b75 --- /dev/null +++ b/frontend/public/ui/content-symbols-v1/dark/communication-unspecified.svg @@ -0,0 +1 @@ +Kommunikation: Keine Angabe diff --git a/frontend/public/ui/content-symbols-v1/light/communication-local.svg b/frontend/public/ui/content-symbols-v1/light/communication-local.svg new file mode 100644 index 0000000..5752d4d --- /dev/null +++ b/frontend/public/ui/content-symbols-v1/light/communication-local.svg @@ -0,0 +1 @@ +Kommunikation: Lokal diff --git a/frontend/public/ui/content-symbols-v1/light/communication-unspecified.svg b/frontend/public/ui/content-symbols-v1/light/communication-unspecified.svg new file mode 100644 index 0000000..6ce63ba --- /dev/null +++ b/frontend/public/ui/content-symbols-v1/light/communication-unspecified.svg @@ -0,0 +1 @@ +Kommunikation: Keine Angabe diff --git a/frontend/src/content-symbol.mjs b/frontend/src/content-symbol.mjs index 8b5dd1f..918474d 100644 --- a/frontend/src/content-symbol.mjs +++ b/frontend/src/content-symbol.mjs @@ -6,6 +6,10 @@ const SYMBOL_REV = { "dark/communication-in": "96DD8CF1D6B0", "light/communication-out": "700E710A12CB", "dark/communication-out": "761536F9818E", + "light/communication-local": "6FD92AEECE11", + "dark/communication-local": "2E1EF315DFE5", + "light/communication-unspecified": "759AF850BB6C", + "dark/communication-unspecified": "541E3CFE050C", }; export function symbolUrl(tone, name) { diff --git a/frontend/src/list-meta.mjs b/frontend/src/list-meta.mjs new file mode 100644 index 0000000..293f472 --- /dev/null +++ b/frontend/src/list-meta.mjs @@ -0,0 +1,33 @@ +/** Readable name from a single mailbox address. Chains stay in the reader. */ +export function partyLabel(raw) { + const value = String(raw || "").split(/[;,]/)[0].trim(); + if (!value) return ""; + const named = value.match(/^\s*"?([^"<]+?)"?\s* { + assert.equal(partyLabel("Karin Vogel "), "Karin Vogel"); + assert.equal(partyLabel('"Kanzlei Beispiel" , Ablage '), "Kanzlei Beispiel"); + assert.equal(partyLabel("ablage@example.org"), "ablage"); +}); + +test("incoming mail shows the sender and outgoing mail the recipient", () => { + const element = { + external: { + source: "imap", + detail: { + message_from: "Karin Vogel ", + message_to: "Kanzlei Beispiel ", + }, + }, + }; + assert.equal(counterpartLabel(element, "in"), "Karin Vogel"); + assert.equal(counterpartLabel(element, "out"), "Kanzlei Beispiel"); + assert.equal(counterpartLabel({ kind: "note" }, "local"), ""); +}); + +test("direction symbols distinguish local, unspecified and the triangles", () => { + assert.equal(directionSymbol("in"), "communication-in"); + assert.equal(directionSymbol("out"), "communication-out"); + assert.equal(directionSymbol("local"), "communication-local"); + assert.equal(directionSymbol(""), "communication-unspecified"); + assert.equal(directionSymbol(null), "communication-unspecified"); +}); + +test("bezug counts only readable disclosed counterparts", () => { + assert.equal(bezugCount({ refers_to: [{ id: "a" }], referred_by: [{ id: "b" }, { id: "c" }] }), 3); + assert.equal(bezugCount({}), 0); + assert.equal(bezugCount(null), 0); +}); diff --git a/frontend/src/pages/Cases.jsx b/frontend/src/pages/Cases.jsx index a7597bf..0f65b16 100644 --- a/frontend/src/pages/Cases.jsx +++ b/frontend/src/pages/Cases.jsx @@ -2,13 +2,14 @@ import { useContext, useEffect, useRef, useState } from "react"; import { Link, useNavigate, useParams, useSearchParams } from "react-router-dom"; import { api, markDirty, textToDocument } from "../api.js"; import { SessionContext } from "../session.js"; +import { chapterPathLabel, siblingChapterIds, trailWithChapter } from "./chapters.js"; import { Modal } from "./Modal.jsx"; import { MailPicker, PaperlessPicker } from "./Sources.jsx"; import { ErrorNote, ShareBox } from "./widgets.jsx"; import { ContentBoard, DirectionChoice, MarkdownEditor, ObjectMenu, OrderChoice, RecordTree, SurfaceView, TargetLine, Trail, WorkLists, WorkSwitch, saveChapterOrder, writeSelection } from "./content.jsx"; import { ReadingPane } from "./ReadingPane.jsx"; import { StructureNavigator, Workspace, rememberScroll, restoreScroll, useWorkspaceLayout } from "./workspace.jsx"; -import { IconButton, NavIcon } from "./icons.jsx"; +import { NavIcon } from "./icons.jsx"; export function CaseList() { const { session } = useContext(SessionContext); @@ -202,8 +203,8 @@ function matterOrigin(group) { } function chapterOrigin(base, chapters, chapterId) { - const title = (chapters || []).find((chapter) => chapter.id === chapterId)?.title; - return title ? `${base} · Kapitel ${title}` : base; + const path = chapterPathLabel(chapters, chapterId); + return path ? `${base} · ${path}` : base; } function mergedCaseItems(record, direction, caseId) { @@ -295,6 +296,7 @@ export function CaseDetail() { const [parentTree, setParentTree] = useState(null); const [error, setError] = useState(""); const [modal, setModal] = useState(""); + const [chapterParentId, setChapterParentId] = useState(""); const [view, setView] = useState("contents"); const [dateDir, setDateDir] = useState("asc"); const { width, structureOpen, setStructureOpen } = useWorkspaceLayout(); @@ -434,8 +436,13 @@ export function CaseDetail() { setParams(updated, { replace: true }); } + function openChapter(parentId = "") { + setChapterParentId(parentId || ""); + setModal("chapter"); + } + async function moveChapter(chapterIdToMove, delta) { - const ids = (record?.chapters || []).map((chapter) => chapter.id); + const ids = siblingChapterIds(record?.chapters || [], chapterIdToMove); const index = ids.indexOf(chapterIdToMove); const target = index + delta; if (!record || index < 0 || target < 0 || target >= ids.length) return; @@ -488,7 +495,8 @@ export function CaseDetail() { overview={hasContained ? { active: overview, count: merged.length, onSelect: showOverview } : null} chapterHeading={`Kapitel in ${record.title}`} onChapter={chooseChapter} - onAddChapter={canEdit ? () => setModal("chapter") : null} + onAddChapter={canEdit ? () => openChapter(chapterId) : null} + onAddRootChapter={canEdit ? () => openChapter("") : null} canAddChapter={canEdit} onMoveChapter={moveChapter} canReorder={canEdit && chapters.length > 1} @@ -515,17 +523,10 @@ export function CaseDetail() { >
- +

{record.title}

{record.status === "open" ? "Offen" : "Geschlossen"} - {record.rights.edit ? ( - - - - - - ) : null}
@@ -536,6 +537,9 @@ export function CaseDetail() { ) : null} + {record.rights.edit ? : null} + {record.rights.edit ? : null} + {record.rights.edit ? : null} {record.rights.edit ? : null} {record.rights.edit ? : null} {record.rights.edit ? : null} @@ -569,7 +573,8 @@ export function CaseDetail() { containerId={id} onlyChapter={chapterId} selectedId={entryId} - listTitle={activeChapter ? activeChapter.title : "Direkt in dieser Akte"} + listTitle={activeChapter ? chapterPathLabel(record.chapters, activeChapter.id) : "Direkt in dieser Akte"} + onAddSubchapter={canEdit ? openChapter : null} context={context} onOpen={openEntry} onChange={load} @@ -611,7 +616,8 @@ export function CaseDetail() {

Dieser Inhalt liegt direkt in der Akte. Er erscheint unter „Direkt in dieser Akte“ und im Überblick, nicht in einem Vorgang.

- + + {activeChapter ? : null} @@ -625,17 +631,19 @@ export function CaseDetail() { { setModal(""); load(); }} /> setModal("")}> - { setModal(""); load(); }} /> + { setModal(""); load(); }} /> setModal("")}> - { setModal(""); load(); }} /> + { setModal(""); load(); }} /> setModal("")}> { setModal(""); load(); }} /> - setModal("")}> + setModal("")}> { setModal(""); if (created?.id) { @@ -802,11 +810,11 @@ function caseTrail(record, caseId, group, scope, chapter) { href: chapter ? `/cases/${caseId}?bereich=${group.matter_id}` : null, }); } - if (chapter && (group || scope === "direct")) items.push({ label: `Kapitel ${chapter.title}`, href: null }); + if (chapter && (group || scope === "direct")) items.push({ label: chapter.title, href: null }); return items; } -export function ChapterForm({ path, onChange }) { +export function ChapterForm({ path, onChange, targetLabel = "", parentChapter = null }) { const [title, setTitle] = useState(""); const [dated, setDated] = useState(""); const [error, setError] = useState(""); @@ -815,7 +823,14 @@ export function ChapterForm({ path, onChange }) { event.preventDefault(); setError(""); try { - const created = await api(path, { method: "POST", body: { title, ...(dated ? { document_on: dated } : {}) } }); + const created = await api(path, { + method: "POST", + body: { + title, + ...(dated ? { document_on: dated } : {}), + ...(parentChapter?.id ? { parent_chapter_id: parentChapter.id } : {}), + }, + }); setTitle(""); setDated(""); onChange(created); @@ -826,7 +841,11 @@ export function ChapterForm({ path, onChange }) { return (
- + {targetLabel ?

Ziel: {targetLabel}

: null} +

+ {parentChapter ? <>Elternkapitel: {parentChapter.title} : <>Ebene: oberste Kapitel} +

+ @@ -852,7 +871,7 @@ function chapterSelect(chapters, value, setValue) { diff --git a/frontend/src/pages/Matters.jsx b/frontend/src/pages/Matters.jsx index eacb6e7..2ae4973 100644 --- a/frontend/src/pages/Matters.jsx +++ b/frontend/src/pages/Matters.jsx @@ -5,11 +5,12 @@ import { SessionContext } from "../session.js"; import { Modal } from "./Modal.jsx"; import { MailPicker, PaperlessPicker } from "./Sources.jsx"; import { ErrorNote, ShareBox } from "./widgets.jsx"; +import { chapterPathLabel, siblingChapterIds, trailWithChapter } from "./chapters.js"; import { ChapterForm, FileForm, NoteForm } from "./Cases.jsx"; import { ContentBoard, ObjectMenu, Placements, RecordTree, SurfaceView, TargetLine, Trail, WorkLists, WorkSwitch, matterOpenHref, saveChapterOrder, writeChapter } from "./content.jsx"; import { ReadingPane } from "./ReadingPane.jsx"; import { StructureNavigator, Workspace, rememberScroll, restoreScroll, useWorkspaceLayout } from "./workspace.jsx"; -import { IconButton, NavIcon } from "./icons.jsx"; +import { NavIcon } from "./icons.jsx"; import { ExportPackage } from "./ExportPackage.jsx"; function pageContext(params) { @@ -197,6 +198,7 @@ export function MatterDetail() { const [record, setRecord] = useState(null); const [error, setError] = useState(""); const [modal, setModal] = useState(""); + const [chapterParentId, setChapterParentId] = useState(""); const rightsContext = inherited || { kind: "matter", id }; const placement = inherited?.kind === "case" ? { kind: "matter", id } : null; const [view, setView] = useState("contents"); @@ -367,8 +369,13 @@ export function MatterDetail() { setStructureOpen(false); } + function openChapter(parentId = "") { + setChapterParentId(parentId || ""); + setModal("chapter"); + } + async function moveChapter(chapterIdToMove, delta) { - const ids = (record?.chapters || []).map((chapter) => chapter.id); + const ids = siblingChapterIds(record?.chapters || [], chapterIdToMove); const index = ids.indexOf(chapterIdToMove); const target = index + delta; if (!record || index < 0 || target < 0 || target >= ids.length) return; @@ -435,7 +442,8 @@ export function MatterDetail() { allCount={(record.bindings || []).length} chapterHeading={`Kapitel in ${record.title}`} onChapter={chooseChapter} - onAddChapter={canEdit ? () => setModal("chapter") : null} + onAddChapter={canEdit ? () => openChapter(chapterId) : null} + onAddRootChapter={canEdit ? () => openChapter("") : null} canAddChapter={canEdit} onMoveChapter={moveChapter} canReorder={canEdit && chapters.length > 1} @@ -462,30 +470,26 @@ export function MatterDetail() { >
- +

{record.title}

{record.status === "open" ? "Offen" : "Geschlossen"} - {canEdit ? ( - - - - setModal("move")} /> - - - ) : null}
{width < 1500 ? : null} - {canEdit ? ( ) : null} + + {canEdit ? : null} + {canEdit ? : null} + {canEdit ? : null} + {canEdit ? : null} {canEdit ? : null} {canEdit ? : null} {record.rights.share || record.is_owner ? : null} @@ -503,7 +507,8 @@ export function MatterDetail() { containerId={id} onlyChapter={chapterId} selectedId={entryId} - listTitle={activeChapter ? activeChapter.title : "Alle Inhalte"} + listTitle={activeChapter ? chapterPathLabel(record.chapters, activeChapter.id) : "Alle Inhalte"} + onAddSubchapter={canEdit ? openChapter : null} onOpen={(binding) => { rememberScroll(listRef.current, scrollKey); openEntry(binding); @@ -553,7 +558,8 @@ export function MatterDetail() { setModal("")}>
- + + {activeChapter ? : null} @@ -567,10 +573,10 @@ export function MatterDetail() { { setModal(""); load(); }} /> setModal("")}> - { setModal(""); load(); }} /> + { setModal(""); load(); }} /> setModal("")}> - { setModal(""); load(); }} /> + { setModal(""); load(); }} /> setModal("")}> { setModal(""); load(); }} /> @@ -578,9 +584,11 @@ export function MatterDetail() { setModal("")}> { setModal(""); load(); }} /> - setModal("")}> + setModal("")}> { setModal(""); if (created?.id) { diff --git a/frontend/src/pages/Shell.jsx b/frontend/src/pages/Shell.jsx index 86cc2f8..cb6b3fb 100644 --- a/frontend/src/pages/Shell.jsx +++ b/frontend/src/pages/Shell.jsx @@ -1,4 +1,4 @@ -import { useContext, useEffect, useState } from "react"; +import { useContext, useEffect, useRef, useState } from "react"; import { NavLink, Outlet, useLocation, useNavigate } from "react-router-dom"; import { SessionContext } from "../session.js"; import { Mark, NavIcon } from "./icons.jsx"; @@ -30,6 +30,8 @@ export function Shell() { } }); const [query, setQuery] = useState(""); + const [searchOpen, setSearchOpen] = useState(false); + const searchRef = useRef(null); const [more, setMore] = useState(false); const [width, setWidth] = useState(() => window.innerWidth); const [markIntroDone, setMarkIntroDone] = useState(false); @@ -149,15 +151,23 @@ export function Shell() {
- - - setMarkIntroDone(true)} /> - - Tsumugu - - - setQuery(event.target.value)} placeholder="Suchen" aria-label="Suchen" /> - +
+ + + setMarkIntroDone(true)} /> + + Tsumugu + + +
+ {searchOpen ? ( +
+ setQuery(event.target.value)} placeholder="Suchen" aria-label="Suchen" autoFocus /> + +
+ ) : null}
diff --git a/frontend/src/pages/chapters.js b/frontend/src/pages/chapters.js new file mode 100644 index 0000000..3bd0fcf --- /dev/null +++ b/frontend/src/pages/chapters.js @@ -0,0 +1,82 @@ +export function chapterPath(chapters, chapterId) { + const byId = new Map((chapters || []).map((chapter) => [chapter.id, chapter])); + const names = []; + const seen = new Set(); + let current = byId.get(chapterId); + while (current && !seen.has(current.id)) { + seen.add(current.id); + names.unshift(current.title); + current = current.parent_chapter_id ? byId.get(current.parent_chapter_id) : null; + } + return names; +} + +export function chapterPathLabel(chapters, chapterId) { + return chapterPath(chapters, chapterId).join(" / "); +} + +export function siblingChapterIds(chapters, chapterId) { + const current = (chapters || []).find((chapter) => chapter.id === chapterId); + const parent = current?.parent_chapter_id || null; + return (chapters || []) + .filter((chapter) => (chapter.parent_chapter_id || null) === parent) + .map((chapter) => chapter.id); +} + +export function descendantChapterIds(chapters, chapterId) { + const children = (chapters || []).filter((chapter) => chapter.parent_chapter_id === chapterId); + return children.flatMap((chapter) => [chapter.id, ...descendantChapterIds(chapters, chapter.id)]); +} + +export function buildChapterSections(chapters, bindings) { + const buckets = new Map(); + const loose = []; + const known = new Set((chapters || []).map((chapter) => chapter.id)); + for (const binding of bindings || []) { + if (binding.chapter_id && known.has(binding.chapter_id)) { + const list = buckets.get(binding.chapter_id) || []; + list.push(binding); + buckets.set(binding.chapter_id, list); + } else { + loose.push(binding); + } + } + const nodes = new Map(); + for (const chapter of chapters || []) { + nodes.set(chapter.id, { + id: chapter.id, + title: chapter.title, + documentOn: chapter.document_on || "", + parentId: chapter.parent_chapter_id || "", + items: buckets.get(chapter.id) || [], + children: [], + }); + } + const roots = []; + for (const chapter of chapters || []) { + const node = nodes.get(chapter.id); + const parent = chapter.parent_chapter_id ? nodes.get(chapter.parent_chapter_id) : null; + if (parent) parent.children.push(node); + else roots.push(node); + } + return { roots, loose }; +} + +export function trailWithChapter(items, chapters, chapterId, backHref) { + if (!chapterId) return items; + const path = chapterPath(chapters, chapterId); + if (!path.length) return items || []; + const base = (items || []).map((item, index, all) => ( + index === all.length - 1 && !item.href ? { ...item, href: backHref } : item + )); + return [...base, { label: path.join(" / "), href: null }]; +} + +export function findSection(nodes, id) { + for (const node of nodes || []) { + if (node.id === id) return node; + const found = findSection(node.children, id); + if (found) return found; + } + return null; +} diff --git a/frontend/src/pages/content.jsx b/frontend/src/pages/content.jsx index e8f0846..9bfcb39 100644 --- a/frontend/src/pages/content.jsx +++ b/frontend/src/pages/content.jsx @@ -1,11 +1,19 @@ import { useEffect, useRef, useState } from "react"; +import { createPortal } from "react-dom"; import { Link } from "react-router-dom"; import { api, fetchFile, fetchPaperless } from "../api.js"; import { contentSourceSymbol, contentSymbol, symbolUrl } from "../content-symbol.mjs"; +import { bezugCount, counterpartLabel, directionSymbol } from "../list-meta.mjs"; import { MarkdownView } from "../markdown.jsx"; -import { IconButton, NavIcon } from "./icons.jsx"; import { Modal } from "./Modal.jsx"; import { ErrorNote } from "./widgets.jsx"; +import { + buildChapterSections, + chapterPathLabel, + descendantChapterIds, + findSection, + siblingChapterIds, +} from "./chapters.js"; export function formatDate(value) { if (!value) return "Ohne Datum"; @@ -56,7 +64,7 @@ export function withSelection(href, params) { export function TargetLine({ label, chapters = [], chapterId = "", chapterTitle = "" }) { if (!label) return null; const chapter = chapters.find((item) => item.id === chapterId); - const namedChapter = chapter?.title || chapterTitle; + const namedChapter = chapter ? chapterPathLabel(chapters, chapter.id) : chapterTitle; return (

Ziel: {label} @@ -77,15 +85,27 @@ export function fachDate(element) { } export function Trail({ items }) { + const [open, setOpen] = useState(false); if (!items?.length) return null; + const long = items.length > 2; + const shown = long && !open ? [items[0], null, items[items.length - 1]] : items; return (

); } @@ -140,30 +160,14 @@ export function RecordTree({ items, parentKey, hrefFor }) { ); } -function sectionsOf(chapters, bindings) { - const buckets = new Map(); - const loose = []; - for (const binding of bindings || []) { - if (binding.chapter_id && chapters.some((chapter) => chapter.id === binding.chapter_id)) { - const list = buckets.get(binding.chapter_id) || []; - list.push(binding); - buckets.set(binding.chapter_id, list); - } else { - loose.push(binding); - } +function looseSection(loose, chapters) { + if (chapters.length && loose.length) { + return { id: "loose", title: "Ohne Kapitel", documentOn: "", parentId: "", items: loose, children: [] }; } - const sections = (chapters || []).map((chapter) => ({ - id: chapter.id, - title: chapter.title, - documentOn: chapter.document_on || "", - items: buckets.get(chapter.id) || [], - })); - if (sections.length && loose.length) { - sections.push({ id: "loose", title: "Ohne Kapitel", documentOn: "", items: loose }); - } else if (!sections.length) { - sections.push({ id: "loose", title: "", documentOn: "", items: loose }); + if (!chapters.length) { + return { id: "loose", title: "", documentOn: "", parentId: "", items: loose, children: [] }; } - return sections; + return null; } export function matterOpenHref(item) { @@ -289,18 +293,151 @@ export function directionValue(communication) { return ""; } -export function DirectionColumn({ direction }) { - const known = direction === "in" || direction === "out"; - const name = direction === "out" ? "communication-out" : "communication-in"; - const label = directionWord(direction); +function DirectionGlyph({ direction }) { + const name = directionSymbol(direction); + const local = direction === "local"; return ( - - {known ? ( - <> - - - - ) : null} + <> + + + + ); +} + +export function DirectionColumn({ direction }) { + const label = directionWord(direction) || "Keine Angabe"; + return ( + + + + ); +} + +const DIRECTION_OPTIONS = [ + ["in", "Eingang"], + ["out", "Ausgang"], + ["local", "Lokal"], + ["", "Keine Angabe"], +]; + +function MenuPopover({ open, anchorRef, onClose, label, children, sheet = false }) { + const panelRef = useRef(null); + const closeRef = useRef(onClose); + closeRef.current = onClose; + const [place, setPlace] = useState(null); + + useEffect(() => { + if (!open) return undefined; + function position() { + const phone = window.matchMedia("(max-width: 720px)").matches; + const rect = anchorRef.current?.getBoundingClientRect(); + if (phone && sheet) { + setPlace({ phone: true }); + return; + } + const width = Math.min(300, window.innerWidth - 16); + const height = 240; + const left = Math.max(8, Math.min(rect ? rect.left : 8, window.innerWidth - width - 8)); + let top = rect ? rect.bottom + 6 : 8; + if (rect && top + height > window.innerHeight - 8) top = Math.max(8, rect.top - height - 6); + setPlace({ phone: false, top, left, width }); + } + position(); + function onKey(event) { + if (event.key !== "Escape") return; + event.preventDefault(); + event.stopPropagation(); + closeRef.current(); + } + function onScroll(event) { + if (panelRef.current?.contains(event.target)) return; + position(); + } + window.addEventListener("keydown", onKey); + window.addEventListener("resize", position); + window.addEventListener("scroll", onScroll, true); + const frame = requestAnimationFrame(() => { + const selected = panelRef.current?.querySelector("[aria-selected='true']") + || panelRef.current?.querySelector("button, a, input, select"); + selected?.focus(); + }); + return () => { + cancelAnimationFrame(frame); + window.removeEventListener("keydown", onKey); + window.removeEventListener("resize", position); + window.removeEventListener("scroll", onScroll, true); + }; + }, [open, sheet, anchorRef]); + + if (!open || typeof document === "undefined") return null; + return createPortal( +
+
, + document.body, + ); +} + +export function DirectionControl({ direction = "", title, disabled = false, onChange }) { + const anchorRef = useRef(null); + const [open, setOpen] = useState(false); + const known = directionWord(direction); + const name = known + ? `Kommunikationsrichtung${title ? ` für ${title}` : ""}: ${known}` + : "Kommunikationsrichtung festlegen – keine Angabe"; + function close() { + setOpen(false); + anchorRef.current?.focus(); + } + return ( + + + +
+ {DIRECTION_OPTIONS.map(([value, label]) => ( + + ))} +
+
); } @@ -342,42 +479,254 @@ function blurb(element) { return raw.replace(/^#{1,3}\s+/gm, "").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/[*`]/g, "").replace(/\s+/g, " ").trim(); } -function BezugLines({ element, source, onOpen, itemHref }) { - const refers = element.refers_to || []; - const replies = element.referred_by || []; - if (!refers.length && !replies.length) return null; - return ( -
- {refers.map((item) => ( - - ))} - {replies.map((item) => ( - - ))} -
- ); -} - -function BezugLink({ item, label, source, onOpen, itemHref, reply = false }) { +function BezugTarget({ item, source, onOpen, itemHref, onDone }) { const found = source.find((entry) => entry.element?.id === item.id); const href = found && itemHref ? itemHref(found) : ""; - const className = reply ? "bezug__link bezug__link--reply" : "bezug__link"; - const body = ( - <> - {label} - {formatDate(item.document_on)} · {item.title} - {directionWord(item.direction) ? {directionWord(item.direction)} : null} - - ); + const caption = `${formatDate(item.document_on)} · ${item.title}`; if (found && onOpen) { return ( - ); } - if (href) return {body}; - return

{body}

; + if (href) { + return {caption}; + } + return

{caption}

; +} + +function BezugMenu({ element, source, onOpen, itemHref }) { + const refers = element.refers_to || []; + const replies = element.referred_by || []; + const count = bezugCount(element); + const anchorRef = useRef(null); + const [open, setOpen] = useState(false); + if (!count) return null; + function close() { + setOpen(false); + anchorRef.current?.focus(); + } + return ( + <> + + + {refers.length ?

Bezug auf

: null} + {refers.map((item) => ( + + ))} + {replies.length ?

Darauf bezogen

: null} + {replies.map((item) => ( + + ))} +
+ + ); +} + +function ChapterHeading({ + section, + count, + expanded, + movable, + canEdit, + canDate, + pending, + siblingIndex, + siblingCount, + chapters, + blockedParents, + version, + orderContext, + onToggle, + onRename, + onRemove, + onDate, + onMove, + onAddSubchapter, + onChange, + onError, + onPending, +}) { + const anchorRef = useRef(null); + const [open, setOpen] = useState(false); + const real = section.id !== "loose"; + const showMenu = real && (canEdit || canDate || movable || onAddSubchapter); + function close() { + setOpen(false); + anchorRef.current?.focus(); + } + return ( + <> +

+ {real ? {section.parentId ? "Unterkapitel" : "Kapitel"} : null} + {section.title} +

+ {count} + {section.documentOn ? {formatDate(section.documentOn)} : null} + {showMenu ? ( + <> + + + + {canEdit && onAddSubchapter ? : null} + {canEdit ? : null} + {canDate ? ( + + ) : null} + {movable ? : null} + {movable ? : null} + {canEdit ? ( +
{ + event.preventDefault(); + const parent = new FormData(event.currentTarget).get("parent"); + onPending(true); + onError(""); + api(`/api/v1/chapters/${section.id}/parent`, { + method: "POST", + body: { expected_version: version, parent_chapter_id: parent || null, ...orderContext }, + }).then(() => { + close(); + return onChange(); + }).catch((err) => onError(err.message)).finally(() => onPending(false)); + }}> +
+ Umhängen + + +
+
+ ) : null} + {canEdit ? : null} +
+ + ) : null} + + ); +} + +function EntryActions({ + element, + binding, + source, + chapters, + index, + lastIndex, + canEdit, + canDestroy, + canSort, + custom, + pending, + onSetBezug, + onClearBezug, + onRemove, + onMove, + onPlaceChapter, +}) { + const anchorRef = useRef(null); + const [open, setOpen] = useState(false); + const show = canEdit || (canSort && custom) || (canSort && chapters.length); + if (!show) return null; + function close() { + setOpen(false); + anchorRef.current?.focus(); + } + return ( +
+ + + {canEdit ? ( + <> +

Bezug

+ + {(element.refers_to || []).map((item) => ( + + ))} + + ) : null} + {canSort && chapters.length ? ( + + ) : null} + {canSort && custom ? : null} + {canSort && custom ? : null} + {canEdit ? : null} + {canEdit && canDestroy ? : null} +
+
+ ); } function TypeGlyph({ name, tone, size = 28 }) { @@ -461,6 +810,7 @@ export function ContentBoard({ onlyChapter = "", selectedId = "", onOpen, + onAddSubchapter, listTitle = "", }) { const source = bindings || record?.bindings || []; @@ -469,13 +819,21 @@ export function ContentBoard({ const [pending, setPending] = useState(false); const [draggingId, setDraggingId] = useState(""); const [indicator, setIndicator] = useState(null); + const [folded, setFolded] = useState(() => new Set()); + const [picking, setPicking] = useState(false); + const [picked, setPicked] = useState(() => new Set()); + const [pickTarget, setPickTarget] = useState(""); const dragRef = useRef(null); const rootRef = useRef(null); + const savingDirection = useRef(false); const custom = record?.content_order === "position"; const direction = record?.content_order_dir === "desc" ? "desc" : "asc"; - const sections = sectionsOf(chapters, source); - const visibleSections = onlyChapter ? sections.filter((section) => section.id === onlyChapter) : sections; - const shownCount = onlyChapter ? (visibleSections[0]?.items.length || 0) : source.length; + const forest = buildChapterSections(chapters, source); + const loose = looseSection(forest.loose, chapters); + const selectedSection = onlyChapter ? findSection(forest.roots, onlyChapter) : null; + const visibleRoots = onlyChapter ? (selectedSection ? [selectedSection] : []) : forest.roots; + const shownCount = onlyChapter ? (selectedSection?.items.length || 0) : source.length; + const activePath = onlyChapter ? chapterPathLabel(chapters, onlyChapter) : ""; const canSort = sortable && record?.rights?.edit; const canEdit = Boolean(record?.rights?.edit); const canDestroy = Boolean(record?.is_owner); @@ -503,6 +861,8 @@ export function ContentBoard({ } async function saveRowDirection(binding, value) { + if (savingDirection.current) return; + savingDirection.current = true; setPending(true); setError(""); try { @@ -518,6 +878,7 @@ export function ContentBoard({ } catch (err) { setError(err.message); } finally { + savingDirection.current = false; setPending(false); } } @@ -577,8 +938,8 @@ export function ContentBoard({ if (!drag?.html5) return; event.preventDefault(); if (drag.kind === "chapter") { - drag.index = chapterUnder(event.clientY); - setIndicator({ sectionId: drag.chapterId, index: drag.index, kind: "chapter" }); + drag.index = chapterUnder(event.clientY, drag.parentId); + setIndicator({ sectionId: drag.chapterId, index: drag.index, kind: "chapter", parentId: drag.parentId || "" }); return; } const sectionId = event.target?.closest?.("[data-section]")?.getAttribute("data-section"); @@ -661,7 +1022,7 @@ export function ContentBoard({ } function moveChapter(chapterId, delta) { - const ids = chapters.map((chapter) => chapter.id); + const ids = siblingChapterIds(chapters, chapterId); const index = ids.indexOf(chapterId); const target = index + delta; if (index < 0 || target < 0 || target >= ids.length) return; @@ -705,7 +1066,10 @@ export function ContentBoard({ } async function removeChapter(section) { - if (!window.confirm(`Kapitel „${section.title}“ löschen? Die Inhalte bleiben in der Liste.`)) return; + const parent = chapters.find((chapter) => chapter.id === section.parentId); + const targetName = parent ? `das Kapitel „${parent.title}“` : "die oberste Ebene"; + const childNote = section.children?.length ? " Direkte Unterkapitel rücken mit ihrem Unterbaum mit." : ""; + if (!window.confirm(`Kapitel „${section.title}“ auflösen? Die Gliederung entfällt. Direkte Inhalte rücken nach ${targetName}.${childNote} Dateien und andere Einbindungen bleiben erhalten.`)) return; setError(""); setPending(true); try { @@ -721,8 +1085,19 @@ export function ContentBoard({ } } + function allSections() { + const list = []; + const walk = (section) => { + list.push(section); + (section.children || []).forEach(walk); + }; + forest.roots.forEach(walk); + if (loose) list.push(loose); + return list; + } + async function move(bindingId, delta) { - const next = sections.map((section) => ({ ...section, items: [...section.items] })); + const next = allSections().map((section) => ({ ...section, items: [...section.items] })); let moved = false; for (const section of next) { const index = section.items.findIndex((item) => item.id === bindingId); @@ -736,6 +1111,29 @@ export function ContentBoard({ await persist(next); } + async function placeMany(ids, chapterId) { + if (!ids.length) return; + setError(""); + setPending(true); + try { + await api(`${orderPath}/bindings/chapters`, { + method: "POST", + body: { + expected_version: record.version, + binding_ids: ids, + chapter_id: chapterId || null, + ...orderContext, + }, + }); + setPicked(new Set()); + onChange(); + } catch (err) { + setError(err.message); + } finally { + setPending(false); + } + } + async function placeChapter(bindingId, chapterId) { setError(""); setPending(true); @@ -762,16 +1160,19 @@ export function ContentBoard({ } function sectionUnder(clientY) { - const nodes = [...(rootRef.current?.querySelectorAll("[data-section]") || [])]; - const hit = nodes.find((node) => { + const nodes = [...(rootRef.current?.querySelectorAll("[data-section]") || [])].filter((node) => { const rect = node.getBoundingClientRect(); return clientY >= rect.top && clientY <= rect.bottom; }); - return hit?.getAttribute("data-section") || null; + nodes.sort((left, right) => left.getBoundingClientRect().height - right.getBoundingClientRect().height); + return nodes[0]?.getAttribute("data-section") || null; } - function chapterUnder(clientY) { - const nodes = [...(rootRef.current?.querySelectorAll("[data-chapter] .chapter-head") || [])]; + function chapterUnder(clientY, parentId) { + const key = parentId || ""; + const nodes = [...(rootRef.current?.querySelectorAll("[data-chapter]") || [])].filter( + (node) => (node.getAttribute("data-chapter-parent") || "") === key, + ); if (!nodes.length) return 0; for (let i = 0; i < nodes.length; i += 1) { const next = nodes[i + 1]?.getBoundingClientRect(); @@ -787,7 +1188,7 @@ export function ContentBoard({ setIndicator(null); if (!drag || !drag.moved || drag.index == null) return; if (drag.kind === "chapter") { - const ids = chapters.map((chapter) => chapter.id); + const ids = siblingChapterIds(chapters, drag.chapterId); const from = ids.indexOf(drag.chapterId); const target = drag.index; if (from < 0 || target == null || target === from) return; @@ -796,7 +1197,7 @@ export function ContentBoard({ reorderChapters(ids); return; } - const next = sections.map((section) => ({ ...section, items: [...section.items] })); + const next = allSections().map((section) => ({ ...section, items: [...section.items] })); const source = next.find((item) => item.id === drag.sectionId); const targetSection = next.find((item) => item.id === (drag.targetSectionId || drag.sectionId)); if (!source || !targetSection) return; @@ -835,8 +1236,8 @@ export function ContentBoard({ if (event.clientY < 72) window.scrollBy(0, -16); if (event.clientY > window.innerHeight - 72) window.scrollBy(0, 16); if (drag.kind === "chapter") { - drag.index = chapterUnder(event.clientY); - setIndicator({ sectionId: drag.chapterId, index: drag.index, kind: "chapter" }); + drag.index = chapterUnder(event.clientY, drag.parentId); + setIndicator({ sectionId: drag.chapterId, index: drag.index, kind: "chapter", parentId: drag.parentId || "" }); return; } drag.targetSectionId = sectionUnder(event.clientY) || drag.sectionId; @@ -902,61 +1303,98 @@ export function ContentBoard({ return (
-
-

{onlyChapter ? (visibleSections[0]?.title || listTitle || "Kapitel") : (listTitle || "Inhalte")}

-

{shownCount} {shownCount === 1 ? "Eintrag" : "Einträge"}

+

{activePath || listTitle || "Inhalte"} {shownCount}

+
+ {canSort && chapters.length && !picking ? ( + + ) : null} + {canSort ? ( + + ) : sortable ? ( +

{custom ? "Eigene Reihenfolge" : `Fachliches Datum, ${direction === "desc" ? "absteigend" : "aufsteigend"}`}

+ ) : null}
- {canSort ? ( - - ) : sortable ? ( -

{custom ? "Eigene Reihenfolge" : `Fachliches Datum, ${direction === "desc" ? "absteigend" : "aufsteigend"}`}

- ) : null}
{pending ?

Ordnung wird gespeichert …

: null} + {picking ? ( +
+

{picked.size} ausgewählt

+ + + +
+ ) : null} {source.length || chapters.length ? ( - visibleSections.map((section) => { - const chapterIndex = chapters.findIndex((chapter) => chapter.id === section.id); - const expanded = !onlyChapter || section.id === onlyChapter; - const movable = canMoveChapters && section.id !== "loose"; - const fromIndex = chapters.findIndex((chapter) => chapter.id === draggingId); + renderBlockList() + ) : ( +

Noch keine Unterlage und keine Notiz.

+ )} +
+ ); + + function renderBlockList() { + const blocks = [...visibleRoots]; + if (!onlyChapter && loose) blocks.push(loose); + return blocks.map((section) => renderBlock(section, 0, false)); + } + + function renderBlock(section, depth, hideHead) { + const siblings = section.id === "loose" ? [] : siblingChapterIds(chapters, section.id); + const siblingIndex = siblings.indexOf(section.id); + const fromSiblings = siblingChapterIds(chapters, draggingId); + const fromIndex = fromSiblings.indexOf(draggingId); + const expanded = !folded.has(section.id); + const movable = canMoveChapters && section.id !== "loose" && siblings.length > 1; const classes = ["content-section"]; - if (!onlyChapter && section.title) classes.push("content-section--group"); + if (depth) classes.push("chapter-nest"); + if (section.title) classes.push("content-section--group"); if (draggingId === section.id) classes.push("is-dragging"); if (!expanded) classes.push("is-collapsed"); - const insertBefore = indicator?.kind === "chapter" && fromIndex > indicator.index && chapterIndex === indicator.index; - const insertAfter = indicator?.kind === "chapter" && fromIndex >= 0 && fromIndex < indicator.index && chapterIndex === indicator.index; + const sameParent = (indicator?.parentId || "") === (section.parentId || ""); + const insertBefore = indicator?.kind === "chapter" && sameParent && fromIndex > indicator.index && siblingIndex === indicator.index; + const insertAfter = indicator?.kind === "chapter" && sameParent && fromIndex >= 0 && fromIndex < indicator.index && siblingIndex === indicator.index; + const blockedParents = new Set([section.id, ...descendantChapterIds(chapters, section.id)]); return (
{insertBefore ? + ); })} {indicator?.sectionId === section.id && indicator?.kind !== "chapter" && indicator.index === section.items.length ?
); - }) - ) : ( -

Noch keine Unterlage und keine Notiz.

- )} -
- ); + } } export function OrderChoice({ mode, direction, disabled, allowPosition = false, onChange }) { diff --git a/frontend/src/pages/workspace.jsx b/frontend/src/pages/workspace.jsx index 3b808de..4a7ae0f 100644 --- a/frontend/src/pages/workspace.jsx +++ b/frontend/src/pages/workspace.jsx @@ -1,5 +1,6 @@ import { useEffect, useState } from "react"; import { Link } from "react-router-dom"; +import { chapterPathLabel } from "./chapters.js"; import { NavIcon } from "./icons.jsx"; export function useWorkspaceLayout() { @@ -53,7 +54,7 @@ export function Workspace({ width, structureOpen, setStructureOpen, hasEntry, na function structureIcon(kind) { if (kind === "Akte" || kind === "Unterakte") return "folder"; - if (kind === "Kapitel") return "chapter"; + if (kind === "Kapitel" || kind === "Unterkapitel") return "chapter"; if (kind === "Inhalte") return "contents"; if (kind === "Querverweis" || kind === "Weitere Akte") return "link"; return "layers"; @@ -64,11 +65,18 @@ function branchHasCurrent(node) { return (node.children || []).some(branchHasCurrent); } -function TreeRow({ node, onNavigate, ancestor = false }) { +function TreeRow({ node, onNavigate, ancestor = false, toggle = null }) { const className = node.current ? "nav-tree__link is-current" : ancestor ? "nav-tree__link is-ancestor" : "nav-tree__link"; const icon = ; - const label = {node.title}; - const name = `${node.kind}: ${node.title}`; + const name = node.path ? `${node.kind}: ${node.path}` : `${node.kind}: ${node.title}`; + const label = ( + + {node.title} + {node.kind === "Kapitel" || node.kind === "Unterkapitel" || node.kind === "Teilvorgang" ? ( + {node.kind} + ) : null} + + ); let row; if (node.onSelect) { row = ( @@ -92,29 +100,46 @@ function TreeRow({ node, onNavigate, ancestor = false }) {
); } - if (node.moveUp === undefined && node.moveDown === undefined) return row; + const moves = node.moveUp !== undefined || node.moveDown !== undefined ? ( + + + + + ) : null; return (
+ {toggle} {row} - - - - + {moves}
); } -function TreeNodes({ nodes, onNavigate, unfold = false }) { +function TreeNodes({ nodes, onNavigate, unfold = false, isOpen, onToggle }) { if (!nodes?.length) return null; return (
    {nodes.map((node) => { - const open = unfold || node.current || branchHasCurrent(node); + const hasChildren = Boolean(node.children?.length); + const open = hasChildren && isOpen(node, unfold); + const toggle = hasChildren ? ( + + ) : ( +