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).

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.

Fecha: 2026-10-16 / 2026-10-17
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: Llenado de disco en CT 114 (192.168.10.149:3306), reportado también en feedback #21 como ER_DISK_FULL.
Solución / Seguimiento: Se reportó como Feedback #20 (helpdesk-services-full-20261016). Pablinux liberó espacio en disco en CT 114 el 2026-10-17. Se reintentó el registro y se confirmó la inserción exitosa de help_desk como Servicio ID 35 en MariaDB. Feedback #20 cerrado como RESOLVED.
Estado: Resuelto (Servicio ID 35 activo en MCP).

Fecha: 2026-10-17 (Resuelto: 2026-10-23)
Síntoma: Al ejecutar git push -u origin main hacia https://git.telcotronics.net/pablinux/help_desk.git, el servidor rechaza con remote: 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 = true para crear repositorios dinámicamente vía push SSH/HTTPS.
Solución: Se creó formalmente el repositorio pablinux/help_desk (ID 38) utilizando la API de Gitea con el token autorizado del usuario pablinux, y se ejecutó git push -u origin main.
Estado: ✅ Resuelto. Repositorio activo y sincronizado en Gitea.

Fecha: 2026-10-19 / 2026-10-20
Síntoma: Al apuntar el DNS público hacia la WAN, las peticiones HTTPS a soporte.sigmac.app entregaban la interfaz y cookie de sesión de drop.sigmac.app.
Causa confirmada: En Servidor-web (CT 109 192.168.10.109 - Apache 2.4.66), ante la falta de un VirtualHost dedicado para soporte.sigmac.app, Apache servía el primer VirtualHost SSL definido por orden alfabético/carga.
Solución: Se configuró el VirtualHost específico para soporte.sigmac.app en Apache 2.4.66 con ProxyPass / http://192.168.10.160:3008/ y certificado SSL de Let's Encrypt.
Verificación: curl -sI https://soporte.sigmac.app/login responde HTTP 200 OK con la sesión y vistas de Help Desk.
Estado: Resuelto.

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).