Archive: System v4 - Estado al 2024-12-24

2025-12-24 17:28:34 +00:00
parent a92d41c846
commit 1b392803fd
81 changed files with 24560 additions and 0 deletions
--- a/v4-archive/mason/README.md
+++ b/v4-archive/mason/README.md
@@ -0,0 +1,99 @@
+# MASON
+
+![Estado](https://img.shields.io/badge/Estado-PLANIFICADO-yellow)
+
+
+**Espacio de enriquecimiento - Sistema TZZR**
+
+## Rol
+
+Mesa de trabajo donde el usuario completa y corrige información antes de consolidar en FELDMAN.
+
+## Posición en el Flujo
+
+```
+CLARA/MARGARET ──┬──► MASON ──► FELDMAN
+                 │       ▲
+ALFRED/JARED ────┘       │
+  (si incidencia)        │
+                         │
+FELDMAN ─────────────────┘
+  (devolver para corregir)
+```
+
+## Funciones
+
+| Acción | Descripción |
+|--------|-------------|
+| Enriquecer | Añadir metadata, notas, contexto |
+| Corregir | Modificar datos incorrectos |
+| Re-etiquetar | Cambiar etiquetas de archivos |
+| Acelerar | Enviar a FELDMAN antes de 24h |
+| Retener | Mantener más tiempo en edición |
+
+## Tiempos
+
+- **Ventana default**: 24h (configurable)
+- **Si expira**: Auto-envío a FELDMAN
+
+## Perfiles de Usuario
+
+| Perfil | Uso de MASON |
+|--------|--------------|
+| Novato | Usa mucho este espacio |
+| Avanzado | Paso casi automático |
+
+## Estructura de Datos
+
+MASON trabaja con la seccion `enriquecimiento` del contenedor (ver [esquema completo](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/06-contenedor-schema.md)):
+
+```json
+{
+  "enriquecimiento": {
+    "notas": "Pendiente de pago",
+    "campos_personalizados": {
+      "proyecto": "Proyecto Alpha",
+      "responsable": "Juan Garcia"
+    },
+    "tags_confirmados": ["sha256-tag1", "sha256-tag2"],
+    "tags_rechazados": ["sha256-tag3"],
+    "correcciones": {
+      "texto": null,
+      "entidades": null
+    },
+    "editado_por": "usuario-id",
+    "editado_at": "2025-01-15T11:00:00Z"
+  }
+}
+```
+
+### Campos disponibles
+
+| Campo | Tipo | Descripcion |
+|-------|------|-------------|
+| `notas` | String | Texto libre del usuario |
+| `campos_personalizados` | Object | Campos key-value definidos por usuario |
+| `tags_confirmados` | Array | h_maestro de tags sugeridos aceptados |
+| `tags_rechazados` | Array | h_maestro de tags sugeridos descartados |
+| `correcciones.texto` | String | Texto corregido si OCR fallo |
+| `correcciones.entidades` | Object | Entidades corregidas |
+
+### Interaccion con extraccion
+
+MASON muestra los `tags_sugeridos` de la seccion `extraccion` para que el usuario:
+- Confirme (se mueven a `enriquecimiento.tags_confirmados`)
+- Rechace (se mueven a `enriquecimiento.tags_rechazados`)
+
+### Mutabilidad
+
+- `enriquecimiento` es **mutable** mientras el registro esta en MASON
+- Una vez enviado a FELDMAN, se congela
+- Si FELDMAN devuelve el registro, vuelve a ser editable
+
+## Arquitectura
+
+Ver documentación completa en [contratos-comunes/architecture](https://git.tzzr.me/tzzr/contratos-comunes/src/branch/main/architecture/03-mason.md)
+
+---
+
+*Componente del sistema TZZR*