# 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*