first commit

infrastructure/README.md

@@ -0,0 +1,21 @@
+# infrastructure
+
+Deployment and local-environment definitions.
+
+**Empty in Phase 1, on purpose.** The Phase 1 scope is the Go module, the
+database connection and the initial migration, run against a PostgreSQL 18.6
+instance that already exists on the developer's machine. Nothing here is needed
+to get `make migrate-up && make run` working.
+
+What lands here in later phases, once each is actually approved:
+
+| File | Phase | Contents |
+| --- | --- | --- |
+| `docker-compose.dev.yml` | 2 | PostgreSQL + pgvector, so the dev database stops being a machine-local install |
+| `docker-compose.dev.yml` (extended) | later | Redis, NATS, MinIO — each only when the phase that needs it starts |
+| `Dockerfile.api` | later | Multi-stage build for `go-api` |
+| `Dockerfile.owliver` | later | The Python service |
+| `otel-collector.yaml` | later | OpenTelemetry collector config |
+
+Adding any of these before its phase would be speculative, so the directory
+holds only this note for now.