docs: référence unique de toutes les variables d'environnement #20

Merged

kyuno merged 1 commit from docs/environment-variables into feat/merge-admin-into-web

2026-08-29 21:27:40 +02:00

kyuno commented

2026-08-29 21:22:05 +02:00

Owner

Stacked sur #18 (branché sur feat/merge-admin-into-web) — le doc décrit la surface d'env d'après #18 (admin servi en même origine, plus de ADMIN_CORS_ORIGIN / ADMIN_WEB_PORT / VITE_ADMIN_API_URL), pour rester cohérent avec les .env.example du même arbre. À retarget sur main quand #18 est mergée. Rien d'autre que de la doc.

Ce que ça ajoute

specs/environment.md — référence unique : chaque variable d'environnement de l'appli, avec

le(s) fichier(s) .env où la poser (7 fichiers : .env racine, apps/api/.env(.test), apps/web/.env, services/tech-step-intent-service/.env, services/tech-step-llm-worker/.env(.test)) ;
obligatoire / optionnel + valeur par défaut ;
qui la consomme et à quoi elle sert ;
la matrice des secrets partagés qui doivent avoir la même valeur des deux côtés (INTENT_SERVICE_SECRET, INTERNAL_WORKER_SECRET, identifiants Postgres) + les contraintes (ADMIN_JWT_SECRET ≠ JWT_SECRET, base de test ≠ base de dev…) ;
des blocs « mise en route rapide » pour les 3 workflows (dev natif / tests apps/api / Docker Compose).

Regroupé par domaine : Postgres, API (cœur / lien NLP / admin / lien worker), front, service NLP, worker LLM, Compose.

C'est un résumé des schémas de validation qui restent la source de vérité (apps/api/src/config/env.ts, services/tech-step-llm-worker/src/config.ts, tech-step-intent-service/intent_service/config.py) + les *.env.example + docker-compose.yml.

README.md — encart dans la section Installation pointant vers ce document, avec la mention que les deux services ont chacun leur propre .env à copier (absent jusqu'ici du parcours d'install).

Vérification

Doc pure, aucun code touché. Faits recoupés un par un avec les schémas Zod/pydantic et les .env.example.

🤖 Generated with Claude Code

**Stacked sur #18** (branché sur `feat/merge-admin-into-web`) — le doc décrit la surface d'env **d'après #18** (admin servi en même origine, plus de `ADMIN_CORS_ORIGIN` / `ADMIN_WEB_PORT` / `VITE_ADMIN_API_URL`), pour rester cohérent avec les `.env.example` du même arbre. À retarget sur `main` quand #18 est mergée. Rien d'autre que de la doc. ## Ce que ça ajoute **`specs/environment.md`** — référence unique : chaque variable d'environnement de l'appli, avec - le(s) fichier(s) `.env` où la poser (7 fichiers : `.env` racine, `apps/api/.env`(`.test`), `apps/web/.env`, `services/tech-step-intent-service/.env`, `services/tech-step-llm-worker/.env`(`.test`)) ; - obligatoire / optionnel + valeur par défaut ; - qui la consomme et à quoi elle sert ; - la **matrice des secrets partagés** qui doivent avoir la même valeur des deux côtés (`INTENT_SERVICE_SECRET`, `INTERNAL_WORKER_SECRET`, identifiants Postgres) + les contraintes (`ADMIN_JWT_SECRET ≠ JWT_SECRET`, base de test ≠ base de dev…) ; - des blocs « mise en route rapide » pour les 3 workflows (dev natif / tests `apps/api` / Docker Compose). Regroupé par domaine : Postgres, API (cœur / lien NLP / admin / lien worker), front, service NLP, worker LLM, Compose. C'est un **résumé** des schémas de validation qui restent la source de vérité (`apps/api/src/config/env.ts`, `services/tech-step-llm-worker/src/config.ts`, `tech-step-intent-service/intent_service/config.py`) + les `*.env.example` + `docker-compose.yml`. **`README.md`** — encart dans la section *Installation* pointant vers ce document, avec la mention que les deux services ont chacun leur propre `.env` à copier (absent jusqu'ici du parcours d'install). ## Vérification Doc pure, aucun code touché. Faits recoupés un par un avec les schémas Zod/pydantic et les `.env.example`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

kyuno added 1 commit 2026-08-29 21:22:06 +02:00

docs: reference unique de toutes les variables d'environnement

CI / lint (push) Successful in 2m17s

Details

CI / build (push) Successful in 2m48s

Details

CI / e2e (push) Failing after 15m19s

Details

CI / test (push) Failing after 22m57s

Details

CI / intent-service-test (push) Failing after 24m1s

Details

9a9401ca8d

Ajoute specs/environment.md : liste et explique chaque variable d'env de
l'appli (API, front, service NLP, worker LLM, Postgres, Compose) —
obligatoire ou non, defaut, fichier ou la poser, role, et la matrice des
secrets partages qui doivent correspondre entre deux bouts.

Resume les schemas de validation (apps/api/src/config/env.ts,
services/tech-step-llm-worker/src/config.ts,
tech-step-intent-service/config.py) qui restent la source de verite, plus
les 7 fichiers *.env.example et docker-compose.yml.

README : pointeur vers ce document depuis la section Installation, et
mention explicite des .env des deux services.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>