> ## 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.

# Modèle de branches Git chez Kaeyros

> Trois branches longue durée alignées sur les environnements : develop pour le dev, staging pour la préproduction, production pour la prod.

Kaeyros Analytics utilise un modèle de branches à trois branches longues, chacune associée à un environnement et un namespace Kubernetes. Ce modèle garantit que le code traverse des étapes de validation progressives avant d'atteindre la production.

| Branche | Environnement | Namespace K8s | Déclenche |
| - | - | - | - |
| `develop` | Développement | `*-dev` | Build image `:dev-<sha>`, déploiement auto |
| `staging` | Préproduction | `*-stg` | Build image `:stg-<sha>`, déploiement auto |
| `production` | Production | `*-prod` | Build image versionnée, déploiement canary |

## Règles de promotion

Vous devez respecter les règles suivantes pour maintenir l'intégrité du pipeline :

* On ne pousse jamais directement sur `staging` ou `production` : le passage s'effectue par Pull Request depuis `develop`.
* Le merge `develop` vers `staging` constitue une promotion en préproduction.
* Le merge `staging` vers `production` constitue une promotion en production, après validation.
* Les branches de feature naissent de `develop` et y retournent par Pull Request.

## Diagramme du flux de branches

```mermaid theme={null}
gitGraph
   commit id: "init"
   branch develop
   checkout develop
   commit id: "feat A"
   commit id: "feat B"
   branch staging
   checkout staging
   commit id: "promote" tag: "stg-release"
   branch production
   checkout production
   commit id: "promote" tag: "prod-release"
```

> [!NOTE]
>
> Les tags `stg-release` et `prod-release` sont des marqueurs logiques : les vrais tags d'image sont générés par GitHub Actions et suivis par argocd-image-updater.


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