c8742a189e
- Documents all enrichment fields available - Shows interaction with extraccion.tags_sugeridos - Explains mutability rules - Links to contratos-comunes schema
97 lines
2.7 KiB
Markdown
97 lines
2.7 KiB
Markdown
# MASON
|
|
|
|
**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*
|