Files
help_desk/.agente/proyecto_errores.md
T

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

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 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 / Acción requerida: El usuario o administrador de Gitea debe crear el repositorio vacío pablinux/help_desk desde la interfaz web de https://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 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).