🤖 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.
⭐0️⃣ Índice Maestro de Bases de Datos
Directorio central y Entity-Relationship Map de todas las tablas del Ecosistema ERP.
Este documento funciona como el mapa universal de la base de datos de Supabase. Toda tabla existente debe estar registrada aquí, clasificada por el módulo al que pertenece.
Módulo de Gestión de Usuarios
- Tabla de Usuarios: Directorio Activo, usuarios y credenciales de acceso. Ver Instructivo
- Tabla de Roles y Permisos: Niveles de seguridad jerárquica y permisos. Ver Instructivo
Módulo de Archivología
- Tabla de Documentos: Inventario maestro universal de archivos digitales y PDFs. Ver Instructivo
- Tabla de Archivadores: Registro de contenedores físicos y su ubicación espacial (Estantes N100, N102). Ver Instructivo
Módulo de Gestión Jurídica
- Tabla de Contratos Legales: Control de ciclo de vida, vigencias y metadatos de los contratos legales. Ver Instructivo
⚠️ REGLA DE ARQUITECTURA: Si estás diseñando un módulo nuevo (Ej: Inventario, Recursos Humanos, Vuelos), debes crear el artículo documental de la tabla siguiendo la plantilla obligatoria y luego agregarlo a este Índice Maestro.
📚 La Cadena Archivológica Perfecta: Lógica Relacional
Para garantizar la máxima velocidad y evitar redundancias (errores humanos), la base de datos utiliza un modelo estricto de normalización relacional («JOINs»). Esto significa que la información fluye en una cadena jerárquica inquebrantable:
DOCUMENTO ➔ EXPEDIENTE ➔ CONTENEDOR (ESTANTE)
El Problema de la Redundancia (Por qué NO conectar Documento directo a Estante):
Imagina que a cada uno de los 100 papeles (Documentos) de un expediente le anotamos con lápiz: «Estoy en el Estante A». Si el día de mañana Archivología muda ese expediente al «Estante B», el sistema tendría que reescribir la ubicación en los 100 papeles uno por uno. Esto es un diseño lento y propenso a errores («Data Corruption»).
La Solución Relacional Moderna:
Al diseñar la tabla, el Documento solo tiene una columna que apunta a su Expediente. Y el Expediente tiene la columna que apunta a su Contenedor. Si mudamos el expediente de estante, solo actualizamos una (1) única fila en la base de datos. Automáticamente, los cientos de documentos adentro de ese expediente heredan la nueva ubicación en microsegundos, gracias al poder de las relaciones SQL.
