🤖 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.
Tabla: Documentos
Inventario maestro universal de archivos digitales y físicos.
👤 1. Traducción para Humanos
Esta es la biblioteca digital de toda la empresa. Aquí se registra absolutamente todo PDF, escaneo o papel físico que exista (la hoja en sí misma). Es el índice universal que te dice cómo se llama el archivo, y dentro de qué Expediente está archivado.
🔗 2. Relaciones y Convergencias
📋 Referencias Cruzadas (Normas, Tipos e Inventarios)
- 📜 Norma Madre: Normas de Archivología – El Documento Universal
- 📒 Clasificación: Normas de Archivología – Tipos de Documentos
- 📂 Inventario: Inventario Maestro de Documentos Genéricos
- ⚙️ Automatización: Resolución de Errores Documentales (Validación IA)
Esta tabla se conecta directamente con los siguientes componentes del ecosistema:
- Con
arc_expedientes: Relación madre. Todo documento (ej. una cédula escaneada) debe vivir obligatoriamente dentro de una «Carpeta» (Expediente). - Con Módulos Periféricos (Ej:
jur_contratos): Otras tablas usan esta como su «disco duro».
⚙️ 3. Automatizaciones (Back-End)
- Trigger Cognitivo (RT-33): Al hacer un
INSERTde un nuevo documento, se dispara un Webhook al Agente de IA para que ejecute el análisis visual del archivo subido. La IA sobreescribe la columnavalidado_iacon el veredicto final. - Automatización (Expurgo Digital): Todos los días un Cron revisa la columna de
caducidad. Si la fecha ya pasó, el archivo es eliminado definitivamente para liberar espacio en el servidor (Purga Digital). - Automatización (Expurgo Físico): El mismo Cron genera automáticamente un Registro de Expurgo Físico — una lista actualizada con todos los documentos y expedientes físicos cuya fecha de retención ha vencido. Un responsable asignado ejecuta la eliminación física y actualiza el estatus en la interfaz (
PENDIENTE→ELIMINADO). Ver Instructivo de Expurgo Físico.
🖥️ 4. Vistas e Interfaces (UX/UI)
- Pantallas y Filtros: Es el corazón del Buscador Central UX/UI. Dependiendo de quién busque, los resultados mostrarán solo los documentos a los que su departamento tiene acceso.
💻 5. Estructura Técnica (Para la IA)
| Columna | Tipo de Dato | Descripción / Restricción |
|---|---|---|
id |
UUID | Primary Key. |
titulo |
VARCHAR | Nombre visible del documento. |
tipo_documento |
VARCHAR / ENUM | FORMATO, CONTROLADO, MULTIMEDIA, GENERICO. Según la Norma de Tipos de Documentos. |
ruta_storage |
VARCHAR | URL del PDF o ID de la nube. |
expediente_id_fk |
UUID | Foreign Key a arc_expedientes. Indica en qué «Carpeta Lógica» está guardado. |
validado_ia |
VARCHAR / ENUM | ‘PENDIENTE’, ‘VERIFICADO’, o ‘CON ERROR’. Alimentado por la RT-33. |
caducidad |
DATE | Fecha en que el archivo puede ser expurgado. |

