3.5 KiB
3.5 KiB
Reglas Técnicas y de Operación — Help Desk
1. Regla de Seguridad Crítica en Infraestructura (MCP)
- Alcance: Todas las operaciones con el servidor MCP de Infraestructura (
192.168.10.160:3006). - Restricción: El servidor MCP tiene bloqueada toda operación de eliminación de registros. La eliminación de cualquier servicio, hardware o registro SOLO puede realizarse desde la interfaz web bajo supervisión humana explícita.
- Motivo: Evitar borrados accidentales de elementos compartidos del ecosistema por parte de agentes autónomos.
2. Aislamiento Multi-Tenant Estricto
- Alcance: Modelos y consultas SQL a la base de datos (
models/*.js). - Restricción: Toda consulta, creación o actualización de tickets, departamentos o usuarios que pertenezcan a un tenant DEBE incluir la cláusula
WHERE company_id = ?correspondiente a la sesión activa (req.session.user.company_id). - Motivo: Garantizar la confidencialidad y aislamiento de datos entre empresas.
3. Manejo de Secretos y Repositorios
- Alcance: Archivo
.envy configuración local. - Restricción: Nunca comitear credenciales, passwords de base de datos ni
SESSION_SECRETa Git. El archivo.envdebe permanecer en.gitignore. Para repositorios se mantiene.env.examplesin valores sensibles. - Motivo: Seguridad de la red interna y cumplimiento de buenas prácticas.
4. Rutina de Actualización Documental
- Alcance: Mantenimiento y evolución del proyecto.
- Restricción: Al solicitar "actualizar proyecto", se debe revisar y sincronizar
agents.md,.agente/proyecto_estructura.md,.agente/proyecto_memoria.md,.agente/proyecto_errores.md,.agente/objetivos.md,.agente/tareas.md,README.mdy la ficha en el MCP de Infraestructura. - Motivo: Preservar la fuente de verdad técnica y la coherencia en todo el ecosistema.
5. Integridad del Módulo FSM (Field Service Management)
- Alcance: Creación, despacho y sincronización de visitas técnicas en terreno.
- Restricción: Toda visita técnica presencial debe generarse a través de
tareasHubService.jshaciatareas.telcotronics.comconorigen: 'HELP_DESK'yorigen_externo_id = ticket.id. El registro local enticket_visitasdebe conservar elexternal_idy suhistorial_jsonen caché. No modificar estados acompletadasin validación del Hub o de la firma/evidencia en campo. - Motivo: Garantizar la trazabilidad legal y técnica entre la mesa de ayuda y las operaciones de campo.
6. Identidad de Agente y Comunicaciones
- Alcance: Archivo
id_agente.mdy conexión asigma-robot/ MCP de Chat. - Restricción: Mantener la identidad en
pendientehasta confirmación formal ensigma-robot. Nunca inventar identificadores, nombres ni tokens locales. Nunca incluir secretos o credenciales enid_agente.md. - Motivo: Cumplimiento del estándar centralizado de agentes del ecosistema Telcotronics.
7. Despliegue y Orquestación con SIAX Monitor
- Alcance: Despliegues de la aplicación a producción (
desplegar.sh,servers.conf). - Restricción: El despliegue debe utilizar
servers.conf(copiado desdeservers.conf.example, nunca commiteado). No utilizarsudointeractivo ni contraseñas fijas en el servidor; el ciclo de vida, reinicio y auditoría de salud debe coordinarse a través de la API REST de SIAX Monitor enhttp://$HOST:8080(POST /api/apps/HELPDESK/restartyGET /api/apps/HELPDESK/status). - Motivo: Cumplimiento de la política oficial de despliegue del ecosistema Telcotronics (Prompt 8 y Feedback #25).