runbook: rebuild nyora-doc-api + footer Nyora DOCX (04/07/2026)

2026-07-04 09:12:11 +01:00
parent f4b8629000
commit 617050ddeb
2 changed files with 31 additions and 0 deletions
@@ -0,0 +1,30 @@
+# Runbook — Rebuild & déploiement nyora-doc-api (footer Nyora DOCX)
+
+**Date** : 04/07/2026 · **Statut** : validé en production
+
+## Problème
+Le footer Nyora (liseré or → · NYORA · → tagline → © 2026) n'a jamais existé dans les DOCX générés par nyora-doc-api. Le fix était écrit dans `app/services.py` (`_add_docx_page_number_footer`) mais inactif : **`/app` est cuit dans l'image Docker, pas bind-mounté** — toute modification de code exige un rebuild.
+
+## Procédure validée (depuis mcp-nas)
+1. **Docker indisponible dans le container mcp-nas** → passer par SSH host : `ssh -p 22222 Best0f@172.17.0.1` (clé ed25519 en place dans ~/.ssh du container). Sur le host : docker = `/usr/local/bin/docker`, **sans sudo** (Best0f dans le groupe docker ; sudo échoue, pas de TTY).
+2. Build : `cd /volume1/docker/nyora-doc-api && /usr/local/bin/docker compose build` (~2 min, pip timeout 180 déjà dans le Dockerfile).
+3. Déploiement : `docker stop nyora-doc-api && docker rm nyora-doc-api && docker compose up -d` — jamais de simple restart, l'image ne serait pas rechargée.
+4. Health : `curl http://172.17.0.1:3050/health` → 200.
+
+## Test /v1/generate — pièges
+- Endpoint **multipart/form-data**, pas JSON : `curl -F "format=docx" -F "data=</tmp/data.json"` + header `X-API-Key` (clé dans hermes-platform/.env). Un POST -d JSON → 422 "body.format missing".
+- Payload avec apostrophes françaises : toujours l'écrire dans un fichier, jamais inline.
+
+## Vérification du footer (sans ouvrir Word)
+```python
+import zipfile, re
+xml = zipfile.ZipFile('doc.docx').read('word/footer1.xml').decode()
+re.findall(r'<w:t[^>]*>([^<]*)</w:t>', xml)   # textes du footer
+'B8862A' in xml                                # liseré + NYORA doré
+```
+Attendu : `· NYORA ·`, `Crafted with precision · Built for excellence`, `© 2026`, pagination.
+
+## Notes
+- Couleur or : **#B8862A (Or Bruni, charte doc-api WCAG AAA)**, pas le #d4a01a de la règle générale footer — divergence assumée, à arbitrer.
+- **Git existe sur le host NAS** (`/usr/bin/git`) — l'ancienne consigne « git depuis le Mac uniquement » est périmée. Push : `git push http://bolbol:PWD@127.0.0.1:3232/bolbol/REPO.git HEAD` depuis le host.
+- Heredoc contenant du python multi-lignes dans mcp-nas → hang/timeout. Transférer les fichiers en base64 chunké (~290 chars) et décoder sur place.