mhoennigandClaude Opus 4.8
aa16665853
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>
75 lines
2.9 KiB
Markdown
75 lines
2.9 KiB
Markdown
<p>
|
|
<img src="docs/brand/logo.svg" width="72" alt="Werkbaum-Logo">
|
|
</p>
|
|
|
|
# Werkbaum
|
|
|
|
[English](README.md) · **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 Sprachdefinition
|
|
- `docs/DECISIONS.md` — Design-Entscheidungen mit Begründung
|
|
- `docs/ROADMAP.md` — Mermaid-Plugin, Taiga-Integration, Tenzu
|
|
- `docs/TASKS.md` — offene Aufgaben (Checkboxen)
|
|
- `docs/brand/BRAND.md` — Logo, Wortbild, Anwendungsregeln
|
|
- `docs/design/` — Design-Herleitung der Marke
|
|
- `CLAUDE.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](LICENSE). © 2026 Michael Hönnig.
|