From b40e379b84db0c372fba9b98332bd9f0ce764d46 Mon Sep 17 00:00:00 2001
From: bvandeusen <bryan.vandeusen@fabledsword.com>
Date: Sat, 18 Apr 2026 21:21:01 +0000
Subject: [PATCH] feat(skel): docker-compose for local Postgres
 (integration-test stack)

---
 docker-compose.yml | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 docker-compose.yml

diff --git a/docker-compose.yml b/docker-compose.yml
new file mode 100644
index 00000000..aaa796fb
--- /dev/null
+++ b/docker-compose.yml
@@ -0,0 +1,26 @@
+version: "3.9"
+
+# Local development environment for Minstrel.
+# Not used by CI — integration tests run against this compose stack manually:
+#   docker compose up -d postgres
+#   go test ./...    # runs full tests (no -short flag)
+
+services:
+  postgres:
+    image: postgres:16-alpine
+    environment:
+      POSTGRES_USER: minstrel
+      POSTGRES_PASSWORD: minstrel
+      POSTGRES_DB: minstrel
+    ports:
+      - "5432:5432"
+    volumes:
+      - minstrel-pgdata:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U minstrel -d minstrel"]
+      interval: 5s
+      timeout: 5s
+      retries: 10
+
+volumes:
+  minstrel-pgdata: