🤖 DIRECTRIZ DE ARQUITECTURA (IA)
Este documento es una norma de diseño (Source of Truth). Su propósito es instruir a los desarrolladores y a los Agentes de Inteligencia Artificial sobre cómo programar, estructurar y auto-auditar las bases de datos e interfaces del ecosistema. No es un manual operativo para el usuario final.
Normas de Archivología – Tablas, Interfaces y Automatizaciones
Estructura estándar obligatoria de la Categoría 05 de cada módulo del ecosistema.
Propósito
Cada módulo del ecosistema ERP contará con una Categoría 05: Tablas, Interfaces y Automatizaciones. Esta categoría es el corazón técnico del módulo: aquí se documenta todo lo que un programador o agente de IA necesita saber para construir ese módulo en código.
Estructura Obligatoria de la Categoría 05
Toda Categoría 05, sin importar el módulo al que pertenezca, debe contener los siguientes elementos en este orden:
1. Índice del Módulo (Obligatorio, siempre de primero)
Un artículo titulado ⭐0️⃣ Índice de [Nombre del Módulo] que funcione como el mapa central. Debe listar todas las tablas, interfaces y automatizaciones del módulo con enlaces directos a cada artículo individual.
2. Artículos de Tablas de Base de Datos
Un artículo por cada tabla, siguiendo la Plantilla Obligatoria de 5 Pasos:
- 👤 Traducción para Humanos
- 🔗 Relaciones y Convergencias
- ⚙️ Automatizaciones (Back-End)
- 🖥️ Vistas e Interfaces (UX/UI) — referencias a las interfaces que consumen esta tabla
- 💻 Estructura Técnica (Para la IA)
3. Artículos de Interfaces y Pantallas
Un artículo por cada interfaz o pantalla relevante del módulo, describiendo: qué datos muestra, qué filtros tiene, qué roles pueden verla y qué acciones puede ejecutar el usuario.
4. Artículos de Automatizaciones Complejas
Si el módulo tiene automatizaciones que afectan a múltiples tablas o que requieren documentación extensa (Crons, Triggers complejos, integraciones con otros módulos), cada una tendrá su propio artículo.
Ejemplo Aplicado: Módulo de Archivología
La Categoría 05 de Archivología (este módulo) contiene actualmente:
- ⭐0️⃣ Índice Maestro de Bases de Datos — El mapa central de todas las tablas core del sistema.
- Tabla: sys_usuarios — Directorio activo de usuarios.
- Tabla: sys_roles — Niveles de acceso y seguridad.
- Tabla: arc_documentos — Biblioteca digital universal.
- Tabla: arc_archivadores — GPS de contenedores físicos.
- Tabla: jur_contratos — Ciclo de vida de contratos legales.
Este mismo patrón debe replicarse en la Categoría 05 de cada módulo futuro (RRHH, Ingresos, Inventario, etc.).
⚠️ Regla de Oro: El Índice del módulo SIEMPRE va de primero. Ningún artículo técnico debe crearse sin primero estar registrado en el índice.
Norma de Archivología | 05. Tablas, Interfaces y Automatizaciones | Centro de Soporte IDEA | Junio 2026
