Démarrer le module en local¶

À la fin de ce tutoriel : ActuaryLab tourne en local, on franchit la chaîne SSO et on voit le /dashboard scopé au tenant.

Pré-requis

ActuaryLab a besoin d'un socle Quantis joignable pour vérifier les tokens SSO (endpoint POST /api/v1/beta/sso/verify/). En dev, on l'atteint sur l'hôte.

Option A — tout-en-un (Docker Compose)¶

docker compose -f docker-compose.dev.yml up --build
#   backend  → http://localhost:8001   (SSO Consumer + /api/me)
#   frontend → http://localhost:3001   (dashboard, garde de session)
#   docs     → http://localhost:8002   (cette documentation, rechargement à chaud)

Option B — backend seul, sans Docker¶

cd backend && python3 -m venv .venv && . .venv/bin/activate
pip install -r requirements.txt
ACTUARYLAB_QUANTIS_VERIFY_URL=http://localhost:8000/api/v1/beta/sso/verify/ \
  uvicorn app.main:app --reload --port 8001

Vérifier le critère de sortie¶

Lancer Quantis, puis /sso/login → cookie de session → /dashboard :

QUANTIS=http://localhost:8000 ACTUARYLAB=http://localhost:8001 ./scripts/smoke_test.sh

Prévisualiser cette documentation seule¶

Sans Docker, pour itérer sur la doc :

pip install -r requirements-docs.txt
mkdocs serve        # http://127.0.0.1:8000, rechargement à chaud

→ Ensuite : Lancer les tests ou Déployer.