runbook: bug concurrence tempfile + nyora_telegram + methode transfert fichier

common/vps-hermes-nabil-visuels-yasmi.md

@@ -39,3 +39,33 @@ Test réel du 19/07 sur gemini-3-pro-image via OpenRouter : aucun sparkle
 visible détecté (analyse pixel + aperçu ASCII du coin). Le filet reste actif
 par sécurité car le bug est intermittent côté Google.
 
+## Production reelle et bug de concurrence (19/07/2026)
+
+Trois visuels livres sur Telegram (Gafsa, Nefta, Sfax) depuis une photo de
+reference — gemini-3-pro-image, 1080x1350, logo lisible, aucun sparkle Google.
+
+### Bug corrige : chemins temporaires fixes
+`nyora_mannequin.py` et `nyora_produit.py` ecrivaient dans des chemins fixes
+(`/tmp/mannequin_brut.png`, `/tmp/mannequin_logo.html`, `/tmp/produit_detoure.png`,
+`/tmp/decor_ia.png`). Deux executions simultanees s'ecrasaient, et trois Chrome
+headless en parallele depassaient le timeout de 120 s.
+**Correctif** : `tempfile.mktemp()` avec prefixe unique.
+**Regle** : lancer les generations **en serie**, jamais en parallele.
+
+### Nouveau module : nyora_telegram.py
+`python3 /data/nyora/nyora_telegram.py image.png "legende" [image2.png "legende2"]`
+Token et chat_id lus dans `/data/.env`, jamais affiches.
+
+### Transfert de fichier vers le VPS (methode validee)
+Ne **jamais** utiliser des chunks base64 en here-doc SSH : tronque et tres couteux.
+1. `curl -F "file=@fichier" https://tmpfiles.org/api/v1/upload`
+2. Le lien `/dl/{id}/nom` renvoie une **page HTML** — en extraire l URL reelle
+   (`grep -oE "https?://tmpfiles.org/dl/[^\"]*\.jpg"`)
+3. Telecharger cote VPS, verifier par `md5sum`, puis `docker cp` dans le container.
+
+### Limite : heritage du physique du mannequin source
+Le mannequin genere herite fortement du physique visible sur la photo de reference.
+Une photo portee par un mannequin europeen donne un rendu europeen malgre
+`--mannequin`. Pour un rendu tunisien fidele : fournir des photos de **vetements
+seuls** (a plat ou sur cintre).
+