Qué se construyó, cómo funciona, en qué estado está y cuáles son las etapas hasta la puesta en marcha operativa.
Hermes está desplegado y operativo. La base de conocimiento está conectada, el gateway de QuickBooks funciona en modo seguro, ambos servicios probados con datos reales, e infraestructura soporte (Coolify, Tailscale, Honcho, n8n) está activa.
El bloqueo inmediato es una acción de Factronics: comprar OpenCode Go para que Hermes corra bajo una cuenta, credenciales y facturación propias. Hoy usa una credencial temporal de Coordenadas.
hermes-fact está conectado a opencode-go con modelo glm-5.3 vía un proxy que maneja la sesión requerida. La ruta técnica funciona (respuestas HTTP 200), pero usa una credencial temporal de Coordenadas. Factronics debe comprar OpenCode Go y entregar su propia credencial para lograr independencia operativa y titularidad de costos desde el día 1.
A partir de ahí, el trabajo restante está organizado en cuatro etapas: desbloqueo, traspaso técnico de IA, activación funcional y UAT + hipercare. Cada componente de este informe indica en qué etapa se resuelve. Ver «Plan de cierre recomendado».
| Componente | Estado | Evidencia principal |
|---|---|---|
| Infraestructura VPS y Coolify | Operativa | Servicios y contenedores activos en srv1666492 |
| Hermes de Factronics | Desplegado · dependencia temporal | Contenedor hermes-factronics saludable, Hermes v0.20.0 |
| Cuenta OpenCode Go de Factronics | Etapa 1 · Factronics | Requiere compra y entrega de la credencial propia |
| Base de conocimiento | Desplegada y evaluada | kb-mcp saludable; 5 herramientas registradas en Hermes |
| Gateway QuickBooks | Desplegado · modo seguro | Gateway y sidecar Tailscale saludables; 130 herramientas registradas; GATEWAY_READ_ONLY=true |
| Fleet de agentes especializados | Diseñado · no provisionado | El servidor solo muestra el perfil default |
| Automatizaciones n8n | Plataforma activa · workflows en curso | WF-001, WF-006 y WF-007 definidos; WF-002 a WF-005 en la Etapa 3 |
| Panel de control | Interfaz desplegada · datos en Etapa 3 | Aplicación accesible; opera sobre datos mock y kill switch local |
| Backup de QuickBooks | Pipeline implementado · por automatizar | Requiere cron en hermes-fact, formato .QBB, copia offsite y restore drill |
| Doc Extractor | Etapa 3 | Requerido por WF-001 y por el caso escaneado de la Cláusula 1 |
| Integración HubSpot | Etapa 3 | Requiere conector, token y los workflows WF-002 y WF-004 (agente Onboarding completo) |
| Operations Supervisor / Asana | Etapa 3 | Requiere conector de Asana, WF-003 y el monitoreo de certificados de reventa |
| Telegram | Etapa 3 | Requiere cargar el token del bot de Factronics |
El estado se expresa por nivel de madurez —construido, validado, operativo— para distinguir con precisión en qué punto está cada componente.
| Entregable contratado | Estado | Nota |
|---|---|---|
| Arquitectura completa + VPS / Coolify / n8n | Hecho | Desplegado y saludable en srv1666492 |
| QB Web Connector (endpoint SOAP) | Hecho · solo lectura | Gateway operativo, /qbwc activo, sidecar Tailscale hacia ADMINLIZETT |
| API de Hermes con 4 agentes | Parcial | Bundle del fleet construido; en el servidor solo el perfil default |
| 5 workflows de n8n (WF-001 a WF-005) | 1 de 5 · validación estática | WF-001 definido; WF-002 a WF-005 se construyen en la Etapa 3 |
| Custom GPTs → conocimiento del agente | Reemplazo de arquitectura | Se descartó OpenAI Assistants API; el contrato pide capas HCL curadas. Se construyó además una base de conocimiento MCP (más potente) que no sustituye la estructura HCL |
| Integración bidireccional y autónoma con HubSpot | Etapa 3 | Requiere conector, token y WF-002 / WF-004 |
| Control Panel para Jovan | Interfaz desplegada · datos en Etapa 3 | Opera sobre datos mock; la Etapa 3 aporta datos reales, kill switch con enforcement y autenticación por roles |
| PostgreSQL: esquemas, migraciones, auditoría | Parcial | hermes-db activo; el panel todavía no lee audit_log real |
| Documentación operativa completa | Etapa 4 | Se entrega junto con la capacitación |
| Capacitación del equipo de Factronics | Etapa 4 | Programada con Jovan y el equipo contable |
| Doc Extractor (markitdown → Tesseract → visión) | Etapa 3 | Requerido por WF-001 y por el caso escaneado de la Cláusula 1 |
| Snapshot rotativo .QBW cada 60 días (3 copias) | Parcial | backup_qb.py retiene 3 copias; requiere cron, formato .QBB y copia offsite |
| Operations Supervisor + Asana + certificados de reventa | Etapa 3 | Agente 3 completo, se despliega con los conectores de Asana |
| Costos de API a cuenta de Factronics desde el día 1 | Etapa 1–2 | Hoy corre con crédito temporal de Coordenadas; se traslada a la cuenta de Factronics en el traspaso |
UAT formal de 50 casos de negocio end-to-end, con al menos un caso escaneado/imagen, aprobado por escrito por Jovan Gutic. Se ejecuta en la Etapa 4, una vez que los cuatro agentes estén provisionados. Las evaluaciones ya realizadas —base de conocimiento 77–97%, campaña del gateway sobre QuickBooks real— cubren componentes aislados y sirven como línea base. Si el UAT no alcanza el 98%, el contrato concede 15 días hábiles de corrección sin costo.
El contrato exige que los tres controles estén probados con una prueba real, no solo construidos, antes de que cualquier agente pase a producción. Avance por control: draft-only ya está garantizado en el gateway por GATEWAY_READ_ONLY=true; el Audit Log existe como tabla y queda pendiente conectarlo al panel; el Kill Switch del panel es visual y se conecta a enforcement real en la Etapa 3, que cierra con la prueba end-to-end de los tres controles.
30 días con revisión quincenal de KPIs de latencia y estabilidad del QBWC, más firma de aceptación de Jovan al día 30 para liberar el 15% retenido. Es el hito de cierre (Fase 7) y arranca con producción. Lo precede el requisito de la Fase 6: 5 días de monitoreo intensivo post-deploy.
Hermes coordina cuatro áreas de negocio: Contabilidad (lectura de órdenes de compra, borradores en QuickBooks), Inbox (clasificación de correos, borradores), Operaciones (seguimiento en Asana), Onboarding (altas de clientes desde HubSpot). El diseño mantiene supervisión humana: prepara borradores y solicitudes de aprobación, no realiza cambios sensibles sin consentimiento.
El contenedor correcto es hermes-r6b1qln7l7f5tivsnl4idmn9, identificado en Coolify como proyecto factronics, recurso hermes-factronics y dominio hermes-fact.916.coordenadas.co. Está activo y saludable.
La instancia ejecuta Hermes Agent v0.20.0 y está configurada con:
Hermes registró 135 herramientas MCP: 5 correspondientes a la base de conocimiento y 130 al gateway de QuickBooks.
La instancia corre hoy con el perfil default. Los seis perfiles preparados para Factronics —orchestrator, contable, inbox, operations, onboarding y gateway— se provisionan en la Etapa 3, junto con las tareas kanban y los jobs programados.
En esa misma etapa el archivo de identidad (SOUL.md) pasa del texto genérico de Hermes a la identidad, tono y reglas operativas de Factronics ya incluidas en el bundle del fleet.
Hermes orquesta el flujo pero no ejecuta el razonamiento: cada solicitud se envía a OpenCode Go. Es el suministro IA y no es opcional. La cuenta propia de Factronics permite:
OpenCode Go exige cabecera de sesión x-opencode-session. Se desplegó el proxy hermes-ocgo-proxy que inyecta hermes-fact-916 y mantiene la interfaz esperada. Tras el cambio:
La ruta técnica está resuelta. Solo queda reemplazar la credencial temporal por la de la cuenta pagada de Factronics.
Permite que Hermes responda con los manuales reales de Factronics, citables y verificables. Convierte PDFs, divide contenido, indexa híbrido (keyword + vector) y publica como servicio MCP.
Búsqueda combina:
Conecta Hermes a QuickBooks Desktop vía QBWC en capas:
GATEWAY_READ_ONLY=true impide toda escritura automática. API pública deshabilitada. Aprobación requerida para cambios. Hermes ve herramientas de escritura pero no puede ejecutarlas.
Bundle desplegable con seis perfiles:
| Perfil | Función |
|---|---|
| orchestrator | Recibe solicitudes y las divide en tareas |
| contable | PO a borrador de QuickBooks y control de discrepancias |
| inbox | Clasificación y borradores de correo con Brand Voice |
| operations | Auditoría de Asana y resúmenes operativos |
| onboarding | Closed Won a validación y alta de cliente |
| gateway | Mantenimiento controlado del código del gateway |
Incluye reglas por perfil, límites de herramientas, auditoría, kill switch y kanban/Asana. El código está listo; provision.sh se ejecuta en la Etapa 3, una vez que Factronics tenga su cuenta OpenCode Go, para que los seis perfiles se validen con la cuenta que queda en producción.
En el working tree local del fleet hay un cambio sin commit que pone allow_all_users: true en el Telegram del orquestador, mientras que el comentario y la política indican acceso exclusivo para Jovan y Pablo. Se restaura la allowlist explícita antes de provisionar.
n8n desplegado y saludable. Se prepararon tres workflows como código:
Validados estáticamente; se importan y activan en la instancia real durante la Etapa 3, junto con:
Interfaz desplegada en fact-control.916.coordenadas.co con navegación, estados, feed, detalle de acciones y kill switch visual. Hoy opera sobre datos mock. En la Etapa 3 se conecta a datos reales:
Con esas conexiones, el panel pasa de interfaz desplegada a herramienta operativa.
backup_qb.py genera snapshot VSS, copia .QBW/.TLG y carpetas, comprime y retiene 3 versiones (artefacto real ~2GB). En la Etapa 3 se completa con:
El backup se declara operativo cuando el restore drill confirme que una copia es efectivamente restaurable.
Microservicio Python/FastAPI, endpoint POST /extract, tres niveles: markitdown (PDF nativo), Tesseract OCR español/inglés (escaneos), visión pagada (fallback). Convierte órdenes de compra nativas o escaneadas en texto limpio para el agente contable.
Habilita dos cosas: que WF-001 procese POs escaneadas y que el UAT de la Cláusula 1 pueda cubrir su caso de imagen. Con un modelo texto-only —el DeepSeek V4 Flash contractual— es la única vía para leer un documento sin capa de texto.
Contrato exige integración bidireccional y autónoma en dos frentes:
Además de clasificar y redactar borradores, crea contactos y avanza etapas de deal en HubSpot cuando la confianza supera 0.85. Es la excepción explícita al principio de human-in-the-loop, acotada porque las notificaciones que dispara el cambio de etapa son texto fijo.
El webhook de HubSpot “Closed Won” dispara el envío de formularios al cliente, la extracción del PDF de respuesta, la verificación de EIN y certificado de reventa en fuentes públicas y el alta del cliente en QuickBooks vía QBWC, con vuelta a HubSpot.
Ambos frentes requieren el conector de HubSpot y su Private App token. Cubren el agente Onboarding completo y la mitad de escritura del Inbox Copilot.
Operations Supervisor audita Asana, vigila fechas límite y responsables, envía resúmenes a Telegram (WF-003, schedule lun-vie 8:00). Incluye monitoreo recurrente de certificados de reventa (proceso nuevo del descubrimiento).
Requiere conector de Asana con su API key, WF-003 y la tarea programada de certificados. El bundle del fleet aporta además WF-006 y WF-007 (espejo kanban ↔ Asana), que se activan en la misma etapa. Del set contratado WF-001 a WF-005, hoy existe WF-001.
Contrato define base curada a mano, no RAG: CONTRACT.md + prompt.md + reference/ por agente, más IDENTITY.md, ROUTING.md y shared/ con known_customers.yaml (34+ clientes), qb_config.md, security_policy.md, topic_routing.yaml, voice_jovan.md.
kb-mcp (FTS5 + vectores, 94 PDFs) es un componente adicional y más potente, pero no sustituye la HCL: es la HCL la que fija reglas operativas, umbrales de confianza (85% → alerta) y listas reducidas de herramientas por perfil. Vive en el bundle del fleet y se instala en la Etapa 3.
Roadmap v1.1 fijó DeepSeek V4 Flash. Contrato: costos de API corren por Factronics desde día 1. Instancia desplegada usa OpenCode Go + glm-5.3 vía proxy, con credencial temporal de Coordenadas. Implicaciones:
Hermes, la base de conocimiento y la conexión con QuickBooks ya existen, están desplegados y probados con datos reales. El siguiente paso es de propiedad: Factronics compra OpenCode Go y el sistema pasa a operar con cuenta, credenciales y facturación propias.
Desde ahí, el camino está trazado en cuatro etapas y cada componente de este informe indica en cuál se resuelve. Queda una decisión que conviene formalizar con Jovan: el desvío de DeepSeek V4 Flash a OpenCode Go.