Cómo funciona MindTune — el mapa

Por qué así: por-que-asi/_index.md (índice de decisiones) · Normativos: ROADMAP_MAESTRO.md §2, MindTune_Design_System.md, MindTune_Mi_MindTune_y_Perfil.md, MindTune_Aprender.md, MindTune_Plataforma_Clinica.md · Código: mindtune_app/lib/ Verificado contra f15a912 el 2026-09-20 · Probado en iPhone: no (quince recorridos -bis pendientes; todo lo de abajo se vio en el simulador o está cubierto por tests)

Esta página es el mapa: qué hay en la app, dónde está y cómo se enlaza. Cada tema tiene su propia página de capa 1 con el detalle, y su par de capa 2 con la razón.

Qué es, en tres frases

MindTune entrega cuatro terapias de sonido para el tinnitus en el teléfono del paciente. Todo el sonido se sintetiza en el aparato y todos los datos clínicos viven ahí: no hay cuentas ni login, y la app funciona completa sin red y sin haber aceptado nada. Un paciente puede usarla solo; si su equipo clínico usa MindTune, puede vincularse y entonces el equipo ve datos y puede indicar terapias.

El primer uso

En cada navegación, el router comprueba dos hechos —si se vio la Lección 0 y si se vio la pantalla de consentimientos— y redirige. La secuencia, que no se puede saltar:

Splash con la marca animada mientras se abre lo local. En el primerísimo arranque corre la vuelta completa y el dorado se sostiene el doble.
Bienvenida (/arranque): «MindTune — Terapias de sonido para el tinnitus, y lo que necesitas saber para usarlas.», botón Empezar →. La marca acá está quieta, no animada.
Lección 0 (/arranque/leccion): Tinnitus y audición: lo primero, seis páginas. Es obligatoria y no tiene botón de saltar.
Consentimientos (/consentimientos): «Antes de empezar», con C1 (mejora del producto) y C3 (investigación). C2 —el del equipo clínico— no existe acá: se otorga al canjear un código. Botones Guardar y Seguir sin compartir.
Hoy.

Una instalación que actualiza y ya tenía consentimientos vistos pasa igual por Bienvenida y Lección 0, y de ahí va directo a Hoy.

Las cinco pestañas

#	Rótulo	Ruta	Qué hay
1	Hoy	`/hoy`	Saludo (Hoy, ‹nombre›), Sesión de hoy —Comenzar sesión / Escuchar otra vez, o Todavía no se puede empezar con lo que falta y un Ir a ‹donde› →—, una tarjeta de Aprender y una de Mi perfil. Acá aparece también la propuesta de la parte corta de tinnitumetría. Sin rutas hijas.
2	Terapias	`/terapias`	El catálogo compacto: las cuatro a la vista, acordeón con la descripción, y una pantalla por terapia (`induccion-filtrado`, `trac-mmidst`, `inhibicion-residual`, `manejo-hiperacusia`).
3	Música	`/musica`	La biblioteca del paciente: listas reordenables (`lista/:id`), el catálogo descargable (`catalogo`), el espacio ocupado (`espacio`) y las otras maneras de traer música (`otras-maneras`).
4	Aprender	`/aprender`	Cuatro ramas de lecciones (`leccion/:id`) y las guías de uso de la app (`guia/:id`). Reemplazó a Historial el 2026-09-11.
5	Mi MindTune	`/perfil`	Nueve filas: Mi Perfil de Tinnitus (tarjeta de avance) · Recomendaciones para mí · Historial · Tu equipo · Mis datos · La ciencia de MindTune · Acerca de MindTune · Ajustes · Laboratorio (solo con el flag de depuración).

La quinta pestaña se llama Mi MindTune desde H8.1, pero la ruta, el name y la clave de bitácora siguen diciendo perfil: es un id, no prosa. Ajustes no es una pantalla: es el interruptor de modo oscuro, en la propia fila.

Las cuatro terapias

id interno	Nombre visible	Resumen	Qué necesita del perfil
`induccion_filtrado`	Inducción de filtrado con Música	Inducir filtrado con tu música	una lista de música
`trac_mmidst`	mMIDST	Tonos modificadores dentro de tu música	la Ft + una lista de música
`inhibicion_residual`	Inhibición residual	Ruido acotado para contener	la Ft
`manejo_hiperacusia`	Manejo de hiperacusia	Manejar tolerancia a ruidos externos	nada

El id trac_mmidst no cambió cuando el nombre visible pasó a mMIDST (2026-09-10): un test vigila que la sigla «TRAC» no aparezca en ningún texto que vea el paciente. Manejo de hiperacusia reemplazó a Reentrenamiento de rango dinámico (2026-09-09) con id nuevo; rango_dinamico está en la lista de retiradas. Se generan las cuatro en el teléfono, en Dart.

No hay candados. Una terapia que no se puede empezar todavía no se esconde ni se tacha: dice qué dato falta y ofrece el atajo al lugar donde se completa (Completar Ft en Mi MindTune →, Elegir música →, Leer cómo usarla →).

⚠️ Desfase: el normativo (MindTune_Aprender.md §0 regla 2) exige haber leído Cómo usarla antes de empezar cada terapia. El código lo evalúa siempre —aunque ninguna terapia lo declare entre sus requisitos—, pero sin lección publicada que lo exija el requisito se da por cumplido (D-A4). Como las ocho lecciones de terapia están en construcción, hoy ese requisito no gatilla nunca. Se encenderá solo cuando Hayo escriba las cuatro Cómo usarla (H7.4).

Mi Perfil de Tinnitus

Son catorce secciones, de las cuales doce cuentan para el avance, que se muestra como «7 de 12 secciones» y nunca como porcentaje.

	id	Título	Cuenta
P00	`equipo`	Lo que midió tu equipo	no — solo aparece con vínculo
P01	`sobreTi`	Sobre ti	sí
P02	`comoEs`	Cómo es tu tinnitus	sí
P03	`ft`	El sonido de tu tinnitus	sí
P04	`eva`	Cuánto te molesta hoy	sí
P05	`horarios`	A qué hora está mejor y peor	sí
P06	`thi`	Cuestionario THI	sí
P07	`hipersensibilidad`	Sensibilidad a los sonidos	sí
P08	`aprehensiones`	Aprehensiones y dudas sobre tu tinnitus	sí
P09	`animo`	Cómo has estado de ánimo	sí
P10	`somatico`	Mandíbula, cuello y tinnitus	sí
P11	`audicion`	Tu audición	sí
P12	`prioridad`	Lo que más te molesta	sí
P13	`inhibicionResidual`	Inhibición residual	no — no se pregunta, se llena sola

Siete secciones son de estado (cambian con el tratamiento) y guardan serie con fecha; el resto son de rasgo. El perfil vence y la pantalla ¿Sigue igual? repregunta solo seis de las de estado, en orden fijo. Al completarse las doce, la app abre una pantalla propia con la vuelta completa de la marca y lleva a Recomendaciones para mí — sin felicitar.

⚠️ Desfase: el normativo y MindTune2027/CLAUDE.md dicen 13 secciones. En el código son catorce: entró P13 Inhibición residual, que no cuenta para el avance. ⚠️ Desfase: PerfilTinnitus.versionEsquema es 6 en el código; el normativo numera el mismo esquema como v4 porque cuenta desde H8.1. Es el mismo formato con dos nombres.

Con equipo clínico y sin él

Quien usa MindTune solo no ve ninguna invitación a vincularse: la fila Tu equipo aparece con una bajada seca, la sección P00 no se lista, y la barra de avisos del equipo no se dibuja. Al canjear el código del centro se otorga C2, entra P00, aparecen las indicaciones con su desenlace, y el panel del terapeuta ve lo que el consentimiento permita.

El paciente manda en su teléfono: puede apartarse de lo indicado, y eso queda anotado y visible para el equipo en vez de bloquearse. Al desvincular, lo que midió el equipo se copia al perfil propio.

Lo que todavía no hay

Contenido de Aprender: de 19 lecciones hay 2 publicadas (Tinnitus y audición: lo primero y Cómo agregar música a mi MindTune) y 17 en construcción. Las cuatro ramas son Entender el tinnitus, Las terapias, Hiperacusia y Cómo usar MindTune.
Recomendaciones para mí tiene pantalla y contrato, pero no algoritmo: reglas_v1 es H8.3.
Video en las lecciones: el control Ver · Leer solo se pinta si la lección es de video, y hoy ninguna lo es.
Servidor desplegado, Apple Developer y TestFlight: nada de eso existe todavía.
Nadie ha oído la app en un iPhone. Quince recorridos -bis pendientes.

Deuda que encontró esta página

Además de los desfases marcados arriba: ROADMAP_MAESTRO.md y MindTune2027/CLAUDE.md dan H8.2 (tinnitumetría) como pendiente de implementar, y está hecha desde el 2026-09-20 en seis commits (5564c7e … 25a62e4, informe f15a912). La lista completa está en deuda.md.

Dónde seguir

Los principios que gobiernan todo esto —las cuatro reglas del Design System §0 y sus excepciones— están en principios.md. Cada tema tiene su par de páginas; el índice de decisiones D-xx está en por-que-asi/_index.md.