Généré le 20/11/2026 05:20

Consolidation Hebdomadaire — 15/11/2026 00h (pulsation consolidation_hebdomadaire, Claude Code)

Synthèse

3 leçons techniques majeures extraites des 48 dernières heures (14-15/11) et gravées dans la mémoire collective. Chaque leçon provient d'un incident réel en production et a déjà été intégrée dans les procédures actives.


🎯 Leçon #1 : Validation visuelle temporelle pour UI dynamiques

Incident déclencheur : Barre d'annonce Ysenra vide, un seul texte sur 3 qui "file" à toute vitesse (14/11).

Erreur initiale : Diagnostic basé sur une capture statique (barre noire vide) → fausse piste (cache, durée d'affichage).

Vraie cause : justify-content: center sur .swiper-wrapper décale la piste de slides de plusieurs écrans vers la gauche. Une capture statique ne peut pas révéler ce bug.

Solution déployée : Script artifacts/diag_bande_20261114/swipe.py qui échantillonne la position CSS transform: translate3d(...) des slides sur ≥1 cycle d'autoplay complet (5,5 s).

Généralisation : Toute vérification de carrousel/slider/animation doit être temporelle, pas statique → captures multiples espacées, injection JS d'écoute d'événements, ou vidéo de 10-15 s.

Intégré dans : .claude/skills/audit-prelancement-site/SKILL.md (nouvelle section "Validation des éléments dynamiques").


🔄 Leçon #2 : Architecture de fallback pour APIs externes non fiables

Incidents simultanés (14/11) :
1. ElevenLabs : crédit épuisé (Starter 30k caractères)
2. Telegram : refus photo PHOTO_INVALID_DIMENSIONS (image 1440×40 trop allongée)
3. Shopify verification : Chrome CDP port 9222 indisponible

Sans fallback : Blocage complet du workflow (impossible de générer PUB-22-v4, planches perdues, règle 17 inapplicable).

Chaîne de fallback déployée :

  1. Voix (studio/providers/voix.py) :
    - ElevenLabs → Edge TTS gratuit (bonus : word timestamps pour sous-titres sans transcription)

  2. Telegram photo (notify_telegram.py, telegram_reliable.py) :
    - sendPhoto → sendDocument si PHOTO_INVALID_DIMENSIONS (même image acceptée)

  3. Chrome CDP (tools/verify_shopify_changes.py) :
    - connect_over_cdp port 9222 → launch own Chrome (propre, sans cookies)

Principe : Tout appel API externe critique → fallback automatique, équivalent fonctionnel (peut être dégradé, jamais bloquant), journalisé.

Ordre de préférence : Service premium → service gratuit → solution locale → erreur propre avec instructions.


📋 Leçon #3 : Règles métier externalisées pour éviter la dette technique

Contexte : Studio Pub — détection automatique de plans indésirables (logo Kaliteas, offre concurrente, site skovasken.com).

Risque évité : Coder les règles en dur dans detection.py → modification du code pour chaque nouveau produit, impossible de bloquer les scripts customs, impossible de versionner indépendamment.

Architecture déployée :

  1. Règles communes : studio/regles/_commun.json (marque-concurrente, site-concurrent, offre-concurrente)
  2. Règles par produit : studio/regles/sneaksafe.json (notre_produit, marques_autorisées, interdits, sources_interdites)
  3. Code agnostique : detection.py charge les règles, Gemini Vision juge selon ces règles

Bénéfices réels obtenus :
- Hook de garde efficace (hooks/garde_studio_pub.py bloque les scripts customs car les règles sont data, pas code)
- Versioning indépendant (modifier une règle = commit JSON, pas Python)
- Audit par produit (git diff studio/regles/sneaksafe.json)
- Test/prod séparés (règles strictes en test, relâchées en prod si besoin)

Principe : Code = invariants + algorithmes. Data = variants + décisions métier.

Indicateur : "Si on ajoute un produit, il faudra modifier ce fichier Python" → la règle doit sortir du code.


📚 Capitalisation

Document créé : knowledge/LECONS_TECHNIQUES_CONSOLIDEES.md (3 leçons détaillées avec contexte, solution, généralisation, liens mémoire)

Intégrations :
- .claude/skills/audit-prelancement-site/SKILL.md : Section "Validation des éléments dynamiques"
- C:\Users\lisa\.gemini\antigravity\knowledge\Architecture_Antigravity.md : Référence dans "Documents de méthode hors de ce dossier"

Prochaine consolidation : 22/11/2026 (hebdomadaire)


{
  "title": "Consolidation Hebdomadaire — Leçons Techniques (15/11 00h)",
  "kpis": [
    {
      "label": "Leçons Capitalisées",
      "value": "3 / 3",
      "status": "success"
    },
    {
      "label": "Incidents Réels Sources",
      "value": "5",
      "status": "info"
    },
    {
      "label": "Intégrations SKILLs",
      "value": "2",
      "status": "success"
    },
    {
      "label": "Prochaine Consolidation",
      "value": "22/11/2026",
      "status": "info"
    }
  ],
  "table": {
    "columns": ["Leçon", "Domaine", "Intégration"],
    "rows": [
      ["#1 Validation temporelle UI", "Frontend / Audit", "audit-prelancement-site/SKILL.md"],
      ["#2 Fallback APIs externes", "Architecture / Résilience", "LECONS_TECHNIQUES_CONSOLIDEES.md"],
      ["#3 Règles métier externalisées", "Architecture / Maintenance", "LECONS_TECHNIQUES_CONSOLIDEES.md + Studio Pub"]
    ]
  }
}