refactor: enhance test workflow with improved DB setup and logging

Author: azzi2023

.github/workflows/test-backend.yml

@@ -12,6 +12,10 @@ on:
 jobs:
   test-backend:
     runs-on: ubuntu-latest
+    env:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: changethis
+      POSTGRES_DB: app
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -25,13 +29,29 @@ jobs:
           version: "0.4.15"
           enable-cache: true
       - run: docker compose down -v --remove-orphans
-      - run: docker compose up -d db mailcatcher
+      - name: Build DB image
+        run: docker compose build --pull --no-cache db
+      - name: Start DB and mailcatcher
+        run: docker compose up -d db mailcatcher
+      - name: Wait for DB to be ready
+        run: |
+          echo "Waiting for PostgreSQL to accept connections..."
+          for i in $(seq 1 60); do
+            docker compose exec db pg_isready -U "${POSTGRES_USER}" -d "${POSTGRES_DB}" >/dev/null 2>&1 && { echo "DB ready"; exit 0; }
+            sleep 2
+          done
+          echo "DB did not become ready in time, printing logs:"
+          docker compose logs --no-color db || true
+          exit 1
       - name: Migrate DB
         run: docker compose run --rm prestart
       - name: Run tests
         run: uv run bash scripts/tests-start.sh "Coverage for ${{ github.sha }}"
         working-directory: backend
       - run: docker compose down -v --remove-orphans
+      - name: Print DB logs on failure
+        if: failure()
+        run: docker compose logs --no-color db || true
       - name: Store coverage files
         uses: actions/upload-artifact@v5
         with: