39 lines
2.5 KiB
Markdown
39 lines
2.5 KiB
Markdown
# 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).
|
|
|