# Documentos y Agendas

Documentos y Agendas

Dominio de información no estructurada

1. 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.

2. 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.

3. 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.

4. 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

5. 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.

6. 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)

7. 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.

8. 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.

9. 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.

10. 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.