Reprise du projet
Version anglaise : en/HANDOVER.md
Commandes
make help # liste FR/EN des cibles (EAI_LOCALE=fr|en)
make install | migrate | start | stop | restart | status | logs
make docker-env | docker-check | docker-start | docker-stop | docker-status | docker-down
make <service>-start | -stop | -status | -logs
cd services/control-plane && .venv/bin/python -m pytest -q -p no:cacheprovider tests
cd services/control-plane && .venv/bin/python -m eai.api_surface
python contracts/validate.py
cd portal && npm test && npm run lint
cd navin-manager/server && python -m pytest -q tests
cd navin-manager/packaging && python -m pytest -q tests
python tools/traceability/trace.py run [E-ID ...]
python tools/traceability/trace.py build
python tools/traceability/trace.py check [--strict]
python tools/traceability/trace.py summary
Les tests navin-manager ont besoin de Go dans /tmp/toolchains (ou NM_TEST_GO). Le Docker n'est pas disponible sur ce poste : make docker-* échoue à docker-check.
Carte du dépôt
| Dossier | Rôle |
|---|---|
KIT_AGENT_PLATEFORME_IA_ENTERPRISE/ | kit : prompt maître et matrice |
catalog/ | manifestes ManagedComponent, exceptions de licence, roadmap |
contracts/ | contrats JSON Schema v1 et validate.py |
deploy/ | Helm, GitOps, compose, observabilité, politiques, Terraform |
docs/ | documentation FR et EN |
make/ | scripts des cibles make |
navin-manager/ | Platform Manager : serveur, agents, opérateur, UI, paquets |
packs/ | packs RH, Finance et modèles |
portal/ | console Next.js |
release/ | lock-manifest et SBOM |
sdks/ | SDK Python, TypeScript, Go, Java |
services/ | Control Plane FastAPI |
sql/ | migrations PostgreSQL et ClickHouse |
tools/ | outils : traçabilité, composants, émetteur de licences, fetch |
Configuration par plan
Voir le tableau des plans de ARCHITECTURE.md ; réglages EAI_* dans docs/operations/configuration.md, fichier local services/control-plane/local.env (modèle local.env.example).
Environnement local
make install crée services/control-plane/.venv, make migrate applique sql/postgres, make start lance l'API (python -m eai.main) et le worker (python -m eai.worker) ; variables dans make/backend.mk (COMPONENTS, ENV_FILE, PORT, MIGRATE=0, DB_WAIT).
Responsables (champ owner de catalog/components)
| Équipe | Manifestes |
|---|---|
| ai-platform | 16 |
| data-engineering | 32 |
| manager-team | 12 |
| multimodal | 18 |
| observability | 48 |
| platform-engineering | 42 |
| security-engineering | 48 |
Détail par composant : COMPONENTS.md.
Limites connues
Détaillées dans le document généré BLOCKERS.md.