/documents/mindmap/:id — Mindmap

Wofür

Hinweis: Rahmen: 00-rahmen.md. Code: packages/plugins/src/documents/client/Mindmapschirm.tsx (der Schirm), mindmap/Mindmapeditor.tsx (Leiste, Tasten, Verlauf), mindmap/Leinwand.tsx (Knoten, Linien, Schieben und Zoomen), mindmap/Knotenfeld.tsx (Farbe, Notiz, Verweis, Lernkarte), mindmap/useMindmapSicherung.ts, mindmap/farben.ts, mindmapanfragen.ts; Anordnung und Prüfung in packages/plugins/src/documents/shared/mindmap.ts, Server in server/mindmap.ts und server/mindmapRouten.ts.

Eine Mindmap ist ein eigener Dokumenttyp neben der Seite (NB-261019-mindmap-als): ein Baum aus Knoten mit einer Wurzel, die zugleich der Titel ist. Man denkt darin laut, ordnet Gedanken in Äste und macht aus einem Knoten eine Lernkarte. Sie hängt im Seitenbaum wie jede Seite, wird freigegeben wie jede Seite und speichert von selbst.

Weg und Rahmen


Route	`/documents/mindmap/:id`; die Kennung ist die des Dokuments. Eben angelegt kommt `{ neu: true }` im Zustand der Navigation mit und öffnet die Wurzel im Schreibfeld, einmal; ein Neuladen öffnet nichts
Merkmal	wie `/documents`
Knoten im Rechtebaum	`gold.documents`
Zimmer	das von `/documents`, mit dem Seitenbaum links wie bei jeder Seite; die Mindmap selbst trägt kein Zimmer
Zugang	„Neue Mindmap“ neben „Neue Seite“ in `/documents`; „Mindmap“ unter „Neu“ im Kopf (`/documents?a=mindmap&neu`); ein Eintrag im Seitenbaum. Zurück führt „Dokumente“ über dem Titel, daneben die Seiten, unter denen die Mindmap hängt

Was man sieht

Oben der Weg („Dokumente“ und die Seiten darüber), der Titel als Überschrift (die Wurzel; leer „Ohne Titel“) und die Leiste: die Anordnung als Segment „Mindmap“, „Nach rechts“, „Gliederung“; mit Schreibrecht „Kind“, „Daneben“ und „Löschen“ (am Telefon mit Wort, am Desktop nur das Zeichen); dann Ein- und Ausklappen, Rückgängig, Wiederholen, Verkleinern, Vergrößern und Einpassen. Rechts der Speicherstand („Gleich gesichert“, „Gesichert 11:32“, bei Fehler rot); am Telefon steht davon nur das Zeichen, vorgelesen wird der Satz weiter. Ohne Schreibrecht steht unter der Leiste „Dir zum Lesen freigegeben.“ oder „Im Papierkorb — nur zum Lesen.“

Die Leinwand liegt auf einer Fläche und zeigt die Knoten als Knöpfe, verbunden mit weichen Linien. Die Wurzel ist gefüllt in der Akzentfarbe; jeder Hauptast trägt eine Farbe aus der Palette der Seitensymbole (blau, grün, orange, rot, violett …), die seine Kinder und Linien übernehmen. Ein Knoten mit Notiz zeigt ¶, einer mit Verweis das Zeichen seitenverweis. Ein eingeklappter Ast trägt „+N“ mit der Zahl darunter.

Mindmap: die Äste links und rechts um die Wurzel.
Nach rechts: alles von der Wurzel nach rechts.
Gliederung: eine eingerückte Liste mit Linien, die man rollt.

Beim Öffnen und nach jedem Wechsel der Anordnung passt sich die Karte ein: Sie verkleinert, bis sie passt, am Desktop nie unter 70 Prozent (darunter wäre die Schrift unlesbar), mit dem Finger gar nicht, damit jeder Knoten 44 Pixel Tippfläche behält. Was nicht passt, steht um die Wurzel (Mindmap) oder oben links und wird geschoben.

Rechts daneben (am Telefon darunter) das Feld zum gewählten Knoten: bei einem Hauptast „Farbe des Asts“, dann „Notiz“, „Verweis auf eine Seite“ mit Suche (bis acht Treffer) oder der verknüpften Seite mit „Verweis lösen“, und für den Besitzer „Als Lernkarte“ bzw. „Karte nachführen“ mit dem Satz „Vorn der Knoten, hinten seine Kinder — ohne Kinder seine Notiz.“ Ohne Schreibrecht steht dort nur, was es gibt, ohne Feld.

Laden und Fehler: Beim Laden ein Gerüst mit „Die Mindmap wird geladen.“; lässt sie sich nicht öffnen: „Diese Mindmap lässt sich nicht öffnen — es gibt sie nicht, oder sie ist dir nicht freigegeben.“ mit „Zu den Dokumenten“.

Was man tun kann

Wählen mit Klick oder Tippen, mit den Pfeiltasten zum Nachbarn in der Richtung.
Anlegen: Tab legt ein Kind an, Enter einen Knoten daneben; beide öffnen gleich das Schreibfeld. Im Schreibfeld beendet Enter oder Escape, Tab beendet und legt ein Kind an. Ein frischer Knoten, der leer verlassen wird, verschwindet wieder.
Schreiben: F2 oder Doppelklick öffnet den Text mit dem Zeiger am Ende; ein getipptes Zeichen beginnt neu und ersetzt ihn. Der Text der Wurzel ist der Titel der Mindmap (bis 255 Zeichen, ein Knoten bis 2000).
Löschen mit Entf oder Rücktaste, samt Ast; die Wurzel bleibt.
Umordnen: Alt+Pfeil hoch oder runter verschiebt unter Geschwistern; mit der Maus einen Knoten auf einen anderen ziehen hängt ihn um. Mit dem Finger schiebt Ziehen die Leinwand.
Klappen mit der Leertaste, dem Knopf in der Leiste oder dem Knopf am Ast.
Rückgängig und Wiederholen mit Strg+Z und Strg+Umschalt+Z; Anlegen, Text und Ende sind ein Schritt.
Ansicht: Mausrad oder Strg+Plus/Minus zoomt, Strg+0 passt ein; Ziehen auf leerer Fläche schiebt.
Farbe, Notiz, Verweis im Feld daneben; ein Verweis öffnet seine Seite.
Als Lernkarte: sichert zuerst, dann entsteht aus dem Knoten eine Karte; „Karte nachführen“ schreibt sie neu.
Anordnung wechseln — sie wird mit der Mindmap gespeichert.

Woher die Daten kommen

POST /api/documents/mindmap/create legt Kopf und Wurzel an (Titel „Neue Mindmap“ aus der Übersicht), …/get liest Kopf, Anordnung, Knoten und die Titel der verknüpften Seiten, …/save schreibt den ganzen Baum samt Anordnung, …/karte macht aus einem Knoten eine Lernkarte.
Gespeichert wird gebündelt 700 Millisekunden nach der letzten Änderung, immer der ganze Baum (bis 2000 Knoten); der Server prüft ihn (pruefeBaum: eine Wurzel, keine Schleife, Grenzen der Texte, Farben nur am Hauptast).
Die Rechte stehen in der Datenbank (Migration 371): personal.mindmap_lesbar und personal.mindmap_schreibbar aus den Freigaben des Kopfes; nicht lesbar ist 404, nur lesbar 403.
Der Seitenbaum links und der Weg oben kommen aus dem Arbeitsplatz der Dokumente (useDocumentTree).

Was fehlt

Im Seitenbaum gibt es noch keinen Eintrag „Unterseite als Mindmap“ am Plus einer Zeile.
Zwei Finger zoomen am Telefon nicht; dort helfen nur die Knöpfe.
Am Telefon beginnt die Leinwand weit unten (Weg, Titel und drei Zeilen Leiste darüber); beim ersten Blick steht die Wurzel am unteren Rand.
Die Gliederung lässt sich mit der Tastatur nicht zum nächsten sichtbaren Knoten rollen, wenn er außerhalb liegt.
Kein Export als Bild, PDF oder Gliederungstext.
Kein Einfügen einer eingerückten Liste als Ast.
Keine Suche in den Knoten.
Kein gemeinsames Bearbeiten in Echtzeit; zwei gleichzeitige Schreiber überschreiben einander.
Die Karte aus einem Knoten folgt späteren Änderungen nur über „Karte nachführen“.