31 lines
2.3 KiB
Markdown
31 lines
2.3 KiB
Markdown
# 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.
|