Conventions de nommage complètes sur la plateforme - Documentation technique Kaeyros

Ce récapitulatif exhaustif rassemble les conventions de nommage utilisées sur la plateforme Kaeyros. Respectez ces règles pour rester cohérent avec l’existant et faciliter la navigation dans ArgoCD, Vault, le registre et les dépôts.

Conventions générales

Objet	Convention	Exemple
Application ArgoCD	`<produit>-<composant>-<env>`	`biolab-api-prod`
Fichier de values	`values/<namespace>/<app>-<env>.yaml`	`values/biolab/api-prod.yaml`
Fichier d’apps	`apps/<produit>/<app>-<env>.yaml`	`apps/biolab/biolab-api-prod.yaml`
Namespace	Nom du produit ou du client, en kebab-case	`biolab`, `booking-hospital`
Cluster PostgreSQL	`<produit><composant><env>` sans séparateur	`oimdashboardapiprod`
Pod PG	`<cluster>-0`	`oimdashboardapiprod-0`
Secret PG (Zalando)	`<user>.<cluster>.credentials.postgresql.acid.zalan.do`	`oim.oimdashboardapiprod.credentials.postgresql.acid.zalan.do`
Image ghcr.io	`ghcr.io/kaeyros-analytics-org/<image>[-<env>]`	`ghcr.io/kaeyros-analytics-org/biolab-backend-prod`
Tag image (semver)	`vX.Y.Z`	`v1.4.2`
Tag image (build)	`<env>-<short-sha>`	`dev-a3f2c1d`, `stg-a3f2c1d`
Branche Git	`develop`, `staging`, `production`, `feature/<slug>`, `fix/<slug>`	`feature/otp-refresh`
Hostname public	`<app>.<domaine-client>`	`api.exemple.com`
Secret TLS	Nom d’hôte complet	`api.exemple.com`
Suffixe env	`dev`, `stg`, `prod`	(jamais `staging` en nouveau fichier)

Préfixes et suffixes de composants

Préfixe/Suffixe	Sens
`dash`	Tableau de bord
`dash-api`	API alimentant un tableau de bord
`back`	Service métier backend
`front`	Interface utilisateur
`api`	API publique
`cron`	Traitement planifié (souvent dans le namespace `crons`)

Coquilles gelées

Certaines fautes historiques sont préservées dans les noms existants. Ne les corrigez pas lors d’une refonte ou d’une migration. Pour la liste complète, voir la page Conventions.

Format de message de commit

Les messages de commit suivent un format standard pour faciliter la lecture des historiques et le filtrage par produit :

<produit>: <action> (<env>)

Exemples :

biolab: ajoute WHATSAPP_BOT_NUMBER (stg)
airflow: fixe le broker-url en secret statique (prod)

Le produit est toujours en minuscules, l’action est une phrase courte à l’infinitif, et l’environnement est indiqué entre parenthèses à la fin.