32 lines
2.9 KiB
Markdown
32 lines
2.9 KiB
Markdown
# 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 `.env` y configuración local.
|
|
- **Restricción:** Nunca comitear credenciales, passwords de base de datos ni `SESSION_SECRET` a Git. El archivo `.env` debe permanecer en `.gitignore`. Para repositorios se mantiene `.env.example` sin 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.md` y 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.js` hacia `tareas.telcotronics.com` con `origen: 'HELP_DESK'` y `origen_externo_id = ticket.id`. El registro local en `ticket_visitas` debe conservar el `external_id` y su `historial_json` en caché. No modificar estados a `completada` sin 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.md` y conexión a `sigma-robot` / MCP de Chat.
|
|
- **Restricción:** Mantener la identidad en `pendiente` hasta confirmación formal en `sigma-robot`. Nunca inventar identificadores, nombres ni tokens locales. Nunca incluir secretos o credenciales en `id_agente.md`.
|
|
- **Motivo:** Cumplimiento del estándar centralizado de agentes del ecosistema Telcotronics.
|