Files
system-docs/v4-archive/mason/README.md
2025-12-24 17:28:34 +00:00

100 lines
2.8 KiB
Markdown

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