Recomendaciones (reglas_v1)
Por qué así: por-que-asi/recomendaciones.md · Normativo:
MindTune_Reglas_v1.md(entero),MindTune_Insumos_reglas_v1.md,MindTune_Mi_MindTune_y_Perfil.md§5–§6 y §9 · Código:lib/domain/reglas_v1.dart,lib/domain/plan_de_hoy.dart,lib/domain/cadencias.dart,lib/domain/siguiente_leccion.dart,lib/data/plan_de_hoy_providers.dart,lib/features/hoy/,lib/features/perfil/recomendaciones_screen.dartVerificado contra5e54593el 2026-10-05 (la dosis ysesionHecha, contra67c165ael 2026-10-10; la versión 1.1 —Reglas §15—, contra41a905f+ H8.20 el 2026-10-29) · Probado en iPhone: no (H8.3-b-bis, H9.9-bis, H8.16-bis, H8.17-bis, H10.1-bis, H8.20-bis)
Qué es, en tres frases
reglas_v1 es una función del dominio que lee el perfil del paciente, sus sesiones y lo que contestó sobre
sueño y ánimo, y devuelve qué terapia de sonido conviene hoy, qué conviene hacer fuera de la app, qué
leer o practicar, con qué dosis y a qué hora. No es una caja negra: cada recomendación lleva el id de
la regla que la produjo (33 reglas, tabla de abajo; versión 1.1) y un texto (motivo) que nombra el dato que la
disparó. No bloquea nada: ninguna regla apaga una terapia ni impide empezarla.
Dónde está en la app
| Dónde | Qué muestra de las reglas |
|---|---|
Hoy (/hoy), L1 | La terapia del día, si no hay indicación del equipo ni una terapia en curso (ver Quién manda abajo), con el motivo como bajada y la franja horaria como subtítulo (Mejor en la tarde, según tu perfil) |
| Hoy, sobre L1 | Una tarjeta neutra ADEMÁS DE MINDTUNE: la acción externa de mayor fuerza (kinesiología, médico, salud mental, otorrino). Toda la tarjeta lleva a Recomendaciones para mí |
| Hoy, bajo L1 | La sugerencia secundaria (MINDTUNE TAMBIÉN SUGIERE) y la fila SI SUBE DE GOLPE · Inhibición residual · botón 15 min (la regla R-SOS; no aparece si la IR ya es L1 o la secundaria del día) |
| Hoy, L2 | Afinar el tono cuando las reglas de mMIDST la necesitan y no hay Ft (posición 8 de L2) |
| Hoy, L3 | Debajo de la lección, una fila PARA PRACTICAR con una Pausa (Respirar lento, Para dormir, Soltar en un minuto o, como último recurso, una guía de Mandíbula y cuello). Arriba de L3, ¿Necesitas ayuda ahora? (S4) |
Mi MindTune → Perfil → Recomendaciones para mí (/perfil/recomendaciones) | Todo junto: arriba los dos textos fijos (Estas son sugerencias, no deberes… y Si un día no alcanzaste…, Reglas §15.4), las acciones externas, Terapias de sonido con el motivo y la dosis de cada una (la franja bajo la primera), la fila SOS, y Para aprender y practicar (lecciones, Pausas y las cuatro guías de Mandíbula y cuello como un paquete) |
Mi semana (/semana), desde la fila Mi semana › de Hoy (bajo L3) y de Recomendaciones para mí (bajo la fila SOS) | Una grilla de lunes a domingo × las terapias de Recomendaciones (sin el rescate), con un punto por sesión hecha y la sugerencia de veces al día de cada una. Ver Mi semana abajo |
Cuándo corre
- En Hoy: solo con el perfil propio completo y vigente (N de N;
estadoDelPerfil == completoYVigente). Con el perfil a medias o vencido, Hoy no usa las reglas: L1 sale de la indicación, la terapia en curso o la base (Inducción de filtrado). - En Recomendaciones para mí: con el perfil completo, vigente o vencido. Algunos datos tienen vigencia propia y se descartan si son viejos; otros no (ver Las entradas). Con el perfil incompleto la pantalla muestra la nota de Inducción y N secciones sin responder.
- Aunque el perfil esté incompleto, lo que antecede por seguridad: la fila ¿Necesitas ayuda ahora? (S4) y la hoja recurrente de R2; y la propuesta del ISI en L2 (P2), cuando ninguna fila anterior de la prelación de L2 (diario, Actualiza o Empieza tu perfil, EVA) la gana. Los avisos de seguridad del perfil (§9) se calculan aparte y no dependen de las reglas.
- Se recalcula al cambiar cualquier dato, al cambiar el idioma (los
motivose vuelven a leer del ARB) y al volver la app al frente (las ventanas de 14 días vencen por fecha).
⚠️ Desfase: quien tenía el perfil completo antes de que existiera P16 (Oídos tapados y alergia, H8.17) pasa a N − 1 de N y pierde las reglas en Hoy hasta responderla; Hoy no lo avisa. Ver deuda.md DF-29.
Quién manda en L1
La prelación de H8.3-a es equipo > en curso > reglas_v1 > base. Desde la versión 1.1 (D-RV16, Reglas
§15.4): cuando las reglas devuelven dos o más terapias recomendadas, en curso cede ante el ciclo (equipo >
reglas > base); con una sola, sigue como antes. Sin eso el ciclo no se vería nunca: desde la primera sesión
L1 sería siempre la en curso. (D-RV16 estrecha la D-HY3 de Hayo; es la opción recomendada del lote, Q-H6, y
se puede retirar.)
| # | Fuente | Cuándo |
|---|---|---|
| 1 | Indicación del equipo (C2) | Hay una indicación vigente de una terapia que la app puede correr |
| 2 | En curso | Alguna sesión de una terapia en los últimos 7 días; con varias, la de más sesiones en 14 días. Se salta con 2 o más recomendadas |
| 3 | reglas_v1 | La primera terapia de la salida de las reglas (con 2 o más recomendadas, la que eligió el ciclo) |
| 4 | Base | Inducción de filtrado, siempre |
Si las reglas proponen otra terapia que la que quedó en L1 (por el equipo o por la en curso), la de las reglas va como sugerencia secundaria; si las reglas mismas son L1, la secundaria es su segunda terapia. La fila SOS no aparece si L1 o la secundaria ya son Inhibición residual (una sola IR en pantalla).
Las entradas
Todas se calculan del perfil propio (no del indicado por el equipo), en variablesDeReglas.
Solo cinco datos tienen vigencia (vigenteParaReglas, dos cadencias; fuera de eso son «sin dato»): el
grado del THI, el GÜF, el Goldberg, la prioridad de P12 y P16. Los demás se usan sin tope de
antigüedad: la serie entera de EVA (basal, actual, persistencia, mejoría clara), el THI basal y el actual
(ΔTHI), P05 (la peor franja, también en P4) y la respuesta sobre la noche de P4. En Hoy no se nota, porque
Hoy solo corre las reglas con el perfil completo y vigente; en Recomendaciones para mí con el perfil
vencido, esos datos viejos cuentan igual.
⚠️ Desfase: Perfil §5.1 dice que un dato de estado vale para
reglas_v1mientras no supere dos cadencias; el código lo aplica solo a los cinco de arriba. DF-31.
| Variable | Qué es, en el código | De dónde |
|---|---|---|
sesionHecha | Una sesión con la dosis mínima útil de su terapia escuchada o la dosis completa: Inducción ≥ 25 min, mMIDST ≥ 30, IR ≥ 1 min de ruido (el silencio de observación no suma; kDosisMinimaUtil, por terapia); hiperacusia, que dura menos, cuenta por la dosis completa. En Inducción, completa es llegar al fin de la bajada | SesionRegistrada.escuchado, .completa |
sesionesHiperacusia / diasDesdeHiperacusia | Las sesiones hechas de Manejo de hiperacusia (las cortas que no llegan a su dosis no cuentan) / días de calendario desde la primera de ellas (sin ninguna, nulo). Con las dos, mmidstTrasHiperacusia = ≥ 10 sesiones y ≥ 14 días (R.1, D-R1H1). Solo se leen con H1 | Historial |
semanaDeUso | 0 sin sesiones hechas; si no, max(⌊días desde la primera / 7⌋, ⌊sesiones hechas / 5⌋) + 1: 7 días o 5 sesiones hechas, lo que ocurra primero | Historial |
gradoThi | Grado 1–5 del último THI vigente (42 d) | P06 |
evaBasal / evaActual | Mediana de las EVA hasta 7 días después de la primera sesión (incluidas las de antes de empezar; sin ninguna, la primera) / mediana de las dos últimas de después de la basal | P04 y la hoja semanal |
evaHoy | La EVA registrada hoy | P04 |
persistencia | Semana ≥ 3 y (la EVA bajó menos de 2 o, con dos THI, el THI bajó menos de 7) | EVA, THI |
mejoriaClara | Semana ≥ 3 y (la EVA bajó 3 o más o el THI bajó 20 o más) | EVA, THI |
| severo | THI grado ≥ 4 o EVA de hoy ≥ 8 | THI, EVA |
gradoGuf | Grado 1–4 del último GÜF vigente (56 d). Grado 2 = 11–17 puntos | P07 |
goldbergUmbral | Último Goldberg vigente con ansiedad ≥ 4 o depresión ≥ 2 | P09 |
levinePositivo / somaticoLeve | Levine positivo / bruxismo o dolor de mandíbula o cuello, con Levine negativo o no hecho | P10 |
ptaPeor, hipoacusiaProbable | El PTA del peor oído; probable = PTA ≥ 40 dB o (pérdida conocida, sin audífonos y 60 años o más) | P11 / P00 |
ftHz | La Ft en uso (la que suena: escrita, sostenida o calculada; la indicada por el equipo si no hay propia). Desde la versión 1.1 ya no hay «Ft alta»: el corte de 1 500 Hz se retiró (Q1) | P03 |
irRespuesta, irFuerte, irNula, irSubio | Desde IR.3, las dos últimas respuestas medidas en la app de la serie de P13 (irSerie): la prueba del perfil o la pregunta del final de una sesión de IR, sin distinguir (sí · parcial · no · subió). Sin ninguna, la IR escrita a mano o copiada del equipo, que también cuenta como respuesta. Fuerte = alguna sí; nula = dos no medidos en la app; subió = alguna de las dos es subió y tiene menos de 56 días (H1-IR); una subió escrita sin medida en la app usa la fecha de P13 respondida, y sin fecha no cuenta | Serie de IR (P13) y sesiones de IR |
prioridadPaciente | Lo primero de Lo que más te molesta, vigente (112 d) | P12 |
franjaPeor | La franja de días hábiles con el nivel más alto; empate, la más tardía | P05 |
pulsatil, unilateralReciente | Pulsátil = sí; un solo oído y de comienzo reciente | P02 |
| grado Tubaria | 0, 2 o 3 según la última P16 vigente (112 d): 2 = media del ETDQ-7 sin el ítem 6 ≥ 2,1, o se tapan en altura y en avión; 3 = lo anterior y alergia | P16 |
r1, r2, r3Reciente, senalDeSueno, isi, post | Los insumos de salud mental y sueño (InsumosSaludMental). r1 = POST ≥ 4; r2 = en 14 días Goldberg sobre umbral, THI grado 5 o ISI ≥ 22; r3Reciente = la tarjeta de ayuda se abrió por una palabra de riesgo en 14 días | P14, P15, P09, P06, P08 |
pausasHechas, pulsoPeor | Las Pausas completas del cuaderno (P6) y si el último pulso de dieta blanda terminó en peor (K2) | Cuaderno |
⚠️ Desfase: Reglas §1.1 define
ftHzcomo la Ft calculada; el código usa la Ft en uso, que respeta la escrita y la sostenida (la que suena). DF-24.
⚠️ Desfase: Reglas §10 dice «GÜF grado ≥ 2 (≥ 10 puntos)», pero el grado 2 del instrumento empieza en 11. Manda el grado: con 10 puntos no hay H1. DF-25.
El ISI está apagado en la app compilada (kIsiDisponible = false, D-SM19): hoy P2, P4 y los grados de
sueño por ISI nunca se dan; el grado de sueño sale solo de la señal de sueño.
Los grados (no se muestran)
Cada dimensión se traduce a un grado 0–4 con la misma escala, para poder ordenar una contra otra. El
grado no se le muestra al paciente ni aparece en ningún motivo; ordena las acciones externas y da la
dimensión principal (dim_top) de la bitácora.
| Dimensión | 1 | 2 | 3 | 4 |
|---|---|---|---|---|
| Emocional | R1 | — | Goldberg sobre umbral, o R2 | R2 por THI grado 5 o ISI ≥ 22; R3 reciente |
| Hiperacusia | — | GÜF grado 2; IR subió (al menos 2) | GÜF grado 3 | GÜF grado 4; sensibilidad primero en P12 |
| Sueño | — | Señal de sueño sin ISI; ISI leve | ISI moderado | ISI severo |
| Tinnitus | THI grado 1 | THI grado 2 | THI grado 3 | THI grado 4–5; EVA actual ≥ 8 |
| Somatosensorial | somaticoLeve | — | Levine positivo | Levine positivo y dolor de mandíbula o cuello |
| Audición | PTA 25–39 sin audífonos | — | hipoacusiaProbable | PTA ≥ 40 y pérdida de audición primero en P12 |
| Tubaria | — | Sobre el corte, o altura + avión | Lo anterior + alergia | — |
| Cefalea | — | P17 positiva (ID-Migraine ≥ 2) | — | — |
En empate gana la primera en este orden: emocional (solo con R2 o R3) › hiperacusia › sueño › tinnitus › somatosensorial › audición › tubaria › cefalea; sin R2 ni R3, la emocional va al final.
Las reglas, una por una
Treinta y tres reglas en cinco capas (versión 1.1, 2026-10-28: entraron H1-IR, R0-IR, M-pre y C-ciclo; se
retiraron M1-ft-alta y M1-ft-baja; M1 dejó de exigir persistencia y R-sist de alternar por día. R.1, 2026-11-01,
D-R1H1 de Hayo: con H1, mMIDST espera 2 semanas y 10 sesiones de hiperacusia; ningún id nuevo). El id es el mismo en el código (ReglaV1, kReglasV1), en la bitácora y en
el servidor, y un test lo vigila: mindtune_app/test/doc3_ids_de_reglas_test.dart compara esta tabla con
kReglasV1 (ninguna regla del código sin fila, ninguna fila sin regla). Evidencia es la de kEvidenciaDeRegla:
empírica si el normativo cita datos, a priori si viene del criterio clínico de Hayo o de una
decisión del lote.
| id | Capa | Dispara cuando… | Qué produce | Evidencia |
|---|---|---|---|---|
S1 | 0 · Seguridad | Tinnitus pulsátil | Acción externa fuerte: otorrinolaringólogo. En Hoy deja de mostrarse cuando el paciente tocó Entendido en el aviso del perfil | a priori |
S2 | 0 · Seguridad | Un solo oído, de comienzo reciente | Acción externa fuerte: consulta médica con audiometría. Igual que S1 con Entendido | a priori |
S3 | 0 · Seguridad | r2 | Acción externa fuerte: salud mental; además reentrenar_01_el_circulo y Respirar lento en el apoyo | empírica |
S3-bajo | 0 · Seguridad | Goldberg sobre umbral o THI grado ≥ 3, sin r2 | Acción externa sugerida: salud mental (Si quieres…), y la primera lección no vista de Reentrenar la atención al tinnitus | empírica |
S4 | 0 · Seguridad | r3Reciente | Fila ¿Necesitas ayuda ahora? en L3; ni Escucharlo ni Entrenar el oído en ninguna sugerencia | a priori |
K1 | 1 · Externas | Levine positivo | Kinesiología fuerte y las cuatro guías de Mandíbula y cuello en el apoyo | empírica |
K2 | 1 · Externas | Bruxismo o dolor de mandíbula/cuello, sin Levine positivo | Kinesiología sugerida (fuerte si el último pulso de dieta blanda terminó en peor), base_06_mandibula_y_cuello y las cuatro guías | empírica |
A1 | 1 · Externas | hipoacusiaProbable | Consulta médica fuerte (evaluación de audífonos) y base_01_que_es | empírica |
A2 | 1 · Externas | PTA del peor oído entre 25 y 39 dB | Solo base_01_que_es en el apoyo (débil, sin acción externa) | empírica |
T1 | 1 · Externas | Grado Tubaria ≥ 2 | Consulta médica sugerida (grado 2) o fuerte con el ensayo antialérgico (grado 3), y base_06_mandibula_y_cuello. Ningún texto nombra un fármaco | empírica |
MG1 | 1 · Externas | P17 positiva vigente (ID-Migraine ≥ 2, 112 días): migranaPositiva, dimensión cefalea grado 2 | Consulta médica sugerida por migraña (fuerte si además es pulsátil; se suma a S1) y base_10_migrana_y_tinnitus. No cambia ninguna terapia de sonido. Si el equipo anotó la migraña en tratamiento (P00, campo migranaEnTratamiento), no dispara; el dato y el grado quedan | a priori |
H1 | 2 · Hiperacusia | GÜF grado ≥ 2 o sensibilidad primero en P12 | L1 Manejo de hiperacusia desde el principio (también en la semana 0, sin sesiones), siempre L1 aunque haya ciclo; desde la semana 2, Inducción de filtrado como recomendada; mMIDST recién con ≥ 10 sesiones hechas de hiperacusia y ≥ 14 días desde la primera (mmidstTrasHiperacusia, D-R1H1), con Ft y sin mejoría clara; antes, mMIDST queda Por ahora no con un motivo que dice cuándo se activa (Primero bajar la sensibilidad: mMIDST se suma después de dos semanas y diez sesiones…). Sin Ft, L2 pide afinarla desde los 7 días de la primera sesión hecha de hiperacusia; Respirar lento siempre junto, en el apoyo | a priori |
H1-IR | 2 · Hiperacusia | irSubio: alguna de las dos últimas respuestas de IR es subió, de menos de 56 días | Lo mismo que H1 aunque el GÜF sea grado 1 o falte, con su propio motivo (Después del ruido tu tinnitus subió un rato…); el grado de hiperacusia sube al menos a 2 | a priori |
H2 | 2 · Hiperacusia | GÜF grado 1 sin sensibilidad primero | Nada: queda anotada; la terapia sigue en el catálogo | a priori |
B0 | 3 · Sonido | Ninguna de las de abajo (y como guarda final: L1 nunca queda vacía) | L1 Inducción de filtrado; el motivo cambia después de la semana 3 | a priori |
M1 | 3 · Sonido | Semana ≥ 4 y hay Ft (desde la versión 1.1, sin exigir persistencia, que se sigue calculando). Con H1, en lugar de la semana: mmidstTrasHiperacusia (≥ 10 sesiones hechas de hiperacusia y ≥ 14 días desde la primera; R.1, D-R1H1) | mMIDST e Inducción como recomendadas (el ciclo elige L1). Con H1, mMIDST se suma detrás de la hiperacusia, con su propio motivo (Con dos semanas y diez sesiones de Manejo de hiperacusia…) | empírica |
M1-precoz | 3 · Sonido | Severo, semana ≥ 2 y hay Ft (sin M1), sin H1 (con H1 la severidad no adelanta mMIDST: manda D-R1H1) | Lo mismo que M1, desde la semana 2 | a priori |
M-pre | 3 · Sonido | Semana ≤ 3, hay Ft y sin H1 (ni mMIDST ya en la lista). Con H1, mMIDST espera D-R1H1 Por ahora no (R.1) | mMIDST después de las recomendadas, Recomendada · mejor después de Inducción; no entra al ciclo | a priori |
M0 | 3 · Sonido | Semana ≥ 4 y mejoría clara | L1 = la terapia más usada en 14 días (o Inducción); sin secundarias. Va antes que M1 | a priori |
R-SOS | 3 · Sonido | Alguna de las dos últimas respuestas de IR es sí o parcial, sin subió | Fila SOS de Inhibición residual bajo L1, como rescate (no es L1 ni secundaria), salvo que la IR sea L1; Hoy la omite también si la IR es la secundaria (una sola IR en pantalla) | a priori |
R-sist | 3 · Sonido | IR fuerte, sin subió | La IR es una recomendada más (entra al ciclo), de 1 a 25 min, 2 o 3 veces al día, con la espera de D-IR5. Ya no alterna por día. Con M0, aparte, solo en Recomendaciones | a priori |
R0 | 3 · Sonido | Dos no seguidos en la app | IR sale de la lista (nunca si es L1) y Recomendaciones lo dice en una línea | a priori |
R0-IR | 3 · Sonido | irSubio | Ninguna IR: ni en la lista, ni fila SOS, ni sistemática, ni la prueba de R-sin-dato, mientras dure (56 días sin otra subió) | a priori |
R-sin-dato | 3 · Sonido | Sin ninguna respuesta de IR (ni de la app —prueba o sesión— ni escrita en P13), semana ≥ 2, hay Ft, sin M0 | IR al final de la lista: prueba una sesión y contesta la pregunta del final (sin línea de dosis; estado Completa tu perfil para saber) | a priori |
C-ciclo | 3 · Sonido | Dos o más terapias recomendadas | Van primero las de sesión hecha más antigua (nunca hecha, primero; empate, el orden de arriba); con H1 la hiperacusia queda en L1 y el ciclo ordena las demás. L1 conserva el id de su regla; el motivo sigue la posición (Inducción en L1 no dice después; la hiperacusia no nombra a Inducción si la secundaria es otra). En Hoy, en curso cede (D-RV16) | a priori |
P1 | 4 · Apoyo | r1 (POST ≥ 4) | reentrenar_01_el_circulo y Respirar lento | a priori |
P2 | 4 · Apoyo | Señal de sueño, sin ISI y con el ISI encendido | L2 propone el ISI (hoy nunca: el ISI está apagado) | a priori |
P3 | 4 · Apoyo | Señal de sueño o ISI ≥ 8 | La primera lección no vista de Volver a dormir bien, antes que las de Reentrenar la atención al tinnitus | a priori |
P4 | 4 · Apoyo | ISI ≥ 15 y la peor franja es al acostarse (o despierta casi siempre de noche) | Para dormir en L3, solo entre las 20:00 y las 05:00 | a priori |
P5 | 4 · Apoyo | Levine positivo o somaticoLeve | Las guías de Mandíbula y cuello en el apoyo (al final); en L3 solo como último recurso, con base_06 vista | a priori |
P6 | 4 · Apoyo | Cinco Soltar el cuerpo completas y ninguna Soltar en un minuto | Soltar en un minuto, hasta hacerla una vez | a priori |
P7 | 4 · Apoyo | reentrenar_06_no_es_una_alarma no vista, o escucharloNoConviene: r3Reciente, Goldberg sobre umbral en 14 días o EVA de hoy ≥ 8 | Nunca se sugiere la Pausa Escucharlo. Con escucharloNoConviene además se salta reentrenar_06, la lección que lleva a ella; con reentrenar_06 solo no vista, esa lección sigue siendo la que se propone | a priori |
P8 | 4 · Apoyo | Semana ≥ 4 y la EVA bajó 2 o el THI bajó 7 | La lección Olvidarse de la app es buena señal (base_08_olvidarse) | a priori |
Cómo se combinan, en el orden en que el código las evalúa (reglasV1, Reglas §9):
- Capa 0 (S1–S4) y los grados.
- Capa 1 y orden de las acciones externas: primero la fuerza (fuerte antes que sugerida); a igual fuerza, las de Capa 0 en su orden (S1, S2, S3/S3-bajo) y después las de Capa 1 por el grado de su dimensión, de mayor a menor. La primera es la tarjeta de Hoy.
- Terapias: H1 / H1-IR > M0 > M1 / M1-precoz > B0 arman las recomendadas; R-sist suma la IR; con dos o más, C-ciclo las ordena; después, en este orden, M-pre, R-SOS, R0, R0-IR y R-sin-dato ajustan la lista.
- Apoyo: P1–P8; Escucharlo (P7) y Entrenar el oído (S4) se filtran al final; las guías van al final.
- Si la lista quedara vacía o empezara por un rescate, Inducción (B0).
⚠️ Desfase: Reglas §4 trae un solo
motivopara T1, que menciona la alergia; el código usa los dos deMindTune_Tubaria_P16.md§3 (sin alergia y con alergia), para no decirle «tienes alergia» a quien no la tiene. DF-30.
El flujograma
Es el de MindTune_Reglas_v1.md §12, corregido para que diga lo que hace el código y partido en dos
para que se lea en pantalla: primero lo que antecede (seguridad y acciones externas), después cómo se
elige la terapia. Las diferencias con el normativo están debajo.
1. Lo que antecede: se calcula antes que la terapia y nunca la impide.
flowchart LR
E[Perfil, sesiones, insumos] --> S{Seguridad}
S -->|pulsátil| S1[S1 · otorrino]
S -->|unilateral reciente| S2[S2 · médico]
S -->|R2| S3[S3 · salud mental, reentrenar_01, Respirar]
S -->|Goldberg o THI ≥ 3 sin R2| S3b[S3-bajo · salud mental, sugerida]
S -->|R3 reciente| S4[S4 · ayuda ahora, sin Escucharlo]
E --> X{Externas, por grado}
X -->|Levine +| K1[K1 · kinesiología + guías]
X -->|bruxismo o dolor| K2[K2 · kinesiología sugerida + guías]
X -->|PTA ≥ 40| A1[A1 · audífonos]
X -->|PTA 25–39| A2[A2 · lección]
X -->|P16 grado ≥ 2| T1[T1 · médico]
X -->|P17 positiva, sin «en tratamiento»| MG1[MG1 · médico + base_10]2. La terapia: las recomendadas, el ciclo, y lo que se suma al final (versión 1.1).
flowchart TD
H{GÜF ≥ 2, sensibilidad o IR subió} -->|sí| H1[H1 / H1-IR · hiperacusia fija en L1 + Respirar]
H -->|no| MC{Mejoría clara}
MC -->|sí| M0[M0 · la más usada]
MC -->|no| W{Semana ≥ 4, o severo y ≥ 2}
W -->|sí, con Ft| M1[M1 o M1-precoz · mMIDST + Inducción]
W -->|sí, sin Ft| PF[B0 · Inducción, afinar la Ft en L2]
W -->|no| B0[B0 · Inducción]
H1 --> RS{IR fuerte}
M1 --> RS
PF --> RS
B0 --> RS
RS -->|sí| RI[R-sist · la IR se suma a las recomendadas]
RS -->|no| C{2 o más recomendadas}
RI --> C
C -->|sí| CC[C-ciclo · la de sesión hecha más antigua primero]
C -->|no| AJ[Ajustes a la lista]
CC --> AJ
M0 --> AJ
AJ --> MP[M-pre · mMIDST después, semana ≤ 3 con Ft]
MP --> SOS[R-SOS · rescate si la IR no es L1]
SOS --> R0[R0 / R0-IR · IR fuera]
R0 --> RP[R-sin-dato · probar IR]
RP --> AP[Apoyo P1–P8]
AP --> OUT[Hoy: equipo, reglas si hay ciclo, en curso, reglas, base]Cómo leer el segundo: GÜF ≥ 2 es el grado del GÜF; IR subió es una respuesta subió de menos de 56 días entre las dos últimas; mejoría clara exige la semana 4; severo es THI grado ≥ 4 o EVA de hoy ≥ 8; la Ft es la en uso. H1 deja la hiperacusia siempre en L1 (y desde la semana 2 suma Inducción; con Ft, 10 sesiones hechas de hiperacusia y 14 días desde la primera, también mMIDST; antes, Por ahora no: R.1, D-R1H1); M0 deja la terapia más usada, sin secundarias; M1 o M1-precoz dan mMIDST e Inducción. Con dos o más recomendadas el ciclo pone primero la que lleva más tiempo sin una sesión hecha. Los ajustes se aplican en ese orden sobre la lista ya elegida, cada uno solo si su condición se cumple (tabla de arriba).
Diferencias con el flujograma del normativo (Reglas §12; todas declaradas en los informes de los hitos):
- M0 va antes que M1, no en paralelo: con mejoría clara en la semana 4 no se empuja mMIDST (INFORME_H8.3b §3, punto 3). En el normativo M0 no tiene salida; en el código sigue el resto de los ajustes (fila SOS incluida).
- H1 también se dispara con sensibilidad primero en P12, no solo con el GÜF.
- La IR fuerte entra al ciclo con H1 y M1 también (solo con M0 va aparte); el normativo (§12) aún dibuja la versión 1.0, con la Ft alta y baja y sin ciclo.
- R-SOS dispara también con parcial y se omite si la IR es L1 (en Hoy, también si es la secundaria).
- Con H1, mMIDST entra a las recomendadas tras 2 semanas y 10 sesiones de hiperacusia (R.1, D-R1H1
de Hayo, 2026-11-01; el ciclo ordena la secundaria). Antes de eso, Por ahora no con el
motivode cuándo se activa (no aparece en Sonido). Reemplaza la decisión de H8.20 («con H1 y las condiciones de M1 o M1-precoz»). El normativo (Reglas v1.1) aún no lo dice: lo absorbe Cowork. - Sin Ft las reglas M no corren: L1 es Inducción y L2 ofrece afinar la Ft.
- R-sin-dato pide además semana ≥ 2 y Ft; R0 nunca quita L1.
- El normativo junta S1 y S2 en una sola salida (Consulta médica); en el código S1 es otorrino y S2 consulta médica. Y S3-bajo, K2, A2 y P1–P8 no estaban en el diagrama del normativo; están acá para que el dibujo cubra todas las reglas que producen algo visible (H2 no produce nada).
- El normativo es un solo diagrama; acá son dos, cortados donde terminan las acciones externas, sin cambiar nada del contenido.
La dosis
Desde la versión 1.1 la dosis va con cada terapia (SalidaReglas.dosis, un DosisSugerida por
terapia con los minutos por sesión, las veces al día y la línea), no solo con la de L1, y siempre es la
mínima útil, nunca una meta; los máximos son sugerencia (DS §0 regla 6, D-RV13):
| Terapia | Minutos · veces al día | Línea que muestra (literal) |
|---|---|---|
| Inducción de filtrado | 25 o más · al menos 1 | De 25 a 35 minutos ya funciona. Puedes repetirla y dejarla sonar todo lo que quieras. La sesión es «25 min o más»: cuenta al terminar la bajada (25 a 40 min según el plan de descenso) y la música sigue hasta 60 min, ajustable |
| mMIDST | los del plan de MM.2 (parte en 20 o 40, +5 por sesión bien tolerada, hasta 60) · al menos 1 | Con 30 ya cuenta. Más, si quieres. solo con 30 o más; con 20 o 25 del plan, Para hoy: n min. |
| Inhibición residual | 1 a 25 · 2 o 3 | De 1 a 25 min, 2 o 3 veces en el día; espera al menos lo que duró la anterior. (IR.2, Plan §1-bis.5-bis) |
| Manejo de hiperacusia | 10 a 20 · 1 a 3 | 10 min al comienzo, hasta 20 con las sesiones que toleras bien. Mejor con una hora entre una sesión y otra. |
Arriba de Recomendaciones para mí van dos textos fijos (Reglas §15.4, D-RV14): «Estas son sugerencias, no deberes. Con una sesión al día, de cualquiera de tus terapias, MindTune ya trabaja. El remedio nunca puede ser peor que la enfermedad: no hace falta hacerlas todas, todos los días.» y «Si un día no alcanzaste porque tu atención estaba en otra cosa, suele ser buena señal: el tinnitus está perdiendo presencia.»
Una sesión cuenta desde los 25 minutos en Inducción, desde los 30 en mMIDST y desde 1 minuto de ruido en
IR (o con la dosis completa); dos de 30 en el día valen lo mismo que una de 60. Cada terapia lleva su línea
también bajo el botón Empezar. El detalle de la dosis de Inducción y de su plan de descenso está en
induccion-de-filtrado.
Ninguna pantalla dice te falta, no cumpliste ni muestra días seguidos; lo vigila maxima_test.dart.
El horario (la peor franja de P05) es un subtítulo, no una condición: la regla no cambia según la hora.
Mi semana
/semana (SEM.1; Reglas §15.6, DS §4.47) es lectura: no lanza sesiones. Una fila por terapia
recomendada —las del ciclo, en su orden, más la IR sistemática si va aparte; no la IR de rescate,
ni mMIDST cuando es M-pre, ni la IR de R-sin-dato (una fila de «prueba una sesión» quedaría vacía semana
tras semana)—: el ícono, el nombre y la sugerencia en letra chica (2–3 al día; sin máximo, 1 al día, o
más si quieres). Si la semana tiene sesiones hechas de terapias que no son fila, al final va una fila
neutra Otras sesiones, sin sugerencia ni toque (D-RV14: una sesión de cualquier tipo ya cuenta); si
no las tiene, no aparece. Debajo, siete celdas de lunes a domingo con un punto por sesión hecha (la misma
sesionHecha del ciclo; hasta cuatro y después «+») y nada si no hubo. La inicial de hoy va en el color de
acento: dice dónde estás, no cómo vas. ‹ lleva a la semana anterior —hasta la de la primera sesión
registrada— y › vuelve hacia la actual. Al pie, los mismos dos textos fijos de arriba. Tocar una fila
cambia a Terapias y abre la ficha de esa terapia. Sin el perfil completo (sin reglas), la grilla lleva solo
la terapia de L1 de Hoy.
Lo que no muestra, a propósito (DS §0 reglas 2 y 6): ni racha, ni días seguidos, ni un porcentaje, ni
un total contra la sugerencia, ni qué día «faltó», ni rojo o verde, ni casillas tachadas. Lo vigila un
barrido de textos, rótulos de VoiceOver y colores en test/sem1_mi_semana_test.dart. No tiene evento de
bitácora propio: solo el nav.pantalla con el nombre semana.
El estado de cada terapia
Desde MD.3 el chip de cada tarjeta del catálogo de Terapias lo decide el motor de decisión
(ChipCatalogo, Motor §12.3): tres textos —Recomendada para ti, Para cuando suba de golpe y Por ahora
no— con el motivo del motor en el acordeón (Completa «{sección}» para saber, la regla que la cerró, o
Tu perfil no la pide por ahora). El estado de las reglas v1.2 (SalidaReglas.estadoRecomendacion, con
Recomendada · mejor después de Inducción y Completa tu perfil para saber) y su motivoDe se
retiraron del código en MD.8.
El seguimiento (lo que alimenta las reglas)
Cada instrumento tiene su cadencia (kCadencias). La última columna dice cuánto tiempo lo usan las reglas
en el código (ver Las entradas):
| Instrumento | Cadencia | Cómo se pide | Vale para las reglas |
|---|---|---|---|
| EVA (P04) | 7 días | Una hoja al abrir la app con Guardar y Ahora no, y una fila de L2 | Sin tope (la serie entera; solo la EVA de hoy pesa como hoy) — DF-31 |
| THI (P06) | 21 días | Fila de L2 (tres días; vuelve a las 6 semanas) | El grado, 42 días; el primero y el último para ΔTHI, sin tope |
| Ft (P03) | 28 días con mMIDST en 14 días; 42 sin | Fila de L2 ¿Sigue igual el tono…? con No lo necesito ahora (14 días). La Ft cambia solo si la nueva se aparta más de media octava | — (la Ft es rasgo) |
| GÜF (P07), Goldberg (P09) | 28 días (Goldberg 14 si alcanzó R2) | Secuencia Actualizar | 56 días (Goldberg-R2, 28) |
| P05, P08, P12 | 56 días | Secuencia Actualizar | P12, 112 días; P05, sin tope (DF-31); P08 no lo leen las reglas |
| POST (P14) · ISI (P15) | 56 · 28 días (ISI ≥ 22: 14) | Secuencia Actualizar | 56 · 28 días (contrato de Insumos) |
| P16 | 56 días | Secuencia Actualizar, al final | 112 días |
| P17 (Dolores de cabeza) | 56 días | Secuencia Actualizar, después de P16 | 112 días |
Una sola hoja al abrir por día: la hoja recurrente de R2 va primero; la de la EVA espera al día siguiente. La hoja de R2 vuelve cada 14 días mientras la última medición que encendió R2 siga sobre el umbral y vigente, con Entendido y Ya lo estoy viendo (que la calla 56 días).
⚠️ Desfase: esa lectura de «cada 14 días mientras R2 siga» es provisional: tal como está escrito, R2 se apaga a los 14 días y la hoja no saldría nunca. Pendiente de decisión de Hayo (INFORME_H9.9 §3; DF-26).
Qué guarda y qué sube
| Dato | Local | C1 | C2 | C3 |
|---|---|---|---|---|
recomendacion.emitida — reglas (ids), l1_terapia, l1_regla, dim_top, grado_<dimensión> ×7, semana_uso, persistencia (si existe), evidencia_l1. Una vez por día y por cambio | bitácora | sí | sí | agregado |
recomendacion.difiere_equipo — l1_regla, terapia_regla, terapia_equipo: la indicación del equipo y las reglas no coinciden (modo sombra) | bitácora | sí | sí | agregado |
aviso.r2_recurrente — respuesta (entendido · ya_lo_veo), sin la causa | bitácora | sí | sí | agregado |
hoy.toque con lugar = externa · sos · pausa | bitácora | sí | sí | agregado |
hoy.plan con ciclo_terapia y ciclo_dias (días desde su última sesión hecha; falta si nunca) cuando el ciclo eligió L1 (Reglas §15.4) | bitácora | sí | sí | agregado |
hoy.toque {lugar: ayuda} y ayuda.mostrada {origen: hoy} | bitácora | no | no | no |
seguimiento.ofrecido · .respondido · .postergado, ft.cambio {octavas} (sin Hz) | bitácora | sí | sí | agregado |
somato.* (guías, pulso de dieta blanda, recordatorio) | bitácora | sí | sí | agregado |
mindtune.reglas.ultima_emitida, mindtune.reglas.ultima_difiere_equipo, mindtune.seguimiento.v1 | preferencias | no | no | no |
Lo que nunca sube, con ningún consentimiento: r3Reciente y todo lo que lo delataría. Por eso
recomendacion.emitida sube las reglas, los grados y la dimensión principal como serían sin R3: S4 no
viaja, el grado emocional que solo viene de R3 sube como el que tendría sin él, y la llegada de R3 no
produce un evento nuevo. Tampoco suben los motivo (son texto de la app, no del paciente), ni texto libre.
El servidor valida los ids de regla y de terapia de cada recomendacion.emitida contra su propia copia
de la lista (backend/clinica/dominio.py, REGLAS_V1); si uno no calza, rechaza el lote entero sin copiar
el valor. Las dos retiradas en la versión 1.1 (M1-ft-alta, M1-ft-baja) siguen aceptándose
(REGLAS_V1_RETIRADAS), para no rechazar el lote de un teléfono que no actualizó. No calcula ni muestra
recomendaciones.
⚠️ Desfase: Reglas §11 pide subir
reglasygradosenteros, y una lista de siete enteros; el código los sube sin R3 (privacidad de Insumos §1, que manda) y como propiedadesgrado_<dimensión>(ocho desde H8.19, con cefalea). Los eventosrecomendacion.difiere_en_cursoyrecomendacion.tocadade §11 no existen (hoy.toquecubre parte). DF-27.
Explorar las reglas
Histórico (D-MD44, 2026-11-09). El explorador y la guía muestran las reglas v1.2, reemplazadas por el motor de decisión el 2026-11-09 (
MindTune_Motor_de_Decision.md). No se portan al motor nuevo: quedan como registro, con el rótulo en cada página; la herramienta viva del motor es el artefacto «Control de módulos» (Motor §11).
Fuera de la app, dos páginas de este sitio muestran lo mismo que esta (EXP.1, MindTune_Explorador_de_Reglas.md):
- Explorador de reglas: a la izquierda el perfil de tinnitus como lo ve la app (las 16
secciones, el uso y el contexto), a la derecha lo que decide (Hoy, los chips de las terapias, los grados,
las 33 reglas, la ruta de
reglasV1y las variables). Parte de los veinte perfiles detools/perfiles_prueba/perfiles_estandar.json(los ocho de inicio primero, después los doce tipo); cualquier respuesta se cambia en su sitio y la salida se recalcula. Fijar como base marca en ámbar qué se movió. - Guía visual de las reglas (Cowork): la tubería en siete pasos, las 33 reglas en tarjetas «si → entonces», la prelación de Hoy y los puntos abiertos para un revisor externo. Cada versión de las Reglas la enmienda en el mismo hito.
El explorador no finge ser la app. Su motor es JavaScript (docs/sitio/static/explorador/motor.js), no
el Dart; por eso la app generaba tools/explorador/historico/casos_golden.json —los veinte perfiles del JSON (8 de inicio
y 12 tipo) y 60 resúmenes aleatorios con semilla fija, con lo que daban planDeHoy y reglasV1— y la página
corre todos los casos al abrir: dice Verificado contra la app: 83/83 en verde, o en rojo con los ids que fallan (en L1, las reglas,
las recomendadas o los grados). node tools/explorador/verificar_golden.mjs hace lo mismo sin navegador. Desde
MD.8 (D-MD44) ese golden está congelado en reglas v1.2: la app ya no lo regenera ni ningún test lo lee; la
verificación vale para la versión histórica, no para la app de hoy (cuyo golden es el del motor,
test/fixtures/motor/golden_md4.json). Lo que la página no reconstruye (ΔTHI, el ISI, las lecciones vistas,
la música cargada, el diario y la indicación del equipo) está en su pestaña Variables.
tools/explorador/empaquetar.py lo deja en un solo archivo HTML para compartirlo.
Los ocho perfiles de inicio (LAB.3, MindTune_Perfiles_de_Prueba.md §2-bis, D-LAB7) van primero en el
JSON, en Laboratorio › Perfiles de prueba (bajo el filete Recién empiezan; los doce, bajo Perfiles tipo)
y en los presets del explorador. Son pacientes que acaban de terminar el perfil: respondido hoy o ayer
(respondidoHaceDias 0 o 1; 0 = hoy) y con 0 o 1 sesión, así que semanaDeUso vale 0 o 1 y B0 los deja en
Inducción. Cruzan severidad (THI 12 → 74, EVA 2 → 9) con el área comprometida, una por mecanismo:
inicio_01 leve y sin P03 (15 de 16 secciones: las reglas no corren y Hoy queda en Inducción de base),
inicio_02 moderado con mal sueño (señal de sueño, una sesión ayer), inicio_03 severo con angustia
(Goldberg sobre el umbral: S3 fuerte, Ft provisional), inicio_04 con la hiperacusia primero (H1: Manejo de
hiperacusia en L1), inicio_05 mayor con hipoacusia y audífonos (A1), inicio_06 somatosensorial (K1),
inicio_07 pulsátil, unilateral y reciente (S1 y S2) e inicio_08 tubario con migraña sin tratar (T1 y
MG1). Cargarlos en orden es el recorrido para mirar cómo se comporta la app desde el primer día; lo que
cada uno dispara de verdad es lo del golden, no el campo esperado del JSON.
Lo que NO hace (a propósito)
- No bloquea ni oculta ninguna terapia: el catálogo entero se puede usar siempre.
- No muestra grados, puntajes, colores de riesgo ni la palabra riesgo (
reglas_v1_test, §13 punto 4, en los tres idiomas). - No manda notificaciones: las hojas son al abrir la app, una por día.
- No cuenta rachas ni deudas.
- No reemplaza a la indicación del equipo: con C2, la indicación es L1 y la regla que difiere queda como sugerencia secundaria.
- No aprende sola: v1 son reglas fijas. Lo que se registra sirve para revisarlas a mano.
- No avisa todavía Tu tono cambió en Recomendaciones (Perfil §5.2; DF-28).
Capturas (claro/oscuro)
No se publican en este sitio (INFORME_DOC.1 §3.5). Están en el repo, generadas desde el árbol de widgets:
capturas/H8.3-b/ (L1 por reglas, tarjeta externa K1, fila SOS, Recomendaciones), capturas/H9.9/
(hoja de R2, Hoy con R2, señal de sueño, ayuda), capturas/H8.15/ (hoja de la EVA, filas de L2),
capturas/H8.17/ (T1 en Hoy y en Recomendaciones) y capturas/H10.1/ (guías y pulso).