tools/local-dev: docker-compose stack for UI development

Adds tools/local-dev/ with postgres + redis + mailpit + backend + gateway plus a Make wrapper, so `make -C tools/local-dev up` brings the full authenticated stack online and `pnpm -C ui/frontend dev` talks to it directly. The committed `.env.development` already points at the stack and pins the matching gateway response public key from the dev keypair under tools/local-dev/keys/. The backend ships a new opt-in env, BACKEND_AUTH_DEV_FIXED_CODE (`tools/local-dev/.env` defaults it to 123456). When set, ConfirmEmailCode accepts that literal in addition to the real bcrypt-verified code; SendEmailCode still queues a real email so Mailpit captures the issued code at http://localhost:8025/, and both paths coexist. The override is rejected as non-six-digit by config validation and emits a loud warning at backend startup. The local-dev Dockerfiles mirror backend/Dockerfile and gateway/Dockerfile but switch the runtime stage to alpine so docker-compose healthchecks can wget /healthz; the gateway Dockerfile additionally copies ui/core/ into the build context because gateway/go.mod's `replace galaxy/core => ../ui/core` is required to compile the gateway main. Smoke tested: - `make -C tools/local-dev up` boots all five services to healthy. - send-email-code + confirm-email-code with code=123456 returns a device_session_id; a real code in Mailpit also redeems successfully. - `pnpm test` 14/14, `pnpm exec playwright test` 44/44. - `go test ./backend/internal/config/...` green. Docs: tools/local-dev/README.md, tools/local-dev/keys/README.md, new "Local development stack" section in ui/docs/testing.md, and a short pointer in ui/README.md. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-08 09:42:29 +02:00
parent f57a290432
commit 69fa6b30e1
20 changed files with 887 additions and 19 deletions
@@ -0,0 +1,74 @@
+# syntax=docker/dockerfile:1.7
+#
+# Local-dev image for the gateway service. Mirrors `gateway/Dockerfile`
+# (the integration/production image) but switches the runtime stage to
+# alpine so docker-compose healthchecks can shell out to `wget`.
+#
+# Build via the local-dev compose: `make -C tools/local-dev up`. The
+# build context is the repository root.
+
+FROM golang:1.26.2-alpine AS builder
+WORKDIR /src
+ENV CGO_ENABLED=0 GOFLAGS=-trimpath
+
+COPY pkg/cronutil/   ./pkg/cronutil/
+COPY pkg/error/      ./pkg/error/
+COPY pkg/geoip/      ./pkg/geoip/
+COPY pkg/model/      ./pkg/model/
+COPY pkg/postgres/   ./pkg/postgres/
+COPY pkg/redisconn/  ./pkg/redisconn/
+COPY pkg/schema/     ./pkg/schema/
+COPY pkg/transcoder/ ./pkg/transcoder/
+COPY pkg/util/       ./pkg/util/
+COPY ui/core/        ./ui/core/
+COPY backend/        ./backend/
+COPY gateway/        ./gateway/
+
+RUN <<'EOF' cat > go.work
+go 1.26.2
+
+use (
+	./backend
+	./gateway
+	./pkg/cronutil
+	./pkg/error
+	./pkg/geoip
+	./pkg/model
+	./pkg/postgres
+	./pkg/redisconn
+	./pkg/schema
+	./pkg/transcoder
+	./pkg/util
+	./ui/core
+)
+
+replace (
+	galaxy/cronutil v0.0.0   => ./pkg/cronutil
+	galaxy/error v0.0.0      => ./pkg/error
+	galaxy/geoip v0.0.0      => ./pkg/geoip
+	galaxy/model v0.0.0      => ./pkg/model
+	galaxy/postgres v0.0.0   => ./pkg/postgres
+	galaxy/redisconn v0.0.0  => ./pkg/redisconn
+	galaxy/schema v0.0.0     => ./pkg/schema
+	galaxy/transcoder v0.0.0 => ./pkg/transcoder
+	galaxy/util v0.0.0       => ./pkg/util
+	galaxy/core v0.0.0       => ./ui/core
+)
+EOF
+
+RUN --mount=type=cache,target=/root/.cache/go-build \
+    --mount=type=cache,target=/go/pkg/mod \
+    go build -o /out/gateway ./gateway/cmd/gateway
+
+FROM alpine:3.20 AS runtime
+
+LABEL org.opencontainers.image.title="galaxy-gateway-local-dev"
+
+RUN apk add --no-cache wget ca-certificates
+
+EXPOSE 8080
+EXPOSE 9090
+
+COPY --from=builder /out/gateway /usr/local/bin/gateway
+
+ENTRYPOINT ["/usr/local/bin/gateway"]