No description
  • TypeScript 53.1%
  • CSS 46.9%
Find a file
Kevin Heyer 6649539e05 Restructure docs and decide architecture stack and environments
Rebuild the documentation from the decisions of three SOLL interviews
so that every page only contains what was actually decided.

Architecture stack (formerly page 1.1, now 1.1.1 Überblick):
- Goals and non-goals of the strategy. "Selbst-heilend" is defined as
  returning a node to its last approved state, not auto-rolling out
  new changes.
- Stack table extended with Proxmox, Forgejo-Runner and CMDB Syncer.
- Single Source of Truth per data type: Forgejo for code, roles,
  manifests and templates; Netbox for host-to-role assignment,
  host-specific values and environment; Loom for the approved
  configuration per node. Loom's per-node state is deliberately not
  written back to Git, so the GitOps principle now names Loom
  approvals alongside Forgejo commits.
- Role selection in Netbox via the Netbox-Sync-Skript, device roles
  (ansible_role_device_*) and central Ansible push for devices that
  cannot run ansible-pull.
- Approval flow in Loom, and two separate Forgejo instances.

Structure (ALLG-05):
- Eleven chapters along the roles of the control loop, plus
  Erstinstallation, Migration, Plattform and Dienste; a meta.ts per
  chapter and sub-chapter.
- The CMDB-Deploy, drift management and custom script sections move
  out of the strategy page into 8.3 CMDB-Deploy and 8.4 Custom-Scripts,
  because they describe components, not strategy.
- Start page: chapter overview, page types, five-level numbering
  scheme, stable abbreviations instead of stable numbers, and the rule
  that concrete instances live only in Netbox.

Environments (ALLG-03, new sub-chapter 1.2 Umgebungen):
- Two environments, Lab and Prod, on the same hardware with Lab in
  its own VLAN 140, sharing Forgejo, Netbox, Loom and OpenBAO.
- Branches lab and main selected by the environment in Netbox; the
  same Loom approval applies in Lab.
- Lab has no backup, no monitoring and only the security minimum
  standards; the escape hatch rules do not apply there.
- Decommissioning is triggered by archiving the object in Netbox.

Roadmap and changelog:
- Roadmap items now use stable abbreviations (STRAT, ENV, CMDB,
  CUSTOM) with a mandatory "Rollenzugehörigkeit" column; the old
  1.1-xx numbers keep their running number and the changelog maps old
  to new.
- Resolved items are removed and listed in the changelog. Open
  decisions, such as Loom as a Netbox plugin, the manifests.yml format
  and the VLAN concept, stay on the roadmap rather than being assumed.
2026-09-30 10:56:53 +02:00
docs Restructure docs and decide architecture stack and environments 2026-09-30 10:56:53 +02:00
skills Add documentation skills and SOLL-first rules for docs/ 2026-09-30 10:56:53 +02:00
.gitignore fresh start 2026-09-30 07:26:22 +02:00
AGENTS.md Add documentation skills and SOLL-first rules for docs/ 2026-09-30 10:56:53 +02:00
blume.config.ts first init 2026-09-29 08:34:17 +02:00
CLAUDE.md first init 2026-09-29 08:34:17 +02:00
LICENSE first init 2026-09-29 08:34:17 +02:00
package-lock.json first init 2026-09-29 08:34:17 +02:00
package.json first init 2026-09-29 08:34:17 +02:00
theme.css first init 2026-09-29 08:34:17 +02:00
tsconfig.json first init 2026-09-29 08:34:17 +02:00