> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Conventions de nommage complètes sur la plateforme

> Tableau de référence des conventions de nommage pour applications, namespaces, bases, secrets, images et branches.

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](https://infra-docs.kaeyros.org/operations/conventions.md).

## Format de message de commit

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

```text theme={null}
<produit>: <action> (<env>)
```

Exemples :

```text theme={null}
biolab: ajoute WHATSAPP_BOT_NUMBER (stg)
airflow: fixe le broker-url en secret statique (prod)
```

> [!NOTE]
>
> Le produit est toujours en minuscules, l'action est une phrase courte à l'infinitif, et l'environnement est indiqué entre parenthèses à la fin.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.