docs: resolve wiki hostname + surface decisions, track the two follow-ups

#0024 decided: axionwiki.lab (development-time). #0020 decided: stay on
Docusaurus with Authentik forward-auth, not the last word on the surface. Both
closed with the decision recorded. New follow-ups the user asked to keep:
0046 (move the wiki into the ThreadNet Server Suite, M4) and 0047 (re-examine
surface alternatives beyond BookStack afterwards, M2). STATUS regenerated;
validate, gen_status --check, upstream_drift and pruefe_prosa green.
This commit is contained in:
Thore Cimbal
2026-08-11 12:00:00 +00:00
parent 2539fd01e8
commit 5b0714a33a
5 changed files with 95 additions and 6 deletions
+4 -4
View File
@@ -2,9 +2,9 @@
<!-- Generated by scripts/gen_status.py — do not edit. -->
## Issues (39 open, 0 closed)
## Issues (39 open, 2 closed)
Verteilung: M1 10 · M2 25 · M4 2 · M5 2
Verteilung: M1 10 · M2 24 · M4 3 · M5 2
| Issue | Status | Meilenstein | Priorität | Title |
|---|---|---|---|---|
@@ -22,11 +22,9 @@ Verteilung: M1 10 · M2 25 · M4 2 · M5 2
| [0015](docs/issues/0015-cfgmon-15-token-hygiene-einmal-tokens-der.md) | next | M2 | medium | CFGMON-15: Token-Hygiene — Einmal-Tokens der LABNET-02-Nacht widerrufen |
| [0018](docs/issues/0018-doc-01-wiki-rollout-abschliessen-ci-freigaben.md) | open | M2 | low | DOC-01: Wiki-Rollout abschließen — CI-Freigaben, Zeitplan, Dokploy-Stack, wiki.lab |
| [0019](docs/issues/0019-doc-02-veralteten-wiki-branch-im-gitops-repo.md) | open | M2 | low | DOC-02: Veralteten `wiki`-Branch im gitops-Repo entfernen? |
| [0020](docs/issues/0020-doc-03-wiki-oberflaeche-entscheiden-docusaurus.md) | next | M2 | medium | DOC-03: Wiki-Oberfläche entscheiden — Docusaurus oder BookStack |
| [0021](docs/issues/0021-overmind-03-windows-build-vm-verschwindet-ci.md) | waiting | M2 | medium | OVERMIND-03: Windows-Build-VM verschwindet — CI kann sie nur starten, nicht anlegen |
| [0022](docs/issues/0022-build-01-macos-client-reproduzierbar-bauen.md) | open | M4 | low | BUILD-01: macOS-Client reproduzierbar bauen — aktuell nur manuell auf sorbs Mac |
| [0023](docs/issues/0023-doc-04-navbar-logo-im-docusaurus-wiki-wird.md) | open | M2 | low | DOC-04: Navbar-Logo im Docusaurus-Wiki wird ausgeliefert, ist aber nicht sichtbar |
| [0024](docs/issues/0024-wiki-hostname-klaeren-wiki-lab-oder-axionwiki.md) | open | M2 | low | Wiki-Hostname klären: wiki.lab oder axionwiki.lab? |
| [0025](docs/issues/0025-deploy-uebergabe-cve-alarme-aggregiert-receiver.md) | waiting | M1 | medium | Deploy-Übergabe: CVE-Alarme aggregiert + Receiver-Robustheit (gitops#51, ff87cb2) |
| [0027](docs/issues/0027-audit-01-acht-widersprueche-aus-dem-labnet-02.md) | waiting | M2 | medium | AUDIT-01: Acht Widersprüche aus dem LABNET-02-Nachlauf (Selbst-Audit CFGMON-Session) |
| [0028](docs/issues/0028-mirror-01-ein-ausfall-der-push-mirrors-bleibt.md) | open | M2 | low | MIRROR-01: Ein Ausfall der Push-Mirrors bleibt unbemerkt — Produktion friert still ein |
@@ -47,6 +45,8 @@ Verteilung: M1 10 · M2 25 · M4 2 · M5 2
| [0043](docs/issues/0043-invitation-flow-eindeutigkeit-case-insensitiv.md) | open | M5 | medium | Invitation-Flow: case-insensitive Eindeutigkeitsprüfung im Prompt-Stage |
| [0044](docs/issues/0044-sops-secret-aenderung-startet-dienst-nicht-neu.md) | open | M5 | low | SOPS-Values-Secret-Änderung startet den konsumierenden Dienst nicht neu |
| [0045](docs/issues/0045-report-event-kein-kontaktweg-fuer-melder.md) | open | M1 | low | Inhalts-Meldung führt ins Leere: kein Kontaktweg für Melder |
| [0046](docs/issues/0046-wiki-in-threadnet-server-suite-umziehen.md) | open | M4 | medium | Wiki in die ThreadNet Server Suite umziehen |
| [0047](docs/issues/0047-wiki-oberflaeche-ueber-bookstack-hinaus-pruefen.md) | open | M2 | low | Wiki-Oberfläche über BookStack hinaus prüfen |
## Active design docs (0)
@@ -1,7 +1,7 @@
---
type: issue
id: "0020"
status: next
status: done
created: 2026-08-02
milestone: M2
priority: medium
@@ -14,6 +14,17 @@ related: []
> Import aus [management#20](https://git.lab/axion1337.chat/management/-/issues/20) (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).
## Entscheidung (2026-08-12, sorb)
**Docusaurus bleibt** — für jetzt. Zugang wird per Authentik-Forward-Auth
eingeschränkt (kein Bereichs-Schutz nötig), Konfiguration vorbereitet in gitops
`docs/deployment-guides/09-wiki-forward-auth.md`; Hostname `axionwiki.lab` (#0024).
Bewusst **kein Schlussstrich unter die Oberflächenfrage**: Die Entscheidung gilt
für den Entwicklungs-Zwischenstand. Nach dem Umzug in die ThreadNet Server Suite
(#0046) werden Alternativen **über BookStack hinaus** neu geprüft (#0047) — ADR-0007
bleibt insofern nicht das letzte Wort, sondern der bisherige Stand.
Zwei Varianten stehen nebeneinander, damit an echten Inhalten entschieden wird statt am Reißbrett ([ADR-0007](https://git.lab/axion1337.chat/management/-/blob/main/decisions/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md)):
| Variante | Stand | Repo |
@@ -1,7 +1,7 @@
---
type: issue
id: "0024"
status: open
status: done
created: 2026-08-02
milestone: M2
priority: low
@@ -13,4 +13,14 @@ related: []
> Import aus [management#24](https://git.lab/axion1337.chat/management/-/issues/24) (2026-08-11). Kommentare und Verlauf bleiben dort; kanonisch ist ab jetzt diese Datei (ADR-0012).
## Entscheidung (2026-08-12, sorb)
**`axionwiki.lab`.** Damit sind `external_host`, der Traefik-`Host()` und der
Cookie-Scope der Forward-Auth-Konfiguration eindeutig festgelegt (gitops
`docs/deployment-guides/09-wiki-forward-auth.md`).
⚠️ Ausdrücklich ein **Entwicklungs-Zwischenstand**: Das Wiki zieht später in die
ThreadNet Server Suite um (#0046), danach wird die Oberfläche über BookStack
hinaus neu bewertet (#0047) — beim Umzug ändert sich der Host erneut.
@@ -0,0 +1,35 @@
---
type: issue
id: "0046"
status: open
created: 2026-08-12
milestone: M4
priority: medium
area: infrastructure
related: [docs/issues/0024-wiki-hostname-klaeren-wiki-lab-oder-axionwiki.md, docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md]
---
# Wiki in die ThreadNet Server Suite umziehen
## Problem / Motivation
Das Wiki läuft aktuell als einzelner Dokploy-Stack auf Overmind
(`axionwiki.lab`) mit Forward-Auth über den Prod-Authentik — ein bewusst
provisorischer Entwicklungs-Zwischenstand (#0024, #0020). Die Vision „reproduzierbar
für Dritte" verlangt aber, dass das Wiki **Teil des reproduzierbaren Stacks** wird,
nicht ein Einzelstück auf dem Lab-Host: Eine forkende Community soll es mit dem Rest
der ThreadNet Server Suite ausrollen können.
## Acceptance
- Das Wiki ist Bestandteil der ThreadNet-Server-Suite-Deployment-Definition
(nicht mehr ein losgelöster Overmind-Stack).
- Host, Reverse-Proxy und Auth-Anbindung sind für die Suite konsistent gelöst —
die Forward-Auth-Verdrahtung aus gitops-Guide 09 wird dabei sauber abgelöst, nicht
fortgeschleppt (sie ist genau darauf ausgelegt).
- Instanzwerte (Host, Auth-Client) sind von generischer Struktur getrennt, damit
ein Fork sie ohne Code-Änderung setzen kann.
## Notes
Beim Umzug ändert sich der Host erneut — der `axionwiki.lab`-Stand aus #0024 gilt
nur bis dahin. Erst nach diesem Umzug greift #0047 (breitere Oberflächen-Evaluation).
@@ -0,0 +1,33 @@
---
type: issue
id: "0047"
status: open
created: 2026-08-12
milestone: M2
priority: low
area: infrastructure
related: [docs/adr/0007-wiki-oberflaeche-docusaurus-vs-bookstack.md, docs/issues/0020-doc-03-wiki-oberflaeche-entscheiden-docusaurus.md]
---
# Wiki-Oberfläche über BookStack hinaus prüfen
## Problem / Motivation
Die Wiki-Oberfläche wurde bisher nur als **Docusaurus vs. BookStack** betrachtet
(ADR-0007, #0020). Für den Entwicklungs-Zwischenstand fiel die Entscheidung auf
Docusaurus mit Forward-Auth. Nach dem Umzug in die ThreadNet Server Suite (#0046)
soll die Frage aber **breiter** neu aufgemacht werden — nicht nur die alte
Zwei-Optionen-Wahl, sondern weitere Kandidaten (z. B. Outline, Wiki.js, andere
docs-as-code- oder App-basierte Lösungen), gemessen an dem, was die Suite dann
tatsächlich braucht (Bereichs-Rechte? Browser-Editing? Git-Quelle?).
## Acceptance
- Ein Vergleich mehrerer Kandidaten (nicht nur Docusaurus/BookStack) gegen die
dann geklärten Anforderungen der ThreadNet Server Suite.
- Entscheidung als ablösendes ADR (ADR-0007 wird dann `superseded`), falls sich
etwas anderes als Docusaurus durchsetzt.
## Notes
Bewusst `low` und ohne Termin: erst nach #0046 sinnvoll, vorher fehlt der Kontext
(die Anforderungen der Suite). Hängt inhaltlich an #0046.