Beim Site-Build ersetzt der Workflow ">Werkbaum 1.0</a>" durch
">Werkbaum 1.0.${{ github.run_number }}</a>" (per sed, nur auf der
Site-Kopie). Die Micro-Version steigt so bei jedem Deployment monoton
um 1 — ohne Commit/Tag zurueck ins Repo und ohne selbstausloesenden
Deploy-Zyklus. run_number via env BUILD_VERSION injiziert. "1.0" bleibt
die manuell gepflegte Basis und die Version beim lokalen Oeffnen; die
viewport-/xml-"1.0" bleiben unberuehrt (Anker >...</a> als Ziel).
Doku: README (EN+DE) Deployment-Abschnitt und DECISIONS D16 ergaenzt.
Keine SPEC-Aenderung (Notation unberuehrt).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.9 KiB
Werkbaum
English · Deutsch
Eine textuelle, Markdown-artige Notation für Projektstrukturpläne (Work Breakdown Structure) mit Und/Oder-Zerlegung — und ein Live-Editor, der sie als Diagramm rendert.
[~] Werkbaum (XL) https://wiki.example.de/relaunch
- [~] Dokumentenspeicher
| [x] Textdatei mit Copy+Paste im Frontend (S)
- [x] Parser
- [x] Texteingabefeld im Frontend
| [ ] Backend
- [~] Darstellung/Rendern (XL)
- [/] H (S) @anna
- [ ] CMS-Anbindung (M)
| [ ] WordPress
| [?] Headless CMS
- = Pflicht-Teilpaket (all of, im Diagramm nebeneinander) ·
| = Alternative (any of, untereinander) · […] = Status ·
(M) = T-Shirt-Aufwand · @name = Zuständigkeit · %% = Kommentar.
Nutzung
frontend/index.html im Browser öffnen — links Text bearbeiten, rechts entsteht das
Diagramm live. Toggles: transponierte (schmale) Darstellung, verworfene
Elemente einblenden.
Projektdokumente
frontend/— Editor ·backend/— Kotlin/Spring (Gerüst folgt, siehe backend/README.md)docs/SPEC.md— verbindliche Sprachdefinitiondocs/DECISIONS.md— Design-Entscheidungen mit Begründungdocs/ROADMAP.md— Mermaid-Plugin, Taiga-Integration, Tenzudocs/TASKS.md— offene Aufgaben (Checkboxen)docs/brand/BRAND.md— Logo, Wortbild, Anwendungsregelndocs/design/— Design-Herleitung der MarkeCLAUDE.md— Projektkontext für Claude Code
Deployment
Der Editor wird per GitHub Actions als statische Seite auf GitHub Pages
veröffentlicht (Workflow: .github/workflows/pages.yml). Ausgelöst bei jedem
Push auf main sowie manuell (workflow_dispatch).
Der Workflow stellt einen Site-Ordner zusammen: frontend/index.html liegt als
index.html an der Wurzel-URL, dazu die vom Editor referenzierten Dateien
(docs/brand/ fürs Favicon, LICENSE für den MIT-Link im Footer). Die
../-Pfade der Editor-Quelle werden dabei nur auf der Kopie geradegezogen — die
Quelldatei bleibt unverändert. backend/ und die übrigen docs/ werden nicht
veröffentlicht.
Beim Zusammenstellen setzt der Workflow zudem die Micro-Version im Footer
aus der Run-Nummer: aus Werkbaum 1.0 wird Werkbaum 1.0.<Run-Nummer> und
steigt bei jedem Deployment um eins — ohne Commit zurück ins Repo. Lokal
geöffnet zeigt der Editor weiterhin Werkbaum 1.0.
Einmalige Einrichtung: In den Repo-Settings unter Pages als Source „GitHub Actions" wählen. Das Repo muss dafür öffentlich sein (GitHub Pages via Actions ist für private Repos nur mit kostenpflichtigem Plan verfügbar).
Lizenz
MIT — siehe LICENSE. © 2026 Michael Hönnig.
