Los principios: cuatro reglas y cuatro excepciones

Por qué así: por-que-asi/diseno-visual-y-movimiento.mdpendiente (pendiente) · Normativo: MindTune_Design_System.md §0 · Código: lib/core/theme.dart, test/movimiento_test.dart Verificado contra f15a912 el 2026-09-20 · Probado en iPhone: no

Cuatro reglas mandan sobre todo lo demás en MindTune. Cuando una decisión visual choca con una de ellas, gana la regla — no la costumbre, ni lo que se ve bonito, ni lo que hacen otras apps. Hay cuatro excepciones, y cada una está escrita con sus condiciones para que nadie la amplíe por descuido.

Regla 1 — La pantalla de sesión no es la interfaz de la sesión

Una sesión dura una hora y el teléfono pasa 55 de esos 60 minutos apagado en un bolsillo. La interfaz de verdad es la pantalla de bloqueo. La pantalla dentro de la app existe para darle permiso al paciente de apagar el teléfono, no para que la mire.

Qué significa en la práctica. El audio sigue con la pantalla apagada y sobrevive a una llamada. No hay nada en la pantalla de sesión que el paciente tenga que vigilar: cuando H1.15 agregó el visual de sesión, en el mismo movimiento se retiró el reloj grande —el avance quedó en la barra y el mm:ss bajó al tamaño más chico de la escala— y todo se atenúa solo a opacidad 0,12 a los 90 s sin tocar. Un contador corriendo en grande es ansiógeno y, sobre todo, es una invitación a mirar.

Regla 2 — Registro, no motivación

MindTune anota lo que pasó. No premia, no celebra, no lleva rachas, no pone metas ni porcentajes de cumplimiento, y no usa rojo en ninguna métrica de adherencia.

Por qué importa tanto acá. El endotipo E4 —joven con hiperacusia y angustia alta— es una parte real de la cohorte, y para esa persona una racha rota no es un empujón: es daño.

Qué significa en la práctica. Cuando el paciente completa las doce secciones del perfil, la app abre una pantalla que dice Tu perfil está completo y lo lleva a sus recomendaciones — sin felicitarlo. La tinnitumetría propone la parte corta hasta tres veces y, si el paciente no la hace, la fila queda en Provisional · 1 de 3 y las terapias siguen funcionando: no hay reproche, no hay insistencia, no hay nada en rojo. La adherencia en el Historial se muestra en tres estados neutros.

Regla 3 — La señal no se tacha

Ni la marca, ni un ícono, ni una ilustración pueden borrar, silenciar o cruzar la señal. La señal se reintegra; no desaparece.

Qué significa en la práctica. La tinnitumetría necesitaba un ícono de altavoz. El de Material viene con la variante tachada, y usarla habría sido dibujar el sonido cancelado. Se dibujó un altavoz propio a mano (CustomPainter, trazo de 1,5) en vez de usar el del sistema. Un detalle minúsculo que nadie va a notar, y esa es exactamente la idea.

Regla 4 — Legible para E3

La referencia es una persona de 68 años con una pérdida auditiva media de 38 dB. Cuerpo de 15 px para arriba, área táctil de 44 px para arriba, contraste AA en todo texto. Nada de gris sobre gris «elegante».

Qué significa en la práctica. La grilla de horarios del perfil usa celdas de 48 px. La serie del perfil no autoescala el eje: va de cero al máximo del instrumento, porque un THI que pasa de 41 a 43 con el eje ajustado se leería como una mejoría que no ocurrió. Y cada recorrido -bis en el iPhone incluye probarlo con letra grande activada: ahí es donde se juegan cosas como si el rótulo Mi MindTune cabe en la barra (D-PF7, sin decidir).

Lo que está prohibido, y punto

• Formas de onda decorativas. Sugieren que la app mide el tinnitus de forma continua y objetiva, y no lo hace: la tinnitumetría es una comparación perceptual puntual. Además invitan a mirar la pantalla durante la sesión, contra la regla 1. (La razón se reescribió el 2026-09-20 con H8.2; la prohibición no cambió.) Cuando Hayo pidió barritas tipo Spotify durante la sesión, se rechazaron por escrito.
• Rojo en cualquier métrica de adherencia.
• Candados y la palabra «desbloquear» en el catálogo. Una terapia que aún no se puede empezar dice qué dato falta y ofrece el camino para completarlo. Ratificado por Hayo en H1.4-bis.
• Sombras como separador — se usan bordes.
• Emoji.
• Más de un color de acento. El teal es el único color de acción de la app.

Las cuatro excepciones

Todas son excepciones a «más de un color de acento» o a la quietud, ninguna a las reglas 1 a 4. Cada una trae condiciones verificables: si una condición se cae, se cae el componente.

1. El dorado del cierre de la marca (2026-08-30, H4.3b)

El #F2C066 con que la marca animada cierra un proceso técnico no es un segundo acento: no pinta ninguna superficie, ningún texto y ningún control. Es medio segundo de luz cuando algo termina, y no vuelve.

Ejemplo real. En el primerísimo arranque tras instalar, y cuando el perfil queda completo, la marca hace la vuelta completa y el dorado se sostiene 1040 ms — el doble de lo normal. Son los dos únicos momentos. Sigue prohibido usar ese cierre al terminar una sesión de terapia: eso sería celebrar.

2. Los matices de identidad de terapia (2026-08-31, H3.2)

El Historial muestra sesiones de cuatro terapias distintas y hacía falta distinguirlas de un vistazo. Los cuatro matices dicen qué terapia fue, nunca qué tan bien lo hiciste.

Tres condiciones. El matiz nunca informa solo —siempre hay rótulo o posición al lado, porque una persona daltónica tiene que poder leer el Historial entero sin el color—; ningún matiz codifica valencia, nada de verde-bien ni rojo-mal; y el teal sigue siendo el único color de acción.

3. El matiz en el catálogo (2026-09-10, H1.4-bis)

Lo mismo, extendido al ícono de cada terapia en su tarjeta del catálogo.

Ejemplo real de la condición que más se pone a prueba: una terapia a la que le faltan datos se atenúa por opacidad, no cambia de color. Si cambiara de color, el matiz estaría diciendo no puedes, y eso es valencia.

4. El visual de sesión (2026-09-20, H1.15)

El ícono de la terapia respira a 6 por minuto durante la sesión y, en las terapias con música, alterna canción a canción con un pulso al tempo de la pista. Es una excepción deliberada al «nada gira, late ni pulsa», y ninguna excepción a la prohibición de formas de onda: no dibuja el sonido, dibuja un ritmo.

Existe porque el objetivo no es que el paciente no mire nada, sino que lo que mire no sea su tinnitus. Desviar la atención hacia la música es terapia, no decoración — el marco lo fijó Hayo, en contra de lo que Cowork había propuesto.

Cinco condiciones. (1) No codifica ningún dato: quitarlo entero no le resta una sola información a la pantalla. (2) No cierra ningún anillo, no vira a dorado y no celebra. (3) La modulación visible nunca pasa de ~1,2 Hz ni del 6 % de escala. (4) Se apaga sola a los 90 s sin tocar, porque la regla 1 manda sobre el gusto. (5) Con Reducir movimiento activado, no existe. Y no abre un segundo acento: los dos modos se distinguen por opacidad y amplitud dentro del matiz de la excepción 2.

⚠️ Desfase: la condición (3) dice 1,2 Hz y otra parte del mismo §4.24 dice que se late en la blanca sobre 120 bpm — que son 2 Hz. El código implementó el techo de 1,2 Hz (parte el pulso en dos sobre 144 bpm). Falta decidir cuál de las dos frases queda. Ver deuda.md.