feat: inicializacion de Help Desk segun estandar Telcotronics con bitacora de errores e integracion MCP

2026-10-16 23:29:32 -05:00
commit 0f2708462e
54 changed files with 7590 additions and 0 deletions
@@ -0,0 +1,38 @@
+# 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).
+