9f819df4d9
Establish the design foundation for the heleosv2 multi-tenant hosting platform before any implementation code: - Monorepo skeleton: docs/, platform-infra/, site-templates/, deployments/, control-panel/ with orientation READMEs. - docs/: roadmap index, architecture + threat model, naming conventions, site profiles, provisioning workflow, backup & DR runbook, repo/GitOps layout, and the approved architecture plan. - docs/adr/: 9 ADRs recording the rationale for single-host Compose, Traefik edge, nginx+fpm split, shared MariaDB, ZFS-per-customer, decoupled backup streams, Forgejo, CLI-first, and SFTP-only. - Secrets hygiene: .gitignore (only *.enc.* committed) and .gitattributes (LF for scripts/Dockerfiles/YAML run on the Linux host). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.2 KiB
1.2 KiB
Architecture Decision Records
Short records capturing why each major choice was made. Format: Context → Decision → Consequences. Status is one of Proposed / Accepted / Superseded.
| ADR | Decision | Status |
|---|---|---|
| 0001 | Single bare-metal host, Docker Compose per customer | Accepted |
| 0002 | Traefik as the edge router | Accepted |
| 0003 | Per-site nginx + php-fpm behind Traefik | Accepted |
| 0004 | Shared MariaDB instance, per-site DB + user | Accepted |
| 0005 | ZFS dataset per customer | Accepted |
| 0006 | Decoupled backup streams (files vs DB vs logs) | Accepted |
| 0007 | Forgejo (lightweight) over GitLab | Accepted |
| 0008 | CLI/templating first, customer panel later | Accepted |
| 0009 | SFTP only (no FTP) | Accepted |
New ADRs are additive and numbered sequentially. To reverse a decision, add a new ADR that supersedes the old one rather than editing history.