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

# Documentation technique Kaeyros : accueil pour l'équipe

> Point d'entrée de la documentation technique interne Kaeyros : plateforme, provisionnement, CI/CD, sécurité, opérations et référence.

Bienvenue dans la documentation technique interne de Kaeyros Analytics. Ce site explique comment fonctionne la plateforme, comment on la provisionne, comment on y déploie, comment on la sécurise et comment on y travaille au quotidien. Il complète les documents du dépôt `argo-production` (référence détaillée) et n'exige aucune connaissance préalable de nos outils, seulement des bases en conteneurs et en HTTP.

> [!NOTE]
>
> Version 2.0, 30 août 2026. Public : toute personne rejoignant l'équipe technique (développement, data, infrastructure). Contact documentation: [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com).

## Par où commencer

> **[Jour 1 : Comprendre](https://infra-docs.kaeyros.org/comprendre/kaeyros-et-sa-plateforme.md)**
>
> L'entreprise, le vocabulaire maison, la forme générale de la plateforme.

> **[Première semaine : Se repérer](https://infra-docs.kaeyros.org/infrastructure/materiel-fournisseurs.md)**
>
> Où tournent les choses, comment un déploiement se produit, obtenir vos accès.

> **[Premier mois : Autonomie](https://infra-docs.kaeyros.org/operations/deployer-version.md)**
>
> Les tâches courantes, les pièges à connaître, les chantiers ouverts.

> **[Quickstart](https://infra-docs.kaeyros.org/quickstart.md)**
>
> Les accès à demander, les outils à installer, les premières commandes.

## Les grandes sections

> **[Infrastructure](https://infra-docs.kaeyros.org/infrastructure/materiel-fournisseurs.md)**
>
> 11 serveurs Hetzner, un cluster RKE2 à Helsinki, AWS, Cloudflare, Namecheap.

> **[Provisionnement](https://infra-docs.kaeyros.org/provisionnement/ansible-principe.md)**
>
> Ansible et durcissement des serveurs : SSH, UFW, fail2ban, ClamAV, audit.

> **[CI/CD](https://infra-docs.kaeyros.org/cicd/branches.md)**
>
> Branches develop / staging / production, pipelines GitHub Actions, Dockerfiles.

> **[Déploiement](https://infra-docs.kaeyros.org/deploiement/gitops-principe.md)**
>
> GitOps, ArgoCD, charts Helm internes, canary Argo Rollouts.

> **[Sécurité](https://infra-docs.kaeyros.org/securite/coffres.md)**
>
> Vault, Passbolt, RBAC, gates de pentest, Wazuh, teler, NeuVector.

> **[Services internes](https://infra-docs.kaeyros.org/services/serveur-outillage.md)**
>
> Outillage docker compose, observabilité, surveillance, catalogue applicatif.

> **[Opérations](https://infra-docs.kaeyros.org/operations/deployer-version.md)**
>
> Conventions, tâches courantes, pièges, chantiers, contacts.

> **[Annexes](https://infra-docs.kaeyros.org/annexes/aide-memoire.md)**
>
> Aide-mémoire des commandes, index des namespaces, URLs, glossaire.

## Ce que ce site apporte

**1. La couche matérielle et le cluster**

Serveurs Hetzner, load balancers, stockage objet, cluster RKE2, socle partagé Kubernetes.

**2. Le provisionnement**

Le rôle d'Ansible dans notre stack : bootstrap serveur, hardening SSH, pare-feu, détection d'intrusion.

**3. Le cycle complet CI/CD à GitOps**

Du push d'un développeur jusqu'au trafic canary, en passant par les gates de sécurité.

**4. La sécurité en profondeur**

Cinq coffres de secrets, RBAC à toutes les couches, processus de pentest et outillage.

**5. La surveillance**

Chaînes de métriques et de journaux, alerting, checklist quotidienne d'astreinte à 5h30.

**6. Une progression pédagogique**

Vocabulaire, exemples, gabarits, pièges connus et chantiers ouverts au 30 août 2026.

## Documents de référence complémentaires

Le dépôt `argo-production` contient la documentation de détail. Consultez-la en parallèle :

| Document | Ce qu'il couvre |
| - | - |
| `docs/architecture.md` | La chaîne GitOps, le pattern app-of-apps, l'anatomie d'une Application |
| `docs/charts.md` | Les neuf charts Helm internes, leurs valeurs, leurs différences |
| `docs/conventions.md` | Les règles de nommage et d'arborescence |
| `docs/operations.md` | Les procédures d'exploitation applicative |
| `docs/etat-des-lieux.md` | L'inventaire des dettes techniques connues |

## Signaler un point à compléter

Certains passages sont marqués `(à compléter)` : ce sont des trous connus. Quand vous en trouvez la réponse, envoyez-la à [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com). Ce document est fait pour être mis à jour.


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