Files
Projektwissen/werkzeuge/vorschau/README.md
T
DanielandClaude Opus 5.5 31131cc5c3 Prozessbibliothek als eigenes Repository auslagern (#9)
- ADR 0004 ersetzt ADR 0003: Die Prozessmodelle liegen im Repository
  AG_Prozesse/Prozessbibliothek, geklont nach Prozessbibliothek/ (neuer
  Eintrag in workspace.toml, .gitignore). prozesse/ ist entfernt; das
  Ablageformat (Ordner je Prozess, drei Dateien, Status) bleibt.
- pruefe_prozesse.py prüft den Klon (Ort über setup_workspace.repos_root),
  lässt Punkt-Ordner wie .git aus und erlaubt in der Wurzel nur die
  Repo-Dateien. Fehlt der Klon, gibt es einen Hinweis statt eines Befunds;
  pytest warnt dann.
- einlesen.py sucht den Bestand in der Bibliothek und nennt Treffer als
  Prozessbibliothek/<name>/, auch wenn der Klon woanders liegt.
- Regeln aus prozesse/README.md nach docs/leitfaden/08_prozessbibliothek.md,
  inklusive Ablauf bei Konverteränderungen (zwei Pull Requests).
- Verweise in AGENTS.md, README, Skills, Leitfäden, Vorlagen, Fallstricken
  und STATUS nachgezogen.
- Tests: python -m pytest -q -> 88 bestanden, 1 xfail (#8), 1 Warnung
  (Bibliothek noch nicht geklont).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 09:40:52 +02:00

2.6 KiB

BPMN-Vorschau

Zeigt eine .bpmn-Datei als Diagramm im Browser — offline, ohne PICTURE, ohne dass die Datei den Rechner verlässt. Grundlage ist bpmn-js, die Bibliothek hinter bpmn.io, lokal eingebettet.

Benutzen

Mit Python (aus dem Workspace-Root) — öffnet die Vorschau direkt im Browser, auch für einen Entwurf:

python scripts/vorschau.py Prozessbibliothek/antrag-pruefen/antrag-pruefen.bpmn
python scripts/vorschau.py entwuerfe/antrag-pruefen.md      # .md wird vorher umgewandelt

Ohne Python: werkzeuge/vorschau/vorschau.html im Browser öffnen (Doppelklick) und eine .bpmn hineinziehen oder über „Datei öffnen …“ wählen. Das funktioniert auch mit einer aus Gitea heruntergeladenen Datei.

Mausrad zoomt, Ziehen verschiebt, „Einpassen“ zeigt das ganze Diagramm.

Was die Vorschau zeigt — und was nicht

Sie zeigt, was in der Datei steht: Elemente, Lanes, Kanten mit genau den Anschlusspunkten, die md_to_bpmn.py berechnet hat. Damit eignet sie sich, um Entwürfe vor der Freigabe und Modelländerungen im Review anzusehen. PICTURE kann dieselbe Datei anders darstellen (eigene Schriften, eigene Behandlung von Anschlusspunkten). Der Import in PICTURE bleibt deshalb der letzte Nachweis.

Eingebettete Bibliothek

Paket bpmn-js 18.29.1 (npm), Datei dist/bpmn-navigated-viewer.production.min.js und dist/assets/*.css
Quelle https://registry.npmjs.org/bpmn-js/-/bpmn-js-18.29.1.tgz
Integrität (npm) sha512-7M3O9LeHbV2ZW9xLXap8CMmIjR+iXWqiXrz7Rt1hE+DqLGhULuwOIgTsQGtXPGVUCrnrk4L38NVlc5R8thOHJw==
Lizenz MIT mit Auflage, siehe bpmn-js/LICENSE

Lizenzauflage: Das bpmn.io-Wasserzeichen unten rechts im Diagramm darf nicht entfernt, verändert oder von anderen Elementen überdeckt werden. Bedienelemente deshalb nie in die untere rechte Ecke der Zeichenfläche legen.

Die Bibliothek lädt nichts aus dem Netz nach; die Adressen darin sind XML-Namensräume und der Link des Wasserzeichens. Das Font-Paket bpmn-font wird nur vom Editor gebraucht und fehlt bewusst.

Aktualisieren

  1. Neue Version bei npm nachsehen, Tarball laden und die integrity aus https://registry.npmjs.org/bpmn-js/<version> gegen die Prüfsumme des geladenen Archivs prüfen.
  2. Die vier Dateien in bpmn-js/ ersetzen (LICENSE auf geänderte Auflagen lesen).
  3. python -m pytest -q — scripts/vorschau.py lehnt eine Bibliothek ab, die <script/</script enthält und damit nicht sicher eingebettet werden kann.
  4. Eine Vorschau erzeugen und im Browser ansehen; Tabelle oben nachziehen. Eigener Pull Request.