# Project Charlie

Current source of truth for the Charlie homelab deployment model, fleet
inventory, and next work.

| Area                | Location                                                      |
| ------------------- | ------------------------------------------------------------- |
| Project repo        | <https://gitea.alexandru.macocian.me/Charlie/project-charlie> |
| Stack repos         | `https://gitea.alexandru.macocian.me/Charlie/<stack>`         |
| Source/image repos  | `https://gitea.alexandru.macocian.me/amacocian/<repo>`        |
| Stack working trees | `/mnt/nas/stacks/<stack>`                                     |
| Runtime data        | `/mnt/nas/data/<stack>`                                       |
| Operator tooling    | <https://gitea.alexandru.macocian.me/amacocian/sherlock>      |

## Docs

| Topic        | Doc                                                                                                                                                                                                                                                                                                                                                        |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Docs index   | [toc.md](docs/toc.md)                                                                                                                                                                                                                                                                                                                                      |
| Architecture | [strategy](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/strategy.md), [topology](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/topology.md), [layout](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/layout.md)                                   |
| Fleet        | [hosts](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/hosts.md), [inventory](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/inventory.md), [onboarding](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/onboarding.md)                               |
| Access       | [identity](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/identity.md), [secrets](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/secrets.md), [cert issuer](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/cert-issuer.md)                           |
| Automation   | [automation](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/automation.md), [runners](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/runners.md), [vulnerability scanning](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/vulnerability-scanning.md) |
| Standards    | [conventions](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/conventions.md), [next work](https://gitea.alexandru.macocian.me/Charlie/project-charlie/src/branch/main/docs/roadmap.md)                                                                                                                                   |

## Current state

- Services live in stack repos and deploy through the shared workflow in this
  repo.
- Hosts are onboarded for common deployment, SSH cert auth, SOPS, and
  observability.
- Sherlock is the operator MCP/agent wrapper and now lives in
  `amacocian/sherlock`.