# BiomecLab v4.0.5 — Component System Cleanup

## Propósito

v4.0.5 consolida la capa visual de BiomecLab antes de seguir agregando features. La prioridad no es crear nuevas herramientas, sino reducir deuda visual: menos variantes accidentales de cards, panels, botones, badges y estados.

BiomecLab debe sentirse como un producto profesional para coaches, no como una colección creciente de módulos técnicos.

## Contrato visual

### 1. Superficies

- `panel` es la superficie principal de cada bloque funcional.
- Las cards internas deben usar superficies oscuras coherentes, bordes suaves y sombras moderadas.
- No deben reaparecer capas blancas, máscaras semitransparentes claras o fondos que reduzcan legibilidad.

### 2. Acciones

- `btn primary`: una acción dominante por bloque cuando sea posible.
- `btn secondary`: acción importante pero no principal.
- `btn ghost`: navegación, exportaciones o acciones auxiliares.
- `btn danger`: borrado, reset o acciones destructivas.

### 3. Estados

- Ready / OK: borde verde suave.
- Warning / pendiente: borde amarillo suave.
- Error / atención: borde rojo suave.
- Local-first / privacidad: chip visible pero no invasivo.
- Cloud opcional: nunca debe competir con el flujo local principal.

### 4. Densidad

- Evitar más de 4–6 cards visibles por bloque principal cuando no sea estrictamente necesario.
- Agrupar acciones en filas compactas solo cuando sean auxiliares.
- El flujo coach debe priorizar lectura rápida: alumno, protocolo, captura, análisis, reporte.

### 5. QA y avanzado

- QA, Demo, Productization, Pilot Feedback y UI System deben vivir en Demo / QA.
- No deben volver a contaminar Inicio o Nuevo Screening.
- Un usuario nuevo debe poder completar un screening sin entender las herramientas internas.

## Reglas para próximas versiones

1. Antes de crear una nueva card, revisar si `panel`, `product-card`, `dashboard-card`, `workflow-card`, `data-card` o `ui-system-card` ya cubren el patrón.
2. Antes de crear un nuevo color o borde, usar los tokens existentes.
3. Antes de agregar otro panel a Inicio, preguntarse si pertenece realmente a Demo / QA, Datos o Reportes.
4. No crear features nuevas si generan una nueva familia visual no documentada.
5. Capture Wizard v4.0.5 debe reutilizar este contrato y no crear otro sistema visual paralelo.

## Criterio de aceptación

- Inicio se mantiene limpio.
- Nuevo Screening se mantiene operativo.
- Las cards son oscuras y legibles en desktop/mobile.
- Los botones comunican jerarquía.
- Los estados son consistentes.
- QA/dev tools están contenidos en Demo / QA.
- `/api/` sigue fuera del Service Worker cache.
- El lenguaje sigue siendo educativo/no clínico.