El catálogo de terapias
Por qué así: por-que-asi/terapias-catalogo.md · Normativos:
ROADMAP_MAESTRO.md§2.5,MindTune_Design_System.md§4.2, §4.11-bis, §4.11-bis-ter y §4.18,MindTune_Reglas_v1.md§15.6 · Código:lib/domain/terapia.dart,lib/features/terapias/terapias_screen.dart,lib/features/terapias/chip_de_recomendacion.dartVerificado contraf15a912el 2026-09-20 · Probado en iPhone: no
Qué es, en tres frases
La pestaña Terapias muestra las cuatro terapias a la vista, una tarjeta compacta cada una, con el detalle adentro de un acordeón. Cada tarjeta dice si la terapia se puede empezar hoy y, si no, qué dato falta exactamente y dónde completarlo. No hay candados, no hay «desbloquear» y no hay «próximamente».
Las cuatro, en orden
El orden en pantalla es el orden en que están declaradas en el código. Los códigos internos T1–T4 no aparecen nunca en la interfaz.
| Orden | Nombre visible | Necesita | Motor |
|---|---|---|---|
| 1 | Inducción de filtrado con Música | una lista de música | rampa de ganancia, puro Dart |
| 2 | mMIDST | la Ft + una lista de música | motor Dart on-device |
| 3 | Inhibición residual | la Ft | ruido de banda estrecha centrado en Ft, puro Dart |
| 4 | Manejo de hiperacusia | nada | el mismo ruido, con otra dosificación |
La pestaña lleva solo su título: la bajada «Cada terapia usa tu perfil y tu música. Si falta algo, la tarjeta te dice qué.» salió en H33.2 (L33-3) para que las cuatro tarjetas quepan.
Cómo es una tarjeta
Cerrada (176–202 pt desde H33.2): el ícono a medida de la terapia a 44 px pintado con su matiz · el nombre
(17/22) · el resumen en 13/18 —una frase corta más la dosis vigente en minutos— · un chevron que anuncia el acordeón. Debajo,
con el perfil incompleto, la línea «Tu perfil de tinnitus te dirá si es una terapia recomendada para
ti.» (DS §4.11-bis-ter, IR.2 + MM.1); con el perfil completo, en su lugar, el chip de recomendación
(CAT.1, ver abajo). Al pie, el chip de estado a la izquierda y, solo si la terapia se puede empezar, el
botón Empezar → a la derecha.
⚠️ Desfase: la línea (dos renglones de 15 px) y el chip que la reemplaza cuestan lo mismo, 44 pt por tarjeta, y las cuatro ya no caben sin scroll en un iPhone de 390 × 844, contra la decisión de Hayo del 2026-09-10 («las cuatro a la vista»). Con el perfil completo se suma además la fila Mis recomendaciones › (100 pt). H33.2 aplicó los medios del lote 33 (margen inferior 16, 8 entre tarjetas, padding vertical 10, sin bajada, resumen a 13): a 390 × 844 la lista todavía se desplaza 107–145 pt con el perfil incompleto y 211–249 con el completo (
terapias_cabe_test.dart). Queda para Hayo.
El chip de recomendación y Mis recomendaciones › (CAT.1)
Con el perfil completo, las reglas (reglas_v1) dicen algo de cada terapia, y el chip lo pone en una
de cinco frases: Recomendada para ti · Recomendada · mejor después de Inducción · Para cuando suba de
golpe · Por ahora no · Completa tu perfil para saber (esta última, con el perfil completo, cuando falta
el dato que decide: la Ft para mMIDST, una respuesta de la prueba de IR para la IR).
No es un botón de acción: texto secundario sobre la superficie alterna, borde fino, y ningún color de
acento salvo un punto de 6 pt a la izquierda en las dos «recomendada». Por ahora no se ve igual que
las demás. Lleva un chevron chico porque se toca: abre el acordeón y trae a la vista la línea del
motivo, la primera del detalle (el mismo motivo que Recomendaciones para mí). Si las reglas no tienen
motivo para ese estado (la hiperacusia sin señal de sensibilidad, mMIDST sin Ft), abre el detalle sin esa
línea. El texto largo pasa a dos renglones en vez de recortarse.
El chip nunca quita ni apaga Empezar →: una terapia Por ahora no se puede empezar igual.
Arriba de las tarjetas, solo con el perfil completo, la fila Mis recomendaciones › (la misma fila de Mi MindTune) cruza a la pestaña Mi MindTune con Recomendaciones para mí encima. No vibra: es navegar.
Abierta: tocar la tarjeta la expande en su lugar; una sola abierta a la vez. Aparece la descripción larga (desde IR.2 + MM.1, la de mMIDST sin la dosis del estudio y la de IR sin minutos ni audífonos) y, si faltan datos, una acción terciaria por cada dato faltante, con el verbo del destino: Completar Ft en Mi MindTune →, Elegir música →, Leer cómo usarla →.
Las acciones van adentro del acordeón. La tarjeta cerrada solo dice qué falta.
El plegado es PlegadoEnSuSitio (core/ui/plegado_en_su_sitio.dart), el mismo de la nota plegable de la portada
del perfil (H8.18): altura en contenido (200 ms); con Reducir movimiento, sin AnimatedSize y de golpe. Hasta
H8.18 el acordeón usaba un AnimatedSize de duración cero, que en debug lanzaba un error de layout al abrirse sin
movimiento.
Los tres estados del chip
| Estado | Cómo se ve | Qué dice |
|---|---|---|
| Lista | relleno tenue de acento, borde y texto en acento, punto de 6 pt | — |
| Faltan datos | sin relleno, borde y texto secundarios, ícono info | Falta: el tono de tu tinnitus · Falta: el tono de tu tinnitus · una lista de música (desde FT.1, DS §6.0-bis: nunca Ft a secas antes de desplegarla) |
| Próximamente | borde discontinuo, texto apagado | el hito del que depende |
El estado Próximamente no se usa hoy: las cuatro terapias están disponibles.
Una terapia con datos faltantes atenúa el nombre y baja el ícono al 55 % de opacidad, pero el matiz no cambia: el color dice qué terapia es, nunca si puedes o no puedes.
Los cuatro íconos
Son dibujos a medida, uno por terapia, sobre rejilla de 24 y trazo 1,8. Una terapia sin ícono no compila.
- Inducción de filtrado: una nota musical y, a su derecha, el nivel que baja despacio y se sostiene.
- mMIDST: las cuatro celdas del anillo de la marca, con cuatro tonos adentro — barras de alto distinto y sin base común, a propósito: no es un ecualizador ni una forma de onda.
- Inhibición residual: la banda estrecha que abraza la Ft — un punto central (el único relleno de la familia), dos arcos a los lados y dos arcos punteados más afuera.
- Manejo de hiperacusia: el techo, y debajo la intensidad que sube y baja dos veces sin tocarlo.
Regla de familia: ninguno tacha, cruza ni apaga nada; ninguno se dibuja sobre una base horizontal común, para que no se lea como una medición.
Lo que está prohibido en esta pantalla
Ratificado por Hayo el 2026-09-10: candados, la palabra «desbloquear», un «próximamente» decorativo, y bajadas largas en la tarjeta cerrada. Tampoco hay botón Empezar → en una terapia que no se puede empezar: nunca un control que no hace nada.
Qué se registra
Expandir una tarjeta escribe un evento de bitácora (terapias.detalle_abierto), también cuando se abre
desde el chip de recomendación; el chip no tiene evento propio. El catálogo no puntúa ni ordena por uso:
el orden es siempre el mismo, y la recomendación solo se lee en el chip y en Recomendaciones para mí.
⚠️ Desfase: el requisito haber leído cómo usarla aparece en el chip como cualquier otro dato faltante, pero hoy no se activa nunca, porque ninguna lección de terapia está publicada. Ver _index.md y deuda.md (DF-09).