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 contrac33900ael 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
c33900ay no se ha reverificado entera. Desde entoncesreglas_v1existe (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
| Lugar | Tarjeta | Qué muestra | Si no hay nada |
|---|---|---|---|
| L1 · Terapia | SESIÓ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 abajo | Nunca falta |
| L1 · si falta un dato | Misma 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 paso | Etiqueta SIGUIENTE PASO, título, una línea, ›. Toda la tarjeta es el toque | Uno de tres pasos (tabla L2) | No existe: la lista se cierra sin hueco |
| L3 · Qué aprender | Etiqueta 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ódigo | Bajada (motivo) |
|---|---|---|---|
| 1 | indicacion | terapiaIndicadaProvider no nulo y la terapia existe en kCatalogo, disponible y con ruta. Si no, cae a la 2 | Indicada por tu equipo |
| 2 | enCurso (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 3 | La que vienes haciendo esta semana |
| 3 | reglasV1 (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 |
| 4 | base | Siempre. No mira el historial: sin nada en 7 días es Inducción aunque antes haya hecho mMIDST | Para 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ón | PasoDeEvaluacion | Título · línea | Destino (cruce con destino) |
|---|---|---|---|---|
| 1 | EstadoDelPerfil.vencido | actualizarPerfil | Mi Perfil de Tinnitus · ¿Actualizamos tu perfil? | Mi MindTune → /perfil/actualizar |
| 2 | EstadoDelPerfil.nuncaEmpezado | empezarPerfil | Mi Perfil de Tinnitus · Cuéntanos cómo es tu tinnitus. No hace falta hacerlo todo hoy. | Mi MindTune → /perfil/mi-perfil |
| 3 | proponerCortaHoy(tinnitumetria, ahora) | afinarFt | Afina 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 anterior | null | — | — |
⚠️ 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 soloproponerCortaHoy, 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 paciente | L1 | L2 | L3 |
|---|---|---|---|
| Nunca empezado · sin sesiones · sin música | Inducción (base) con Todavía no se puede empezar · Falta: una lista de música | Mi Perfil de Tinnitus | Guía de la música; vista → genérica |
| Nunca empezado · sin sesiones · con música | Inducción (base), lista | Mi Perfil de Tinnitus | Guía de la música (o Cómo usar Inducción si se publica) |
| Parcial · Inducción en curso | Inducción (en curso) | Afinar si toca la parte corta; si no, nada | Cómo usar Inducción → base → … según §5.3 |
| Parcial · mMIDST en curso | mMIDST (en curso) | Afinar si toca la parte corta (con Ft escrita, nada) | Cómo usar mMIDST → … |
| Parcial · sin sesiones en 7 días | Inducción (base) | Afinar si toca | según §5.3 |
| Completo y vigente · en curso | La en curso, sin sugerencia secundaria; con 2 o más recomendadas, la del ciclo (D-RV16, H8.20) | nada | Por qué funciona de la más usada (si publicada) |
| Completo y vigente · sin sesiones en 7 días | Inducción (base) — reglas_v1 es null | nada | según §5.3 |
| Vencido | Según la prelación | Actualizar el perfil (antes que afinar) | según §5.3 |
| Indicación vigente | La indicada, sobre la en curso | Como las filas de arriba | según §5.3 |
⚠️ Desfase: en las filas 1 y 2 el normativo dice
baseo genérica / Cómo usar Inducción obase. Con la ramabaseen construcción, §5.3 cae a la regla 5 y el código muestra la guía de la música (ramaapp). 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
| Dato | Local | C1 | C2 | C3 |
|---|---|---|---|---|
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_plan | bitácora | sí | sí | agregado |
hoy.toque — lugar ∈ 1 · 2 · 3 · secundaria | bitácora | sí | sí | agregado |
mindtune.hoy.ultimo_plan (la clave, no el plan) | preferencias | no | no | no |
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)
- No decide por sí mismo la regla mecanismo → terapia: la lee de
reglas_v1(recomendaciones.md). - No empuja el perfil parcial desde Hoy.
- No muestra el Historial ni n de 12: dice lo escuchado hoy de la terapia de L1 y nada más.
- No anima la entrada: si el plan cambia con la pestaña a la vista, cada lugar se funde en 200 ms (§8.4).
- No recalcula a medianoche con la app abierta en primer plano: el plan se recalcula cuando cambia una entrada o al volver la app al frente.
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×.