test: add unit test suite for config, health checks, and lifespan wiring

tests/unit/bootstrap/test_lifespan.py

@@ -0,0 +1,19 @@
+import pytest
+from fastapi import FastAPI
+from httpx import AsyncClient
+
+from src.config import Settings
+
+pytestmark = [pytest.mark.unit, pytest.mark.asyncio]
+
+
+async def test_lifespan_starts_and_stops_without_docker(client: AsyncClient) -> None:
+    response = await client.get("/healthz")
+    assert response.status_code == 200
+
+
+async def test_lifespan_binds_resources_to_app_state(app: FastAPI, client: AsyncClient) -> None:
+    await client.get("/healthz")
+    resources = app.state.resources
+    assert isinstance(resources.settings, Settings)
+    assert resources.minio_client is not None

tests/unit/test_config.py

@@ -0,0 +1,27 @@
+from pathlib import Path
+
+import pytest
+
+from src.config import Settings
+
+pytestmark = pytest.mark.unit
+
+
+def test_settings_loads_defaults_without_env_file() -> None:
+    settings = Settings(_env_file=None)
+
+    assert settings.postgres.port == 5433
+    assert settings.minio.bucket == "chatbot-source-files"
+    assert settings.ingestion.max_concurrency == 4
+    assert settings.qdrant.url == "http://127.0.0.1:6343"
+
+
+def test_settings_parses_env_example() -> None:
+    env_example = Path(__file__).parent.parent.parent / ".env.example"
+
+    settings = Settings(_env_file=env_example)
+
+    assert settings.postgres.host == "127.0.0.1"
+    assert settings.minio.endpoint == "127.0.0.1:9100"
+    assert settings.ingestion.embed_batch_size == 128
+    assert settings.qdrant.api_key is None

tests/unit/test_healthz.py

@@ -0,0 +1,11 @@
+import pytest
+from httpx import AsyncClient
+
+pytestmark = [pytest.mark.unit, pytest.mark.asyncio]
+
+
+async def test_healthz_returns_ok_status(client: AsyncClient) -> None:
+    response = await client.get("/healthz")
+
+    assert response.status_code == 200
+    assert response.json() == {"status": "ok"}

tests/unit/test_readyz.py

@@ -0,0 +1,17 @@
+import pytest
+from httpx import AsyncClient
+
+pytestmark = [pytest.mark.unit, pytest.mark.asyncio]
+
+
+async def test_readyz_reports_all_dependencies_not_ready_without_docker(
+    client: AsyncClient,
+) -> None:
+    response = await client.get("/readyz")
+
+    assert response.status_code == 503
+    assert response.json() == {
+        "postgres": False,
+        "minio": False,
+        "qdrant": False,
+    }