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 contraf15a912el 2026-09-20 · Probado en iPhone: no (quince recorridos-bispendientes; 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 los hechos del primer uso —idioma, llegada, Lección 0, tour, consentimientos y pantalla final— y redirige al primero pendiente. 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.
- Selector de idioma (
/idioma): Español · Português · English, cada uno en su idioma; Continuar empuja la pantalla siguiente. - ¿Cómo llegas a MindTune? (
/idioma/llegada, LL.1, 2026-10-29), empujada sobre el selector con su‹: dos tarjetas de camino, Por mi cuenta (guarda el hecho y pasa a la Bienvenida) y Con mi equipo, que empuja Esta parte está en construcción (/idioma/llegada/equipo) con un solo Volver y no guarda nada. Quien ya había pasado el tour antes de LL.1 no ve la pregunta (sin migración). Qué sube: arquitectura. - Bienvenida (
/arranque): MindTune y «Apoyo en el manejo del tinnitus», 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. Un solo botón, Guardar mi elección, que se habilita con C1 contestada (también con todo en No). - 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 | Once filas (doce con el Laboratorio): ¿Necesitas ayuda ahora? (H9.2) · Mi Perfil de Tinnitus (tarjeta de avance) · Mi perfil de un vistazo (desde PF.4, con una sección respondida; la cartilla) · Recomendaciones para mí · Historial · Tu equipo · Mis datos · La ciencia de MindTune · Acerca de MindTune · Reiniciar recorrido (LL.2: la Lección 0 y el tour otra vez; cruza a Aprender con la lección encima) · Configuración · 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. Configuración 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
El avance se muestra como «7 de N secciones» y nunca como porcentaje. Desde H8.19 (2026-10-29) N = 16
(17 con el ISI encendido; IR.3 la había dejado en 15/16): el código lo calcula (kTotalDeSecciones) y nunca escribe el número a mano.
La tabla de abajo es la del perfil de doce; P14 (POST), P15 (ISI, apagado) y P16 (oídos tapados) cuentan
desde H9.3, H9.4 y H8.17, P13 cuenta desde IR.3 y P17 desde H8.19.
| id | Título | Cuenta | |
|---|---|---|---|
| P00 | equipo | Lo que midió tu equipo | no — solo aparece con vínculo |
| P01 | sobreTi | Datos básicos | sí |
| P02 | comoEs | Cómo es tu tinnitus | sí |
| P03 | ft | El tono de tu tinnitus | sí |
| P04 | eva | Cuánto te molesta hoy | sí |
| P05 | horarios | Fluctuaciones durante el día y la semana | sí |
| P06 | thi | Cuestionario THI | sí |
| P07 | hipersensibilidad | Sensibilidad a los sonidos | sí |
| P08 | aprehensiones | Aprehensiones y dudas sobre tu tinnitus | sí |
| P09 | animo | Componente emocional del tinnitus | sí |
| P10 | somatico | Mandíbula, cuello y tinnitus | sí |
| P11 | audicion | Tu audición | sí |
| P12 | prioridad | Lo que más te molesta | sí |
| P17 | migrana | Dolores de cabeza · Migraña (va después de P16) | sí, desde H8.19 — una pregunta puerta (¿has tenido dolores de cabeza?; con No queda completa) y el ID-Migraine (3 sí/no, positivo con 2 o más); resultado en palabras, vence a los 112 d (cadencia 56). Positiva, dispara MG1 (ver Recomendaciones); el equipo puede anotar en tratamiento en P00 y MG1 se apaga sin borrar la respuesta |
| P13 | inhibicionResidual | ¿Te baja con ruido? · Prueba de inhibición residual | sí, desde IR.3 — una prueba guiada de ~14 min (calibrar · 10 min de ruido · 2 min de silencio); sin Ft dice Falta: el tono de tu tinnitus; vence a los 56 d. Ver Inhibición residual |
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.
Los resultados de todas las secciones, juntos y sin calificar, están en Mi perfil de un vistazo (PF.4), con el mismo bloque arriba de la ficha del panel.
⚠️ Desfase:
PerfilTinnitus.versionEsquemaes 13 en el código (IR.3: la serie de IR con su origen; H8.19 suma en el mismo 13 la serie de P17 y la marcamigranaEnTratamiento, sin migración); el normativo numera los esquemas desde H8.1 y a veces no coincide. 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_v1es 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
-bispendientes.
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.