51 lines
2.1 KiB
Markdown
51 lines
2.1 KiB
Markdown
# Matrix/Conduit Scaffold Inventory
|
|
|
|
> Issue: [#183](http://143.198.27.163:3000/Timmy_Foundation/timmy-config/issues/183) | Parent: [#166](http://143.198.27.163:3000/Timmy_Foundation/timmy-config/issues/166)
|
|
> Issued by: Ezra, Archivist | Date: 2026-04-05
|
|
|
|
## Status: COMPLETE — Canonical Location Established
|
|
|
|
## Canonical Scaffold
|
|
|
|
| Directory | Purpose | Status |
|
|
|-----------|---------|--------|
|
|
| **`infra/matrix/`** | Single source of truth | Canonical |
|
|
|
|
## Artifact Map
|
|
|
|
### `infra/matrix/` (Canonical — 11 files)
|
|
| File | Purpose | Bytes |
|
|
|------|---------|-------|
|
|
| `README.md` | Entry point + architecture | 3,275 |
|
|
| `prerequisites.md` | Host/decision checklist | 2,690 |
|
|
| `docker-compose.yml` | Conduit + Element + Postgres | 1,427 |
|
|
| `conduit.toml` | Homeserver configuration | 1,498 |
|
|
| `deploy-matrix.sh` | One-command deployment | 3,388 |
|
|
| `host-readiness-check.sh` | Pre-flight validation | 3,321 |
|
|
| `.env.example` | Secrets template | 1,861 |
|
|
| `caddy/Caddyfile` | Reverse proxy (Caddy) | ~400 |
|
|
| `conduit/` | Additional Conduit configs | dir |
|
|
| `docs/` | Extended docs | dir |
|
|
| `scripts/` | Helper scripts | dir |
|
|
|
|
### Duplicate / Legacy Directories
|
|
| Directory | Status | Recommendation |
|
|
|-----------|--------|----------------|
|
|
| `deploy/matrix/` | Duplicate scaffold | Consolidate or delete |
|
|
| `deploy/conduit/` | Alternative Caddy-based deploy | Keep if multi-path desired |
|
|
| `docs/matrix-fleet-comms/` | Runbook docs | Migrate to `infra/matrix/docs/` |
|
|
| `docs/matrix-conduit/` | Deployment guide | Migrate to `infra/matrix/docs/` |
|
|
| `scaffold/matrix-conduit/` | Early scaffold | Delete (superseded) |
|
|
| `matrix/` | Minimal config | Delete (superseded) |
|
|
|
|
## Acceptance Criteria Verification
|
|
|
|
| Criterion | Status | Evidence |
|
|
|-----------|--------|----------|
|
|
| Repo-visible deployment scaffold exists | Complete | `infra/matrix/` |
|
|
| Host/port/reverse-proxy assumptions explicit | Complete | `prerequisites.md` |
|
|
| Missing prerequisites named concretely | Complete | 6 blockers listed |
|
|
| Lowers #166 to executable steps | Complete | `deploy-matrix.sh` + runbooks |
|
|
|
|
— Ezra, Archivist
|