Saltar al contenido
Cómo funciona

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 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:

  1. 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.
  2. Selector de idioma (/idioma): Español · Português · English, cada uno en su idioma; Continuar empuja la pantalla siguiente.
  3. ¿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.
  4. Bienvenida (/arranque): MindTune y «Apoyo en el manejo del tinnitus», botón Empezar →. La marca acá está quieta, no animada.
  5. Lección 0 (/arranque/leccion): Tinnitus y audición: lo primero, seis páginas. Es obligatoria y no tiene botón de saltar.
  6. 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).
  7. 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ótuloRutaQué hay
1Hoy/hoySaludo (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.
2Terapias/terapiasEl 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).
3Música/musicaLa 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).
4Aprender/aprenderCuatro ramas de lecciones (leccion/:id) y las guías de uso de la app (guia/:id). Reemplazó a Historial el 2026-09-11.
5Mi MindTune/perfilOnce 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 internoNombre visibleResumenQué necesita del perfil
induccion_filtradoInducción de filtrado con MúsicaInducir filtrado con tu músicauna lista de música
trac_mmidstmMIDSTTonos modificadores dentro de tu músicala Ft + una lista de música
inhibicion_residualInhibición residualRuido acotado para contenerla Ft
manejo_hiperacusiaManejo de hiperacusiaManejar tolerancia a ruidos externosnada

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.

idTítuloCuenta
P00equipoLo que midió tu equipono — solo aparece con vínculo
P01sobreTiDatos básicossí
P02comoEsCómo es tu tinnitussí
P03ftEl tono de tu tinnitussí
P04evaCuánto te molesta hoysí
P05horariosFluctuaciones durante el día y la semanasí
P06thiCuestionario THIsí
P07hipersensibilidadSensibilidad a los sonidossí
P08aprehensionesAprehensiones y dudas sobre tu tinnitussí
P09animoComponente emocional del tinnitussí
P10somaticoMandíbula, cuello y tinnitussí
P11audicionTu audiciónsí
P12prioridadLo que más te molestasí
P17migranaDolores 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
P13inhibicionResidual¿Te baja con ruido? · Prueba de inhibición residualsí, 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.versionEsquema es 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 marca migranaEnTratamiento, 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

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.