♻️ Run database setup explicitly before startup (#2426)

## AI Disclaimer

Using Codex with gpt-5.6-sol. Reviewed manually.

.github/workflows/deploy-production.yml

@@ -33,4 +33,5 @@ jobs:
         with:
           persist-credentials: false
       - run: docker compose -f compose.yml -f compose.deploy.yml build
+      - run: docker compose -f compose.yml -f compose.deploy.yml run --rm backend bash scripts/prestart.sh
       - run: docker compose -f compose.yml -f compose.deploy.yml up -d

.github/workflows/deploy-staging.yml

@@ -33,4 +33,5 @@ jobs:
         with:
           persist-credentials: false
       - run: docker compose -f compose.yml -f compose.deploy.yml build
+      - run: docker compose -f compose.yml -f compose.deploy.yml run --rm backend bash scripts/prestart.sh
       - run: docker compose -f compose.yml -f compose.deploy.yml up -d

.github/workflows/playwright.yml

@@ -78,6 +78,7 @@ jobs:
     - run: bash scripts/generate-client.sh
     - run: docker compose build
     - run: docker compose down -v --remove-orphans
+    - run: docker compose run --rm backend bash scripts/prestart.sh
     - name: Run Playwright tests
       run: docker compose run --rm playwright bunx playwright test --fail-on-flaky-tests --trace=retain-on-failure --shard=${{ matrix.shardIndex }}/${{ matrix.shardTotal }}
     - run: docker compose down -v --remove-orphans

.github/workflows/test-docker-compose.yml

@@ -20,6 +20,7 @@ jobs:
           persist-credentials: false
       - run: docker compose build
       - run: docker compose down -v --remove-orphans
+      - run: docker compose run --rm backend bash scripts/prestart.sh
       - run: docker compose up -d --wait backend adminer
       - name: Test backend is up
         run: curl http://localhost:8000/api/v1/utils/health-check

backend/README.md

@@ -42,6 +42,7 @@ The setup is also already configured so you can run the tests through the VS Cod
 To run the backend and built frontend in Docker Compose:
 
 ```console
+$ docker compose run --rm backend bash scripts/prestart.sh
 $ docker compose watch
 ```
 

compose.deploy.yml

@@ -44,10 +44,6 @@ services:
       # Use the Let's Encrypt resolver
       - traefik.http.routers.adminer-https.tls.certresolver=le
 
-  prestart:
-    environment:
-      FRONTEND_HOST: https://${DOMAIN:?Variable not set}
-
   backend:
     restart: always
     environment:

compose.override.yml

@@ -72,10 +72,6 @@ services:
       SMTP_PORT: "1025"
       SMTP_TLS: "false"
 
-  prestart:
-    environment:
-      ENVIRONMENT: "local"
-
   mailcatcher:
     image: schickling/mailcatcher
     ports:

compose.yml

@@ -53,10 +53,7 @@ services:
       db:
         condition: service_healthy
         restart: true
-      prestart:
+    environment:
-        condition: service_completed_successfully
-    # The YAML anchor lets the prestart service reuse this environment mapping.
-    environment: &backend-environment
       PROJECT_NAME: ${PROJECT_NAME:?Variable not set}
       BACKEND_CORS_ORIGINS: ${BACKEND_CORS_ORIGINS:-}
       SECRET_KEY: ${SECRET_KEY:?Variable not set}
@@ -92,17 +89,5 @@ services:
       - traefik.http.routers.backend-http.rule=Host(`${DOMAIN:-localhost}`)
       - traefik.http.routers.backend-http.entrypoints=http
 
-  prestart:
-    image: backend:latest
-    build:
-      context: .
-      dockerfile: backend/Dockerfile
-    depends_on:
-      db:
-        condition: service_healthy
-        restart: true
-    command: bash scripts/prestart.sh
-    environment: *backend-environment
-
 volumes:
   app-db-data:

deployment.md

@@ -99,6 +99,7 @@ With the environment variables in place, you can deploy with Docker Compose:
 ```bash
 cd /root/code/app/
 docker compose -f compose.yml -f compose.deploy.yml build
+docker compose -f compose.yml -f compose.deploy.yml run --rm backend bash scripts/prestart.sh
 docker compose -f compose.yml -f compose.deploy.yml up -d
 ```
 

development.md

@@ -57,6 +57,7 @@ The build is written to `backend/app/frontend` and served by FastAPI at <http://
 To run the backend and built frontend in Docker Compose:
 
 ```bash
+docker compose run --rm backend bash scripts/prestart.sh
 docker compose watch
 ```
 

frontend/README.md

@@ -15,9 +15,9 @@ bun run dev
 
 * Then open your browser at http://localhost:5173/.
 
-Run the backend locally with `uv run fastapi dev` and PostgreSQL in Docker Compose. See [../development.md](../development.md) for the complete setup.
+Run `uv run bash scripts/prestart.sh` and `uv run fastapi dev` from the `backend` directory, with PostgreSQL running in Docker Compose. See [../development.md](../development.md) for the complete setup.
 
-To serve the frontend with FastAPI, run `bun run build` from the `frontend` directory and open `http://localhost:8000`. To run the full stack with Docker Compose, use `docker compose watch`.
+To serve the frontend with FastAPI, run `bun run build` from the `frontend` directory and open `http://localhost:8000`.
 
 Check the file `package.json` to see other available options.
 
@@ -89,6 +89,7 @@ The frontend code is structured as follows:
 The frontend includes initial end-to-end tests using Playwright. To run the tests, you need to have the Docker Compose stack running. Start the stack with the following command:
 
 ```bash
+docker compose run --rm backend bash scripts/prestart.sh
 docker compose up -d --wait backend
 ```
 

scripts/test-local.sh

@@ -11,5 +11,6 @@ if [ $(uname -s) = "Linux" ]; then
 fi
 
 docker-compose build
+docker-compose run --rm backend bash scripts/prestart.sh
 docker-compose up -d
 docker-compose exec -T backend bash scripts/tests-start.sh "$@"

scripts/test.sh

@@ -6,6 +6,7 @@ set -x
 
 docker compose build
 docker compose down -v --remove-orphans # Remove possibly previous broken stacks left hanging after an error
+docker compose run --rm backend bash scripts/prestart.sh
 docker compose up -d
 docker compose exec -T backend bash scripts/tests-start.sh "$@"
 docker compose down -v --remove-orphans