Infrastructure¶
This section is the application's view of infrastructure: how the local dev stack is wired, how CI turns code into container images, how secrets reach the running app, what to expect at runtime. It's deliberately scoped to what an application engineer needs to know.
Where the actual cluster lives: DevOps
Terraform-managed resources (Cloudflare DNS, Tunnel, Workers, R2), the OVH bare-metal k3s cluster, Argo CD applications, Kubernetes manifests (deployments, services, ingresses, network policies), Postgres operations (CNPG), and cluster-side runbooks (deploy, rollback, scaling, disaster recovery) all live in the DevOps companion site. This section does not duplicate that content; it links out where details matter.
| If you want to know… | Read here | Read in DevOps |
|---|---|---|
| How my code becomes an image | Container images | OVH bare metal |
| How my image reaches prod | Deployment (overview) | DevOps → Deploy (runbook), Argo CD |
| Where secrets come from | Secrets (app perspective) | Secrets Management (provisioning) |
| What runs in the cluster | — | Tomoda K8s app, Postgres CNPG, Redis, Photon |
| How prod scales / autoscales | — | DevOps → Scaling, SCALING_PLAN.md |
| Disaster recovery | — | DevOps → DR |
In this section¶
-
Environments (local, dev, prod) and a high-level topology diagram of how requests flow through the stack — from the app's point of view.
-
The local infra stack — Postgres + PostGIS, Redis, RustFS, Photon — and the
task devworkflow. -
The GitHub Actions workflow (
images.yml) that builds backend and frontend images and pushes them to GHCR. -
The app's view of how a git tag becomes a running pod — the high-level flow, with handoffs to DevOps for the cluster-side specifics.
-
The local
.env.localworkflow, thepull-secrets.shscript, and how secrets the app needs are sourced in prod (via DevOps's External Secrets Operator setup). -
The self-hosted Photon geocoding service — why it exists, how the backend uses it, and where the index lives. (Cluster-side deployment lives in DevOps.)