Hoy y el recorrido del paciente — por qué así
Cómo funciona: como-funciona/hoy-y-recorrido.md · Decisiones: D-HY1 … D-HY5 (2026-09-22, Hayo) · Normativo:
MindTune_Recorrido_del_Paciente.md· Última revisión: 2026-09-22.
1. Contexto y problema
Hasta el 2026-09-22 la sesión del día en Hoy era mMIDST salvo indicación del equipo, escrito como una
constante en hoy_screen.dart. Era correcto cuando la app tenía una terapia; ya tenía cuatro, un perfil
de 12 secciones, tinnitumetría con tres caminos y un módulo de lecciones. Al pie se habían ido juntando
tres tarjetas (MI PERFIL, Afinar el sonido, Aprender) sin nada que las ordenara. Y la constante tenía
una consecuencia clínica concreta: a un paciente recién llegado, sin Ft, Hoy le decía Todavía no se
puede empezar · Falta: Ft, cuando Inducción de filtrado —que no necesita Ft— estaba lista en el
catálogo.
Hayo fijó el esquema: tres lugares, siempre en el mismo orden y con una tarjeta cada uno (la terapia más recomendada; el siguiente paso en el modelo evaluación → tratamiento; qué aprender), y una regla base que no depende de ningún algoritmo: mientras el perfil no esté completo, el lugar 1 es Inducción de filtrado.
2. El recorrido, en etapas (el modelo)
Las etapas son estados observables en el teléfono, no fechas. Un paciente puede saltar etapas (trae su Ft y completa el perfil el primer día) o quedarse meses en E2 (usa Inducción y nunca abre el perfil): las dos cosas son legítimas y Hoy tiene que servir en las dos.
| Etapa | Cómo se reconoce | Qué hace el paciente | Qué hace Hoy |
|---|---|---|---|
| E0 Instalación | Primera apertura | Ve la marca (vuelta completa) | No se ve: manda el primer uso |
| E1 Primer uso | Lección 0 no vista o consentimientos sin responder | Bienvenida → Lección 0 → Antes de empezar | No se ve todavía |
| E2 Empezar | Perfil sin empezar o parcial; sin sesiones en 7 días | Elige música, empieza Inducción, abre el perfil de a poco | L1 Inducción (base) · L2 el perfil · L3 rama base |
| E3 En curso, perfil incompleto | ≥ 1 sesión en 7 días; perfil parcial | Sesión diaria; completa secciones | L1 la en curso · L2 el perfil / la Ft · L3 Cómo usarla o base |
| E4 Perfil completo | 12 de 12, vigente | Ve Recomendaciones para mí | L1 en curso o reglas_v1 · sin L2 · L3 Por qué funciona |
| E5 Revisión | Una sección de estado vencida (28/14/56 días) | Actualiza THI/EVA/GÜF/Goldberg | L2 actualizar el perfil |
| T Con equipo (transversal) | C2 aceptado; indicación vigente | Recibe la indicación; acepta o no | L1 la indicación, siempre primero |
El normativo trae además un diagrama de flujo en Mermaid con el mismo contenido. No está acá: cuando se escribió esta página el sitio de docs (DOC.1) no renderizaba Mermaid, y el normativo mismo dice que en ese caso la tabla basta (RP-P4). Desde DOC.3 el sitio sí lo dibuja (el flujograma de las reglas está en como-funciona/recomendaciones.md); copiar este diagrama queda para la reverificación de esta página.
3. Alternativas consideradas
| Alternativa | A favor | En contra | Resultado |
|---|---|---|---|
| Dejar la constante (mMIDST por defecto) | Cero trabajo | Pide Ft a quien no la necesita; no escala a cuatro terapias | Descartada |
| Las reglas sobre la terapia en curso | La app «sabe más» en cuanto el perfil se completa | mMIDST y las de ruido son tratamientos de 12 semanas: cambiar la terapia a mitad porque se completó el perfil interrumpe lo que sí se está haciendo | Descartada (D-HY3) |
| Ignorar el historial | Más simple | Propone Inducción a quien lleva seis semanas de mMIDST | Descartada (D-HY3) |
| En curso sobre las reglas, y lo que propongan las reglas como sugerencia secundaria | El paciente decide; mismo principio que con el equipo (H6.9): se propone, no se impone | Una fila más cuando haya reglas | Elegida |
| L2 siempre con algo (fila perfil al día) | Estructura fija | Ocupa espacio permanente con algo ya hecho; proponer siempre algo fabrica tareas | Descartada (D-HY2) |
| L2 desaparece si no hay nada | Coherente con §0 regla 2 (registro, no motivación) | La pantalla cambia de alto según el estado | Elegida |
| Citar 7 de cada 10 en la tarjeta de Hoy | Es el argumento más fuerte | Es una afirmación clínica sin fuente publicable todavía (PF-P1) | Descartada (D-HY5): la cifra vive solo en Perfil §2.3, que ¿Por qué esta? abre |
| Reescribir §2.3 con la frase corta | Un solo texto | §2.3 es normativo y más completo | Descartada (D-HY5): la frase corta converge con §2.3, no la reemplaza |
| La matriz como dato en el repo | Una sola fuente ejecutable | Más ingeniería de la que hoy conviene | Descartada (D-HY1) |
4. Decisiones
| id | Fecha | Quién | Qué | Por qué |
|---|---|---|---|---|
| D-HY1 | 2026-09-22 | Hayo | H8.3-a es solo el orquestador y la regla base; las reglas mecanismo → terapia son H8.3-b. La fuente del recorrido es el normativo; docs/ lo explica en este par de páginas | Una regla a medias que recomienda por una razón mal calculada es peor que no recomendar |
| D-HY2 | 2026-09-22 | Hayo | Sin nada que evaluar ni actualizar, L2 no se muestra | Una fila pasiva es ruido; proponer siempre algo fabrica tareas |
| D-HY3 | 2026-09-22 | Hayo | Prelación equipo > en curso > reglas_v1 > base; si las reglas proponen otra que la en curso, sugerencia secundaria | No interrumpir tratamientos de 12 semanas; el paciente decide |
| D-HY4 ⏳ | 2026-09-22 | Hayo | L2 provisional: vencido → actualizar; nunca empezado → empezar; Ft a medio afinar → la parte corta. El perfil parcial no se empuja desde Hoy | Hayo definirá el orden según parámetros del perfil (RP-P2) |
| D-HY5 | 2026-09-22 | Hayo | Tarjeta base: Inducción de filtrado con Música · Para empezar hoy, sin perfil: útil en la gran mayoría de los casos y a menudo suficiente · ¿Por qué esta? → la nota literal de §2.3. La cifra 7/10 no aparece en Hoy | La cifra espera PF-P1 antes de la App Store |
5. Consecuencias
FuenteDeRecomendacionganóindicacion,en_cursoybase: Hoy dice de dónde salió la terapia, y la bitácora lo registra con los mismos ids.- Siguiente para ti (Aprender) y L3 son una sola función: si el orden de Aprender §5.3 cambia, cambia en las dos pantallas.
- La bitácora gana
hoy.planyhoy.toque. Sin ellos H8.3-b se escribiría a ciegas: son lo que después dice si la gente toca lo que Hoy propone. - Las tarjetas MI PERFIL y Afina el sonido dejaron de existir como tarjetas; sus textos siguen, dentro de L2.
6. Límites conocidos y riesgos
- La rama
baseestá en construcción (RP-P1): lo que Hayo llama «Cómo entendemos el tinnitus hoy» ya tiene casilla, pero sin sus cuatro lecciones L3 no tiene qué proponer al recién llegado más que la guía de la música. - D-HY4 es provisional: un paciente con el perfil a medias no recibe ningún empujón desde Hoy.
- ¿Por qué esta? podría leerse como duda sobre la terapia y no como pregunta: eso solo se juzga en el iPhone (H8.3-a-bis).
- En curso se mide con 7 × 24 h, no con días de calendario: una sesión de hace exactamente una semana a una hora más temprana que ahora ya no cuenta.
7. Qué revisar y cuándo — reglas_v1 (pendiente H8.3-b)
Cerrado: H8.3-b (
793aa62) y H9.9 (90436f2) escribieronreglas_v1y las siete preguntas de abajo quedaron respondidas enMindTune_Reglas_v1.md§10. Lo que sigue es la historia; lo vigente está en recomendaciones.md.
Lo que Hayo adelantó el 2026-09-22, no normativo todavía:
- Menos de un mes de uso → siempre Inducción de filtrado.
- Después, frente a persistencia → mMIDST.
- Con fuerte inhibición residual → una mezcla en la que Inhibición residual entra en la recomendación.
- Con fuertes indicadores de hiperacusia → lo primerísimo es la terapia de hiperacusia.
Correspondencia con el modelo HBK (Modelo_HBK_Tinnitus.md §5): hiperacusia = mecanismo 2; Inducción =
5; mMIDST = 6; Inhibición residual = 7. Los mecanismos 1, 3, 4 y 8 no tienen terapia en la app y saldrían
como acción externa (seguridad primero).
Las siete preguntas que H8.3-b tiene que cerrar antes de escribir una regla: cómo se cuenta un mes de uso; qué es persistencia; de dónde sale fuerte inhibición residual; qué son fuertes indicadores de hiperacusia; cuál gana entre hiperacusia («lo primerísimo») y el mes de Inducción («siempre»); si la seguridad bloquea o solo antecede; y si el horario sugerido lo lleva L1 o solo Recomendaciones para mí. Cuando se decidan, se actualiza primero el normativo y después estas páginas.
8. Historia
- H8.3-a (2026-09-22): el orquestador y la regla base. Commit
c33900a, informeINFORME_H8.3a_Orquestador_de_Hoy.md. Desviaciones declaradas en su §3 y en deuda.md DF-18 … DF-22. - Antes: H1.8 (la sesión vuelve a Hoy, mMIDST), H6.9 (la barra del equipo sale de Hoy), H7.1 (la tarjeta Aprender), H8.1 (MI PERFIL), H8.2 (la parte corta).