refactor(scripts): add log helper, volume file check, API addresses (#2)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: nanotaboada

CHANGELOG.md

@@ -77,8 +77,9 @@ This project uses famous football coaches as release codenames, following an A-Z
   only (#2)
 - `Dockerfile`: removed `COPY storage/ ./hold/` and its associated comment;
   added `COPY alembic.ini` and `COPY alembic/` (#2)
-- `scripts/entrypoint.sh`: runs `alembic upgrade head` before launching the
-  app; replaces hold→volume copy and manual seed script pattern (#2)
+- `scripts/entrypoint.sh`: checks for an existing database file in the Docker
+  volume; runs `alembic upgrade head` only on first start; adds structured
+  `log()` helper with timestamps, emojis, and API/Swagger UI addresses (#2)
 - `compose.yaml`: replaced `STORAGE_PATH` with `DATABASE_URL` pointing to the
   SQLite volume path (#2)
 - `.gitignore`: added `*.db`; `storage/players-sqlite3.db` removed from git

compose.yaml

@@ -11,6 +11,7 @@ services:
       - storage:/storage/
     environment:
       - PYTHONUNBUFFERED=1
+      - STORAGE_PATH=/storage/players-sqlite3.db
       - DATABASE_URL=sqlite+aiosqlite:////storage/players-sqlite3.db
     restart: unless-stopped
 

scripts/entrypoint.sh

@@ -1,9 +1,29 @@
-#!/bin/bash
+#!/bin/sh
 set -e
 
-echo "Starting container..."
-echo "Applying database migrations..."
-alembic upgrade head
-echo "Database migrations applied."
-echo "Launching app..."
+# Helper function for formatted logging
+log() {
+    echo "[ENTRYPOINT] $(date '+%Y/%m/%d - %H:%M:%S') | $1"
+    return 0
+}
+
+STORAGE_PATH="${STORAGE_PATH:-/storage/players-sqlite3.db}"
+
+log "✔ Starting container..."
+
+mkdir -p "$(dirname "$STORAGE_PATH")"
+
+if [ ! -f "$STORAGE_PATH" ]; then
+    log "⚠️ No existing database file found in volume."
+    log "🗄️ Applying Alembic migrations to initialize the database..."
+    alembic upgrade head
+    log "✔ Migrations applied."
+else
+    log "✔ Existing database file found at $STORAGE_PATH."
+fi
+
+log "✔ Ready!"
+log "🚀 Launching app..."
+log "🔌 API endpoints | http://localhost:9000"
+log "📚 Swagger UI    | http://localhost:9000/docs"
 exec "$@"