feat(backend): initialisation du projet FastAPI

Structure en couches api / services / repositories / models, sens de
dependance unique, une session SQLAlchemy async injectee par dependance.

- Python 3.14, dependances gerees par uv et verrouillees dans uv.lock
- FastAPI expose par une factory : aucune configuration lue a l'import,
  ce qui rend tests et migrations independants de l'environnement
- Settings Pydantic, APP_SECRET_KEY et DATABASE_URL sans valeur par defaut
- Sondes /health/live et /health/ready, metriques Prometheus sur /metrics
- Lint et format ruff, mypy strict, pytest avec couverture
- Alembic branche sur DATABASE_URL et non sur alembic.ini
- Image Docker multi-stage, utilisateur non root, sonde de sante integree

apps/backend/app/api/deps.py

@@ -0,0 +1,10 @@
+from typing import Annotated
+
+from fastapi import Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from app.core.config import Settings, get_settings
+from app.db.session import get_session
+
+SessionDep = Annotated[AsyncSession, Depends(get_session)]
+SettingsDep = Annotated[Settings, Depends(get_settings)]

apps/backend/app/api/v1/endpoints/health.py

@@ -0,0 +1,33 @@
+from fastapi import APIRouter, HTTPException, status
+from sqlalchemy import text
+from sqlalchemy.exc import SQLAlchemyError
+
+from app.api.deps import SessionDep, SettingsDep
+from app.core.logging import get_logger
+from app.schemas.health import LivenessStatus, ReadinessStatus
+
+logger = get_logger(__name__)
+router = APIRouter(tags=["health"])
+
+
+@router.get("/live", summary="Sonde de vivacite")
+async def liveness(settings: SettingsDep) -> LivenessStatus:
+    return LivenessStatus(
+        status="ok",
+        service=settings.name,
+        version=settings.version,
+        environment=settings.env,
+    )
+
+
+@router.get("/ready", summary="Sonde de disponibilite")
+async def readiness(session: SessionDep) -> ReadinessStatus:
+    try:
+        await session.execute(text("SELECT 1"))
+    except SQLAlchemyError, OSError:
+        logger.exception("Base de donnees injoignable")
+        raise HTTPException(
+            status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
+            detail="Base de donnees injoignable",
+        ) from None
+    return ReadinessStatus(status="ready", database="reachable")

apps/backend/app/api/v1/router.py

@@ -0,0 +1,6 @@
+from fastapi import APIRouter
+
+from app.api.v1.endpoints import health
+
+api_router = APIRouter()
+api_router.include_router(health.router, prefix="/health")