Thème
Paramètres plateforme
Objectif
Les paramètres plateforme exposent des réglages runtime administrables (overrides IA/RAG, options diverses) avec hot-reload — modifiables sans redéploiement par un administrateur.
Qui l'utilise
Tenant Admin, platform admin.
| Action | Permission RBAC |
|---|---|
| Lire les paramètres | platform:settings:read |
| Modifier les paramètres | platform:settings:write |
Prérequis
- Données de coût ingérées — voir Ingest & mapping.
- Permission de lecture correspondante (voir ci-dessus).
Accès
- Menu : Administration → Platform settings
- URL :
/admin/settings
Éléments de l'interface
- Panneau de réglages clés/valeurs (SETTING_SPECS).
- Overrides IA / RAG (provider LLM, activation RAG).
- Application hot-reload (mutation du singleton Settings).
- API
GET/PUT /platform/settings.
Workflow pas à pas
- Ouvrez Administration → Platform settings.
- Modifiez la clé souhaitée (ex. provider LLM).
- Enregistrez : la valeur est prise en compte à chaud.
- Vérifiez l'effet dans Santé plateforme.
Bonnes pratiques FinOps
- Documentez tout override (raison, date) — les réglages runtime priment sur l'
.env. - Testez un changement IA/RAG hors heures de pointe.
Limitations & disclaimers
- Réservé aux admins ; certaines clés impactent le coût (LLM) — changez en connaissance de cause.
- La table de settings est sans RLS par design (config plateforme, pas donnée tenant).
- 🔒 Vous ne voyez que les données de votre tenant et de votre périmètre cost center (voir IAM/RBAC).
Dépannage
| Symptôme | Cause probable | Résolution |
|---|---|---|
| Changement sans effet | Cache/clé non reconnue | Vérifier la clé dans SETTING_SPECS ; recharger |
| Accès refusé | Permission manquante | Demander platform:settings:write |