fix(db): let Flyway own full DB lifecycle on fresh installs (#130)

baseline-on-migrate=true with baseline-version=3 caused Flyway to mark
an empty database as already at V3 (due to its own schema_history table
creation), skipping all migrations and leaving no players table. Remove
the baseline settings so Flyway runs V1→V2→V3 normally on first start.

Remove the pre-seeded storage/players-sqlite3.db from version control
and the Dockerfile COPY ./hold/ layer — Flyway now creates the database
and seeds all 26 players automatically. Add storage/.gitkeep and ignore
storage/*.db. Update README accordingly.

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

Author: nanotaboada

.gitignore

@@ -1,6 +1,7 @@
 HELP.md
 .claude/settings.local.json
 target/
+storage/*.db
 !.mvn/wrapper/maven-wrapper.jar
 !**/src/main/**/target/
 !**/src/test/**/target/

Dockerfile

@@ -44,11 +44,6 @@ COPY --chmod=444        README.md                   ./
 COPY --chmod=555        scripts/entrypoint.sh       ./entrypoint.sh
 COPY --chmod=555        scripts/healthcheck.sh      ./healthcheck.sh
 
-# The 'hold' is our storage compartment within the image. Here, we copy a
-# pre-seeded SQLite database file, which Compose will mount as a persistent
-# 'storage' volume when the container starts up.
-COPY --chmod=555        storage/                    ./hold/
-
 # Install SQLite runtime libs, add non-root user and prepare volume mount point
 RUN apk add --no-cache sqlite-libs && \
     addgroup -S spring && \

README.md

@@ -289,6 +289,10 @@ V{version}__{description}.sql
 
 All migration SQL is written to be compatible with both **SQLite** (local dev) and **PostgreSQL** (see #286).
 
+### First start
+
+On first run, Flyway detects an empty database and applies V1 → V2 → V3 in sequence, creating the `players` table and seeding all 26 players. The database file (`storage/players-sqlite3.db`) is created automatically and is excluded from version control.
+
 ### Adding a new migration
 
 Create a new file in `src/main/resources/db/migration/` with the next version number:
@@ -299,13 +303,9 @@ touch src/main/resources/db/migration/V4__Add_nationality_column.sql
 
 Flyway applies it automatically on the next application startup. View the applied history by querying the `flyway_schema_history` table.
 
-### Existing databases
-
-`baseline-on-migrate=true` ensures that databases created before Flyway was introduced are recognised as already at `V3` (schema + full seed data), so no migrations run against them. Fresh databases (new file) run V1 → V2 → V3 from scratch.
-
 ### Reset local database
 
-Delete the SQLite file and restart the application — Flyway recreates the schema and seed data automatically:
+Delete the SQLite file and restart — Flyway recreates the schema and seed data from scratch:
 
 ```bash
 rm storage/players-sqlite3.db

scripts/entrypoint.sh

@@ -22,7 +22,7 @@ fi
 
 log "✔ Ready!"
 log "🚀 Launching app..."
-log "🔌 API endpoints | http://localhost:9000"
-log "📚 Swagger UI    | http://localhost:9000/swagger/index.html"
-log "❤️  Health check  | http://localhost:9001/actuator/health"
+log "🔌 API endpoints   | http://localhost:9000"
+log "📚 Swagger UI      | http://localhost:9000/swagger/index.html"
+log "❤️ Health check    | http://localhost:9001/actuator/health"
 exec "$@"

src/main/resources/application.properties

@@ -27,11 +27,6 @@ spring.jpa.properties.hibernate.format_sql=true
 
 # Flyway Database Migration Configuration
 # Flyway manages all schema creation and seed data via versioned SQL migrations.
-# baseline-on-migrate: treats an existing database (without flyway_schema_history)
-#   as already at baseline-version, avoiding re-running migrations on pre-seeded DBs.
-# baseline-version=3: baselines existing databases at V3 (schema + all seed data
-#   already applied), while fresh databases run V1 → V2 → V3 from scratch.
+# On first start, Flyway creates the database and runs V1 → V2 → V3 in order.
 spring.flyway.enabled=true
 spring.flyway.locations=classpath:db/migration
-spring.flyway.baseline-on-migrate=true
-spring.flyway.baseline-version=3