Process de livraison Telaria
Principe fondateur : aucun contact avec les devs sans spec complète. On applique strictement, on améliore par la pratique. "Increment is the key."
Ce process s'applique à toutes les instances de l'écosystème (Lead Tech Telaria, Lead Tech Adoption, Rédacteur web) pour toute livraison de fonctionnalité, correction ou évolution documentaire significative.
Nomenclature des environnements
| Nom | Machine | Usage |
|---|---|---|
local (zeus) |
Windows Mathieu — C:\src\* |
Code + tests unitaires uniquement |
dev |
poseidon — LAN 192.168.1.50:9501 | Développement + premiers tests fonctionnels |
staging |
telaria-dev / adoption-dev (VPS OVH) | Intégration avant prod — validation navigateur externe obligatoire |
production |
telaria-fr / adoption-fr + madrien.fr / mathieuadrien.fr (VPS OVH) | Livraison uniquement — Chef ou Mathieu |
Termes abandonnés : "preprod" (remplacé par
devoustagingselon le contexte).
Les 11 étapes
| # | Étape | Responsable | Condition bloquante |
|---|---|---|---|
| 1 | Définition du besoin | Mathieu + Chef | Entrée backlog avec ID obligatoire (TLR-XXX) |
| 2 | Rédaction du brouillon spec | Chef | Brouillon complet, zéro trou |
| 3 | Validation du brouillon | Chef + Mathieu | ⛔ Bloquant — brouillon validé par Mathieu avant tout envoi à Atlas |
| 4 | Envoi à Atlas avec implémenteur désigné | Chef → Atlas | Ref backlog + destinataire nommé dans le message |
| 5 | Intégration doc + ack immédiat | Atlas | Atlas formate, intègre dans telaria-doc, committe — la spec est officielle |
| 6 | Transmission à l'implémenteur | Atlas → Instance | Atlas envoie la spec validée, notifie Chef en parallèle |
| 7 | Implémentation + tests (DoD atteint) | Instance | TU verts, testé sur dev (poseidon) + staging — notifie Chef |
| 8 | Validation du livrable | Chef + Mathieu | Sur staging — navigateur externe obligatoire, pas curl loopback |
| 9 | MEP prod | Chef | ⛔ Bloquant — zéro MEP sans feu vert explicite Chef ou Mathieu |
| 10 | Backlog mis à jour | Chef | Ticket done définitif — intouchable après cette étape |
| 11 | Communication de clôture | Chef | Notifie Atlas (Mà J doc éventuelles) + instance implémenteur (ticket clos) |
Règles absolues
- Brouillon spec validé par Mathieu avant envoi à Atlas — jamais en direct
- Atlas nomme toujours l'implémenteur dans son message à l'instance
- Ticket fermé = intouchable — bug ou évolution = nouveau ticket
- Chef n'intervient pas entre Atlas et l'instance une fois la spec transmise (sauf question remontée)
- L'instance ne touche pas au VPS prod de son propre chef — feu vert Chef obligatoire (étape 9)
Anti-patterns
Ces pratiques violent le process et doivent être signalées immédiatement au Chef :
- Spec sans validation Mathieu : Atlas reçoit un brouillon non validé et l'intègre quand même
- Brief sans spec : contacter un dev sans spec complète référencée
- Implémentation sans ref backlog : démarrer un travail sans ID TLR-XXX
- Livraison sans DoD : déployer sans avoir vérifié les critères de la spec
- Spec post-implémentation : écrire la spec après le code (elle ne peut plus être bloquante)
- Chantier parallèle non déclaré : démarrer un travail hors backlog sans accord Chef/Mathieu
- MEP sans staging : déployer en prod sans validation préalable sur staging (retex TLR-001, 2026-06-16)
- MEP sans feu vert : déployer en prod sans feu vert explicite Chef ou Mathieu
- Rouvrir un ticket fermé : tout changement post-
done= nouveau ticket
Communication inter-instances — politique de rotation des inboxes
Les inboxes fichiers ont une taille limitée. Au-delà d'un certain volume, les instances risquent de rater des messages (scan tronqué).
Règle :
- Maximum 10 messages actifs par fichier inbox
- Au-delĂ : archiver les plus anciens dans
inbox-from-<sender>.archive.md(append), conserver uniquement les 5 derniers dans le fichier actif - Les instances consultent l'archive si elles recherchent un message ancien
- Cette règle s'applique à tous les canaux inbox de l'écosystème
RĂ´le d'Atlas dans ce process
Atlas intervient aux étapes 5 et 6 — intégration documentaire et transmission à l'implémenteur.
- Étape 5 : reçoit le brouillon du Chef (déjà validé par Mathieu), formate, intègre dans
telaria-doc, committe. La spec est officielle dès ce commit. Si une question se pose → demande au Chef, jamais à Mathieu directement. - Étape 6 : notifie l'instance implémenteur désignée par Chef ET notifie Chef en parallèle.
- Étape 11 : reçoit la notification de clôture du Chef, met à jour la doc si nécessaire.
Atlas ne pilote pas les étapes 7-10 — c'est le domaine du Chef, de Mathieu et de l'instance implémenteur.
Voir aussi
- Fiches de poste — responsabilités de chaque rôle
- Ecosystem — instances et canaux de communication
- Roadmap / Backlog — suivi des items TLR-XXX