Runbook TI — Operaciones del Ecosistema¶

CRESA La Vega · Centro de Diagnóstico¶

Versión: 0.1 (scaffold) · 2026-05-20 Dirigido a: Equipo técnico Yaba responsable del ecosistema CRESA. Sucesor / soporte nivel 2. Estado: Pendiente de transcripción del conocimiento operativo actualmente en memorias internas.

⚠ Próximamente: este runbook formaliza el conocimiento técnico que hoy vive en memorias de trabajo del equipo Yaba (procedimientos de migración, recovery, manejo de incidentes recientes, hairpin NAT, fixes específicos de Botpress/Frappe/Chatwoot). Se publica como referencia interna y para garantizar continuidad si cambia el responsable Yaba.

1. Para qué sirve este runbook¶

Documentar procedimientos técnicos de operación, recuperación y mantenimiento del ecosistema CRESA La Vega. Es el manual al que recurre el responsable Yaba ante un incidente o cambio de infraestructura.

A diferencia de los manuales funcionales, este SÍ usa nombres reales del stack (ERPNext/Frappe, Botpress, Chatwoot, n8n, Docker, Postgres, MariaDB) — quien lee este documento necesita los nombres exactos para diagnosticar.

2. Antes de empezar¶

Quien opera este runbook debe tener:

Acceso SSH a la VM 101 (donde corre el stack de CRESA).
Acceso al panel NPM en VM 100 (cre.yababot.do es proxy desde ahí).
Credenciales de bench/Frappe (Administrator).
Acceso al repo /home/yaba/cresa/ del host.
Conocimiento básico de Docker Compose.

3. Procedimientos operativos¶

Próximamente.

Procedimientos previstos para v1.0:

§3.1 — Backup y recovery del stack completo (snapshots vs export por servicio).
§3.2 — Recuperación tras pérdida de la VM (playbook de migración validado 2026-05-11).
§3.3 — Restart ordenado de los containers (orden de dependencias).
§3.4 — Re-aplicar migraciones pendientes de Chatwoot/ERPNext tras upgrade.
§3.5 — Sincronización de actions Botpress (BPFS=database, no docker cp).
§3.6 — Diagnóstico de incidentes comunes (bot sin responder, ERPNext caído, n8n perdió networks).
§3.7 — Rotación de credenciales (API keys, SMTP, certificados).
§3.8 — Deploy de cambios al portal de manuales (este mismo portal).

4. Troubleshooting¶

Próximamente — tabla de síntoma → diagnóstico → fix, indexada por componente.

5. Glosario técnico¶

Próximamente — términos del stack y sus equivalencias en los manuales funcionales.

6. Anexos¶

Próximamente — arquitectura de redes Docker, mapeo de puertos, lista de containers y sus deps, hostnames internos, política de hairpin NAT.