dtoro
f127925d5a
Deleted stale (Python-era artifacts, superseded by DB): - archive/oikos-cards/ (46 files, predecessor to DB entity graph) - archive/ledger/ (5-line JSONL fragment, superseded by DB audit log) Moved to docs/ (actual, current architecture docs): - docs/infrastructure/ — 12 infrastructure docs (network, DNS, mesh, SSH, ingress, media-permissions, backups, homelab-context, auto-deploy, VPS-hardening, monitoring, check-lifecycle) - docs/secrets/ — secrets README and rotation runbook - docs/GLOSSARY.md — 28-term homelab glossary Added STALE.md markers to hermes-plans/ and secrets-issuance/. Added MOVED.md pointers in archive sources. Updated docs/index.md to include new paths.
21 lines
1.1 KiB
Markdown
21 lines
1.1 KiB
Markdown
# Docs
|
|
|
|
Long-form reference material for the Oikos platform and homelab infrastructure.
|
|
Operational state and topology live in the DB (seeded from `seeds/`); these docs
|
|
cover architecture, decisions, procedures, and the system model.
|
|
|
|
| Path | Contents |
|
|
| ---- | -------- |
|
|
| [adr/](adr/README.md) | Architecture Decision Records (numbered, append-only) |
|
|
| [infrastructure/](infrastructure/) | Homelab infrastructure architecture — network, DNS, mesh, ingress, backups, SSH, VPS hardening, auto-deploy, monitoring |
|
|
| [mbse/](mbse/README.md) | Model-Based Systems Engineering views of the platform |
|
|
| [mascot/](mascot/README.md) | MBSE subsystem model for the desktop mascot (planned) |
|
|
| [operations/](operations/README.md) | Operator runbooks (deploy, rollback, recovery) |
|
|
| [secrets/](secrets/README.md) | Secret management procedures and rotation runbook |
|
|
| [GLOSSARY.md](GLOSSARY.md) | Term definitions across the homelab |
|
|
|
|
For agent orientation see [AGENTS.md](../AGENTS.md); for the operating model
|
|
see [.agents/OIKOS.md](../.agents/OIKOS.md); for development see
|
|
[CONTRIBUTING.md](../CONTRIBUTING.md). Design plans live in
|
|
[plans/](../plans/), not here.
|