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

Hoy y el recorrido del paciente

Por qué así: por-que-asi/hoy-y-recorrido.md · Normativo: MindTune_Recorrido_del_Paciente.md §2–§6 y §8, DS §4.28 · Código: lib/domain/plan_de_hoy.dart, lib/data/plan_de_hoy_providers.dart, lib/features/hoy/ Verificado contra c33900a el 2026-09-22 · Probado en iPhone: no (H8.3-a-bis)

⚠️ Desfase (anotado en DOC.3, 2026-10-05): esta página se verificó contra c33900a y no se ha reverificado entera. Desde entonces reglas_v1 existe (H8.3-b) y L2 tiene ocho posiciones (H8.15, H9.9). Lo que hacen las reglas en L1, la sugerencia secundaria, la tarjeta externa, la fila SOS y la Pausa de L3 está en recomendaciones.md; las tres afirmaciones que ya no eran ciertas se corrigieron abajo. El resto (la tabla de L2 y la matriz) espera su reverificación.

Qué es, en tres frases

Hoy es la primera pestaña: un encabezado (Hoy, Marta) y tres tarjetas en orden fijo, cada una con una sola cosa. La primera es la terapia de hoy, la segunda el siguiente paso de evaluación (o nada), la tercera una lección. Qué va en cada una lo decide una función pura del dominio, planDeHoy; la pantalla solo pinta.

Dónde está en la app

Pestaña Hoy (/hoy), la que abre la app después del primer uso. La barra del equipo (H6.9) va encima, en el shell, y no es uno de los tres lugares.

Los tres lugares

LugarTarjetaQué muestraSi no hay nada
L1 · TerapiaSESIÓN DE HOY: ícono de la terapia (40 px, su matiz), nombre, bajada = motivo, la dosis (25 min o más, con tu música. en Inducción; 1 h, con tu música y los cuatro tonos dentro. en mMIDST), botón Comenzar sesión (o Escuchar otra vez si hoy ya hubo sesión de esa terapia; entonces dice Hoy llevas 24 min escuchados.). Con fuente base, debajo, la fila ¿Por qué esta?La terapia de la prelación de abajoNunca falta
L1 · si falta un datoMisma cabecera + Todavía no se puede empezar · Falta: una lista de música · Ir a Mi música →El mismo RequisitoTerapia que el catálogo—
L2 · Siguiente pasoEtiqueta SIGUIENTE PASO, título, una línea, ›. Toda la tarjeta es el toqueUno de tres pasos (tabla L2)No existe: la lista se cierra sin hueco
L3 · Qué aprenderEtiqueta PARA APRENDER · {rama}, título de la lección, su bajada, ›La lección de Siguiente para ti (Aprender §5.3)La tarjeta genérica APRENDER · Qué es el tinnitus y cómo usar cada terapia.

Debajo de L3 (y de la Pausa, si la hay) va siempre la fila Mi semana ›, sin tarjeta: abre la grilla de la semana con las sesiones hechas de cada terapia recomendada, sin rachas ni porcentajes (ver recomendaciones.md). Tocarla no deja hoy.toque.

Solo L1 tiene botón primario y ícono de terapia. Ninguna tarjeta cambia de color ni de tamaño según el estado, y en Hoy no aparece ninguna cifra de avance del perfil ni porcentaje.

¿Por qué esta? abre una hoja desde abajo con la nota de Perfil §2.3, literal (las mismas constantes que la portada del perfil): Puedes empezar hoy mismo, sin haber completado tu perfil. … La última frase (No a todas las personas les alivia por completo…) se omite si el perfil está completo. La cifra 7 de cada 10 está en esa hoja y no en la tarjeta.

La sugerencia secundaria (fila MINDTUNE TAMBIÉN SUGIERE bajo L1, sin botón, con ›) la produce reglas_v1 desde H8.3-b: aparece con el perfil completo y vigente cuando las reglas proponen otra terapia que la de L1 (ver recomendaciones.md).

L1 — quién manda (la prelación, tal como está en planDeHoy)

#Fuente (FuenteDeRecomendacion)Condición en el códigoBajada (motivo)
1indicacionterapiaIndicadaProvider no nulo y la terapia existe en kCatalogo, disponible y con ruta. Si no, cae a la 2Indicada por tu equipo
2enCurso (id en_curso)Alguna SesionRegistrada de una terapia corrible con inicio ≥ ahora − 7 días (7 × 24 h, kVentanaEnCurso). Con varias: la de más sesiones en 14 días (kVentanaDeUso); empate, la de la sesión más reciente. Desde H8.20 (D-RV16) se salta cuando reglas_v1 devuelve 2 o más recomendadas (SalidaReglas.cicla): manda el ciclo de la 3La que vienes haciendo esta semana
3reglasV1 (id reglas_v1)Perfil propio N de N y vigente → la primera terapia de reglas_v1 (desde H8.3-b; ver recomendaciones.md)El motivo de la regla
4baseSiempre. No mira el historial: sin nada en 7 días es Inducción aunque antes haya hecho mMIDSTPara empezar hoy, sin perfil: útil en la gran mayoría de los casos y a menudo suficiente

Los faltantes de L1 se calculan con el perfil en uso (lo indicado aceptado), igual que el catálogo. Una sesión cuenta aunque no haya completado la dosis. Una sesión o una indicación de una terapia retirada (rango_dinamico) no cuenta.

L2 — el siguiente paso (provisional, D-HY4)

Sobre el perfil propio; la primera que aplique:

#CondiciónPasoDeEvaluacionTítulo · líneaDestino (cruce con destino)
1EstadoDelPerfil.vencidoactualizarPerfilMi Perfil de Tinnitus · ¿Actualizamos tu perfil?Mi MindTune → /perfil/actualizar
2EstadoDelPerfil.nuncaEmpezadoempezarPerfilMi Perfil de Tinnitus · Cuéntanos cómo es tu tinnitus. No hace falta hacerlo todo hoy.Mi MindTune → /perfil/mi-perfil
3proponerCortaHoy(tinnitumetria, ahora)afinarFtAfina el tono de tu tinnitus · Parte corta, 2 min. (o ¿Afinamos una vez más?)Mi MindTune → tinnitumetría corta, desde=hoy
—Perfil parcial, o completo y vigente sin nada de lo anteriornull——

⚠️ Desfase: el normativo (§4) titula los pasos Actualiza tu perfil · qué venció y Tu perfil de tinnitus; el código reusa los textos que ya tenían las tarjetas de H8.1 (D-HY4 lo pide así), que no dicen qué venció. Ver deuda.md DF-18.

⚠️ Desfase: el normativo pide Ft provisional y proponerCortaHoy. El código usa solo proponerCortaHoy, que además propone la cuarta corrida cuando la dispersión de las tres primeras pasa de 0,5 octavas, con la Ft ya firme (regla de Tinnitumetría §4, sin cambio). DF-19.

L3 — qué aprender

siguienteLeccionPara(...) en domain/siguiente_leccion.dart arma las entradas de §5.3 y la usan las dos pantallas: la fila Siguiente para ti de Aprender y L3. Tocar la tarjeta cambia a Aprender y empuja la lección (/aprender/leccion/<id>?desde=hoy) o la guía (/aprender/guia/<id>?desde=hoy).

Desde H7.15 Aprender abre por defecto en la vista Mapa (domain/ruta_de_aprender.dart + features/aprender/mapa_de_aprender.dart; Aprender §1.2, DS §4.44): ahí no hay tarjeta Siguiente para ti y su lección es el nodo Estás aquí, el primer pendiente del camino —la misma lección, porque la primera de Para ti es siempre la de siguienteLeccion (§5.3-bis)—. La vista Lista conserva la tarjeta. El conmutador Mapa · Lista se guarda en ProgresoAprender.vistaPreferida.

Hoy, con el curriculum real, casi todas las lecciones están en construcción: al recién llegado L3 le muestra la guía de la música (Cómo agregar música a mi MindTune, rama Cómo usar MindTune) y, una vez vista, la tarjeta genérica.

La matriz, tal como quedó

Cada fila es un test en test/plan_de_hoy_test.dart (grupo la matriz §6, fila por fila).

Estado del pacienteL1L2L3
Nunca empezado · sin sesiones · sin músicaInducción (base) con Todavía no se puede empezar · Falta: una lista de músicaMi Perfil de TinnitusGuía de la música; vista → genérica
Nunca empezado · sin sesiones · con músicaInducción (base), listaMi Perfil de TinnitusGuía de la música (o Cómo usar Inducción si se publica)
Parcial · Inducción en cursoInducción (en curso)Afinar si toca la parte corta; si no, nadaCómo usar Inducción → base → … según §5.3
Parcial · mMIDST en cursomMIDST (en curso)Afinar si toca la parte corta (con Ft escrita, nada)Cómo usar mMIDST → …
Parcial · sin sesiones en 7 díasInducción (base)Afinar si tocasegún §5.3
Completo y vigente · en cursoLa en curso, sin sugerencia secundaria; con 2 o más recomendadas, la del ciclo (D-RV16, H8.20)nadaPor qué funciona de la más usada (si publicada)
Completo y vigente · sin sesiones en 7 díasInducción (base) — reglas_v1 es nullnadasegún §5.3
VencidoSegún la prelaciónActualizar el perfil (antes que afinar)según §5.3
Indicación vigenteLa indicada, sobre la en cursoComo las filas de arribasegún §5.3

⚠️ Desfase: en las filas 1 y 2 el normativo dice base o genérica / Cómo usar Inducción o base. Con la rama base en construcción, §5.3 cae a la regla 5 y el código muestra la guía de la música (rama app). DF-20.

⚠️ Desfase: si se publica Cómo usar Inducción, pasa a ser requisito de la terapia (D-A4) y la fila 2 muestra Todavía no se puede empezar · Falta: haber leído cómo usarla en vez de la tarjeta lista. DF-21.

Qué guarda y qué sube

DatoLocalC1C2C3
hoy.plan — l1_fuente, l1_terapia, l1_faltantes (n), l2 (opcional), l3 (id de lección, opcional), y desde H8.20 ciclo_terapia y ciclo_dias (días desde su última sesión hecha; falta si nunca) cuando L1 salió del ciclo (Reglas §15.4). Una vez por día y por cambio de plan: se recuerda AAAA-MM-DD|firma en mindtune.hoy.ultimo_planbitácorasísíagregado
hoy.toque — lugar ∈ 1 · 2 · 3 · secundariabitácorasísíagregado
mindtune.hoy.ultimo_plan (la clave, no el plan)preferenciasnonono

Sin nombres ni texto libre: vocabularios cerrados, un entero y un id de lección. Los dos tipos van en el grupo Hoy del esquema del export. Como toda la bitácora, salen con C1 o C2.

⚠️ Desfase: el normativo (§8) dice bajo C1; en el código no hay una tabla por evento: la bitácora entera sale por el canal que haya (C1 telemetría o C2 clínico). DF-22.

El servidor no calcula ni muestra el plan; backend/sync/catalogo.py solo conoce los dos tipos para no contarlos como desconocidos.

Lo que NO hace (a propósito)

Capturas (claro/oscuro)

Desde el árbol de widgets (test/capturas_h83a_test.dart, Roboto del SDK), en capturas/H8.3a/: nunca empezado con música · Inducción en curso con Ft provisional · completo con mMIDST en curso · indicación del equipo — en claro y oscuro — y dos con letra 1,3×.