3.3 KiB
3.3 KiB
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
--watchen ciertas versiones y sistemas de archivos bajo Linux. - Solución / Alternativa: Utilizar
nodemonpara desarrollo o arrancar connpm startestándar. - Verificación: Ejecución directa con
node app.jsfunciona de forma estable. - Estado: Resuelto (con workaround documentado).
Incidente #2: Dependencia no utilizada en código activo (jsonwebtoken)
- Fecha: 2026-05-16
- Síntoma:
jsonwebtokenfigura en las dependencias depackage.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_servicioen el MCP de Infraestructura (192.168.10.160:3006), MariaDB devolvió:MysqlError 1114 (HY000): The table 'services' is full. - Causa confirmada: La tabla
servicesen la base de datosmcp_infraestructura(MariaDB192.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, severidadCRITICAL, estadoOPEN) en el sistema de feedback del MCP. Reintentar el registro una vez resuelto en MariaDB. - Estado: Reportado / Pendiente de resolución externa.
Incidente #4: Error 403 al hacer push a git.telcotronics.net (Push to create no habilitado)
- Fecha: 2026-10-17
- Síntoma: Al ejecutar
git push -u origin mainhaciahttps://git.telcotronics.net/pablinux/help_desk.git, el servidor rechaza conremote: Push to create is not enabled for users. fatal: no es posible acceder... The requested URL returned error: 403. - Causa confirmada: La instancia de Gitea no tiene activada la directiva global
ENABLE_PUSH_TO_CREATE = truepara crear repositorios dinámicamente vía push SSH/HTTPS. - Solución / Acción requerida: El usuario o administrador de Gitea debe crear el repositorio vacío
pablinux/help_deskdesde la interfaz web dehttps://git.telcotronics.net. Una vez creado el repositorio vacío, el push funcionará de inmediato. - Estado: Documentado / Pendiente de creación en interfaz web.
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 enapp.js. - Filtro de consulta:
GET https://api.siax-system.net/api/errores?app_origen=Help Desk - Comando de verificación:
npm run check:errors(onode scripts/consultar_errores.js). - Consola visual humana:
https://siax-system.net(WebControlSigma).