fix: Add DB env to integration

Signed-off-by: Alan Peixinho <alan.peixinho@profusion.mobi>

Author: alanpeixinho

.github/workflows/ci.yaml

@@ -164,7 +164,7 @@ jobs:
 
       - name: Run integration tests with coverage
         run: |
-          TEST_BASE_URL=http://localhost:8001 poetry run pytest -m "integration" --use-local-db --run-all --cov=kernelCI_app --cov=kernelCI_cache --cov-report=term-missing
+          DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m "integration" --use-local-db --run-all --cov=kernelCI_app --cov=kernelCI_cache --cov-report=term-missing
           cp .coverage coverage-integration.sqlite
         working-directory: ./backend
 

docs/IntegrationTests.md

@@ -258,7 +258,7 @@ docker compose -f docker-compose.test.yml up --build -d
 **Step 5: Run integration tests**
 ```bash
 cd backend
-TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db --run-all
+DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db --run-all
 ```
 
 **Step 6: Clean up**
@@ -275,26 +275,33 @@ The test environment uses `backend/kernelCI/test_settings.py` which:
 - Configures local PostgreSQL database
 - Sets `TEST_BASE_URL=http://localhost:8001/`
 
+Most integration tests are HTTP black-box tests against the running `test_backend`
+container, but some (e.g. management-command tests) are DB-backed and use
+`@pytest.mark.django_db` with factories. Those connect to PostgreSQL directly from
+the host, so the run commands set `DB_HOST=127.0.0.1 DB_PORT=5435` to reach the
+`test_db` container (published on port `5435`); `pytest-django` then creates its own
+isolated `test_*` database, separate from the seeded one used by the HTTP tests.
+
 ### Running Specific Tests
 
 **Run all integration tests:**
 ```bash
-TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db --run-all
+DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db --run-all
 ```
 
 **Run only a subset of tests (faster):**
 ```bash
-TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db
+DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db
 ```
 
 **Run specific test file:**
 ```bash
-TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db backend/kernelCI_app/tests/integrationTests/<your_test>.py
+DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db backend/kernelCI_app/tests/integrationTests/<your_test>.py
 ```
 
 **Run specific method:**
 ```bash
-TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db backend/kernelCI_app/tests/integrationTests/<your_test>.py::<your_function>
+DB_HOST=127.0.0.1 DB_PORT=5435 TEST_BASE_URL=http://localhost:8001 poetry run pytest -m integration --use-local-db backend/kernelCI_app/tests/integrationTests/<your_test>.py::<your_function>
 ```
 
 ### Troubleshooting