help_desk/.agente/proyecto_errores.md

Bitácora de Errores e Incidentes — Help Desk

Incidente #1: Comportamiento inestable de node --watch

• Fecha: 2026-05-16
• Síntoma: El comando node --watch app.js (npm run dev) no detecta recargas o falla en ciertos entornos Linux / terminales virtuales.
• Causa confirmada: Limitación del soporte experimental de --watch en ciertas versiones y sistemas de archivos bajo Linux.
• Solución / Alternativa: Utilizar nodemon para desarrollo o arrancar con npm start estándar.
• Verificación: Ejecución directa con node app.js funciona de forma estable.
• Estado: Resuelto (con workaround documentado).

---

Incidente #2: Dependencia no utilizada en código activo (jsonwebtoken)

• Fecha: 2026-05-16
• Síntoma: jsonwebtoken figura en las dependencias de package.json, pero no es importado en ninguna ruta activa (routes/).
• Causa confirmada: Se planificó inicialmente una API REST para clientes móviles, pero se implementó interfaz web monousuario/multi-tenant con express-session.
• Solución: Mantener identificada la dependencia; evaluar si se implementará la API REST para la app móvil o desinstalarla para limpiar el árbol de dependencias.
• Estado: Pendiente de decisión técnica.

---

Incidente #3: Error 1114 al registrar servicio en MCP de Infraestructura

• Fecha: 2026-10-16
• Síntoma: Al invocar crear_servicio en el MCP de Infraestructura (192.168.10.160:3006), MariaDB devolvió: MysqlError 1114 (HY000): The table 'services' is full.
• Causa confirmada: La tabla services en la base de datos mcp_infraestructura (MariaDB 192.168.10.149:3306) alcanzó su límite de tamaño o memoria asignada.
• Solución / Seguimiento: Se reportó como Feedback #20 (helpdesk-services-full-20261016, severidad CRITICAL, estado OPEN) en el sistema de feedback del MCP. Reintentar el registro una vez resuelto en MariaDB.
• Estado: Reportado / Pendiente de resolución externa.

---

Integración con Bitácora Centralizada (API-SIGMA-WEBCONTROL)

• Endpoint de Reporte: POST https://api.siax-system.net/api/errores
• Módulo implementado: config/errorReporter.js + middleware global en app.js.
• Filtro de consulta: GET https://api.siax-system.net/api/errores?app_origen=Help Desk
• Comando de verificación: npm run check:errors (o node scripts/consultar_errores.js).
• Consola visual humana: https://siax-system.net (WebControlSigma).