feat(dev): local docker-compose stack

Adds dev/docker-compose.yml + breakpilot-dev Keycloak realm + make dev-up/down/reset/logs targets so a developer can boot the full dependency stack from this repo.
2026-05-19 09:35:02 +00:00
parent 8e37f65b8e
commit e3a62c8113
6 changed files with 444 additions and 1 deletions
@@ -42,6 +42,8 @@ The single source of truth for which container runs on which VM in which environ

 ## Run locally

+### IaC validation
+
 ```bash
 make validate                   # check all manifests parse + have required fields
 make plan ENV=stage             # resolve manifests for stage → .orca-out/stage/
@@ -51,6 +53,18 @@ make apply ENV=stage            # no-op until M1.2 stands up the Orca controller

 `make validate` runs in CI on every PR.

+### Dev stack
+
+`platform/orca-platform` doubles as the home for the local-dev compose stack so a developer can clone this repo, run `make dev-up`, and immediately work against a real Keycloak realm + Postgres / Redis / Mongo / MinIO. See [`dev/README.md`](./dev/README.md) for the full picture.
+
+```bash
+make dev-up                     # Keycloak (:8080) + Postgres (:5432) + Redis (:6379) + Mongo (:27017) + MinIO (:9000)
+make dev-down                   # stop, keep volumes
+make dev-reset                  # stop, wipe, fresh
+```
+
+Seed user: `test@breakpilot.dev` / `test` (tenant `acme`, products `certifai` + `compliance`).
+
 ## Per-milestone fill-in schedule

 Each stub manifest in `manifests/` carries a header comment naming the milestone that finalises its real values. Summary: