& so it begins

2026-02-28 14:50:04 +02:00
commit f00381f2b6
536 changed files with 26294 additions and 0 deletions
--- a/dev/README.md
+++ b/dev/README.md
@@ -0,0 +1,42 @@
+# Dev
+
+Self-contained local development stack. Spin up all shared infrastructure on a per-project basis.
+
+## Services
+
+| Service            | Description                              | Port(s)        |
+| ------------------ | ---------------------------------------- | -------------- |
+| **PostgreSQL**     | Primary relational database              | `5432`         |
+| **Valkey**         | Redis-compatible cache / message broker  | `6379`         |
+| **SigNoz**         | Observability UI (traces, metrics, logs) | `8080`         |
+| **OTel Collector** | OpenTelemetry ingest (gRPC / HTTP)       | `4317`, `4318` |
+| **ClickHouse**     | Telemetry storage backend for SigNoz     | —              |
+
+## Run
+
+```sh
+cd dev
+docker compose -f docker-compose.dev.yaml up -d
+```
+
+## Stop
+
+```sh
+docker compose -f docker-compose.dev.yaml down
+```
+
+To also remove all persisted data volumes:
+
+```sh
+docker compose -f docker-compose.dev.yaml down -v
+```
+
+## Connection strings
+
+| Resource   | Default value                                             |
+| ---------- | --------------------------------------------------------- |
+| PostgreSQL | `postgresql://postgres:postgres@localhost:5432/primarydb` |
+| Valkey     | `redis://localhost:6379`                                  |
+| SigNoz UI  | `http://localhost:8080`                                   |
+| OTLP gRPC  | `localhost:4317`                                          |
+| OTLP HTTP  | `localhost:4318`                                          |