# BiomecLab v4.0.5 — Report UX Refinement

## Objetivo

Separar la salida del análisis en tres lecturas claras para evitar que el reporte sea una mezcla de decisiones de coach, explicación al alumno y datos técnicos internos.

BiomecLab sigue siendo una herramienta educativa/no clínica. El reporte debe ayudar a conversar, documentar y hacer seguimiento longitudinal; no debe entregar diagnósticos ni conclusiones médicas.

## Contrato de salida

### 1. Coach brief

Debe responder:

- ¿Qué prioridad de observación conviene trabajar primero?
- ¿La captura permite interpretar el resultado con confianza o cautela?
- ¿Hay baseline/progreso comparable?
- ¿Qué se debería repetir en la próxima sesión?

### 2. Alumno brief

Debe responder:

- ¿Qué observamos hoy en palabras simples?
- ¿Cuál será el foco de trabajo?
- ¿Cómo se verá el progreso en próximas sesiones?
- ¿Qué límites educativos tiene la lectura?

### 3. Export técnico

Debe contener lo avanzado sin invadir el reporte principal:

- JSON completo.
- CSV general.
- CSV técnico.
- Lab Mode JSON/CSV/HTML.
- Share Pack.
- detalles de motor, validación, benchmark y comparabilidad.

## Cambios v4.0.5

- Report Experience ahora se presenta como **Report UX Refinement**.
- Se agregan carriles visibles para coach, alumno y export técnico.
- El preview de brief muestra salida seleccionada, coach brief, alumno brief, export técnico y prioridades.
- Las acciones principales quedan reducidas a guardar, exportar HTML/PDF y copiar resumen.
- Las exportaciones técnicas pasan a un `<details>` avanzado.
- El HTML breve incluye una sección explícita de export técnico separado.
- El reporte completo deja de duplicar el bloque Report Experience.

## Guardrails

- No poner todos los botones de exportación al mismo nivel visual.
- No mostrar Lab Mode/CSV técnico como lectura principal del coach.
- No mezclar explicación al alumno con detalles del motor.
- No usar lenguaje clínico.
- No reemplazar criterio profesional ni evaluación de salud.
- Mantener visible que los videos no se suben por defecto.

## Checklist manual de QA

1. Abrir **Reportes**.
2. Confirmar tres carriles: Coach brief, Alumno brief y Export técnico.
3. Cambiar audiencia y formato; confirmar que el preview se actualiza.
4. Cargar demo o analizar video; confirmar que se habilitan brief JSON/HTML/copiar.
5. Revisar que JSON/CSV/Lab/Share Pack estén colapsados en export técnico avanzado.
6. Exportar Brief HTML y verificar que contiene coach brief, alumno brief, export técnico y uso responsable.
7. Exportar Reporte HTML/PDF y verificar que no duplica Report Experience.
8. Ejecutar Test Runner y confirmar `Report UX Refinement válido`.

## Siguiente paso

Después de ordenar la salida del reporte, BiomecLab debe pasar por **v4.0.5 — CSS Refactor Foundation** y luego **v4.0.5 — CSS Refactor Foundation** antes de nuevas features.