[ShaunSHamilton]

Summary

One command per slice of the platform, with dependencies, migrations and local S3, in Docker:

bun run dev edd        # eDd + eDb + SeaweedFS, migrated; attached, Ctrl-C stops
bun run dev -d edd     # background, returns once ready; stop with `bun run dev down`
bun run dev edd wapp   # combine slices
bun run dev logs edd | ps | down | reset | compose <args>

Slices: edb, cdb, s3, edd, aapi, wapp, all.

• compose.dev.yaml: databases extends their own compose.yaml; apps are defined there so a slice never needs another app's required vars. One-shots create cDb's curriculum database, the S3 bucket, and run edb-migrate / cdb-migrate. Apps start after them (service_completed_successfully).
• Attached (default), like docker compose up: follows logs of the slice's own long-running services; Ctrl-C stops the slice and every service it depends on (passed explicitly, since attached up only stops the services it is given).
• -d, like docker compose up -d: one-shots (restart: "no") must exit 0, then long-running services must be healthy. Not up --wait alone: it fails on a one-shot that has already exited, and returns before a slow one finishes.
• SeaweedFS on s3.localhost:18333: a network alias inside Docker and loopback in browsers, so presigned URLs work from both. Dev-only keys in dev/seaweedfs-s3.json.
• eDd builds with CARGO_PROFILE=dev and runs with MOCK_AUTH=true, so no OAuth credentials: log in through POST /auth/dev/login. eDd does not use cDb, so edd does not start it; all does.
• apps/examiner-dashboard/Dockerfile: new CARGO_PROFILE arg, default release. Deploy builds unchanged.
• dev/dev.ts: creates missing databases/*/.env with random passwords, passes them to compose. compose <args> passes arguments through unchanged.
• package.json: dev now runs slices; previous dev (wApp + eDd client HMR) is dev:client.
• Docs: CONTRIBUTING "Run", README cheatsheet, eDd S3 note.

Notes

• Uses the same host ports as the per-directory compose projects: stop those first. Volumes are separate (project exam-platform-dev).
• Code changes need the slice run again (rebuild). bun run dev:client alongside edd gives client HMR.
• Volumes migrated before feat(eDd): add s3 object store + test page #38 renamed cDb migration 0002 fail migrate-cdb ("previously applied but has been modified"): bun run dev reset.

Test plan

• compose.dev.yaml config resolves
• bun run dev s3: Ctrl-C stops s3-init and s3, command returns after they stop
• bun run dev -d s3: returns after s3-init exits 0
• bun run dev -d cdb on fresh volumes: curriculum-db-init, migrate-cdb exit 0, returns 0; on stale volume reports failed: migrate-cdb, exits 1
• bun run dev compose up -d s3 detaches
• bun run dev edd after rebase onto feat(eDd): add s3 object store + test page #38: dev login, upload to /api/objects, presigned URL fetch
• edb / aapi / wapp slices
• Google login with real GOOGLE_* in the app .env

🤖 Generated with Claude Code