Documentos y Agendas¶
Documentos y Agendas
Dominio de información no estructurada
Propósito del dominio
Este documento define el modelo conceptual, principios y alcance del dominio Documentos y Agendas dentro del proyecto Prodisys Gemelo.
Este dominio tiene como objetivo preservar, organizar y relacionar información humana y no estructurada, incluyendo:
dosieres de proyectos,
documentos técnicos,
informes,
agendas físicas digitalizadas,
notas manuscritas,
garabatos y apuntes históricos,
sin forzar su estructura ni su vinculación inmediata con sistemas transaccionales.
Separación explícita de ALEPH 2.1 Decisión arquitectónica
Documentos y Agendas NO pertenecen al dominio ALEPH.
ALEPH:
es un sistema transaccional,
tiene estructura rígida,
representa hechos administrativos cerrados.
Documentos y Agendas:
son exploratorios,
incompletos,
ambiguos,
evolucionan con el tiempo.
👉 Por diseño, este dominio es independiente y solo mantiene referencias externas a ALEPH cuando existen.
Principios rectores 3.1 Nada se pierde
Todo documento es válido, incluso si:
no tiene proyecto asociado,
no tiene fecha exacta,
no se entiende completamente hoy.
3.2 No forzar estructura
La clasificación:
puede ser parcial,
puede ser incierta,
puede mejorar con el tiempo.
3.3 Referencias débiles son aceptables
Un documento puede:
“probablemente” pertenecer a un proyecto,
“posiblemente” corresponder a un cliente,
solo estar asociado a un año.
Modelo conceptual 4.1 Documento (entidad lógica)
Un Documento representa una unidad conceptual de información, independientemente de cuántos archivos físicos tenga.
Ejemplos:
“Dossier Proyecto A516”
“Agenda 2012”
“Notas visita PERENCO”
Campos conceptuales:
id_documento
titulo
tipo_documento (dossier, informe, agenda, nota, escaneo, etc.)
descripcion
fecha_aproximada o rango
origen (digital, escaneado, importado)
estado (borrador, final, histórico)
tags (libres)
4.2 Archivo (entidad física)
Un Archivo es una representación física del documento.
Un documento puede tener uno o muchos archivos.
Campos conceptuales:
id_archivo
id_documento
ruta
hash
mime_type
fecha_creacion
version
Ejemplo:
PDF original
versión revisada
imágenes escaneadas
páginas individuales de una agenda
4.3 Referencia (vinculación flexible)
Una Referencia conecta un documento con otro concepto del sistema, sin imponer integridad fuerte.
Tipos de referencia posibles:
proyecto (ALEPH)
contrato
cotización
empresa
año
persona
ninguno
Campos conceptuales:
id_referencia
id_documento
tipo_referencia (proyecto, contrato, cotizacion, empresa, anio, persona)
valor_referencia (ej. A516, 860516431, 2014)
confianza (alta, media, baja)
👉 Esto permite capturar conocimiento humano sin exigir certeza absoluta.
4.4 Agenda (caso especial)
Una Agenda es un documento especial:
suele abarcar un rango de fechas,
puede contener múltiples temas,
puede referenciar múltiples proyectos,
puede tener baja legibilidad inicial.
Conceptualmente:
Agenda = Documento
Página de agenda = Archivo
Almacenamiento propuesto
Se utiliza el mismo enfoque que ALEPH: append-only en JSONL.
data/ documentos/ documentos.jsonl archivos.jsonl referencias.jsonl agendas/ agendas.jsonl
Ventajas:
trazabilidad completa,
no se pierde historia,
fácil reprocesamiento futuro.
Flujo de uso típico 6.1 Dossier de proyecto
Crear un Documento
Adjuntar uno o más archivos
Crear referencia al proyecto ALEPH (confianza alta)
Agregar nuevas versiones con el tiempo
6.2 Agenda histórica
Crear Documento tipo agenda
Cargar escaneos o fotos
Definir rango de fechas aproximado
Crear referencias:
año (alta)
proyectos probables (confianza baja)
Relación con ALEPH
ALEPH no conoce documentos.
Documentos sí pueden referenciar ALEPH.
Las referencias son siempre externas y opcionales.
Esto mantiene:
estabilidad en ALEPH,
flexibilidad en documentación,
independencia de dominios.
Qué no se hará inicialmente
No se forzará OCR perfecto.
No se clasificará todo desde el inicio.
No se impondrá un workflow rígido.
No se integrará directamente en la APP principal.
Primero:
capturar,
preservar,
poder buscar.
Evolución futura (no obligatoria)
Este dominio puede crecer hacia:
OCR progresivo,
búsqueda semántica,
clasificación asistida,
vinculación automática con ALEPH.
Nada de esto es requisito para comenzar.
Estado del documento
Este documento define la versión inicial estable del dominio Documentos y Agendas.
Cualquier ampliación futura deberá:
respetar estos principios,
mantener independencia de ALEPH,
preservar información histórica.