Files
tsumugu/docs/product/TSUMUGU_UX_MVP_ERGAENZUNG.md
LarsandCursor 3c190c87b4
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Successful in 1m37s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 9s
Halte Anlagen und Versand als eigene Verwendung fest, damit die uebermittelte Fassung und ihre Nachweise spaeter nicht still mit der Arbeitsfassung verschmelzen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-18 09:57:59 +02:00

51 KiB
Raw Permalink Blame History

Tsumugu – Ergänzung zur Bedienung, Orientierung und Aktenordnung im MVP

Stand: 18.10.2026 · Fassung: 0.9, klare Kapitelgrenzen, Schreiben mit Anlagen und Versand/Nachweise.

Aktueller Ausbau F-08b/c: Schreiben, Anlagen, Versand und Kapitelgrenzen – gemeinsamer Auftrag. Anlagen sind eine neue ausdrückliche Inhaltsverwendung; Unterkapitel bleiben thematische Gliederung. Schreiben werden mit ihren Anlagen kompakt dargestellt, Versand mit konkretem übermitteltem Stand und vollständigen Nachweisen dokumentiert. E-Mails bleiben vollständig erhalten, ihre reine Nachweisdarstellung kann redundante Einträge im aktiven Kontext vermeiden. Gliederung und durchgehende Chronologie unterscheiden; keine stillen Datumsänderungen oder Umdeutung allgemeiner Bezüge. Kapitel/Unterkapitel durch Flächen/Typografie/Einrückung abgrenzen, doppelte Überschrift und unklare Zählwerte korrigieren. Kompakte Liste, bestehende Symbole und Kontextrechte bleiben erhalten. Der Auftrag legt die neue Darstellung gegenüber widersprechenden älteren Vorgaben fest; keine Umsetzung wird hiermit als bereits fertig behauptet.

Neuester Auftrag F-06f: Kompakte Inhaltsliste – vollständige Anforderungen und Cursor-Auftrag. 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, insbesondere S-01a–d, F-04a und F-05a; technischer Entwurf.

Aktuelle Umsetzungsvorgabe: Vorschauzeilen als Standard, stabile objektbezogene Breadcrumbs, getrennte Anzeige der Aktenzuordnung, eine zentrale wechselnde Arbeitsfläche und verpflichtendes Drag-and-drop für die eigene Reihenfolge. Diese Fassung ersetzt die widersprechenden Freiheiten der Fassung 0.1. Bereits funktionierende Teile des ersten Umbaus bleiben erhalten.

Neueste Präzisierung F-06c: Die Zeilen erhalten eindeutige Typ-Symbole als verlässlichen Standard. Der Nutzer weist darauf hin, dass Miniaturen häufig fehlen oder keine lesbare Information tragen. Eine echte Miniatur ergänzt nur dort, wo sie erkennbar hilft; der große Leser bleibt erhalten. Die folgende ältere Thumbnail-Pflicht ist entsprechend ersetzt. Fertige Einzeldateien und konkrete Einbindung stehen im Symbol-/Logo-Rahmen-Auftrag.

1. Ziel und Verbindlichkeit

Neueste Präzisierung F-06e: Inhaltstyp, Quelle und Kommunikationsrichtung getrennt darstellen. Eingang/Ausgang erscheinen als gefülltes Dreieck ganz vorne in einer festen Richtungsspalte: Eingang nach rechts hinein, Ausgang nach links heraus, Desktop 28px/Handy mindestens 24px. Danach Inhaltstyp und Titel; Text „Eingang“/„Ausgang“ bleibt sichtbar. Unbekannte Richtung oder eigene Gedanken lassen diese Spalte leer und gleich breit. Die Notizdateien tatsächlich durch die gelieferte Sprechblase mit Stift ersetzen und ausgelieferten Inhalt prüfen. Die Richtung bezieht sich auf die vertretene Seite im aktiven Vorgang, nicht auf den angemeldeten Nutzer. Datumsfelder allein begründen keine eindeutige Richtung, beide Felder nicht zu „Eingang · Ausgang“ verbinden. Bestehende Vorbelegung nur bei belastbaren Quelldaten, bewusste Korrektur/Leeren erhalten. Spezifikation und konkreter Cursor-Auftrag, Fassung 1.1, einschließlich fertiger SVG-/PNG-Zeichen im Symbolpaket 1.3.

Die bestehende erste Lieferung „Organisieren und Nachverfolgen“ soll im Alltag verständlich und praktisch bedienbar werden. Die Überarbeitung umfasst Darstellung und Bedienabläufe sowie die dafür erforderlichen gezielten Anpassungen an Schnittstellen und Speicherung. Ein reiner Austausch von Farben und Abständen erfüllt diesen Auftrag nicht.

Die Reihenfolge innerhalb einer Akte kann selbst fachliche Information tragen. Nutzer müssen Zusammenhänge erkennen, Inhalte sinnvoll anordnen und die nächste Arbeit schnell erreichen können. Das technische Änderungsprotokoll darf diese Arbeitsansicht nicht bestimmen.

Die folgenden Quellen sind zu unterscheiden:

  • Ausdrücklicher Nutzerbedarf: Die derzeitige Optik ist verwirrend; Hierarchien sind nicht erkennbar; lange Aktionsprotokolle überladen Objekte. Fachliche Daten und alternative Ordnungsmöglichkeiten fehlen in der nutzbaren Inhaltsdarstellung. Das Änderungsprotokoll bleibt zur Nachvollziehbarkeit sinnvoll, kann aber über ein Menü erreichbar sein. Die innere Aktenordnung ist ein wesentlicher Informationsträger.
  • Bereits bestätigtes Fachmodell: Eigenständige und mehrfach zugeordnete Vorgänge, gemeinsam verwendete Elemente mit Kontextrechten, reine Gliederung durch Kapitel sowie getrennte Aufgaben und Fristen bleiben erhalten.
  • Konkrete Ausgestaltung für diese Überarbeitung: Nach der zweiten Prüfung und dem Vergleich zweier Entwürfe ist „Vorschauzeilen“ die ausgewählte Richtung. Der Nutzer beauftragt die Fortschreibung dieser Anforderungen und die Übergabe an den Coder. Die nachfolgenden Regeln legen den nächsten Umsetzungsauftrag fest; sie werden nicht rückwirkend als Entscheidungen aus dem ursprünglichen Fachinterview ausgegeben. Routineentscheidungen zur Darstellung trifft der Agent selbst.

Diese Ergänzung präzisiert die Bedienung des MVP. Sie ändert keine Rechte-, Ownership-, Lösch- oder Datenraumregeln. Bei Widersprüchen in älteren Dokumenten sind deren damaliger Stand und der aktuelle Auftrag zu beachten; ein historischer Spezifikationsauftrag ist kein Verbot einer inzwischen ausdrücklich beauftragten Implementierung.

2. Ausgangsbefunde und Prüfgrenzen

2.1 Erste Prüfung – historischer Ausgangspunkt

Grundlage ist eine angemeldete, lesende Prüfung der Development-Anwendung am 17.10.2026: Übersicht, Akten- und Vorgangslisten, vorhandene Detailseiten und Erfassungsdialoge für Vorgänge, Unterlagen, Aufgaben und Fristen. Es wurden keine fachlichen Daten gespeichert, gelöscht oder freigegeben. Die Befunde belegen sichtbare Bedienprobleme; sie sind kein vollständiger Funktionstest des Backends.

Sichtbarer Befund Geforderte Verbesserung
Übersicht beginnt mit „Vorläufige Annahmen“ und Erläuterungen interner Rechte-/Fristenlogik. Arbeit und Inhalte zuerst; allgemeine Annahmen aus dem normalen Arbeitsbereich entfernen.
Leere Teilvorgangs- und Querverweisbereiche stehen im Vorgang vor den Unterlagen. Inhalte und Handlungsbedarf unmittelbar erreichbar; selten benötigte Struktur ergänzend darstellen.
Vorgangsübersicht verweist zum Anlegen auf eine Akte. Vorgang direkt und ohne verpflichtende Aktenzuordnung anlegen können.
Hauptnavigation gewichtet Datenräume, Quellen und Nutzer stark; Aufgaben/Fristen fehlen als eigener Einstieg. Tägliche Arbeit direkt erreichbar; Administration bündeln.
Dokumentdialog beginnt mit Entfernen, globalem Löschen und Einbindungsverwaltung. Inhalt/Vorschau und Lesen/Bearbeiten priorisieren.
Technische Aktionsereignisse füllen die Chronologie. Fachliche Ordnung, fachlichen Verlauf und Änderungsprotokoll trennen.
Akte zeigt einen leeren Unterlagenbereich, obwohl ein enthaltener Vorgang eine Unterlage hat. Direkte Inhalte und Inhalte untergeordneter Vorgänge verständlich unterscheiden.
Dialog „Vorgang anlegen“ schließt mit „Vorgang verbinden“. Aktionen eindeutig nach ihrer tatsächlichen Wirkung benennen.

Datumsfelder und Positionswerte sind im technischen Entwurf und teilweise im Code bereits vorhanden. Der Agent prüft ihren tatsächlichen Zustand und verwendet sie, soweit passend. Aus einer fehlenden nutzbaren Anzeige folgt nicht, dass das gesamte Datenmodell neu gebaut werden muss.

2.2 Zweite Prüfung – Grundlage des nächsten Umbaus

Die erneute lesende Prüfung zeigt Verbesserungen: vereinfachte Navigation, direkt anlegbare eigenständige Vorgänge, Ordnungsarten und zurückgenommene Verwaltungsaktionen. Diese Fortschritte erhalten. Es wurden weiterhin keine fachlichen Daten verändert. Die zweite Prüfung ist kein Nachweis bestandener Speichertests oder eines erfolgreichen Drag-and-drop-Vorgangs.

Aktueller Befund Korrektur in Fassung 0.2
Derselbe Vorgang zeigt über die Übersicht einen Aktenpfad und über die Vorgangsliste einen anderen Breadcrumb. Breadcrumb beschreibt den stabilen Objektpfad; Aktenzuordnung und geprüfter Handlungskontext werden separat dargestellt und erhalten.
Inhaltsliste, „Struktur und Zuordnung“ sowie Verlauf/Protokoll bleiben große Bereiche derselben Seite. Eine zentrale Arbeitsfläche; ergänzende Ansichten ersetzen ihren Inhalt. Struktur dient als kompakte Navigation.
Direkte Akteninhalte und Inhalte enthaltener Vorgänge werden in separaten Blöcken einschließlich Leerzuständen dargestellt. Eine Inhaltskomponente mit klarer Auswahl des betrachteten Bereichs und Herkunftsangaben.
Titel-/Datumszeilen und formularlastige Dokumentdetails vermitteln wenig Inhalt. Vorschauzeilen mit Thumbnail, Kurzbeschreibung und direkter Leseansicht.
Es gibt Verschiebeschaltflächen, aber keine erkennbare Drag-and-drop-Implementierung im geprüften Frontend. Drag-and-drop einschließlich Einfügeposition, Speicherung und alternativem Tastatur-/Touchweg wird Pflicht.

Die vorherigen Vorgaben waren bei Breadcrumbs und Seitenaufbau zu offen; Drag-and-drop war ausdrücklich optional. Die gemeldeten Probleme werden daher als präzisierter Auftrag behandelt, nicht pauschal als Verletzung damaliger Pflichten.

3. Arbeitsablauf als Maßstab

Der folgende Ablauf muss mit der überarbeiteten Anwendung durchgängig möglich sein:

  1. Einen Vorgang direkt anlegen, zunächst auch ohne Akte.
  2. Den Vorgang bei Bedarf einer vorhandenen Akte zuordnen.
  3. Ein Schreiben als eigene Datei oder Paperless-Referenz hinzufügen und eine Notiz ergänzen.
  4. Ein fachliches Datum erfassen oder bewusst offenlassen.
  5. Die Inhalte nach fachlichem Datum oder in eigener Reihenfolge anordnen.
  6. Eine Unterlage anhand ihrer Vorschau und Kurzbeschreibung erkennen, direkt öffnen, lesen und eine kontextbezogene Anmerkung ergänzen.
  7. Eine Aufgabe und unabhängig davon eine Frist erfassen.
  8. Später den Vorgang und die offene Arbeit über die Übersicht oder die jeweiligen Listen wiederfinden.
  9. Eine Änderung bei Bedarf im separat aufrufbaren Änderungsprotokoll nachvollziehen.

Die Oberfläche muss den aktuellen Kontext und die Wirkung von Änderungen verständlich machen, ohne auf jeder Seite das vollständige Berechtigungsmodell zu erklären.

4. Navigation und Startseite

Die Hauptnavigation enthält die täglichen Arbeitsbereiche:

  • Übersicht
  • Vorgänge
  • Akten
  • Aufgaben & Fristen

Quellen, Nutzerverwaltung und Datenraumverwaltung werden in einem verständlich benannten Verwaltungs-/Einstellungsbereich gebündelt. Vorhandene Funktionen bleiben dort erreichbar. Eine vorhandene Auswahl des aktuellen Datenraums bleibt im Arbeitsbereich sichtbar, soweit sie für die Bedienung erforderlich ist; sie muss klar von dessen Verwaltung unterschieden sein. Die bestehende Suche bleibt leicht zugänglich.

Die Übersicht zeigt offene Aufgaben, anstehende und überfällige Fristen sowie zuletzt verwendete oder zuletzt bearbeitete sichtbare Vorgänge. Eine einfache zuletzt-bearbeitet-Liste genügt; kein neues umfassendes Nutzungs-Tracking aufbauen. „Vorgang anlegen“ ist eine direkt erreichbare Hauptaktion. Keine zusätzlichen dekorativen Kennzahlen ohne Arbeitsnutzen.

Aufgaben & Fristen bietet eine zentrale, filterbare Sicht mit klar erkennbarer Zuordnung zum lesbaren Fachobjekt. Die Trennung beider Sachverhalte bleibt auch bei gemeinsamer Darstellung verständlich. Nur lesbare Herkunftsobjekte verlinken; bestehende Regeln für eigenständige Aufgaben beibehalten.

5. Hierarchie und Kontext

Akten, Unterakten, Vorgänge, Teilvorgänge, Kapitel und Querverweise dürfen optisch nicht wie gleichartige, unverbundene Karten wirken.

  • Jede Detailseite zeigt einen klickbaren, objektbezogenen Breadcrumb mit sichtbaren, berechtigt zugänglichen Stationen, anschließend Titel, Status und verständliche Objektart. Der Breadcrumb ist keine Besuchshistorie.
  • Eine Akte zeigt ihre tatsächliche sichtbare Unteraktenhierarchie, beispielsweise „Akten → Vermietung → Musterwohnung“. Ein Vorgang, der in genau einer lesbaren Akte liegt oder in einem geprüften Aktenkontext geöffnet wird, setzt dieselbe Aktenkette fort: „Akten → Vermietung → Nebenkosten Jakisch → Vorgang Nebenkosten 2025“. Ein Teilvorgang hängt daran den lesbaren Elternvorgang. Der Breadcrumb ist damit an beiden Einstiegen gleich und führt zu den Strukturstellen. Liegt der Vorgang in mehreren lesbaren Akten und ist keine davon als Kontext gewählt, erfindet der Breadcrumb keine Hauptakte und bleibt bei „Vorgänge → Nebenkosten 2025“; die Zuordnungen bleiben daneben wählbar. Querverweise erzeugen keine zusätzliche Elternkette. Ein in der Aktenansicht ausgewählter Vorgang oder ein ausgewähltes Kapitel verlängert denselben Breadcrumb.
  • Eine Unterlage ergänzt den Pfad ihres aktuell geöffneten Containers, beispielsweise „Vorgänge → Nebenkosten 2025 → Einwendungen zur Abrechnung“. Bei Mehrfacheinbindung kann dieselbe Unterlage in unterschiedlichen Containern unterschiedliche Pfade haben. Innerhalb desselben Containers bleibt der Pfad bei wechselndem Einstieg stabil.
  • Die relevante Aktenzuordnung wird daneben verständlich als „In Akte: Vermietung → Musterwohnung“ angezeigt und ist navigierbar. Weitere lesbare Zuordnungen sind dort auswählbar. Es gibt keine künstliche Hauptakte. Bei eigenständigen Vorgängen entfällt die Aktenangabe, solange keine passende Zuordnung gewählt ist.
  • Die visuelle Stabilisierung darf den tatsächlichen Handlungskontext nicht entfernen oder still wechseln. Kontextparameter, serverseitige Berechtigungsprüfung sowie Zuordnung von Anmerkungen bleiben beim Öffnen, Bearbeiten, Weiterlesen, Zurückkehren und Neuladen erhalten. Ein Kontextwechsel ist eine bewusste Auswahl und wird serverseitig geprüft. Keine Rechtevereinigung über andere Zuordnungen und kein automatischer Rückfall auf einen weitergehenden Owner-Zugriff.
  • 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.

6. Aufbau von Akten und Vorgängen

Oben: Breadcrumb, Titel, Status, gegebenenfalls eine kurze Beschreibung und eine eindeutige Hauptaktion zum Hinzufügen von Inhalten. Verwaltungsaktionen sind ergänzend zugänglich.

Die Seite besitzt genau eine zentrale Arbeitsfläche. Standard ist „Inhalte“. „Aufgaben & Fristen“ ist ein zweites Register derselben Fläche. „Fachlicher Verlauf“, „Änderungsprotokoll“ und „Zuordnungen“ öffnen sich über das Objektmenü als eigene Ansicht in dieser Fläche. Immer nur die gewählte Ansicht anzeigen; die bisherige Inhaltsliste wird beim Wechsel nicht zusätzlich darüber stehen gelassen. Objektkopf und Gliederungsnavigation bleiben zur Orientierung erhalten. Rückkehr zu den Inhalten erhält Auswahl, Filter, Ordnung und nach Möglichkeit die Leseposition.

Der große Sammelblock „Struktur und Zuordnung“ entfällt. Seine fachliche Gliederung wandert in die Bereichsnavigation; Aktionen wie Kapitel anlegen, Zuordnen, Querverweis und Teilen sind am passenden Objekt-/Abschnittsmenü verfügbar. Kein Ersatz durch mehrere neue gleichartige Akkordeons oder eine ständig sichtbare zweite Verwaltungsleiste.

Leere Teilvorgänge, Querverweise, Unterakten und Kapitel dürfen keinen langen Stapel großer Leerzustände vor den Inhalten erzeugen. Eine kompakte Aktion zum erstmaligen Anlegen genügt. Benötigte Funktionen bleiben auffindbar.

Die Aktenansicht verwendet eine gemeinsame Inhaltskomponente mit einer kompakten Bereichsauswahl. Sie unterscheidet eindeutig:

  • Direkt in dieser Akte: unmittelbar eingebundene Inhalte.
  • In enthaltenen Vorgängen: Inhalte der zugeordneten Vorgänge, jeweils mit sichtbarer berechtigter Herkunft und Öffnung im passenden Kontext.

Zusätzlich bietet „Alle Inhalte“ eine gemeinsame Lesesicht auf direkte Inhalte und die Inhalte der unmittelbar zugeordneten Vorgänge. Herkunft ist an jeder Vorschauzeile als kurze Angabe erkennbar, beispielsweise „Direkt in dieser Akte“ oder „Aus Vorgang Nebenkosten 2025“. In der Akte ist dies der normale Überblick; ein leerer direkter Inhaltsbereich wird nicht als zusätzlicher Block davor angezeigt. Die Bereichsauswahl kann auf direkte Einträge, einen Vorgang oder ein Kapitel einschränken. Genau eine Liste bleibt sichtbar. Eine rekursive Gesamtsicht über beliebig tiefe Hierarchien ist nicht erforderlich.

„Alle Inhalte“ ist eine abgeleitete Lesesicht, die fachlich nach Datum sortierbar ist. Sie erzeugt keine neuen Einbindungen, keine zweite manuelle Gesamtordnung und keine Änderung an den gespeicherten Ordnungen der Herkunftsvorgänge. Für „Eigene Reihenfolge“, neue Inhalte und neue Kapitel muss ein einzelner bearbeitbarer Container ausgewählt sein; die Oberfläche benennt dieses Ziel, beispielsweise „Kapitel in Vorgang Nebenkosten 2025 hinzufügen“, und bietet in der Lesesicht zuerst die Bereichsauswahl. Aktenrechte gelten nicht ungeprüft als Bearbeitungsrecht eines ausgewählten Vorgangs. Fachliches Ziel und Handlungskontext bleiben getrennt. Kein mehrdeutiges Ziehen über mehrere Herkunftscontainer.

Die Bereichs- und Kapitelauswahl gehört zum gerade geöffneten Objekt. Ein Wechsel der Akte, des Vorgangs oder des Teilvorgangs übernimmt keine fremde Auswahl. Eine zum selben Objekt gehörende Auswahl bleibt bei Neuladen, Browser-Zurück und Rückkehr aus einer Unterlage erhalten. Nach dem Anlegen ist das neue Kapitel ausgewählt und beim Hinzufügen weiterer Einträge vorausgewählt; Ziel und Kapitel sind im Formular erkennbar. Der Ordnungsmodus bleibt in einer kompakten Auswahl sichtbar, ohne eine Reihe großer Sortierschaltflächen.

Bei Mehrfachvorkommen bleibt die konkrete Einbindung eindeutig. Dasselbe Element darf in der Lesesicht nicht wie mehrere unabhängige Originale wirken: Mehrere sichtbare Herkunftseinbindungen als solche kenntlich machen, vor dem Öffnen gegebenenfalls die konkrete Einbindung auswählen. Inhalte und Anmerkungen ausschließlich aus dem gewählten geprüften Kontext öffnen. Verborgene Einbindungen weder zählen noch benennen.

6.1 Vorschauzeilen als verbindlicher Standard

Eine Vorschauzeile ist eine kompakte horizontale Inhaltskarte mit:

  • kleinem Thumbnail beziehungsweise einer klaren Ersatzdarstellung;
  • gut lesbarem Titel;
  • fachlichem Datum, Typ und Quelle in einer zurückhaltenden Metadatenzeile;
  • ein bis zwei Zeilen Kurzbeschreibung oder Textauszug;
  • Herkunfts-/Kapitelangabe, soweit für die aktuelle Ansicht erforderlich;
  • einem kleinen Aktionsmenü sowie einem Ziehgriff im eigenen Ordnungsmodus.

Ein Klick auf Vorschau oder Titel öffnet die Leseansicht. Nicht die ganze Zeile mit großen Verschiebe- und Verwaltungsbuttons füllen. Unbekannte Inhalte transparent kennzeichnen, statt Beschreibungen oder Datumsangaben zu erfinden.

Die Kurzbeschreibung ist optional und am Element bearbeitbar, sofern die bestehenden Inhaltsrechte dies erlauben. Sie ist gemeinsame Metainformation, keine lokale Anmerkung. Ohne manuell gepflegte Beschreibung kann ein vorhandener, sicher verfügbarer Textauszug dienen. Keine KI-Zusammenfassung und keine neue OCR-/Importplattform als Voraussetzung. Die kontextbezogene Anmerkung bleibt separat.

Jede Zeile zeigt ein eindeutiges Symbol für die bekannte Inhaltsart; keine identische generische Ikone für alle Typen. Für Notizen Symbol und lesbaren Textauszug verwenden. Bei Fotos oder tatsächlich unterscheidbaren Bildmotiven kann eine zusätzliche echte Miniatur helfen. Kleine PDF-/Textseitenbilder sind nicht pauschal erforderlich. Fehlt eine Miniatur oder scheitert ihre Erzeugung, bleibt das passende Typ-Symbol mit direktem Öffnungsweg sichtbar; keine große leere Textkachel und kein endloser Ladezustand. Große Dokumentvorschau und Originalöffnung bleiben erhalten. Keine fest eingebauten Mustervorschauen im Produkt und kein ungefragtes vollständiges Dateiladen allein für eine nicht genutzte Listenminiatur. Dateiart und Quelle getrennt halten; Paperless ohne Formatmetadaten nicht automatisch als PDF bezeichnen.

Eine Dokumentkachel-Ansicht ist eine optionale spätere Darstellungsalternative. Für diesen Auftrag genügt die ausgewählte Vorschauzeilen-Ansicht. Keine Pflicht, beide Entwurfsvarianten parallel zu implementieren. Falls beide entstehen, verwenden sie dieselben Einbindungen, Filter und Reihenfolgen und werden nicht als zwei Listen gleichzeitig angezeigt.

7. Fachliche Daten und Ordnung der Inhalte

7.1 Datumsbedeutung

Die Inhaltsliste zeigt je Eintrag mindestens Titel, Typ und das vorhandene fachliche Datum mit verständlicher Bedeutung. Bei Schreiben ist das regelmäßig das Dokumentdatum, bei einer Notiz oder einem fachlichen Ereignis ein ausdrücklich erfasstes Bezugs-/Ereignisdatum.

  • Dokumentdatum, Versanddatum, Zugangsdatum und technisches Erfassungsdatum bleiben semantisch getrennt. Bestehende Werte erhalten ihre Bedeutung.
  • Bei Erfassung und Bearbeitung ist das fachliche Datum leicht erreichbar und optional. Fehlende Daten werden als „Ohne Datum“ erkennbar, ohne Pflicht zu erfundenen Angaben.
  • Das Erfassungsdatum wird nicht stillschweigend als Dokument- oder Ereignisdatum verwendet. Dokumenttitel werden nicht automatisch als zuverlässige Datumsquelle interpretiert.
  • Eine Metadatenänderung an einem gemeinsam verwendeten Element kann mehrere Kontexte betreffen. Bestehende Berechtigungs- und gemeinsame Änderungsregeln gelten weiter. Für unterschiedliche Aktenordnungen dient die kontextbezogene Position.
  • Deutsche Datumsdarstellung verwenden. Technische Zeitstempel im Änderungsprotokoll verständlich lokal anzeigen; Rohwerte und Zeitzonen bleiben bei Bedarf nachvollziehbar.

7.2 Zwei einfache Ordnungsarten

Ordnungsart Verhalten
Fachliches Datum Aufsteigend oder absteigend wählbar; die Richtung ist sichtbar. Undatierte Einträge stehen in beiden Richtungen in einer klar erkennbaren Gruppe am Ende.
Eigene Reihenfolge Nutzer ordnen Einträge gezielt, beispielsweise Schreiben vor Anlage oder Begründung vor Beleg. Das Datum bleibt sichtbar, bestimmt hier aber die Position nicht.

Weitere frei kombinierbare Sortierregeln oder ein allgemeiner Regelbaukasten sind kein MVP-Ziel. Eine zusätzliche einfache Titelsortierung ist optional und darf die beiden erforderlichen Modi nicht verzögern.

7.3 Bezug auf eine konkrete Unterlage

Ein Schreiben kann die Antwort auf ein bestimmtes früheres Schreiben sein. Der Bezug speichert genau diese Beziehung. Er sortiert die Liste nicht um und zieht die beiden Enden nicht zusammen. Schreiben, die dazwischen eingegangen oder hinausgegangen sind, bleiben eigene Zeilen an ihrer fachlichen Stelle.

  • An der Antwort steht „Bezug auf“ mit Datum und Titel der früheren Unterlage. An jener steht „Darauf bezogen“ mit den Antworten.
  • Der Leser zeigt denselben Schriftwechsel als eigene Folge, nur aus den verbundenen Unterlagen. Die Lücke bleibt in der Inhaltsliste sichtbar.
  • Ein Klick auf den Bezug öffnet die andere Unterlage, ohne die gewählte Liste oder ihre Position zu wechseln.
  • Der Bezug ist kein Kapitel, kein zweites Elternteil und kein Querverweis zwischen Vorgängen.
  • Eingang und Ausgang folgen der optionalen, eindeutigen Kommunikationsangabe gemäß F-06e. Eindeutige Postfachmetadaten können vorbelegen; Versand-/Zugangsdatum allein ist kein allgemeiner Richtungsnachweis. Absender, Empfänger und Anhänge bleiben an der übernommenen E-Mail sichtbar.

7.4 Speicherung und Interaktion

  • Eigene Positionen gehören zur Einbindung im jeweiligen Container, nicht zum globalen Dokument. Dieselbe Unterlage kann in Akte A zuerst und in Vorgang B zuletzt stehen.
  • Eine Inhaltsordnung innerhalb desselben Vorgangs bleibt dessen Ordnung, auch wenn der Vorgang über unterschiedliche Akten geöffnet wird. Die Position des Vorgangs innerhalb einer Akte gehört dagegen zu seiner dortigen Zuordnung.
  • Gewählter Ordnungsmodus, Richtung und eigene Reihenfolge bleiben nach Neuladen und erneutem Anmelden erhalten. Für den MVP gilt eine gemeinsame gespeicherte Ordnung je Container; persönliche Sortierprofile sind nicht erforderlich. Änderungen daran benötigen das passende Bearbeitungsrecht im geprüften Kontext.
  • Innerhalb von Kapiteln gilt die gewählte Inhaltsordnung. Die Kapitel selbst bleiben in ihrer eigenen Gliederungsreihenfolge. Ein ungegliederter Bereich bleibt eindeutig. Das Kapitel eines Eintrags wird durch einen Sortierwechsel nicht verändert.
  • Gleichdatierte oder undatierte Einträge erhalten eine stabile Reihenfolge, etwa anhand vorhandener Positionswerte und einer eindeutigen technischen Kennung. Technische Gleichstandsregeln werden nicht als fachliche Daten ausgegeben.
  • Neue Einträge stehen im Modus „Eigene Reihenfolge“ zunächst am Ende des gewählten Abschnitts; eine gezielte Einfügeposition ist möglich, falls bereits einfach unterstützt. Keine unvorhersehbare Umordnung bestehender Einträge.
  • Ein Wechsel zur Datumssortierung zerstört die eigene Reihenfolge nicht. Die Rückkehr stellt sie wieder her. Für neue Container ist „Fachliches Datum, aufsteigend“ der einfache Default; vorhandene Reihenfolgen werden bei der Einführung nicht ungefragt ersetzt.
  • Drag-and-drop ist im Modus „Eigene Reihenfolge“ verpflichtend: sichtbarer Ziehgriff, erkennbar mitbewegter Eintrag, eindeutige Einfügelinie vor beziehungsweise nach dem Ziel, Abbruch ohne Änderung und nach dem Ablegen zuverlässig gespeicherte Position. Auch an Anfang und Ende eines Abschnitts ablegen können. Bei langen Listen erforderliches Scrollen während des Ziehens unterstützen.
  • Im Datumssortiermodus kein wirkungsloses Ziehen von Einträgen anbieten. Für die manuelle Eintragsordnung muss der Modus sichtbar gewechselt werden. In einer zusammengesetzten Lesesicht zunächst den einzelnen bearbeitbaren Container wählen.
  • Tastatur und Touch erhalten zusätzlich einen vollständigen Weg ohne Drag-and-drop, beispielsweise kleine Menüaktionen „Nach oben“/„Nach unten“. Leser erhalten keine aktiven Verschiebeaktionen. Erfolgreiches Speichern, laufender Vorgang, Fehler und Versionskonflikt verständlich anzeigen; eine fehlgeschlagene Speicherung darf nicht wie eine dauerhaft übernommene Ordnung erscheinen.
  • Der Pflichtumfang für Drag-and-drop ist die Reihenfolge innerhalb eines Kapitels beziehungsweise des ungegliederten Bereichs und das Ziehen eines Eintrags in ein anderes Kapitel desselben Containers. Der Kapitelwechsel bleibt zusätzlich über „In Kapitel einordnen“ möglich. Ein Kapitelwechsel innerhalb desselben Containers ändert keine Ownership oder Freigabe.
  • Kapitel tragen eine eigene Reihenfolge und optional ein fachliches Datum. Am Kapitelkopf ziehen oder „Nach oben“/„Nach unten“ verschiebt das Kapitel samt seinen Einträgen, auch wenn der Vorgang noch nach Datum sortiert ist. Das Ablegen stellt die Ordnung sichtbar auf „Eigene Reihenfolge“ und speichert die Position. Solange die Kapitel nicht von Hand verschoben werden, bestimmt im Datumsmodus das Kapiteldatum die Reihenfolge; Kapitel ohne Datum stehen am Ende. Die Einträge bleiben in ihrem Kapitel. Die Aktion „In Kapitel einordnen“ und das Verschieben eines Kapitels ändern weder gemeinsame Inhalte noch Freigaben.
  • Sortieren ist kein Verschieben in einen anderen Vorgang und verändert keine Rechte, Inhalte, Ownership oder Freigaben.
  • Reorder-Anfragen werden serverseitig geprüft. Fremde oder nicht lesbare Einträge dürfen nicht über übermittelte IDs bearbeitet oder offengelegt werden. Die Reihenfolge ausschließlich sichtbarer Einträge darf verborgene Positionen nicht als Lücken oder Anzahl verraten. Verdeckte Einbindungen dürfen beim Speichern nicht verloren gehen.
  • Gleichzeitige Änderungen dürfen keine fremden Einbindungen oder Reihenfolgen still überschreiben. Eine einfache Versionsprüfung mit verständlicher Aufforderung zum Neuladen genügt.

Die technische Speicherung kann vorhandene bindings.position, Kapitelpositionen und Datumsfelder verwenden. Tabellen-/Feldnamen sind kein neuer Produktvertrag; unnötige parallele Modelle vermeiden.

8. Inhaltsansicht, fachlicher Verlauf und Änderungsprotokoll

Diese drei Zwecke erhalten getrennte Zugänge:

Ansicht Zweck und Inhalt
Inhalte Fachlich geordnete Unterlagen, Notizen und Gliederung; normale Arbeitsansicht.
Fachlicher Verlauf Dokumente, Kommunikation und fachliche Ereignisse anhand ihrer ausdrücklich vorhandenen fachlichen Zeitbezüge. Datumstypen bleiben unterscheidbar.
Änderungsprotokoll Wer hat wann etwas erfasst, geändert, zugeordnet oder entfernt? Technische Nachvollziehbarkeit bei Bedarf.

Fachlicher Verlauf und Änderungsprotokoll werden über das Objektmenü als eigene Ansicht der zentralen Arbeitsfläche geöffnet. Kein angehängter Bereich unter der Inhaltsliste und kein zweites dauerhaftes Registerband am Seitenende. Das Protokoll bleibt vollständig und berechtigt abrufbar. Lange Protokolle werden begrenzt nachgeladen oder paginiert; kein unendlicher Aktionsstapel in der normalen Objektansicht. Fehlende historische Informationen werden nicht erfunden.

Das Ausblenden in der Arbeitsansicht bedeutet weder das Löschen von Audit-Einträgen noch das Abschalten der Protokollierung. Nicht jede technische Aktion erzeugt einen fachlichen Verlaufseintrag. Derselbe Dokumentzugang darf dort nicht durch mehrere technische Ereignisse als mehrere fachliche Vorgänge erscheinen. Im Protokoll bleiben tatsächlich unterschiedliche Aktionen nachvollziehbar.

Fehlt für einen Eintrag ein fachliches Datum, wird dies transparent behandelt; ein technischer Zeitstempel macht ihn nicht nachträglich zu einem datierten fachlichen Ereignis. Eine vollständige neue Ereignis-Engine ist für die Trennung nicht erforderlich.

9. Unterlagen öffnen und bearbeiten

Ein Klick auf eine Unterlage führt unmittelbar zu einer brauchbaren Lese-/Detailansicht mit Titel, Inhalt beziehungsweise sicherer Vorschau und den relevanten Metadaten. Eine Desktop-Seitenansicht ist ebenso möglich wie eine gut strukturierte Detailseite. Der Dokumentinhalt beziehungsweise Notiztext erhält die Hauptfläche; ein dauerhaft geöffneter Metadateneditor mit einem separaten „Öffnen“-Button als einzigem Lesezugang genügt bei unterstützten Vorschautypen nicht. Datums-/Beschreibungsbearbeitung und Anmerkungen bleiben kompakt erreichbar. Bei nicht unterstützten oder nicht erreichbaren externen Vorschauen ist ein eindeutiger Öffnungsweg mit Erklärung zulässig. Dialoge nicht beliebig ineinander verschachteln.

  • Notizen zeigen ihren Text; berechtigte Bearbeitung ist eindeutig erreichbar.
  • Eigene Dateien und Paperless-Referenzen nutzen vorhandene sichere Vorschau-/Öffnungsmöglichkeiten. Für nicht darstellbare oder nicht erreichbare Inhalte gibt es einen klaren Öffnen-/Downloadweg beziehungsweise eine verständliche Fehlermeldung.
  • Kontextbezogene Anmerkungen sind am gelesenen Inhalt verfügbar und als solche erkennbar. Ihre Wirkung bleibt vom gemeinsamen Notiztext unterscheidbar.
  • Weitere Einbindungen, Schreibschutz, Teilen und Entfernen gehören in einen ergänzenden Bereich oder ein Aktionsmenü. Häufiges Lesen wird nicht von diesen Einstellungen überlagert.
  • „In weitere Akte/Vorgang einbinden“ ist eine bewusste Aktion mit Zielauswahl und den vorhandenen Freigabe-/Zielbearbeitungsprüfungen. Lokales Ordnen darf keine neue Sichtbarkeit erzeugen. Kein containerübergreifendes Drag-and-drop mit stiller Freigabe und keine Dokumentkopie zur Einordnung.
  • „Aus diesem Vorgang entfernen“ und „Überall löschen“ bleiben sprachlich und funktional getrennt. Globale Löschwirkung muss vor der Ausführung klar sein; bestehende Schutz- und Bestätigungsregeln bleiben erhalten.
  • Keine Änderung an Paperless-Originalen, Berechtigungen oder Freigaben allein durch Öffnen und Vorschau. Kein neuer Paperless-Abgleich als Voraussetzung dieses UX-Auftrags.

10. Erfassung und Nachverfolgung

„Vorgang anlegen“ ist in der Vorgangsübersicht verfügbar. Eine Aktenzuordnung ist optional und kann später ergänzt werden. In einer Akte darf die Aktion eindeutig „Vorgang anlegen und zuordnen“ heißen. Eine Auswahl eines bereits existierenden Vorgangs heißt entsprechend „Vorhandenen Vorgang zuordnen“; Anlage und Zuordnung dürfen nicht durch widersprüchliche Beschriftungen vermischt werden.

Für neue Inhalte genügen klar benannte Einstiege für Notiz, Datei und externe Referenz. Bereits vorhandene E-Mail- oder Paperless-Funktionen bleiben nutzbar; keine neue Importplattform bauen. Kurze Formulare mit Titel, Inhalt/Quelle und optionalem fachlichem Datum; weitere Optionen bei Bedarf. Gewählter Zielkontext und gegebenenfalls Kapitel müssen erkennbar sein. Nach dem Speichern erscheint der Eintrag im Ziel und an der erklärbaren Position.

Eine E-Mail wird vor dem Übernehmen in einer Vorschau gelesen. Der Klick wählt sie aus; übernommen wird sie erst ausdrücklich. Ordner und Nachrichtenliste bleiben kompakt, linksbündig und unabhängig scrollbar. Richtung, Absender, Empfänger und Anhänge sind in der Liste und nach dem Einfügen sichtbar. Der Leser lädt den Nachrichtentext aus dem Postfach. Paperless-Dateien bleiben ein eigener Vorschauweg. Andere Herkunft erhält nicht die E-Mail-Ansicht.

„Aufgabe hinzufügen“ und „Frist erfassen“ erhalten eindeutige Einstiege. Ein gemeinsamer Dialog mit einer verständlichen Auswahl ist zulässig; zwei gleichzeitig offene, konkurrierende Formulare vermeiden. Arbeitstermin einer Aufgabe und maßgebliche Frist klar beschriften. Aufgabe erledigen und Frist als erfüllt kennzeichnen bleiben getrennte Aktionen. Lange allgemeine Erklärungen durch kurze kontextuelle Hilfen ersetzen.

Formulare zeigen Fehler am betroffenen Feld, sichern Eingaben bei fehlgeschlagenem Speichern und verhindern unbeabsichtigte Mehrfachanlage. Bei tatsächlich ungesicherten Eingaben vor dem Verlassen warnen; leere Dialoge ohne unnötige Rückfrage schließen lassen.

11. Visuelle und responsive Umsetzung

Ziel ist eine ruhige, lesbare Arbeitsoberfläche mit klarer Gewichtung. Vorhandene geeignete Komponenten und das bestehende Erscheinungsbild weiterentwickeln; kein neues Designsystem als Vorprojekt.

  • Wenige konsistente Schriftgrößen und Abstände; Seitentitel, Abschnittstitel, Zeilentitel und ergänzende Angaben sind klar unterscheidbar.
  • Vorschauzeilen mit ausgerichteten Thumbnails, lesbaren Titeln, Kurzbeschreibungen und wenigen relevanten Kennzeichen bilden die zentrale Inhaltsansicht. Lange Titel bleiben lesbar; notwendige Information nicht ausschließlich in Tooltips verstecken.
  • Eine erkennbare Hauptaktion je Arbeitsbereich; sekundäre Aktionen zurückhaltend. Destruktive Aktionen ergänzend und eindeutig.
  • Weißraum dient der Gruppierung. Große Leerflächen und hohe Karten pro Eintrag dürfen zusammengehörige Arbeit nicht auseinanderziehen.
  • Status und Dringlichkeit über Text und ergänzende Gestaltung vermitteln, nicht allein über Farbe.
  • Sichtbare Fokusmarkierungen, beschriftete Eingaben, verständliche Symbolaktionen und ausreichend bedienbare Klickflächen.
  • Desktop: Objektkopf, kompakte Gliederungsnavigation und eine zentrale Arbeitsfläche; keine gleichzeitigen Inhalts-/Historien-/Zuordnungslisten. Kleinere Displays: Gliederung ausklappbar, Vorschauzeilen umbrechen sinnvoll, die Leseansicht bleibt bedienbar; keine unbedienbare verkleinerte Mehrspaltenansicht.
  • Ladezustand, echter Leerzustand, Fehler und fehlende Berechtigung sind unterscheidbar. Während des Ladens keine irreführende Behauptung „Keine Akte“ oder „Keine Unterlagen“.

12. Technischer Rahmen und Datenbestand

Die bestehende Anwendung wird gezielt weiterentwickelt: produktlokal mit FastAPI, PostgreSQL und React gemäß Repository und geltenden Jinkendo-Verträgen. Keine neue Architekturinventur und kein pauschaler Neubau. Die konkreten Blueprint-Quellen sind im technischen Entwurf und im historischen Technik-Handoff verzeichnet; dortige frühere Auftragsgrenzen gelten für jene damalige Spezifikationsetappe.

Der Agent prüft zunächst aktuellen Code, AGENTS.md, Tests und Arbeitsstand. Nicht zugehörige lokale Änderungen bleiben unberührt. Für erforderliche neue persistente Ordnungsangaben gezielte Migrationen mit erhaltendem Umgang mit Bestandsdaten erstellen. Vorhandene manuelle Reihenfolgen und fachliche Daten erhalten; keine Reset-/Seed-Lösung für einen bestehenden Datenbestand.

Breadcrumbs, Gesamtsichten, Suchtreffer, Vorschauen, Protokolle und Sortierung verwenden dieselben gültigen Berechtigungen und Handlungskontexte wie der übrige Zugriff. Eine ausgeblendete Schaltfläche ersetzt keine serverseitige Prüfung. Gemeinsam verwendete Elemente bleiben gemeinsam; kein Kopieren zur Vereinfachung der Oberfläche.

Thumbnails, Textauszüge und Kurzbeschreibungen sind geschützte Inhalte. Vorhandene Datei-/Paperless-Adapter und sichere Renderwege verwenden. Cache oder direkte Vorschaulinks dürfen keine öffentlichen Nebenwege schaffen oder entzogene Zugriffe fortbestehen lassen. Berechtigung auch beim Abruf abgeleiteter Inhalte prüfen. Erforderliche Ausgaben begrenzen und Fehler in der Vorschau dürfen die Inhaltsliste nicht unbenutzbar machen.

Nicht Bestandteil dieses Auftrags sind Finanzfunktionen, bidirektionale Paperless-Synchronisation, KI, externer Anwaltszugang, eine allgemeine Workflow-Engine, beliebige dynamische Sichten oder ein umfangreicher Regelbaukasten. Die dafür bestätigten Produktziele bleiben bestehen.

13. Abnahme und Nachweise

ID Überprüfbares Ergebnis
UX-01 Über die Vorgangsübersicht lässt sich ein eigenständiger Vorgang ohne Akte anlegen und anschließend optional zuordnen. Titel, Aktion und Ergebnis stimmen überein.
UX-02 Akten-/Unteraktenhierarchie und fachliche Vorgangs-/Teilvorgangsbeziehung sind anhand von objektbezogenem Breadcrumb und kompakter Gliederung verständlich. Aktenzuordnung ist separat erkennbar; Direktlinks und weitere lesbare Zuordnungen offenbaren keine verborgenen Pfade.
UX-03 Ein Vorgang mit Unterlagen und ohne Teilvorgänge/Querverweise zeigt seine Inhalte unmittelbar; keine langen leeren Strukturabschnitte davor.
UX-04 Mindestens acht gemischte Einträge mit unterschiedlichen Daten, zwei gleichen Daten und zwei fehlenden Daten werden bei beiden Datumsrichtungen stabil und nachvollziehbar angezeigt. Erfassungsdatum ersetzt kein fehlendes Fachdokumentdatum.
UX-05 Eine eigene Reihenfolge bleibt nach Neuladen und erneuter Anmeldung erhalten. Wechsel zu Datumsordnung und zurück erhält die eigene Ordnung. Ein neuer Eintrag wird an der dokumentierten Stelle eingefügt.
UX-06 Dasselbe Element steht in zwei verschiedenen Containern an unterschiedlichen Positionen. Umordnen in A ändert B nicht. Gemeinsamer Inhalt bleibt gemeinsam; Anmerkungen bleiben kontextbezogen.
UX-07 Kapitelgliederung bleibt beim Sortieren erhalten. Direkte Akteninhalte sind von Inhalten ihrer Vorgänge erkennbar unterscheidbar und im passenden Kontext erreichbar. Kapitel eines Vorgangs oder Teilvorgangs erscheinen unter diesem Objekt, auch aus der Akte, und entstehen nicht an der Akte, solange ein anderer Bereich ausgewählt ist.
UX-21 In der Lesesicht ohne eindeutiges Ziel verlangt die Oberfläche zuerst eine Bereichsauswahl. Kapitel- und Inhaltsaktionen verwenden das Bearbeitungsrecht des gewählten Containers. Eine Auswahl eines anderen Objekts wird nicht als Filter mitgenommen; die Auswahl desselben Objekts bleibt bei Neuladen und Rückkehr aus der Unterlage erhalten. Ein neu angelegtes Kapitel ist sofort sichtbar und beim nächsten Eintrag vorausgewählt.
UX-08 Unterstützte Dokumente/Notizen öffnen mit direkt nutzbarer Vorschau beziehungsweise Text als Hauptinhalt. Ein bloßer Formularbildschirm mit externem Öffnen-Button genügt dafür nicht. Für nicht verfügbare/unterstützte Vorschauen gibt es einen erklärten sicheren Öffnungsweg. Entfernen und globales Löschen dominieren die Ansicht nicht.
UX-09 Änderungen bleiben im separat aufrufbaren Protokoll nachvollziehbar; auch viele Aktionen verlängern die normale Inhaltsseite nicht. Fachlicher Verlauf enthält keine mehrfachen technischen Abbilder desselben fachlichen Ereignisses.
UX-10 Aufgabe und Frist lassen sich eindeutig erfassen und zentral wiederfinden. Erledigen der Vorbereitungsaufgabe lässt die unabhängige Frist offen.
UX-11 Leser dürfen die gespeicherte gemeinsame Ordnung nicht verändern. Manipulierte Reorder-IDs und Kontextangaben gewähren keinen Zugriff. Verborgene Titel/Anzahlen fehlen auch in Breadcrumb, Gesamtsicht und Änderungsverlauf. Gleichzeitige Änderungen führen nicht zu stillem Datenverlust.
UX-12 Bestehende Daten, Referenzen und eigene Dateien bleiben nach erforderlichen Migrationen erhalten. Vorhandene Reihenfolgen werden nicht stillschweigend überschrieben.
UX-13 Desktop und schmaler mobiler Bildschirm sind praktisch bedienbar; Reihenfolgeänderung gelingt ohne Drag-and-drop und wesentliche Aktionen per Tastatur. Lade-/Fehlerzustände sind verständlich.
UX-14 Derselbe Vorgang zeigt über Vorgangsliste, Akte und Direktlink denselben Struktur-Breadcrumb, sobald eine Akte als Kontext gewählt ist oder nur eine lesbare Aktenzuordnung besteht. Mehrere Zuordnungen ohne Kontext erfinden keine Hauptakte. Die gesonderte Kontextanzeige bleibt korrekt. Öffnen einer Unterlage, Rückkehr und Neuladen erhalten den geprüften Handlungskontext ohne Erweiterung von Zugriff oder Anmerkungsreichweite.
UX-15 Inhaltsliste, Aufgaben, Verlauf, Änderungsprotokoll und Zuordnungen stehen nicht als parallele Listen untereinander. Menü-/Registerwechsel zeigt genau eine zentrale Ansicht. Rückkehr erhält Auswahl, Filter und Ordnung. Der große Block „Struktur und Zuordnung“ ist entfernt.
UX-16 Ein gefüllter Vorgang zeigt Zeilen mit eindeutigem Typ-Symbol, Titel, fachlichem Datum/„Ohne Datum“, getrennter Typ-/Quellenangabe und Kurzbeschreibung oder vorhandenem Auszug. Miniaturen ergänzen dort, wo sie tatsächlich helfen; fehlende Miniaturen erzeugen keine große Leerbox oder endlose Ladeanzeige. Der große Leser bleibt zugänglich. Keine erfundenen Inhalte oder fest eingebauten Demo-Thumbnails.
UX-17 Mit mindestens acht synthetischen Einträgen sind per tatsächlicher Maus-/Pointer-Interaktion Ziehen nach oben/unten, an Anfang/Ende, Abbruch und bei Bedarf Scrollen nachgewiesen. Einfügelinie und Ergebnis stimmen überein; nach Neuladen bleibt die Ordnung erhalten. Ein Klick auf Pfeilbuttons ersetzt diesen Nachweis nicht.
UX-18 Fehlgeschlagene oder konkurrierende Umordnung wird verständlich behandelt. Leser, Datumsmodus und zusammengesetzte Lesesichten bieten kein wirkungsloses/unzulässiges Drag-and-drop. Tastatur-/Touchalternative ist zusätzlich geprüft.
UX-19 „Alle Inhalte“ einer Akte zeigt direkte und über unmittelbar zugeordnete Vorgänge sichtbare Einträge in einer gemeinsamen Lesesicht mit Herkunft, ohne zusätzlichen leeren Direktblock. Manuelle Ordnung bleibt den einzelnen Containern zugeordnet. Öffnen einer Mehrfacheinbindung verwendet den eindeutig gewählten Kontext.
UX-20 Reale Thumbnails, Textauszüge und Beschreibungen bleiben für unberechtigte Nutzer auch über direkte Abrufe und nach Rechteentzug geschützt. Eine gespeicherte Vorschau umgeht die bestehenden Zugriffsregeln nicht.

Passende vorhandene Tests weiterverwenden. Neue automatisierte Tests vor allem für persistente Ordnung, stabile Datumslogik, Konflikte, Migrationen, Navigations-/Kontexterhalt und Rechtegrenzen abgeleiteter Inhalte ergänzen. Keine Tests nur zum Nachzeichnen von CSS oder statischen Beschriftungen. Betroffene Frontend-/Backend-Prüfungen ausführen und den vollständigen Kernablauf im Browser prüfen. Visualisierung und tatsächliche Bedienung müssen zusätzlich zu technischen Tests beurteilt werden. Ein technisch erfolgreicher Reorder-API-Test weist kein funktionierendes Drag-and-drop nach.

Zur Übergabe aussagekräftige Screenshots der Übersicht, einer gefüllten Akte mit Gliederung, eines Vorgangs mit Vorschauzeilen und einer geöffneten Unterlage liefern, einschließlich einer schmalen Ansicht. Für Drag-and-drop den tatsächlich ausgeführten Ablauf und das Ergebnis vor/nach Neuladen dokumentieren. Dafür synthetische Daten verwenden; keine Zugangsdaten oder vertraulichen Bestandsinhalte in Dokumentation oder Screenshots übernehmen. Geplante, bestandene und nicht ausführbare Prüfungen ausdrücklich unterscheiden. Wird Development bereitgestellt, den ausgelieferten Versions-/Commitstand und den dort tatsächlich geprüften Umfang nennen; ein lokaler Stand ist kein Nachweis des Deploy-Ergebnisses.

14. Arbeitsauftrag und Abschluss

Bei ausdrücklicher Beauftragung der Umsetzung auf Basis dieser Ergänzung gilt:

  1. Bestehenden Stand gezielt prüfen; knapp festhalten, welche Komponenten erhalten und welche angepasst werden.
  2. Den beschriebenen Arbeitsablauf durchgängig umsetzen, einschließlich benötigter Persistenz und Rechteprüfung. Nicht nach einer weiteren Konzept- oder Grundlagenphase aufhören.
  3. Technischen Entwurf nur an den tatsächlich betroffenen Stellen anpassen, falls Schnittstellen oder Speicherung abweichen. Keine zweite vollständige Spezifikation erzeugen.
  4. Technisch und visuell prüfen; erkennbare Bedienprobleme und Regressionen im Auftrag beheben. Routinefragen selbst entscheiden. Nur echte fachliche Widersprüche oder nicht auflösbare Blockaden knapp mit Empfehlung melden und an unabhängigen Teilen weiterarbeiten.
  5. Ergebnis mit betroffenen Dateien, kurzen Start-/Prüfhinweisen, Screenshots, ausgeführten Nachweisen und verbleibenden Einschränkungen übergeben.

Ein Push auf develop löst laut Repository einen Development-Deploy aus. Der reine Dokumentationsauftrag, der diese Ergänzung erstellt, autorisiert weder Implementierung noch Commit, Push, Deployment oder Änderungen an laufenden Systemen. Der spätere Umsetzungsauftrag soll den gewünschten Übergabepunkt ausdrücklich benennen; ohne zusätzliche Angabe bis zur lokal prüfbaren Umsetzung arbeiten und kein Deployment auslösen. Production wird nicht durch diesen UX-Auftrag freigegeben.

15. Fortschreibung

  • 0.9: F-08b/c: Hauptschriftstück und Anlagen ausdrücklich zuordnen; Versand mit Nachweisen und abrufbarem übermitteltem Stand. Redundante Nachweis-E-Mails bewusst kompakt darstellen; Original vollständig bewahren. Klare Kapitelgrenzen/Zähler und durchgehende Chronologie präzisiert. Gemeinsamer Auftrag und Abnahmefälle verlinkt.

  • 0.8: F-08a: verschachtelte Kapitel ohne eigene Rechte. Pfad, Mehrfachauswahl, Umhängen und Auflösen in der bestehenden Navigation und im vorhandenen Export. Teilvorgänge bleiben eigene Objekte.

  • 0.7: F-06f: konsolidierter Auftrag zur Reduktion der Eintrags- und Kopfhöhe; Richtungszeichen als direkte Bedienung und Punkt für Lokal. Bezugsdetails erst bei Bedarf, keine Klammern/Leisten oder zusätzliche Reihenfolgeänderung. Abnahme mit mehreren unabhängigen Zwischenstücken und vergleichbaren Zeilenhöhen.

  • 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.

  • 0.3: Aktueller Nutzerbedarf F-06c: gelieferte Typ-Symbole als verlässliche Orientierung; Miniaturen nur bei erkennbarem Nutzen; Notiz mit Auszug; keine Leerboxen oder ewiges Thumbnail-Laden; große Leseansicht bleibt. Frühere pauschale Thumbnail-Pflicht ersetzt. Kein Fachmodell-/Rechtewechsel.

  • 0.1: Erste lesende Oberflächenprüfung, Ausgangsanforderungen und 13 Abnahmekriterien.

  • 0.2: Zweite Prüfung und Nutzerauftrag zur Übergabe: ausgewählte Vorschauzeilen als Standard; stabile Objektpfade statt einstiegsabhängiger Breadcrumbs; Kontextanzeige separat bei unveränderten Rechteprüfungen; genau eine zentrale Arbeitsfläche; gemeinsame Aktenlesesicht mit Herkunft; echte Vorschauen/Kurzbeschreibungen; Drag-and-drop von optional zu verpflichtend; 20 Abnahmekriterien und konkrete Nachweise. Die weitere Kachelvariante bleibt optional. Diese Fortschreibung ändert ausschließlich die Anforderungsdokumentation.