🤖 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.
⭐9️⃣ Instructivo General de Bases de Datos (Tablas)
El estándar Documentation-Driven Database: Ninguna tabla puede existir en el ERP sin su instructivo correspondiente.
El ecosistema ERP se sostiene sobre múltiples bases de datos relacionales (ej. el Sistema 091, o la Base de Datos Académica). Para evitar el caos de tablas huérfanas, columnas ocultas y duplicidad de datos generada por departamentos trabajando en silos, se establece la Regla de Oro de Bases de Datos Guiadas por Documentación (Documentation-Driven Database).
1. Regla Suprema: Cero Tablas sin Instructivo
🛑 Prohibición de Creación Técnica Directa
Queda terminantemente prohibido crear una tabla o base de datos nueva en Airtable, Supabase o cualquier plataforma del ERP sin haber publicado previamente su respectivo Instructivo Normativo en la base de conocimientos.
2. Requisitos del Instructivo de Base de Datos
Antes de que los desarrolladores o líderes configuren una tabla (ej. «1-Areas de trabajo», «00.23-Usuarios» o «Trámites»), deben redactar un artículo en la Categoría 09 que actúe como La Fuente Única de la Verdad (Source of Truth). Este instructivo debe contener obligatoriamente:
| Elemento Obligatorio | Descripción |
|---|---|
| Propósito de la Tabla | Para qué existe esta base de datos y qué problema operativo resuelve. |
| Diccionario de Datos (Columnas) | Una lista exacta de todas las columnas (campos) que llevará la tabla, especificando si son texto, número, fecha, booleanos o listas desplegables. |
| Relaciones (Links) | A qué otras tablas se conecta (Ej: «La tabla Trámites se enlaza a la tabla de Usuarios»). |
| Responsable (Owner) | Quién es el departamento o rol encargado de mantener esta tabla limpia y actualizar su estructura. |
Una vez que la norma está publicada en la base de conocimientos y aprobada, se autoriza la creación técnica de la tabla en la plataforma del ERP, la cual deberá reflejar de forma exacta lo dictado en el instructivo.
Bases de Datos | 01. Generalidades | Centro de Soporte IDEA | Junio 2026
Plantilla Obligatoria de Bases de Datos
Bajo la norma de Documentation-Driven Database y el modelo MVC (Modelo-Vista-Controlador), está estrictamente prohibido crear el artículo de una tabla con código técnico crudo sin explicar su contexto. Todo artículo documental de una tabla de base de datos deberá tener obligatoriamente la siguiente estructura de 5 pasos:
- 👤 Traducción para Humanos: Explicación sencilla de qué problema real resuelve esta tabla en la empresa.
- 🔗 Relaciones y Convergencias: Lista de Foreign Keys o cruces de información con otras tablas del ecosistema.
- ⚙️ Automatizaciones (Back-End): Triggers automáticos, eventos cron programados invisibles para el usuario.
- 🖥️ Vistas e Interfaces (UX/UI): Diferentes pantallas o módulos del ERP donde se consulta esta tabla, detallando qué filtros o restricciones visuales aplican según el rol.
- 💻 Estructura Técnica (Para la IA): El diccionario de datos crudo en formato tabla con las columnas, tipos de datos (VARCHAR, UUID, etc.) y constraints para uso exclusivo de los programadores y agentes de IA.
