14 KiB
Tsumugu: Kommunikationsrichtung – Spezifikation und Cursor-Auftrag
Stand: 17.10.2026 · Fassung: 1.2 · Umfang: Kommunikationsrichtung im bestehenden MVP.
Vorrangige aktuelle Darstellung: Kompakte Inhaltsliste, Auftrag 1.0. 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.
Ziel und Einordnung
Beim Lesen eines Vorgangs muss unmittelbar erkennbar sein, welche Kommunikation eingegangen und welche ausgegangen ist. Eine Notiz bezeichnet eine Gesprächs-/Gedankenaufzeichnung, ein PDF ein Dateiformat und Paperless eine Quelle. Diese Merkmale sind unabhängig von der Kommunikationsrichtung.
Dieser Auftrag präzisiert F-06e der Produktspezifikation. Er ergänzt den Symbolauftrag und die vorhandenen Beziehungen/Schriftwechsel aus F-06d. Bestehende Antworten-/Bezugsverknüpfungen, Kapitel, Reihenfolge und große Leseransicht bleiben erhalten. Die bisherige pauschale Ableitung „Zugangsdatum = Eingang, Versanddatum = Ausgang“ ist durch die folgenden Regeln ersetzt.
1. Darstellung
- Reihenfolge am Anfang jeder Inhaltszeile: feste Richtungsspalte, danach Inhaltstyp-Symbol, danach Titel/Text. Das Richtungssignal darf nicht weiter als winziger Pfeil im Metadatentext stehen. Ein Drag-Griff darf die fachliche Richtungsspalte nicht ersetzen; Sortierbedienung gesondert anordnen.
- Eingang: gefülltes Dreieck zeigt nach rechts, hinein in die Zeile. Ausgang: gefülltes Dreieck zeigt nach links, heraus aus der Zeile. Einheitlich horizontale Richtung, keine Diagonalpfeile. Dunkelgrün auf hellen Flächen bzw. Mint auf dunklen Flächen, keine reduzierte Deckkraft.
- Richtungsspalte ungefähr 36px breit, Dreieck als SVG 28px am Desktop und mindestens 24px am Handy. Auf Höhe des Typsymbols/Titelanfangs ausrichten. Das tatsächliche gefüllte Motiv muss deutlich sichtbar sein; nicht durch innenliegende große Leerflächen oder zusätzliche Verkleinerung abschwächen. Sichtbarer Text „Eingang“ bzw. „Ausgang“ bleibt in den Metadaten. Keine künstliche Dopplung weiterer kleiner Richtungspfeile daneben.
- Ohne bekannte Richtung kein Dreieck, aber dieselbe Spaltenbreite: Typ-Symbole und Titel bleiben in allen Zeilen bündig. Keine Attrappe für „intern“ oder „unbekannt“ ergänzen. Keine eigene kombinierte Bilddatei für jede Kombination aus Format und Richtung.
- Notizsymbol wirklich ersetzen: in beiden Farbvarianten und allen tatsächlich genutzten Formaten die gelieferte runde Sprechblase mit Stift übernehmen. Weder Blattumriss noch Haftnotiz weiterverwenden. Das PDF bleibt eine Dokumentform; unbekannter Dateityp darf ein generisches Dateisymbol behalten. Paperless nicht pauschal als PDF ausgeben.
- Bekannte Beteiligte als „Von: …“ beziehungsweise „An: …“ anzeigen. Keine Person erfinden, wenn nur die Richtung bekannt ist. Bei Bedarf sind beide Angaben in den Details sichtbar.
- Kommunikationsdatum verständlich benennen, etwa „Eingegangen am“ bzw. „Versendet am“. Dokumentdatum, Zugangsdatum, Versanddatum und Import-/Änderungszeitpunkt nicht gleichsetzen. Bestehende fachliche Sortierung und manuelle Reihenfolge nicht stillschweigend verändern.
- Beispiel einer Zeile:
PDF · [Richtungszeichen] Eingang · Von: Hausverwaltung Müller · Eingegangen am 12.10.2026, darunter Titel und kurzer Auszug. Bei Ausgang entsprechend Empfänger und Versanddatum. - In Liste, Leser und vorhandenem Schriftwechsel dieselbe Richtungslogik verwenden. In schmalen Ansichten darf die Metadatenzeile umbrechen; Titel, Typ und Richtung bleiben lesbar. Kein zusätzlicher Navigationsbereich.
- Form und Text vermitteln die Bedeutung; Farbe kann ergänzen. Keine nur per Hover verfügbare Kennzeichnung. Dekorative Bilddatei neben dem Text mit leerem Alttext einbinden. Pfeile nicht als unbeschriftete Aktionstasten darstellen.
2. Bedeutung und einfache Eingabe
Richtung ist optional. Minimaler fachlicher Zustand:
| Angabe | Bedeutung | Listenanzeige |
|---|---|---|
| Eingang | Kommunikation an die im Vorgang vertretene Seite | Zeichen + „Eingang“ |
| Ausgang | Kommunikation von der im Vorgang vertretenen Seite | Zeichen + „Ausgang“ |
| Keine Richtungsangabe | Keine Kommunikation oder Richtung noch unbekannt | Kein Richtungssignal |
Im Bearbeiten-Dialog reicht eine Auswahl „Keine Angabe / Eingang / Ausgang“. Leer ist weder automatisch „intern“ noch „eingegangen“. Kein zusätzliches Pflichtfeld und keine neue Statusmaschine. Das Entfernen einer zuvor gesetzten Richtung muss speicherbar sein und darf anschließend nicht durch einen Fallback sofort zurückgesetzt werden.
- Gesprächsnotiz über einen eingehenden Anruf: Notizsymbol + Eingang. Selbst initiierter Anruf: Notizsymbol + Ausgang. Gedankenprotokoll oder Gespräch ohne sinnvolle Richtung: Notizsymbol ohne Richtungszeichen. Keine neue Notiz-Untertypenverwaltung erforderlich.
- Eine Richtung ist keine Versandbestätigung: Die Auswahl versendet keine Nachricht, setzt keine Frist und erledigt keine Aufgabe. Ein Entwurf darf nicht ohne bestätigten Versand als tatsächlich versendet erscheinen.
3. Bezugsseite und Mehrfacheinbindung
- Eingang/Ausgang bezieht sich auf die Person oder Organisation, deren Kommunikation im aktiven Vorgang dokumentiert wird. Die Richtung darf bei Benutzerwechsel oder späterem Anwaltszugang nicht umspringen.
- Vorhandene geeignete Angaben zur vertretenen Seite nutzen. Wo diese nicht eindeutig ist, Richtung bewusst manuell erfassen; keine automatische Vermutung aus Login, Eigentümer, Anleger oder Importeur. Für diesen Ausbau kein neues Kontakt-/Parteienregister bauen.
- Bei Einbindung desselben Elements in unterschiedliche Kontexte darf eine dort abweichende Bezugsseite nicht zu einer global falschen Richtungsänderung führen. Dafür vorhandene Einbindungs-/Kontextmetadaten nutzen oder minimal ergänzen. Der Datei-/Notizinhalt bleibt gemeinsam. Eine lokale Zuordnung oder Korrektur darf keine fremde Einbindung überschreiben oder deren Daten offenlegen.
- Gleiche Bezugsseite und unveränderte Kommunikationsdaten konsistent anzeigen. Keine neue Kopie der Datei zur bloßen Richtungsänderung anlegen. Konkrete Speicherung anhand des vorhandenen Modells dokumentieren; keine zusätzliche generische Kommunikationsplattform entwickeln.
4. Quellen, Bestandsdaten und Korrekturen
- Belastbare explizite Quellinformation darf die Richtung vorbelegen, beispielsweise eine beim Übernehmen gesicherte E-Mail-Richtung. Bloße Ordnernamen, Paperless als Quelle, PDF als Format, Titel, Importzeit oder Ersteller sind kein hinreichender Nachweis.
- Ein Versand- oder Zugangsdatum allein ist ohne eindeutige Bezugsseite kein allgemeiner Richtungsbeweis. Ein Schreiben hat häufig beide Daten. Daraus nicht gleichzeitig „Eingang · Ausgang“ als Richtung desselben Eintrags ableiten. Beide Daten bleiben als unterschiedliche Sachangaben erhalten.
- Vorhandene eindeutige Richtungsangaben erhalten. Unklare Bestandsdaten leer lassen; keine Massenklassifizierung nach Vermutung. Bei Widersprüchen keine zufällige Vorrangentscheidung treffen: Richtung als ungeklärt behandeln und eine gezielte Korrektur ermöglichen, Daten nicht löschen.
- Manuelle Korrektur und bewusstes Leeren müssen Vorrang vor einer automatischen Vorbelegung behalten. Hierfür die kleinste geeignete Kennzeichnung im bestehenden Datenmodell verwenden. Kein Hintergrundimport darf die Korrektur still überschreiben.
- Lese- und Änderungsrechte des aktiven Kontexts gelten unverändert auch für Richtung und Beteiligte. Ein lesender Anwalt sieht dieselben freigegebenen Angaben; er erhält daraus keine neuen Rechte.
5. Fertige Zeichen verwenden
Symbolpaket 1.3, weiterhin unter:
C:/Dev/jinkendo-app-design-2026-10-17/assets/content-symbols-v1/
light/communication-in.svg,light/communication-out.svg: dunkelgrün für helle Arbeitsflächen.dark/communication-in.svg,dark/communication-out.svg: mintfarben für dunkle Flächen.- Entsprechende PNGs unter
<theme>/png/24,48,96. - Gefüllte, bereits gedrehte Dreiecke verwenden:
communication-in.svgrechts,communication-out.svglinks. Größe/Position nach Abschnitt 1, keine 16–18px-Konturpfeile mehr. Die Originalkontur stammt aus Lucidetriangle, gedreht und gefüllt; Lizenz übernehmen. Keine Unicode-Zeichen, Emoji-Pfeile oder frei gezeichneten Ersatzsymbole. Das geliefertenote.svgzeigt die Sprechblase mit Stift. - Dateien tatsächlich in das ausgelieferte App-Assetverzeichnis übernehmen. Paketpfad allein im Auftrag oder identische Dateinamen sind kein Nachweis. Quelle und App-Kopie per Hash/Inhalt vergleichen, bei Notiz und beiden Richtungszeichen je
light/dark. Cache-Aktualisierung durch passende Versions-/Hash-URLs oder vorhandene Buildstrategie sicherstellen. Ein Nutzer soll die Korrektur nach normalem Neuladen sehen, ohne Browserdaten löschen zu müssen.
Keine neue Bibliothek installieren. Das Richtungszeichen ergänzt Typ und Quelle; ein PDF aus Paperless behält sein PDF-Symbol und seine Quellenangabe.
6. Gezielter Umsetzungseinstieg
Vor Änderungen den aktuellen Stand prüfen und laufende Änderungen erhalten. Bei Erstellung dieses Auftrags waren bereits content.jsx, ReadingPane.jsx, Sources.jsx, API-Schemas und Korrespondenzdaten vorhanden. Wiederverwenden, keine zweite parallele Richtungslogik aufbauen.
Insbesondere prüfen/korrigieren. Die folgenden fachlichen Einstiegspunkte stammen aus Fassung 1.0; inzwischen vorhandene korrekte Umsetzung erhalten:
-
DirectionMarkrendert derzeit 16px-Konturpfeile. Auf führende Dreiecksspalte umstellen und in allen tatsächlich verwendeten Zeilen/Leserstellen prüfen. -
Tatsächlichen Inhalt von
frontend/public/ui/content-symbols-v1/light/note.svgunddark/note.svgmit den gelieferten Quellen vergleichen und ersetzen. Das beobachtete Problem ist keine bloße falsche Typbezeichnung: Die sichtbare Notiz lädt bereits den Pfadnote.svg, dessen App-Datei aber einen Blattumriss enthält. -
mailFactsinfrontend/src/pages/content.jsxverwendet bisher für jede Richtung außeroutden Text „Eingang“. Fehlend/ungültig muss ohne Richtung bleiben. -
dateFlowleitet bisher aussent_on/received_onRichtungsangaben ab und zeigt bei beiden „Eingang · Ausgang“. Durch die fachlich eindeutige Logik ersetzen; Datumsfelder erhalten. -
Entsprechende Standardannahmen in E-Mail-Vorschau und Leser (
Sources.jsx,ReadingPane.jsx) angleichen. -
Vorhandene API-/Persistenzfelder gezielt ergänzen, soweit für explizite Richtung, Korrekturen und Kontextbezug erforderlich. Rückwärtskompatible Migration; keine destruktive Umdeutung der Bestandsdaten. Relevante technische Dokumentation anpassen.
7. Abnahme
Mit synthetischen Daten prüfen und konkrete Ergebnisse liefern:
- Eingehendes PDF und ausgehendes PDF: gleicher Inhaltstyp, klar unterschiedliche Richtung, richtige Beteiligte/Datumsbezeichnung.
- Eingehende und ausgehende E-Mail: konsistent in Liste, Leser und Schriftwechsel; unbekannte Richtung wird nicht als Eingang angezeigt.
- Telefonnotiz mit Eingang, Telefonnotiz mit Ausgang und Gedankenprotokoll ohne Richtung: Notizsymbol bleibt immer eindeutig erhalten.
- Paperless-Referenz ohne Richtungsnachweis sowie Schreiben mit beiden Datumsfeldern: keine erfundene oder doppelte Richtung.
- Richtung ändern und leeren, neu laden und erneut öffnen: Änderung bleibt erhalten; automatische Vorbelegung stellt den alten Wert nicht wieder her.
- Benutzerwechsel bei gleichem Kontext ändert die Richtung nicht. Zweite Einbindung mit anderer Bezugsseite wird nicht durch die erste Korrektur überschrieben. Keine Einsicht in fremde Kontexte.
- Leserecht allein erlaubt keine Änderung der Kommunikationsangaben. Vorhandene Antwortbezüge, Ordnung und Dokumentöffnung funktionieren weiter.
- Desktop und Handy, lange Namen/Titel und Bedienung per Tastatur prüfen. Relevante fachliche Tests für Speicherung/Zuordnung/Rechte und vorhandenen Frontend-Build ausführen. Screenshots der synthetischen Beispiele liefern; ausgeführte und nicht ausführbare Prüfungen trennen.
- Führende Dreiecke bei normalem Zoom prüfen: Eingang zeigt rechts hinein, Ausgang links heraus. Beide ohne Hover gut erkennbar. Eine dritte Zeile ohne Richtung hält dieselbe Ausrichtung. Dreieck ist weder Button noch Aufklappsteuerung; Kennzeichnung mit sichtbarem Text und zugänglichem Namen konsistent.
- Echte Notiz und Datei/PDF nebeneinander ansehen: Sprechblase mit Stift gegenüber Blatt, sofort unterscheidbare Silhouetten. Geladene tatsächliche Asset-URLs und deren Inhalt prüfen; gleichnamige alte Dateien oder ein lediglich erfolgreicher Build reichen nicht als Erfüllung. Screenshots beider Inhaltstypen und Richtungen am Desktop und Handy mitliefern.
Arbeite bis zur lokal prüfbaren Umsetzung. Keine erneute Spezifikationsrunde als Endergebnis. Kein Commit, Push oder Deployment durch diesen Auftrag; ein Push auf develop würde Development auslösen. Ergebnisse, betroffene Dateien, Prüfungen und tatsächliche Einschränkungen knapp übergeben. Es wird keine erfolgreiche Live-Integration durch das bloße Vorhandensein der Dateien behauptet.