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

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.dart Verificado contra 5e54593 el 2026-10-05 (la dosis y sesionHecha, contra 67c165a el 2026-10-10; la versión 1.1 —Reglas §15—, contra 41a905f + 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óndeQué muestra de las reglas
Hoy (/hoy), L1La 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 L1Una 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 L1La 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, L2Afinar el tono cuando las reglas de mMIDST la necesitan y no hay Ft (posición 8 de L2)
Hoy, L3Debajo 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

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

#FuenteCuándo
1Indicación del equipo (C2)Hay una indicación vigente de una terapia que la app puede correr
2En cursoAlguna 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
3reglas_v1La primera terapia de la salida de las reglas (con 2 o más recomendadas, la que eligió el ciclo)
4BaseInducció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_v1 mientras no supere dos cadencias; el código lo aplica solo a los cinco de arriba. DF-31.

VariableQué es, en el códigoDe dónde
sesionHechaUna 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 bajadaSesionRegistrada.escuchado, .completa
sesionesHiperacusia / diasDesdeHiperacusiaLas 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 H1Historial
semanaDeUso0 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 primeroHistorial
gradoThiGrado 1–5 del último THI vigente (42 d)P06
evaBasal / evaActualMediana 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 basalP04 y la hoja semanal
evaHoyLa EVA registrada hoyP04
persistenciaSemana ≥ 3 y (la EVA bajó menos de 2 o, con dos THI, el THI bajó menos de 7)EVA, THI
mejoriaClaraSemana ≥ 3 y (la EVA bajó 3 o más o el THI bajó 20 o más)EVA, THI
severoTHI grado ≥ 4 o EVA de hoy ≥ 8THI, EVA
gradoGufGrado 1–4 del último GÜF vigente (56 d). Grado 2 = 11–17 puntosP07
goldbergUmbralÚltimo Goldberg vigente con ansiedad ≥ 4 o depresión ≥ 2P09
levinePositivo / somaticoLeveLevine positivo / bruxismo o dolor de mandíbula o cuello, con Levine negativo o no hechoP10
ptaPeor, hipoacusiaProbableEl 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
ftHzLa 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, irSubioDesde 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 cuentaSerie de IR (P13) y sesiones de IR
prioridadPacienteLo primero de Lo que más te molesta, vigente (112 d)P12
franjaPeorLa franja de días hábiles con el nivel más alto; empate, la más tardíaP05
pulsatil, unilateralRecientePulsátil = sí; un solo oído y de comienzo recienteP02
grado Tubaria0, 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 alergiaP16
r1, r2, r3Reciente, senalDeSueno, isi, postLos 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íasP14, P15, P09, P06, P08
pausasHechas, pulsoPeorLas Pausas completas del cuaderno (P6) y si el último pulso de dieta blanda terminó en peor (K2)Cuaderno

⚠️ Desfase: Reglas §1.1 define ftHz como 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ón1234
EmocionalR1—Goldberg sobre umbral, o R2R2 por THI grado 5 o ISI ≥ 22; R3 reciente
Hiperacusia—GÜF grado 2; IR subió (al menos 2)GÜF grado 3GÜF grado 4; sensibilidad primero en P12
Sueño—Señal de sueño sin ISI; ISI leveISI moderadoISI severo
TinnitusTHI grado 1THI grado 2THI grado 3THI grado 4–5; EVA actual ≥ 8
SomatosensorialsomaticoLeve—Levine positivoLevine positivo y dolor de mandíbula o cuello
AudiciónPTA 25–39 sin audífonos—hipoacusiaProbablePTA ≥ 40 y pérdida de audición primero en P12
Tubaria—Sobre el corte, o altura + aviónLo 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.

idCapaDispara cuando…Qué produceEvidencia
S10 · SeguridadTinnitus pulsátilAcción externa fuerte: otorrinolaringólogo. En Hoy deja de mostrarse cuando el paciente tocó Entendido en el aviso del perfila priori
S20 · SeguridadUn solo oído, de comienzo recienteAcción externa fuerte: consulta médica con audiometría. Igual que S1 con Entendidoa priori
S30 · Seguridadr2Acción externa fuerte: salud mental; además reentrenar_01_el_circulo y Respirar lento en el apoyoempírica
S3-bajo0 · SeguridadGoldberg sobre umbral o THI grado ≥ 3, sin r2Acción externa sugerida: salud mental (Si quieres…), y la primera lección no vista de Reentrenar la atención al tinnitusempírica
S40 · Seguridadr3RecienteFila ¿Necesitas ayuda ahora? en L3; ni Escucharlo ni Entrenar el oído en ninguna sugerenciaa priori
K11 · ExternasLevine positivoKinesiología fuerte y las cuatro guías de Mandíbula y cuello en el apoyoempírica
K21 · ExternasBruxismo o dolor de mandíbula/cuello, sin Levine positivoKinesiología sugerida (fuerte si el último pulso de dieta blanda terminó en peor), base_06_mandibula_y_cuello y las cuatro guíasempírica
A11 · ExternashipoacusiaProbableConsulta médica fuerte (evaluación de audífonos) y base_01_que_esempírica
A21 · ExternasPTA del peor oído entre 25 y 39 dBSolo base_01_que_es en el apoyo (débil, sin acción externa)empírica
T11 · ExternasGrado Tubaria ≥ 2Consulta 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ármacoempírica
MG11 · ExternasP17 positiva vigente (ID-Migraine ≥ 2, 112 días): migranaPositiva, dimensión cefalea grado 2Consulta 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 quedana priori
H12 · HiperacusiaGÜF grado ≥ 2 o sensibilidad primero en P12L1 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 apoyoa priori
H1-IR2 · HiperacusiairSubio: alguna de las dos últimas respuestas de IR es subió, de menos de 56 díasLo 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 2a priori
H22 · HiperacusiaGÜF grado 1 sin sensibilidad primeroNada: queda anotada; la terapia sigue en el catálogoa priori
B03 · SonidoNinguna 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 3a priori
M13 · SonidoSemana ≥ 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-precoz3 · SonidoSevero, 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 2a priori
M-pre3 · SonidoSemana ≤ 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 cicloa priori
M03 · SonidoSemana ≥ 4 y mejoría claraL1 = la terapia más usada en 14 días (o Inducción); sin secundarias. Va antes que M1a priori
R-SOS3 · SonidoAlguna 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-sist3 · SonidoIR 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 Recomendacionesa priori
R03 · SonidoDos no seguidos en la appIR sale de la lista (nunca si es L1) y Recomendaciones lo dice en una líneaa priori
R0-IR3 · SonidoirSubioNinguna 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-dato3 · SonidoSin ninguna respuesta de IR (ni de la app —prueba o sesión— ni escrita en P13), semana ≥ 2, hay Ft, sin M0IR 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-ciclo3 · SonidoDos o más terapias recomendadasVan 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
P14 · Apoyor1 (POST ≥ 4)reentrenar_01_el_circulo y Respirar lentoa priori
P24 · ApoyoSeñal de sueño, sin ISI y con el ISI encendidoL2 propone el ISI (hoy nunca: el ISI está apagado)a priori
P34 · ApoyoSeñal de sueño o ISI ≥ 8La primera lección no vista de Volver a dormir bien, antes que las de Reentrenar la atención al tinnitusa priori
P44 · ApoyoISI ≥ 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:00a priori
P54 · ApoyoLevine positivo o somaticoLeveLas guías de Mandíbula y cuello en el apoyo (al final); en L3 solo como último recurso, con base_06 vistaa priori
P64 · ApoyoCinco Soltar el cuerpo completas y ninguna Soltar en un minutoSoltar en un minuto, hasta hacerla una veza priori
P74 · Apoyoreentrenar_06_no_es_una_alarma no vista, o escucharloNoConviene: r3Reciente, Goldberg sobre umbral en 14 días o EVA de hoy ≥ 8Nunca 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 proponea priori
P84 · ApoyoSemana ≥ 4 y la EVA bajó 2 o el THI bajó 7La 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):

  1. Capa 0 (S1–S4) y los grados.
  2. 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.
  3. 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.
  4. Apoyo: P1–P8; Escucharlo (P7) y Entrenar el oído (S4) se filtran al final; las guías van al final.
  5. Si la lista quedara vacía o empezara por un rescate, Inducción (B0).

⚠️ Desfase: Reglas §4 trae un solo motivo para T1, que menciona la alergia; el código usa los dos de MindTune_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):

  1. 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).
  2. H1 también se dispara con sensibilidad primero en P12, no solo con el GÜF.
  3. 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.
  4. R-SOS dispara también con parcial y se omite si la IR es L1 (en Hoy, también si es la secundaria).
  5. 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 motivo de 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.
  6. Sin Ft las reglas M no corren: L1 es Inducción y L2 ofrece afinar la Ft.
  7. R-sin-dato pide además semana ≥ 2 y Ft; R0 nunca quita L1.
  8. 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).
  9. 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):

TerapiaMinutos · veces al díaLínea que muestra (literal)
Inducción de filtrado25 o más · al menos 1De 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
mMIDSTlos del plan de MM.2 (parte en 20 o 40, +5 por sesión bien tolerada, hasta 60) · al menos 1Con 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 residual1 a 25 · 2 o 3De 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 hiperacusia10 a 20 · 1 a 310 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):

InstrumentoCadenciaCómo se pideVale para las reglas
EVA (P04)7 díasUna hoja al abrir la app con Guardar y Ahora no, y una fila de L2Sin tope (la serie entera; solo la EVA de hoy pesa como hoy) — DF-31
THI (P06)21 díasFila 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 sinFila 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 Actualizar56 días (Goldberg-R2, 28)
P05, P08, P1256 díasSecuencia ActualizarP12, 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 Actualizar56 · 28 días (contrato de Insumos)
P1656 díasSecuencia Actualizar, al final112 días
P17 (Dolores de cabeza)56 díasSecuencia Actualizar, después de P16112 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

DatoLocalC1C2C3
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 cambiobitácorasísíagregado
recomendacion.difiere_equipo — l1_regla, terapia_regla, terapia_equipo: la indicación del equipo y las reglas no coinciden (modo sombra)bitácorasísíagregado
aviso.r2_recurrente — respuesta (entendido · ya_lo_veo), sin la causabitácorasísíagregado
hoy.toque con lugar = externa · sos · pausabitácorasí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ácorasísíagregado
hoy.toque {lugar: ayuda} y ayuda.mostrada {origen: hoy}bitácoranonono
seguimiento.ofrecido · .respondido · .postergado, ft.cambio {octavas} (sin Hz)bitácorasísíagregado
somato.* (guías, pulso de dieta blanda, recordatorio)bitácorasísíagregado
mindtune.reglas.ultima_emitida, mindtune.reglas.ultima_difiere_equipo, mindtune.seguimiento.v1preferenciasnonono

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 reglas y grados enteros, y una lista de siete enteros; el código los sube sin R3 (privacidad de Insumos §1, que manda) y como propiedades grado_<dimensión> (ocho desde H8.19, con cefalea). Los eventos recomendacion.difiere_en_curso y recomendacion.tocada de §11 no existen (hoy.toque cubre 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):

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)

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