pilotage/process-livraison.md

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 dev ou staging selon 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

Assistant documentaire

Posez une question sur la documentation. Les réponses citent leurs sources — un clic ouvre le document à gauche.

Loading…
Loading the web debug toolbar…
Attempt #