Deuda que encontró la documentación
Lista única de desfases (el código y el normativo no dicen lo mismo) y de deuda normativa (un informe pidió actualizar algo y nadie lo hizo). Cada página de
como-funciona/que marca un> ⚠️ Desfase:tiene su fila acá. Esta lista no arregla nada: ningún hilo de documentación reescribe normativos. Última revisión: 2026-10-10, contra67c165a(DOC.3 sumó DF-23 … DF-31; IF.6, DF-32 … DF-34).
1. Desfases entre el código y los normativos
| id | Qué | Verdad en el código | Dice el normativo | Fuente | Dueño |
|---|---|---|---|---|---|
| DF-01 | H8.2 está hecha | Seis commits 5564c7e … 25a62e4, informe f15a912, 16 capturas | ROADMAP_MAESTRO.md §3 y §6 y MindTune2027/CLAUDE.md la dan como PROMPT pendiente para Claude Code | git log, INFORME_H8.2_Tinnitumetria.md | 🧠 Cowork |
| DF-02 | Secciones del perfil | 14 valores en SeccionPerfil, 12 cuentan (entró P13 Inhibición residual) | 13 secciones | domain/perfil_secciones.dart:38 | 🧠 Cowork |
| DF-03 | Versión del esquema del perfil | versionEsquema = 6 | v4 (cuenta desde H8.1) | domain/perfil_tinnitus.dart:281 | 🧠 Cowork |
| DF-04 | Test de octava | ±6 pasos de grilla = 1 octava (grilla de 1/6) | «±12 pasos» → saltaba dos octavas | MindTune_Tinnitumetria.md §6; INFORME_H8.2 §3.1 | 🧠 Cowork |
| DF-05 | Enunciado del test de octava | Con Ft > 5 657 Hz solo hay dos tarjetas y el texto cambia | «Uno de estos tres» | MindTune_Tinnitumetria.md §3.5; INFORME_H8.2 §3.1 | 🧠 Cowork |
| Semáforo de ruido ambiente | ✅ Resuelto en H8.11 (2026-10-01): 3 s de micrófono integrado, sin cifras; las constantes se calibran en H8.11-bis (TM-P10) | 3 s de micrófono con semáforo (D-T9) | INFORME_H8.11_Semaforo_de_ruido.md | — | |
| DF-07 | Volumen del sistema | No se puede leer (audio_session 0.1.25 lo tiene comentado): CausaDeInvalidez.volumen nunca se produce | Se lee al empezar y al terminar | INFORME_H8.2 §3.4 → TM-P6 | 🧠 decide volume_controller o MethodChannel |
| DF-08 | Techo de los dos ruidos | ~6 dB por debajo del techo del tono (guarda de pico sobre −6 dBFS RMS) | Un solo techo para todos los estímulos | INFORME_H8.2 §3.2 | 🧠 Cowork · 👤 oírlo en el iPhone |
| DF-09 | Requisito Cómo usarla | Se evalúa siempre, pero sin lección publicada se da por cumplido (D-A4) → hoy no gatilla nunca | Requisito por terapia, dicho como dato faltante | domain/terapia.dart:224-266; MindTune_Aprender.md §0 regla 2 | 👤 Hayo (H7.4 escribe las cuatro lecciones) |
| DF-10 | Tabla de qué sube con cuál | La tinnitumetría sube resumen con C2, comparaciones con C1 y series con C3 | MindTune_Consentimientos.md no tiene ninguna fila de tinnitumetría | INFORME_H8.2 §5 | 🧠 Cowork |
| DF-11 | Catálogo de eventos del servidor | sync/catalogo.py recibió los ocho de H8.2; faltan aprender.*, arranque.completado, perfil.seccion_*, perfil.vencido, perfil.actualizacion_*, ciencia.enlace, acerca.enlace | Debería tenerlos todos | INFORME_H8.2 §3.8 (anotado, no arreglado) | ⚙️ Claude Code |
| DF-12 | Campos del perfil en §2.4 del roadmap | Ya no son diez campos | «los 10 campos» | INFORME_H8.1 §5 | 🧠 Cowork |
| DF-13 | La ficha técnica de mMIDST contradice al código | 44 100 Hz · burst 166,7 ms · rampas lineales de 40,8 ms · ganancia 2,5×Δ dBFS · generador v3.3 | mMIDST_Spec_Tecnica.md: 48 kHz · 165 ms · raised-cosine 10 ms · «+5,2 dB» · generador v4.0 | MindTune_Plan_Integrado.md §1 (lo declara) | 🧠 Cowork (corregir la ficha) |
| DF-14 | Estrategias de tonos 1–3 | El código rotula la 0 como (validada) y deja las otras tres sin marca | §1.1 pide marcarlas como exploratorias en la app y en ética | features/audio/mmidst_params.dart:25-29 | 🧠 Cowork + ⚙️ Claude Code |
| DF-15 | H2.4 sin firmar | — | El parámetro clínico de mMIDST oído peor con lateralidad bilateral o central espera la firma de Hayo | ROADMAP_MAESTRO.md H2.4 | 👤 Hayo |
| DF-16 | Revista del RCT | El PDF del proyecto dice Brain Sciences | Hayo mencionó Frontiers; la cita va a salir en La ciencia dentro de la app | MindTune_Mi_MindTune_y_Perfil.md:481 (PF-P5) | 👤 Hayo |
| DF-17 | El «7 de cada 10» de Inducción de filtrado | Texto normativo de §2.3, hoy visible en la app, sin fuente publicable | Afirmación clínica de Hayo (programa CAS); el normativo mismo la marca pendiente | MindTune_Mi_MindTune_y_Perfil.md §2.3 y §11 (PF-P1) | 👤 Hayo — antes de la App Store |
| DF-18 | Textos de L2 en Hoy (H8.3-a) | Mi Perfil de Tinnitus · ¿Actualizamos tu perfil? / Cuéntanos cómo es tu tinnitus… (los de las tarjetas de H8.1); no dice qué venció | Actualiza tu perfil · qué venció y Tu perfil de tinnitus | features/hoy/lugares_de_hoy.dart; MindTune_Recorrido_del_Paciente.md §4 | 🧠 Cowork |
| DF-19 | Condición de afinar la Ft en L2 | Solo proponerCortaHoy: incluye la cuarta corrida con Ft firme | «Ft provisional y proponerCortaHoy» | domain/plan_de_hoy.dart (_siguientePaso); Recorrido §4 | 🧠 Cowork |
| DF-20 | L3 del recién llegado | La guía de la música (rama app, §5.3 regla 5), porque base está en construcción | Matriz §6 filas 1–2: «base o genérica» / «Cómo usar Inducción o base» | test/plan_de_hoy_test.dart filas 1–2; Recorrido §6 | 🧠 Cowork · 👤 RP-P1 |
| DF-21 | Inducción con su Cómo usarla publicada | Pasa a requisito (D-A4): L1 dice Falta: haber leído cómo usarla | Matriz §6 fila 2: Inducción (base) lista | domain/terapia.dart; Recorrido §6 | 🧠 Cowork decide si la base exime del requisito |
| DF-22 | hoy.plan y hoy.toque «bajo C1» | No hay tabla por evento en el código: la bitácora entera sale con C1 o C2 | «Ambos bajo C1»; MindTune_Consentimientos.md §1 no tiene fila de Hoy | data/vinculo_providers.dart (_canal); Recorrido §8 | 🧠 Cowork |
| DF-23 | M1-ft-alta (reglas_v1) | Dispara con Ft ≥ 1 500 Hz y semana ≥ 2, sin M0, sin persistencia: mMIDST como secundaria (con H1, al final) | Reglas §6: «M1 o M1-precoz y ftAlta» (que no haría nada) contra §9 paso 4 | domain/reglas_v1.dart (cabecera); INFORME_H8.3b_Reglas_v1.md §3, contradicción 1 y §5 (a) | 👤 Hayo decide el alcance · 🧠 Cowork corrige §6 |
| DF-24 | La Ft que leen las reglas | tinnitumetria.ftEnUsoHz (escrita, sostenida o calculada; la del equipo de respaldo) | Reglas §1.1: tinnitumetria.calculada.ftHz | domain/reglas_v1.dart (variablesDeReglas); INFORME_H8.15 §5 | 🧠 Cowork |
| DF-25 | H1 por GÜF | Grado ≥ 2 = 11 puntos o más (guf.dart) | Reglas §10, pregunta 4: «grado ≥ 2 (≥ 10 puntos)» | INFORME_H8.3b §3, contradicción 6 | 🧠 Cowork |
| DF-26 | La hoja recurrente de R2 | Lectura provisional: vuelve cada 14 días mientras la última medición que encendió R2 siga sobre el umbral y vigente (Goldberg-R2 28 d) | «Cada 14 días mientras r2 siga», con r2 de 14 días: no saldría nunca (Perfil §9.2, Reglas §3 S3, Insumos §1) | domain/cadencias.dart (tocaHojaR2); INFORME_H9.9_Insumos_en_Hoy.md §3, contradicción 1 | 👤 Hayo |
| DF-27 | Bitácora de reglas_v1 | recomendacion.emitida sube reglas, grados y dim_top sin R3, con los grados como siete grado_<dimensión>; no existen recomendacion.difiere_en_curso ni recomendacion.tocada | Reglas §11: reglas y grados enteros, lista de 7 enteros, cinco eventos | INFORME_H9.9 §3 contradicción 2; INFORME_H8.3b §3 puntos 6 y 10 | 🧠 Cowork |
| DF-28 | Aviso Tu tono cambió | No existe en Recomendaciones para mí (la fecha del cambio solo vive en la bitácora, ft.cambio) | Perfil §5.2: reglas_v1 lo anuncia | INFORME_H8.3b §3 punto 10 | ⚙️ Claude Code |
| DF-29 | P16 y el perfil que ya estaba completo | Quien tenía N de N pasa a N − 1 y pierde las reglas en Hoy hasta responder P16; Hoy no lo avisa | D-TU2 (P16 cuenta para N) con Recorrido §3 (reglas solo con N de N vigente) | domain/plan_de_hoy.dart (_porReglasV1); INFORME_H8.17_P16_Tubaria.md §3 y §5 (P-H8.17-1) | 👤 Hayo · 🧠 Cowork |
| DF-30 | motivo de T1 | Dos textos, por grado (sin alergia / con alergia), los de Tubaria §3 | Reglas §4: un solo texto, que dice «y tienes alergia» | INFORME_H8.17 §3, C1 | 🧠 Cowork |
| DF-31 | Vigencia de los datos que leen las reglas | vigenteParaReglas solo filtra el grado del THI, el GÜF, el Goldberg, P12 y P16. La serie de EVA (basal, actual, persistencia, mejoría clara), el THI basal/actual (ΔTHI), P05 (franjaPeor, también en P4) y la noche de P4 se usan sin tope. En Hoy no se nota (exige perfil completo y vigente); en Recomendaciones para mí con el perfil vencido, cuentan datos de cualquier antigüedad | Perfil §5.1: «un dato de estado se considera vigente mientras no supere 2 cadencias» (EVA 14 d, P05 112 d…) | domain/reglas_v1.dart (variablesDeReglas, franjaPeor); hallado por la revisión de DOC.3 | 🧠 Cowork decide · ⚙️ Claude Code |
| DF-32 | Cerrar la hoja ¿Cómo te fue? con el gesto | Conserva lo respondido y decide con el plan tal como se leía en Para hoy: sin cambio = De acuerdo, con cambio = Seguir con {anterior} % | Inducción §3 (D-IF13): «cerrarla equivale a De acuerdo sin respuestas si el plan no cambió» (descartarlas podía cambiar el plan en silencio) | features/terapias/hoja_como_te_fue.dart; INFORME_IF.5_Como_te_fue.md §3 D3 | 🧠 Cowork confirma |
| DF-33 | Qué indicación «fija el descenso» (Inducción) | Cualquier indicación aceptada de Inducción sin apartado del descenso detiene el plan, aunque no traiga descensoSonoridad (retrato completo de H6.9) | Inducción §2.2 punto 1: «una indicación … que fija el descenso» | data/ajustes_providers.dart (equipoFijaElDescenso); INFORME_IF.4_El_plan_de_descenso.md §3 D8 | 🧠 Cowork · 👤 Hayo |
| DF-34 | Historial de Inducción | Muestra escuchado de dosis con dosis = fin de la bajada (una sesión que sonó hasta el final dice «60 de 25 min»), y Bajó un {p} % en toda sesión con descenso, también las incompletas | Inducción §3.4: el nivel «en la sesión evaluada»; §1 no dice cómo se registra completa | features/historial/sesion_detalle_screen.dart; INFORME_IF.3 §3 D1, INFORME_IF.5 §3 D10 | 🧠 Cowork (redacción) |
2. Deuda normativa declarada por los informes y no absorbida
Siete informes pidieron actualizar normativos y su §5 sigue sin aplicarse. Es lo que el roadmap §6 llama deuda normativa fina.
| Informe | Hito | Fecha | Qué pide, en grueso |
|---|---|---|---|
INFORME_H8.1_Perfil.md §5 | H8.1 | 2026-09-11 | 8 ítems: subescalas del THI mal sumadas en la prosa (F 11 · E 9 · C 5), decidir si Tu equipo sin vínculo revierte P1 de H6.3, DS §4.10 y §4.20–4.23, grupo Perfil en la Bitácora, fila perfil.aprehensiones · C2 en Consentimientos, §2.4 del roadmap, Siguiente para ti en Aprender §5.3 |
INFORME_H1.14_Cierres.md §5 | H1.14 | 2026-09-20 | 8 filas: DS §4.14 (la Bienvenida deja de ser excepción), §4.14-bis (la vuelta completa arranca desde 0; la señal es «no había perfil»), §8.2; Perfil §4 (v5 · cierreDePerfilMostrado), §5-bis y §8; Aprender §6.1 (marca estática) |
INFORME_H1.15_Visual.md §5 | H1.15 | 2026-09-20 | 9 filas de DS: decidir §4.1 (tope del pulso a 1,2 Hz vs. pulso a la negra hasta 120 bpm), que el pulso solo existe en mMIDST, umbral de autocorrelación 0,20 y mínimo de 30 s, alineación con la posición de la pista, ícono a 96 px, §5.3 y §5.1 |
INFORME_H8.2_Tinnitumetria.md §5 | H8.2 | 2026-09-20 | 16 filas repartidas entre Tinnitumetría (§3, §4, §6, §7, §13), DS §4.25 y §4.7, Perfil §3.2 y §4, Plan Integrado §1.2-quinquies, Bitácora §1.1 y Consentimientos |
INFORME_IF.3_Induccion_25_minutos_o_mas.md §5 | IF.3 | 2026-10-09 | Inducción §1 (cómo se registra completa, la barra de sesión, la línea de Hoy), Bitácora §1.5 (dosisS = fin de la bajada), Plataforma Clínica (Planificado), DS §5.1 y §6, Reglas §1.1 |
INFORME_IF.4_El_plan_de_descenso.md §5 | IF.4 | 2026-10-09 | Inducción §2.1–§2.3 (dónde vive el plan, resumen con 100 %, migración, rango 10–60, redondeo), §1 (línea de 25 a 35 frente a bajadas de 40), D8 (DF-33), Plataforma Clínica (rangos y motivo de la foto) |
INFORME_IF.5_Como_te_fue.md §5 | IF.5 | 2026-10-09 | Inducción §3 (D-IF13, DF-32; corte del dato; nombres cortos), §5 (preguntas solo respondidas, una línea por evaluación; propuesta preguntadas), Bitácora §1.5 y §4, Plataforma Clínica, DS §4.39 y §6, Consentimientos §2 regla 4 |
3. Cosas menores anotadas al pasar
- Configuración (antes Ajustes) no es una pantalla ni una ruta: es el interruptor de modo oscuro dentro de su propia fila.
- La carpeta del código se llama
features/tinnitumetria/(con u); varios documentos escribentinnitometria. - Tres títulos de sección del perfil se recortan en la barra superior, y el rótulo Mi MindTune queda pegado al borde derecho con letra normal (D-PF7 sin decidir).