feat: Refactor database configuration to use granular environment variables; update Docker and CI/CD workflows accordingly

docs/quickstart.md

@@ -34,7 +34,15 @@ docker build -t calminer:latest .
 docker run --rm -p 8000:8000 calminer:latest
 
 # Supply environment variables (e.g., Postgres connection)
-docker run --rm -p 8000:8000 -e DATABASE_URL="postgresql://user:pass@host/db" calminer:latest
+docker run --rm -p 8000:8000 ^
+  -e DATABASE_DRIVER="postgresql" ^
+  -e DATABASE_HOST="db.host" ^
+  -e DATABASE_PORT="5432" ^
+  -e DATABASE_USER="calminer" ^
+  -e DATABASE_PASSWORD="s3cret" ^
+  -e DATABASE_NAME="calminer" ^
+  -e DATABASE_SCHEMA="public" ^
+  calminer:latest
 ```
 
 If you maintain a Postgres or Redis dependency locally, consider authoring a `docker compose` stack that pairs them with the app container. The Docker image expects the database to be reachable and migrations executed before serving traffic.
@@ -66,15 +74,23 @@ The project includes a referential `currency` table and migration/backfill tooli
 
 ### Run migrations and backfill (development)
 
-Ensure `DATABASE_URL` is set in your PowerShell session to point at a development Postgres instance.
+Configure the granular database settings in your PowerShell session before running migrations.
 
 ```powershell
-$env:DATABASE_URL = 'postgresql://user:pass@host/db'
+$env:DATABASE_DRIVER = 'postgresql'
+$env:DATABASE_HOST = 'localhost'
+$env:DATABASE_PORT = '5432'
+$env:DATABASE_USER = 'calminer'
+$env:DATABASE_PASSWORD = 's3cret'
+$env:DATABASE_NAME = 'calminer'
+$env:DATABASE_SCHEMA = 'public'
 python scripts/run_migrations.py
 python scripts/backfill_currency.py --dry-run
 python scripts/backfill_currency.py --create-missing
 ```
 
+> ℹ️ The application still accepts `DATABASE_URL` as a fallback if the granular variables are not set.
+
 Use `--dry-run` first to verify what will change.
 
 ## Database Objects
@@ -91,10 +107,10 @@ The database contains tables such as `capex`, `opex`, `chemical_consumption`, `f
 
 ## Where to look next
 
-- Architecture overview & chapters: [architecture](docs/architecture/README.md) (per-chapter files under `docs/architecture/`)
-- [Testing & CI](docs/architecture/14_testing_ci.md)
-- [Development setup](docs/architecture/15_development_setup.md)
-- Implementation plan & roadmap: [Solution strategy](docs/architecture/04_solution_strategy_extended.md)
-- Routes: [routes](routes/)
-- Services: [services](services/)
-- Scripts: [scripts](scripts/) (migrations and backfills)
+- Architecture overview & chapters: [architecture](architecture/README.md) (per-chapter files under `docs/architecture/`)
+- [Testing & CI](architecture/14_testing_ci.md)
+- [Development setup](architecture/15_development_setup.md)
+- Implementation plan & roadmap: [Solution strategy](architecture/04_solution_strategy.md)
+- Routes: [routes](../routes/)
+- Services: [services](../services/)
+- Scripts: [scripts](../scripts/) (migrations and backfills)