> ## 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, fichiers et commits

> Arborescence, formes de nommage, coquilles gelées à conserver et format des messages de commit sur argo-production.

Ce document rassemble les conventions de nommage, l'arborescence des fichiers et le format des messages de commit dans le dépôt `argo-production`. Il sert de référence pour nommer les applications, organiser les fichiers et rédiger des commits cohérents.

## Arborescence (13.1)

Les fichiers d'application et de valeurs suivent une structure hiérarchique basée sur le produit, le client et l'environnement.

```bash Arborescence theme={null}
apps/<produit>/<application>-<env>.yaml
apps/<produit>/<client>/<composant>-<env>.yaml      # multi-tenants
values/<namespace>/<application>-<env>.yaml
```

Trois formes de nommage coexistent dans le dépôt. Adoptez la première :

| Forme | Exemple | Occurrences |
| - | - | - |
| `<app>-<env>.yaml` | `api-prod.yaml` | 171 |
| `<app>-<env>-values.yaml` | `api-prod-values.yaml` | 72 |
| `<composant>-<env>.yaml` | `worker-stg.yaml` | le reste |

## Nom des Applications (13.2)

Deux ordres de segments existent pour le nom d'une Application ArgoCD. Retenez celui qui trie correctement et se lit comme le nom de fichier :

```text theme={null}
<produit>-<composant>-<env>
```

Exemple : `biolab-api-prod`, `sema-odoo-gateway-stg`.

> [!WARNING]
>
> Le nom d'une Application est le préfixe de toutes ses ressources Kubernetes. Il n'est pas librement modifiable. Pour les contraintes liées au renommage, consultez la page [Renommage](https://infra-docs.kaeyros.org/deploiement/renommage.md).

## Un fichier, une application (13.3)

24 fichiers contiennent plusieurs Applications ArgoCD séparées par `---`. Cette pratique est tolérée pour des composants indissociables (par exemple un backend et son worker déployés ensemble), mais la règle reste : **un fichier par application**.

## Coquilles gelées (13.4)

Certains chemins et labels contiennent des fautes de frappe historiques. Elles doivent être conservées telles quelles pour ne pas casser les déploiements existants.

| Chemin / Label | Coquille gelée |
| - | - |
| `apps/antid-dahboard/` | `dahboard` |
| `apps/**/booking-*-forntend-*.yaml` | `forntend` |
| `treafik.yaml` | `treafik` |
| `databases/premuim-food-*.yaml` | `premuim` |
| `values/bsl_ucb/`, `values/dina_api/`, `values/miq_api/`, `values/mira_api/`, `values/vmdo_staging/` | underscore au lieu du tiret |
| `environement` dans `podLabels` | `environement` partout |

> [!WARNING]
>
> Les corrections sont souhaitables, mais elles doivent être réalisées dans des commits dédiés, application par application, avec une fenêtre de coupure planifiée.

## Messages de commit (13.5)

Le format attendu est :

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

Exemples de commits conformes :

* `biolab: ajoute WHATSAPP_BOT_NUMBER (stg)`
* `airflow: fixe le broker-url en secret statique (prod)`
* `sema: retire l'app odoo, garde sema-odoo-gateway`

> [!NOTE]
>
> L'historique contient majoritairement des messages génériques du type `update`. La nouvelle convention ci-dessus est à généraliser progressivement.


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