El catálogo de terapias — por qué así

Cómo funciona: como-funciona/terapias-catalogo.md · Decisiones: H1.4 (2026-08-28), H1.4-bis (2026-09-10), D-R1/D-R2/D-R3 (2026-09-09) · Normativos: ROADMAP_MAESTRO.md §2.5, MindTune_Design_System.md §0, §4.2, §4.18 · Última revisión: 2026-09-20. Citas por clave → referencias.md (pendiente de escribir).

1. Contexto y problema

Al empezar el desarrollo había una sola terapia, cableada en el código: mMIDST, sin catálogo y sin manera de agregar otra. El programa de tinnitus de Clínica Alemana, en cambio, indica cuatro cosas distintas según lo que tenga cada paciente. La app tenía que poder representar eso.

El problema de fondo no era técnico sino de tono. Un catálogo de terapias que el paciente no puede empezar todavía se parece peligrosamente a un juego: cosas grises que se «desbloquean». Y la persona que abre esta app no está jugando — está buscando alivio para algo que la tiene despierta de noche.

2. Lo que dice la evidencia

La cohorte propia tiene cuatro endotipos, obtenidos sin supervisión sobre 395 pacientes del programa: E1 de bajo impacto, E2 somatosensorial/bruxismo, E3 hipoacúsico de mayor edad, y E4, joven con hiperacusia y angustia alta. Separan por mecanismo y predicen qué terapia se le asignó a cada paciente (p < 1e-8).

Dos de esos endotipos gobiernan directamente el diseño de esta pantalla:

• E4 es la razón de la regla registro, no motivación: para una persona joven, hiperacúsica y angustiada, un catálogo que premia y castiga no es neutro. Una racha rota es iatrogénica.
• E3 —68 años, pérdida media de 38 dB— es la razón de que la tarjeta sea legible antes que elegante, y de que el dato faltante se diga con todas sus letras en vez de con un ícono.

3. Alternativas consideradas

3.1 Cómo mostrar cuatro terapias

3.2 Qué hacer con una terapia que todavía no se puede empezar

La regla operativa que salió de acá: el dato faltante se nombra siempre. «LDL por oído», no «datos del perfil». Y el atajo lleva directo a ese campo, no a la raíz del perfil.

3.3 El botón en una terapia no disponible

Se evaluó dejar Empezar → siempre visible y desactivado. Se descartó: nunca un control que no hace nada. Si falta un dato, el botón no está; lo que hay es la acción que sí sirve, adentro del acordeón.

3.4 «Próximamente»

El estado existe en el código y no se usa: las cuatro terapias están disponibles. Se dejó implementado porque el catálogo va a crecer, pero está explícitamente prohibido usarlo como decoración —una terapia que nadie va a construir no se anuncia.

3.5 La cuarta terapia: qué se reemplazó y por qué (2026-09-09, D-R3)

La entrada anterior, Reentrenamiento de rango dinámico, describía una escalera entre sesiones: el nivel subía por etapas a lo largo de semanas, partiendo por debajo del LDL medido del paciente.

Lo que Hayo pidió es otra cosa: el paciente calibra en cada sesión el techo que tolera hoy, y dentro de la sesión la intensidad fluctúa entre ese techo y el 60 % de sonoridad. Es desensibilización por exposición graduada, no TRT de banda ancha a bajo nivel.

Son dos terapias distintas, no un cambio de nombre. Por eso entró con id nuevo (manejo_hiperacusia) y rango_dinamico quedó retirado en el vocabulario de la bitácora, para que los eventos ya escritos sigan leyéndose. Consecuencia directa: el LDL dejó de ser requisito — un techo que se calibra cada vez no depende de un número medido una vez.

3.6 Por qué tres decisiones y no dos para las terapias de ruido

Inhibición residual y Manejo de hiperacusia comparten el estímulo —ruido de banda estrecha tipo audiómetro centrado en la Ft— y difieren solo en la dosificación. Por eso D-R1 es el estímulo, y D-R2 y D-R3 son las dos dosis. Separarlas así permite cambiar una dosis sin tocar el generador, que es código validado.

4. Decisiones

5. Consecuencias

Obliga a que cada terapia declare su ícono (una sin ícono no compila), su resumen en tres líneas y sus requisitos; y a que cada requisito sepa decir su nombre exacto y su destino.

Prohíbe candados, «desbloquear», «próximamente» decorativo, bajadas largas en la tarjeta cerrada, y controles que no hacen nada.

Toca otros temas: mmidst, induccion-de-filtrado (pendiente), inhibicion-residual (pendiente) y manejo-de-hiperacusia (pendiente) son las cuatro entradas; aprenderpendiente (pendiente) provee el requisito de lectura; diseno-visual-y-movimientopendiente (pendiente) define el chip, el matiz y el acordeón.

6. Límites conocidos y riesgos

1. El orden es fijo y no sabe nada del paciente. Las cuatro tarjetas se muestran siempre igual, en el mismo orden, a un paciente con hiperacusia severa y a uno sin ella. La personalización vive en Recomendaciones para mí, que todavía no tiene algoritmo (H8.3).
2. El requisito de lectura está inerte. Ver DF-09 en deuda.md.
3. Las dosis de las dos terapias de ruido no están firmadas. H2.4 sigue pendiente, y Cowork dejó constancia de una reserva clínica sobre la instrucción del techo tolerable.
4. Nadie ha visto esta pantalla en un teléfono de verdad, ni con letra grande. El acordeón con cuatro tarjetas y texto grande es justamente el caso donde el diseño compacto puede romperse.
5. Los nombres visibles no se han probado con pacientes. «Inducción de filtrado con Música» es preciso y largo; «mMIDST» es una sigla que no significa nada para nadie fuera del equipo. Es una decisión deliberada —no llamar TRAC a nada frente al paciente— pero su costo no está medido.

7. Qué revisar y cuándo

• Si alguien vuelve a proponer candados o «desbloquear»: está prohibido dos veces por escrito. La pregunta correcta es qué dato falta y cómo acortar el camino a completarlo.
• Cuando el catálogo pase de cuatro entradas: revisar si «las cuatro a la vista» sigue siendo posible, o si hay que agrupar. Es el supuesto sobre el que se eligió la tarjeta compacta.
• Cuando exista reglas_v1 (H8.3): decidir si el catálogo se reordena por recomendación o si se mantiene fijo y la recomendación vive solo en Mi MindTune. Hoy la respuesta es la segunda.
• Si H2.4 cambia una dosis: el resumen de la tarjeta lleva la dosis vigente adentro, así que cambia solo — pero la lección Cómo usarla correspondiente hay que revisarla a mano.
• Después del primer recorrido en el iPhone con letra grande: revisar si el resumen de tres líneas aguanta.

8. Historia

• 2026-08-28 — H1.4: catálogo declarativo, adelantado por el hilo de la biblioteca de música. Se fija el orden de presentación y se prohíben los candados.
• 2026-09-09 — D-R1, D-R2 y D-R3: el estímulo de ruido y las dos dosis. La cuarta terapia se reemplaza con id nuevo. H2.2 y H2.3 implementadas el mismo día (4200924).
• 2026-09-10 — H1.4-bis (09b42f7): tarjeta compacta, acordeón, íconos a medida, y el nombre visible de trac_mmidst pasa a mMIDST. Se ratifica la prohibición de candados.