Saltar al contenido
Cómo funcionaPor qué así →

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.dart Verificado contra f15a912 el 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.

OrdenNombre visibleNecesitaMotor
1Inducción de filtrado con Músicauna lista de músicarampa de ganancia, puro Dart
2mMIDSTla Ft + una lista de músicamotor Dart on-device
3Inhibición residualla Ftruido de banda estrecha centrado en Ft, puro Dart
4Manejo de hiperacusianadael 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

EstadoCómo se veQué dice
Listarelleno tenue de acento, borde y texto en acento, punto de 6 pt—
Faltan datossin relleno, borde y texto secundarios, ícono infoFalta: 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óximamenteborde discontinuo, texto apagadoel 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.

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).