Ordne Akten und Vorgaenge nach fachlichem Datum oder eigener Reihenfolge und mache den Inhalt zur Arbeitsansicht.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
1 parent
27925093e2
commit
52bda91aad
22 files changed
+2079
-258
No files matched your search
@@ -216,6 +216,8 @@ Gemeinsame Spalten der fachlichen Ankerobjekte `cases`, `matters`, `elements`, `
|
||||
|
||||
Auth-Tabellen `auth_accounts` und `auth_sessions` folgen dem Auth-Blueprint. Ein Anzeigename ist kein Identitätsbeweis.
|
||||
|
||||
Akten und Vorgänge speichern `content_order` (`date` oder `position`) und `content_order_dir` (`asc` oder `desc`). Bestehende Zeilen bleiben auf `position`, damit eine schon gesetzte Einbindungsreihenfolge nicht ersetzt wird. Neue Akten und Vorgänge beginnen mit fachlichem Datum aufsteigend. `bindings.position` gehört zur Einbindung. Die Datumssortierung schreibt sie nicht um. `PATCH /api/v1/cases/{id}/content-order` und `POST /api/v1/cases/{id}/bindings/order` sowie die gleichen Pfade unter `matters` prüfen das Bearbeitungsrecht im Handlungskontext und `expected_version`. Der fachliche Verlauf liest die Datumsfelder der sichtbaren Unterlagen einmal je Element. Das Änderungsprotokoll bleibt `GET .../chronology`, seitenweise über `cursor`.
|
||||
|
||||
### 4.3 Überblick
|
||||
|
||||
```mermaid
|
||||
|
||||
@@ -1,8 +1,10 @@
|
||||
# Tsumugu – Fachliche Produktspezifikation
|
||||
|
||||
**Stand:** 16.10.2026 · **Arbeitsstand:** 0.25, erster fachlicher Lieferumfang bestätigt.
|
||||
**Stand:** 17.10.2026 · **Arbeitsstand:** 0.26, UX-/Ordnungsbedarf der ersten Lieferung ergänzt.
|
||||
**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.
|
||||
|
||||
Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das nächste Interview. Sie nimmt keine offenen Produktentscheidungen vorweg. Datenmodell, konkrete Workflows, MVP-Abnahmebedingungen und Implementierungsaufträge werden nach den jeweiligen Entscheidungen hier ergänzt. Anwendungscode, Datenbanken und Deployments sind nicht Gegenstand dieser Etappe.
|
||||
|
||||
## 1. Quellen und Verbindlichkeit
|
||||
@@ -342,6 +344,14 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
|
||||
|
||||
**Auswirkungen:** Technische Pakete für Nachverfolgung und Übersichten dürfen nicht auf Finanzfunktionen oder virtuelle Zusammenstellungen warten müssen. Die für echte personenbezogene Daten erforderlichen Schutz-, Release- und Recovery-Verträge gehören zum ersten realen Betrieb und werden nicht bis zum Finanzausbau aufgeschoben. Noch offene Rechte-/Ownership-/Löschregeln bleiben ausdrücklich offen. Es wurde mit dieser Entscheidung noch kein Implementierungsauftrag erteilt.
|
||||
|
||||
### F-06a – Orientierung, fachliche Aktenordnung und Änderungsprotokoll: Bedarf präzisiert am 17.10.2026
|
||||
|
||||
**Ausdrücklicher Nutzerbedarf:** Die aktuelle Anwendung ist optisch verwirrend und unpraktisch; Hierarchien sind nicht erkennbar. Lange Protokolle jeder Aktion überladen das Objekt. Das Änderungsprotokoll bleibt für die Nachvollziehbarkeit der Änderungsreihenfolge sinnvoll, kann aber separat über ein Menü erreichbar sein. Elemente benötigen nutzbare fachliche Datumsangaben und/oder alternative Sortierschlüssel. Die innere Reihenfolge einer Akte ist selbst ein wesentlicher fachlicher Informationsträger.
|
||||
|
||||
**Auswirkungen auf den MVP:** Fachliche Inhaltsordnung, fachlicher Verlauf und technische Änderungshistorie getrennt behandeln. Hierarchie und aktueller Kontext erkennbar machen. Eigenständige Vorgänge und die bestätigte Mehrfachzuordnung bleiben gemäß S-01b erhalten. Ein reiner optischer Austausch ohne Verbesserung der Arbeitsabläufe genügt nicht.
|
||||
|
||||
**Empfohlene konkrete Ausgestaltung:** Klickbare Breadcrumbs und sichtbare Gliederung, gespeicherte Datumssortierung beziehungsweise eigene Reihenfolge je Container, kompakte Inhaltslisten, unmittelbar lesbare Unterlagen, zentral erreichbare Aufgaben/Fristen und separat aufrufbares Änderungsprotokoll. Umfang, Sortierregeln, Datenschutzgrenzen, Abnahmekriterien und der Rahmen eines späteren Coding-Auftrags stehen in [TSUMUGU_UX_MVP_ERGAENZUNG.md](TSUMUGU_UX_MVP_ERGAENZUNG.md). Diese Details werden als aktuelle Umsetzungsempfehlungen ausgewiesen, nicht als frühere Nutzerbeschlüsse. Keine Änderung der Rechte-/Ownership-/Löschregeln und keine Ausweitung auf die zurückgestellten Finanz- oder Synchronisationsfunktionen.
|
||||
|
||||
## 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.
|
||||
@@ -394,4 +404,6 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
|
||||
|
||||
16.10.2026, Arbeitsstand 0.25: F-05a bestätigt: erste nutzbare Lieferung „Organisieren und Nachverfolgen“, Finanzfunktionen und bidirektionale Paperless-Synchronisation anschließend. Ersten fachlichen Abnahmeablauf und Auswirkungen auf die technische Lieferstaffelung festgehalten. Technische Spec 0.3 wird daran angeglichen; keine Implementierung.
|
||||
|
||||
17.10.2026, Arbeitsstand 0.26: Nutzerbedarf F-06a nach der lesenden Prüfung der bestehenden Development-Oberfläche aufgenommen. Ergänzung `TSUMUGU_UX_MVP_ERGAENZUNG.md` als Referenz für den gewünschten Coding-Auftrag erstellt: Orientierung, fachliche Daten und kontextbezogene Ordnung, Arbeitsansichten, zurückgenommenes Änderungsprotokoll und prüfbare Abnahme. Konkrete UX-Ausgestaltung als Umsetzungsempfehlung von ausdrücklichen Nutzeranforderungen getrennt. Keine Änderungen an Anwendungscode, Datenbanken oder Deployments.
|
||||
|
||||
Nach jeder Entscheidung diese Datei mit kurzer Begründung und Auswirkungen auf Fachmodell/MVP aktualisieren. Die historische Baseline bleibt unverändert. Keine Implementierung ohne ausdrückliche Freigabe; technische Umsetzung später anhand der dann freigegebenen Jinkendo-Blueprints.
|
||||
@@ -0,0 +1,226 @@
|
||||
# Tsumugu – Ergänzung zur Bedienung, Orientierung und Aktenordnung im MVP
|
||||
|
||||
**Stand:** 17.10.2026 · **Fassung:** 0.1
|
||||
**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).
|
||||
|
||||
## 1. Ziel und Verbindlichkeit
|
||||
|
||||
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:** Navigation, Seitenaufbau, zwei Ordnungsarten, Datumsdarstellung und Interaktionsregeln werden nachfolgend als pragmatische Umsetzungsvorgaben beschrieben. Sie sind Empfehlungen aus der aktuellen UX-Prüfung und keine rückwirkend behaupteten früheren Produktbeschlüsse. Der Umsetzungsauftrag, der auf diese Datei verweist, legt sie als Arbeitsgrundlage zugrunde. 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
|
||||
|
||||
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.
|
||||
|
||||
## 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 ö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 Breadcrumb-Pfad mit sichtbaren, berechtigt zugänglichen Stationen, anschließend Titel, Status und verständliche Objektart.
|
||||
- Beispiel eines Zugangswegs: „Akten → Vermietung → Wohnung Jakisch → Nebenkosten 2025“. Der Pfad stellt den tatsächlich verwendeten Weg dar; er erfindet keine verpflichtende Hauptakte.
|
||||
- Bei mehreren Aktenzuordnungen bleibt erkennbar, über welchen Weg der Vorgang geöffnet wurde. Weitere lesbare Zuordnungen sind separat erreichbar. Ein Wechsel verwendet den dafür serverseitig geprüften Handlungskontext.
|
||||
- Ein direkter Einstieg in einen eigenständigen Vorgang funktioniert ohne erfundene Elternakte. Breadcrumbs dürfen keine unbekannten oder unberechtigten Herkunftsnamen offenlegen.
|
||||
- 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. Sie erhalten weder eigene Rechte noch einen eigenen Bearbeitungsstatus.
|
||||
|
||||
Breadcrumbs lösen die Navigation. Für die Gliederung innerhalb des aktuellen Objekts braucht es zusätzlich sichtbare Abschnitte, Einrückung oder eine kompakte ausklappbare Strukturübersicht. 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.
|
||||
|
||||
Der Arbeitsbereich stellt Unterlagen und Notizen in den Mittelpunkt. Aufgaben und Fristen erscheinen kompakt daneben oder unmittelbar anschließend. Struktur, Zuordnungen und Verlauf sind über klar beschriftete Bereiche oder Register zugänglich. Die genaue Aufteilung darf der Agent passend zum vorhandenen Frontend gestalten; die Prioritäten gelten unabhängig von der gewählten Komponente.
|
||||
|
||||
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 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.
|
||||
|
||||
Für den MVP genügt eine klar benannte Umschaltung oder ein ergänzender Abschnitt mit Zugriff auf diese Inhalte. Eine rekursive Gesamtsicht über beliebig tiefe Hierarchien ist nicht erforderlich. Die eigene Reihenfolge gilt für die direkten Einträge des jeweiligen Containers. Eine ergänzende Gesamtsicht ist eine abgeleitete Lesesicht und erzeugt weder neue Einbindungen noch eine konkurrierende Aktenordnung. Bei Mehrfachvorkommen bleibt der Herkunftskontext eindeutig.
|
||||
|
||||
## 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 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.
|
||||
- Verschieben ist nur im Modus „Eigene Reihenfolge“ aktiv. Es funktioniert über verständliche Bedienelemente, etwa „Nach oben“/„Nach unten“; Drag-and-drop kann ergänzen. Tastatur und Touch müssen ohne Drag-and-drop auskommen.
|
||||
- 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. |
|
||||
|
||||
Das Änderungsprotokoll wird über das Objektmenü, ein Register oder einen standardmäßig geschlossenen Bereich geöffnet. Es 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. 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.
|
||||
- „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.
|
||||
|
||||
„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.
|
||||
- Inhalte als kompakte Listen oder Tabellen mit ausgerichtetem Datum, Titel, Typ und wenigen relevanten Kennzeichen. 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: Inhalte und aktueller Handlungsbedarf ohne Durchscrollen leerer Strukturabschnitte erreichbar. Kleinere Displays: Struktur, Liste und Vorschau sinnvoll nacheinander; 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](TECHNICAL_SPEC_HANDOFF.md) 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.
|
||||
|
||||
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 | Akte → Unterakte → Vorgang und Vorgang → Teilvorgang sind anhand von Breadcrumb und sichtbarer Gliederung verständlich. Direktlinks und mehrere lesbare Zuordnungen funktionieren ohne Offenlegung verborgener 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. |
|
||||
| UX-08 | Dokument/Notiz öffnet mit nutzbarem Inhalt beziehungsweise klarem sicheren Öffnungsweg. Entfernen und globales Löschen dominieren diese 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. |
|
||||
|
||||
Passende vorhandene Tests weiterverwenden. Neue automatisierte Tests vor allem für persistente Ordnung, stabile Datumslogik, Konflikte, Migrationen und Rechte-/Kontextgrenzen 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.
|
||||
|
||||
Zur Übergabe aussagekräftige Screenshots der Übersicht, eines gefüllten Vorgangs und einer geöffneten Unterlage liefern, einschließlich einer schmalen Ansicht. 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.
|
||||
|
||||
## 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.
|
||||
Reference in new issue
Block a user