chore: one-command local dev stack startup with healthcheck wait #638
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Context
Three review rounds on PR #629 cited "dev stack wasn't up" as the reason manual UI verification (320 px viewport check, 7-item test plan, screen-reader spot-check) was deferred. A one-command local stack with healthcheck-blocking startup removes this paper cut and unblocks the manual checklist for future PRs.
Reviewer rationale: Tobi #10924, #10956, #11054 on PR #629.
Required
Makefiletargetmake devor a wrapper script (scripts/dev.sh) that runs:docker compose up -d --wait— blocks until all healthchecks pass.cd frontend && npm run dev— backgrounded.cd backend && ./mvnw spring-boot:run— backgrounded.docker-compose.yml..devcontainer/README.mdupdated if relevant.Optional companions
make down— bring the stack down cleanly.make logs— tail backend + frontend + key Compose service logs.make verify— runsdocker compose psand exits non-zero if any service is unhealthy (useful in CI smoke-test if ever wanted).Acceptance
make dev(or equivalent) brings backend, MinIO, Postgres up and waits for healthchecks..devcontainer/README.mdupdated where applicable.docker,node, andmvn/SDKMAN installed,make dev(or the equivalent wrapper) once,curl -fsS http://localhost:5173andcurl -fsS http://localhost:8080/actuator/healthreturn HTTP 200 without further intervention, anddocker compose psreports all services ashealthy.Out of scope
./mvnw spring-boot:run/npm run dev) — those stay as escape hatches.Reviewer rationale: original Tobi sequence; AC-5 Given-When-Then refinement per Elicit on PR #629 round 4 (#11147).