chore: make compose ports configurable

apps/api/Dockerfile

@@ -35,8 +35,8 @@ ENV STORAGE_DIR=/app/storage
 
 RUN mkdir -p /app/storage && chown node:node /app/storage
 
-# Standalone output does not include public/ or static/; both are required for
-# the UI (design CSS, fonts, emblem) and must be copied explicitly.
+# Standalone output does not include public/ or .next/static; the UI needs both
+# (client bundles, stylesheets, images), so they are copied explicitly.
 COPY --from=build --chown=node:node /repo/apps/api/.next/standalone/ ./
 COPY --from=build --chown=node:node /repo/apps/api/.next/static ./apps/api/.next/static
 COPY --from=build --chown=node:node /repo/apps/api/public ./apps/api/public

compose.yaml

@@ -7,8 +7,9 @@ services:
       POSTGRES_USER: refined
       POSTGRES_PASSWORD: refined
       POSTGRES_DB: refined
+    # Override the host ports with DB_PORT / API_PORT when they are taken.
     ports:
-      - "127.0.0.1:5432:5432"
+      - "127.0.0.1:${DB_PORT:-5432}:5432"
     volumes:
       - gov-portal-pgdata:/var/lib/postgresql/data
     healthcheck:
@@ -28,15 +29,17 @@ services:
       DATABASE_URL: postgres://refined:refined@db:5432/refined
       STORAGE_DIR: /app/storage
     ports:
-      - "127.0.0.1:3000:3000"
+      - "127.0.0.1:${API_PORT:-3000}:3000"
     volumes:
       - gov-portal-avatars:/app/storage
     depends_on:
       migrate:
         condition: service_completed_successfully
 
   # Gate API startup on a successful schema migration. This is safe to rerun:
-  # Drizzle records applied migrations in the database.
+  # Drizzle records applied migrations in the database. The image also carries
+  # the repository scripts, so it runs one-off tasks too:
+  #   docker compose run --rm migrate bun run db:init
   migrate:
     build:
       context: .