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

---

## Incidente #5: Colisión inicial en proxy inverso de `soporte.sigmac.app` con vhost SSL por defecto
- **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.

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