feat(schema): esquema declarativo + seed v3 del formulario [4B]

Extiende questions con instance_generator/instance_of/hint y documenta
los operadores contains/eq_sole en conditional_rules (ADR-005).

Reescribe seed.sql con el instrumento v3.0.0 completo: 10 secciones,
40 preguntas (2 consentimiento + 38), contenido 100% desde
Formulario_Mapeo_Corregido.xlsx (versión autoritativa). Flujo
declarativo en datos, no en presentación: 3.1='No' oculta 3.2-3.5;
"Ninguna" en 4.1 salta a S10; "solo niño sin discapacidad" deja
visibles 5.3, 8.4, 9.1, 9.4 y oculta el resto (decisión confirmada
sobre el Excel corregido).

SEED_SPEC.md reescrito como contrato v3.0.0.

No ejecutado en producción — solo archivos de migración y seed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

SEED_SPEC.md

@@ -1,152 +1,209 @@
-# SEED_SPEC.md — Contrato del instrumento "Mapeo de Cuidadores" v2.1
+# SEED_SPEC.md — Contrato del instrumento "Mapeo de Cuidadores" v3.0.0
 
-> Versión 2.1 — incorpora feedback del equipo médico, Etapa 3I2 (Jun 2026). Reemplaza la v2.
-> 44 preguntas (se elimina 2.4, se agrega 6.6) · 8 secciones · Códigos únicos corregidos.
+> Versión 3.0.0 — Sprint 4, Etapa 4B (Jun 2026). Reemplaza la v2.1. Reescritura completa del
+> instrumento: 10 secciones, 40 preguntas (2 consentimiento + 38 de relevamiento), esquema
+> declarativo de flujo (ADR-005). Seed LIMPIO — no migra datos de v2.1.
+>
+> Fuente de contenido AUTORITATIVA: `Formulario_Mapeo_Corregido.xlsx` (versión corregida,
+> en rojo = cambios aplicados). El mockup `wizard_formulario_mapeo_v3.html` define estructura
+> de secciones y mecánica del mini-wizard (4.1→4.2/4.3); donde el Excel difiere en el flujo
+> condicional de "solo niño sin discapacidad", gana el Excel (decisión de la directora, ver
+> abajo "Flujo condicional — recorrido soloNino").
+>
 > Claude Code reescribe `seed.sql` a partir de ESTE contrato.
 
 ## Convenciones
-- Tipos: radio→`single_choice`, checkbox→`multiple_choice`, escala 1-5→`rating`,
-  texto libre largo→`text_long`, texto corto→`text_short`.
-- **`conditional_rules` en la pregunta DEPENDIENTE** (cada pregunta declara su propia condición).
-- Los 3 triggers (1.1, 1.6, 1.13) son `single_choice` de 2 opciones (Sí · No); solo **"Sí"** dispara
-  el bloque correspondiente.
-- `is_sensitive=true` en preguntas de salud/discapacidad/diagnóstico (marcadas ✅).
-- `3.4` (salary) — `is_sensitive=true` + analyst-only (ADR-001 addendum): nunca en vistas org_admin.
-- RE-INDEX: las preguntas marcadas son candidatas a índice compuesto (metodología TBD Sprint 3).
-- En preguntas `multiple_choice` el formulario muestra el subtítulo "Podés marcar más de una opción".
-- "Prefiero no decir" eliminada de todas las preguntas (Cambio 1, Etapa 3I2).
 
-## Estructura condicional (4 bloques)
-- **cond-disc-propia** — 1.1='Sí' → muestra 1.2, 1.3, 1.4, 1.5
-- **cond-familiar** — 1.6='Sí' → muestra 1.7, 1.8, 1.9, 1.10, 1.11, 1.12
-- **cond-adulto-mayor** — 1.13='Sí' → muestra 1.14, 1.15, 1.16
-- **salto-triple** — si 1.1='No' Y 1.6='No' Y 1.13='No' (es decir, ninguno de los tres dio
-  'Sí'), se ocultan completas las secciones 2, 3, 4, 5 y las preguntas 6.1, 6.2, 6.3. El
-  formulario salta directo a 6.4. Implementado como `conditional_rules`
-  `{"if_question":["1.1","1.6","1.13"],"op":"eq_any","value":"Sí","action":"show"}` en cada
-  pregunta del bloque (equivalente: se muestra si AL MENOS uno de los tres es 'Sí').
-- Sección A, 6.4-6.6 y Sección 7 (cierre): **top-level, siempre visibles.**
+- Tipos: radio→`single_choice`, checkbox→`multiple_choice`, texto libre corto→`text_short`,
+  texto libre largo→`text_long`, sí/no→`yes_no`.
+- Secciones persisten como filas `questions.type='section'`: `prompt`=nombre de sección,
+  `hint`=descripción/"porqué" (Opción C, ver ADR-005 §4.2).
+- `conditional_rules` vive en la pregunta/sección DEPENDIENTE (auto-target implícito, sin
+  campo `target`). Vocabulario completo en `supabase/migrations/20260620000002_form_schema_v3.sql`:
+  operadores `eq`, `eq_any`, `not_in`, `contains`, `eq_sole`; acciones `show`, `hide`.
+- `is_sensitive=true` en preguntas de salud/discapacidad/diagnóstico y en 8.4 (franja salarial,
+  CONFIDENCIAL — analyst-only, nunca en vistas de empresa, igual que 3.4 en v2.1).
+- En preguntas `multiple_choice` el `hint` suele ser "Podés marcar más de una opción".
+- Mini-wizard de instanciación (ADR-005): 4.1 es `instance_generator=true`; 4.2 y 4.3 tienen
+  `instance_of='4.1'` y se repiten una vez por cada vínculo familiar (opciones 2–7) marcado en 4.1.
+  Las respuestas de cada instancia se guardan en `answers.instance_id` (`'familiar_1'`, `'familiar_2'`...).
+- Geo: 2.1 (departamento, 18 opciones) y 2.2 (ciudad, 219 opciones filtradas por departamento en
+  el renderer) son cuasi-identificadores. 2.3 (barrio) es `text_short` de texto libre, opcional —
+  NO entra al store analítico crudo sin categorizar (regla 4 CLAUDE.md); se usa solo como apoyo
+  cualitativo, no agregable.
+
+## Flujo condicional — las 3 reglas principales
+
+1. **`r_show_si_s3_1`** — 3.1='Sí' → muestra 3.2, 3.3, 3.4, 3.5 (discapacidad propia).
+   Si 3.1='No', toda la sub-rama queda oculta.
+2. **`r_hide_ning`** — 4.1 contiene "Ninguna de las anteriores / No tengo vinculación de cuidado"
+   → oculta S5, S6, S7, S8(header), 8.4, S9(header), 9.1, 9.4. El formulario salta directo a S10.
+3. **`r_hide_ning_sn`** (Ninguna O soloNino) — además de la condición anterior, también oculta
+   cuando 4.1 tiene como ÚNICO elemento seleccionado "Hijo menor sin discapacidad" (`eq_sole`).
+   Oculta: 5.1, 5.2, 5.4, S6 completa, S7 completa, 8.1, 8.2, 8.3, 9.2, 9.3.
+
+### Flujo condicional — recorrido "solo niño sin discapacidad" (soloNino)
+
+Decisión de la directora (Etapa 4B): cuando 4.1 tiene como única respuesta "Hijo menor sin
+discapacidad", el recorrido visible es **5.3 → 8.4 → 9.1 → 9.4 → fin**, tal como lo especifica
+el Excel corregido (no el mockup, que marcaba toda la Sección 5 como oculta). Esto es más
+granular que un simple "salto de sección": 5.3, 8.4, 9.1 y 9.4 quedan visibles porque no
+dependen de que haya responsabilidad económica o de cuidado activo — preguntan por quién
+cuida durante el horario laboral (5.3), franja salarial (8.4) y percepción/voluntariado
+organizacional (9.1, 9.4), que aplican igual a quien solo tiene un hijo menor sin discapacidad.
+
+- **4.1 = sole "Hijo menor sin discapacidad"**: 4.2 y 4.3 se ocultan (no hay tipo de
+  discapacidad ni dispositivos de apoyo que relevar), 5.1/5.2/5.4 ocultas, 5.3 VISIBLE,
+  S6 y S7 completas ocultas, 8.1–8.3 ocultas, 8.4 VISIBLE, 9.1 VISIBLE, 9.2/9.3 ocultas,
+  9.4 VISIBLE.
+- **4.1 contiene "Ninguna de las anteriores..."**: salta directo a S10 (todo S5–S9 oculto).
+- **4.1 = cualquier combinación de opciones 2–7** (con o sin la opción 1): recorrido completo,
+  4.2/4.3 generan una instancia por cada vínculo 2–7 declarado.
 
 ---
 
-## Sección A — Datos Generales (top-level)
-| Code | Tipo | Pregunta | Opciones | Notas |
-|---|---|---|---|---|
-| A1 | single_choice | ¿En qué departamento de Paraguay vivís?* | Asunción (Capital) · Alto Paraguay · Alto Paraná · Amambay · Boquerón · Caaguazú · Caazapá · Canindeyú · Central · Concepción · Cordillera · Guairá · Itapúa · Misiones · Ñeembucú · Paraguarí · Presidente Hayes · San Pedro | qi_zone |
-| A2 | single_choice | ¿En qué ciudad vivís?* | 219 ciudades (GeoSelectWidget: dependiente de A1) | qi_city — Sprint 3 |
-| A3 | text_short | ¿En qué barrio vivís? | — (texto libre, opcional) | |
-| A4 | single_choice | ¿En qué área o gerencia trabajás?* | Directorio · Gerencia · Operaciones/Producción · Comercial/Ventas · Administración/Finanzas · Recursos Humanos/Cultura · Tecnología/Sistemas · Logística/Distribución · Otra área | qi_sector |
-| A5 | single_choice | ¿Cuántos años tenés? | Menos de 25 años · 25 a 34 años · 35 a 44 años · 45 a 54 años · 55 años o más | qi_age_bucket |
-| A6 | single_choice | ¿Con qué género te identificás? | Femenino · Masculino · No binario/Otro | |
-| A7 | single_choice | ¿Cuál es tu modalidad de trabajo actual? | Presencial · Remoto (home office) · Híbrido | |
+## Sección 1 — Consentimiento (`S1`, pos. 10)
 
-## Sección 1 — Prevalencia: cuidado y discapacidad *(sensible)*
-| Code | Tipo | Cond. | Pregunta | Opciones | is_sensitive |
+| Code | Tipo | Pregunta | Requerida | Notas |
+|---|---|---|---|---|
+| 1.1 | yes_no | Declaro que fui informado/a sobre el propósito de esta encuesta y el tratamiento de mis respuestas, y acepto participar de forma voluntaria en el diagnóstico interno de [Empresa]. | Sí | Gate de participación — ver `consent_versions` v2 |
+| 1.2 | yes_no | Autorizo que mis respuestas anonimizadas se utilicen para el estudio país sobre la economía del cuidado en Paraguay. | No | Scope `macro_n1` — Modo A (CLAUDE.md regla 7) |
+
+## Sección 2 — Datos generales (`S2`, pos. 20)
+
+| Code | Tipo | Pregunta | Opciones | is_sensitive | Notas |
 |---|---|---|---|---|---|
-| 1.1 | single_choice | trigger | ¿Vos mismo/a vivís con alguna discapacidad o condición de salud que afecte tu funcionamiento cotidiano?* | Sí · No | ✅ |
-| 1.2 | multiple_choice | 1.1=Sí | ¿Qué tipo de discapacidad o condición tenés? | Discapacidad física/motriz · Visual · Auditiva · Intelectual · TEA · Psicosocial/salud mental · Condición crónica que genera limitaciones · Otra | ✅ |
-| 1.3 | multiple_choice | 1.1=Sí | ¿Usás algún elemento de apoyo para la movilidad o autonomía? | Silla de ruedas · Bastón · Andador · Muletas · Prótesis · Tecnología asistiva · No utilizo | ✅ |
-| 1.4 | single_choice | 1.1=Sí | ¿Contás con certificado oficial de discapacidad? | Sí · No, pero estoy en trámite · No | ✅ |
-| 1.5 | single_choice | 1.1=Sí | ¿Tu condición afecta tu desempeño o comodidad en el trabajo? | Sí, de forma significativa · Sí, pero en aspectos puntuales · No, está bien gestionada | ✅ |
-| 1.6 | single_choice | trigger | ¿Tenés algún familiar cercano (hijo/a, pareja, hermano/a, padre/madre) que viva con discapacidad?* | Sí · No | ✅ |
-| 1.7 | multiple_choice | 1.6=Sí | ¿Cuál es tu vínculo con esa persona? | Hijo/a · Cónyuge/pareja · Padre o madre · Hermano/a · Otro familiar | ✅ |
-| 1.8 | multiple_choice | 1.6=Sí | ¿Qué tipo de discapacidad tiene? | Física/motriz · Visual · Auditiva · Intelectual · TEA · Psicosocial/salud mental · Condición crónica severa · Otra | ✅ |
-| 1.9 | multiple_choice | 1.6=Sí | ¿Qué tipo de apoyo o acompañamiento necesita principalmente? | Movilidad física · Comunicación · Apoyo escolar/educativo · Inclusión laboral · Terapias/rehabilitación · Apoyo emocional/psicosocial | ✅ |
-| 1.10 | multiple_choice | 1.6=Sí | ¿Usa algún elemento de apoyo para la movilidad o autonomía? | Silla de ruedas · Bastón · Andador · Muletas · Prótesis · Tecnología asistiva · No utiliza | ✅ |
-| 1.11 | single_choice | 1.6=Sí | Si es niño/a o adolescente en edad escolar: ¿está escolarizado/a y enfrenta barreras de aprendizaje? | Escolarizado/a, sin barreras importantes · Escolarizado/a, enfrenta barreras o faltan ajustes · No está escolarizado/a · No aplica | ✅ |
-| 1.12 | single_choice | 1.6=Sí | ¿La persona con discapacidad se encuentra trabajando actualmente? | Sí, está trabajando · No, y está buscando empleo · No, y no está buscando · No aplica | ✅ |
-| 1.13 | single_choice | trigger | ¿Tenés algún adulto mayor (60+ años) a tu cuidado o bajo tu responsabilidad?* | Sí · No | |
-| 1.14 | single_choice | 1.13=Sí | ¿Qué nivel de dependencia tiene? (la más representativa) | Independiente, pero necesita supervisión · Dependencia leve · Dependencia moderada · Dependencia severa | ✅ |
-| 1.15 | multiple_choice | 1.13=Sí | ¿Tiene una condición de salud que genere mayor necesidad de cuidado? | Demencia/Alzheimer · ACV/Parálisis · Enfermedad crónica grave · Movilidad reducida · Deterioro cognitivo · Sin condición específica | ✅ |
-| 1.16 | single_choice | 1.13=Sí | ¿Vive con vos o en otra vivienda? | Vive en mi hogar · Vive en otra vivienda · Está en residencia/institución | |
+| 2.1 | single_choice | Departamento | 18 departamentos de Paraguay + Capital | no | qi (cuasi-identificador) |
+| 2.2 | single_choice | Ciudad | 219 ciudades (filtradas por 2.1 en el renderer) | no | qi |
+| 2.3 | text_short | ¿En qué barrio vivís? | — (texto libre) | no | `hint`='Opcional.' — no entra al store analítico crudo |
+| 2.4 | single_choice | ¿Cuál es tu rango de edad? | Menos de 25 · 25-34 · 35-44 · 45-54 · 55+ | no | qi |
+| 2.5 | single_choice | ¿Con qué género te identificás? | Femenino · Masculino · No binario/Otro | no | qi |
+| 2.6 | single_choice | ¿En qué nivel organizacional estás? | Directivo · Gerencial · Jefatura · Operativo · Auxiliar · Otro | no | qi |
+| 2.7 | single_choice | ¿Cuál es tu modalidad de trabajo actual? | Presencial · Remoto · Híbrido | no | qi |
 
-## Sección 2 — Intensidad y rol del cuidado (top-level)
-> Cond.: **salto-triple** — toda la sección se oculta si 1.1='No' Y 1.6='No' Y 1.13='No'.
+## Sección 3 — Prevalencia de discapacidad (`S3`, pos. 30) *(sensible)*
+
+Cond.: 3.2–3.5 visibles solo si 3.1='Sí' (`r_show_si_s3_1`).
+
+| Code | Tipo | Pregunta | Opciones | is_sensitive |
+|---|---|---|---|---|
+| 3.1 | single_choice | ¿Vos mismo/a tenés alguna discapacidad o condición de salud que pudiera afectar tu independencia o desempeño laboral? | No · Sí | ✅ trigger |
+| 3.2 | multiple_choice | ¿Qué tipo de discapacidad o condición tenés? | Física/motora · Visual · Auditiva · Intelectual · Mental/psicosocial · Del habla y la comunicación · Múltiple · Vejez/osteoporosis/artrosis/otras · Amputación · Otra | ✅ |
+| 3.3 | multiple_choice | ¿Usás algún elemento de apoyo para la movilidad o autonomía? | Silla de ruedas · Bastón de apoyo · Bastón blanco · Andador · Muletas · Prótesis · Tecnología asistiva · Audífonos · No utilizo | ✅ |
+| 3.4 | single_choice | ¿Contás con certificado oficial de discapacidad? | Sí · No, pero estoy en trámite · No | ✅ |
+| 3.5 | multiple_choice | ¿Cómo afecta tu discapacidad y/o condición limitante en tu trabajo? | No afecta mi rendimiento · Falta de adecuaciones afecta más que la discapacidad · Transporte · Accesibilidad para participar | ✅ |
+
+## Sección 4 — Vinculación familiar (`S4`, pos. 40) *(sensible)*
+
+Mini-wizard: 4.1 `instance_generator=true`; 4.2/4.3 `instance_of='4.1'`, una instancia por
+vínculo 2–7 declarado en 4.1. Ocultas (4.2/4.3) si Ninguna o soloNino (`r_hide_ning_sn`).
+
+| Code | Tipo | Pregunta | Opciones | is_sensitive |
+|---|---|---|---|---|
+| 4.1 | multiple_choice | ¿Cuál de las siguientes vinculaciones familiares tenés? | 1. Hijo menor sin discapacidad · 2. Hijo menor con discapacidad · 3. Hijo adulto con discapacidad · 4. Familiar menor con discapacidad · 5. Familiar mayor con discapacidad · 6. Padre/madre con movilidad reducida o 100% dependiente · 7. Otro/Especificar · 8. Ninguna de las anteriores / No tengo vinculación de cuidado | ✅ generador |
+| 4.2 | multiple_choice (instancia) | ¿Qué tipo de discapacidades o limitaciones tienen tus familiares vinculados? | (mismo set que 3.2) | ✅ |
+| 4.3 | multiple_choice (instancia) | ¿Qué tipo de dispositivos de apoyo utilizan tus familiares vinculados? | (mismo set que 3.3, "No utiliza" en 3ra persona) | ✅ |
+
+## Sección 5 — Responsabilidad y cuidado (`S5`, pos. 50)
+
+Cond.: oculta completa si Ninguna (`r_hide_ning`). 5.1/5.2/5.4 además ocultas si soloNino;
+**5.3 permanece visible en soloNino** (ver "recorrido soloNino" arriba).
 
 | Code | Tipo | Pregunta | Opciones |
 |---|---|---|---|
-| 2.1 | multiple_choice ⚠️ TECH-DEBT | ¿Quién es el/la responsable principal del cuidado? | Yo soy el/la principal · Comparto con otro familiar · Hay cuidador/a pagado/a · Está en institución/centro de día |
-| 2.2 | single_choice | ¿Cuántas horas por día dedicás, en promedio, al cuidado directo? | Menos de 1h · Entre 1 y 3h · Entre 3 y 6h · Más de 6h · Varía mucho |
-| 2.3 | multiple_choice | ¿En qué momentos del día cuidás principalmente? | Antes del trabajo · Durante horario laboral (llamadas/emergencias) · Al llegar del trabajo · Durante la noche · Los fines de semana · Es continuo sin horario fijo |
-| 2.5 | single_choice | Como cuidador/a primario, ¿presentás signos de agotamiento o estrés crónico? | Sí, frecuentemente · A veces · No, lo llevo bien |
+| 5.1 | multiple_choice | ¿Cuál es tu rol en el cuidado de los niños y/o personas con discapacidad o dependientes? | Proveo financieramente · Comparto gastos con familiares · Administro recursos/organizo servicios · Cuido unas horas al salir del trabajo · Me ocupo de todas las gestiones |
+| 5.2 | multiple_choice | ¿En qué momento del día te ocupás de gestionar/organizar el cuidado? | Antes del trabajo · Después del trabajo · Durante el trabajo (llamadas/emergencias) · En cualquier momento · Fines de semana |
+| 5.3 | multiple_choice | Durante el tiempo que estás en el trabajo, ¿quién se ocupa del cuidado de las personas a tu cargo? | Mi cónyuge · Otro familiar · Cuidador/a contratado/a · Centro de estudios o cuidado · Un/a vecino/a · Otro |
+| 5.4 | single_choice | ¿Desde hace cuánto cumplís este rol de responsable o cuidador/a? | Menos de 1 año · 1-3 años · 3-5 años · Más de 5 años |
 
-> ⚠️ TECH-DEBT (2.1): pasó de `single_choice` a `multiple_choice` — selección múltiple sin orden
-> de prioridad. Deuda: implementar ranking (Principal cuidador soy yo > secundario instituto >
-> principal pagado > secundario familiar). Ver `TECH_DEBT.md`.
->
-> **2.4 eliminada** (Cambio 6, Etapa 3I2): "¿Contás con apoyo de otras personas para el cuidado?"
-> — feedback del equipo médico: pregunta similar/redundante con 2.1. Ver `OBSERVATIONS.md`.
+## Sección 6 — Intensidad del cuidado (`S6`, pos. 60)
 
-## Sección 3 — Impacto económico del cuidado (top-level)
-> Cond.: **salto-triple** — toda la sección se oculta si 1.1='No' Y 1.6='No' Y 1.13='No'.
-> 3.4: is_sensitive=true + analyst-only (no exponer a org_admin).
+Cond.: oculta completa si Ninguna o soloNino (`r_hide_ning_sn`).
+
+| Code | Tipo | Pregunta | Opciones |
+|---|---|---|---|
+| 6.1 | single_choice | ¿Cuántos días por semana estás a cargo del cuidado directo, en promedio? | 1–2 · 3–4 · 5–6 · Todos los días |
+| 6.2 | single_choice | Cuando estás a cargo del cuidado, ¿cuántas horas por día dedicás, en promedio? | 1–2 · 3–4 · 5–6 · Más de 6 horas |
+| 6.3 | multiple_choice | ¿En qué momentos del día cuidás principalmente? | Antes del trabajo · Al llegar del trabajo · Durante la noche · Fines de semana |
+| 6.4 | single_choice | Además del cuidado directo, ¿cuántas horas al día necesitás estar disponible o de guardia? | 1–2 · 3–4 · 5–6 · Más de 6 horas · Permanente/sin horario |
+
+## Sección 7 — Impacto en el trabajo (`S7`, pos. 70)
+
+Cond.: oculta completa si Ninguna o soloNino (`r_hide_ning_sn`).
+
+| Code | Tipo | Pregunta | Opciones |
+|---|---|---|---|
+| 7.1 | single_choice | ¿Cómo describirías tu nivel de descanso cuando te ocupás del cuidado y cómo impacta en tu desempeño? | Descanso bien · Irregular pero lo manejo · Me cuesta, afecta con frecuencia · Descanso muy poco, agotamiento afecta desempeño |
+| 7.2 | single_choice | En los últimos 3 meses, ¿con qué frecuencia sentiste que el cuidado afectó tu concentración o rendimiento? | Nunca/casi nunca · Algunas veces al mes · Varias veces por semana · Casi todos los días |
+| 7.3 | single_choice | En el último año, ¿faltaste al trabajo por situaciones relacionadas al cuidado? | Nunca · Pocas veces (1-3/año) · Varias veces (4-10/año) · Con frecuencia (+10/año) |
+| 7.4 | multiple_choice | ¿Qué aspectos de tu vida se ven más afectados por tu rol de cuidador/a? | Tiempo libre · Sueño · Vida social · Vida en pareja/familiar · Salud física · Salud emocional/mental · Desarrollo profesional · Situación económica |
+| 7.5 | multiple_choice | Por tu rol de cuidado, ¿alguna vez tuviste que…? | Reducir jornada · Rechazar ascenso · Declinar viajes/extras/capacitaciones · Cambiar a puesto menos exigente · Faltar/llegar tarde reiteradamente · Pensar en dejar el trabajo · Dejar un trabajo anterior · Ninguna de las anteriores |
+| 7.6 | single_choice | Pensando en los próximos 12 meses, ¿qué tan probable es que dejes o reduzcas tu trabajo por razones de cuidado? | Nada probable · Poco probable · Algo probable · Muy probable |
+
+## Sección 8 — Impacto económico (`S8`, pos. 80)
+
+Cond.: header y 8.4 ocultos si Ninguna (`r_hide_ning`). 8.1–8.3 además ocultas si soloNino.
+**8.4 permanece visible en soloNino.**
+
+| Code | Tipo | Pregunta | Opciones | is_sensitive |
+|---|---|---|---|---|
+| 8.1 | single_choice | ¿Cuánto estimás que gastás por mes en el cuidado? | 7 franjas, < 1M a > 15M Gs. | no |
+| 8.2 | multiple_choice | ¿En qué conceptos gastás principalmente el monto expresado? | Cuidador/a particular · Centro de día/institución · Traslados · Equipamiento médico/tecnología asistiva · Servicios terapéuticos/rehabilitación · Medicamentos · Insumos personales · Otros | no |
+| 8.3 | multiple_choice | ¿Cómo sostenés los gastos y responsabilidades del cuidado? | Solo con mi empleo · Ingresos extraordinarios · Emprendimiento · Me ayudan familiares · Me ayudan organizaciones sociales · Me ayudan vecinos/amigos · Eventos de recaudación · Subsidios estatales | no |
+| 8.4 | single_choice | ¿En qué franja salarial mensual te ubicás con tu trabajo en esta empresa? *(CONFIDENCIAL)* | 9 franjas, hasta 3M a 50M+ Gs. | ✅ analyst-only, nunca en vistas de empresa (igual criterio que 3.4 en v2.1) |
+
+## Sección 9 — Conciencia organizacional (`S9`, pos. 90)
+
+Cond.: header, 9.1 y 9.4 ocultos si Ninguna (`r_hide_ning`). 9.2/9.3 además ocultas si soloNino.
+**9.1 y 9.4 permanecen visibles en soloNino.**
 
 | Code | Tipo | Pregunta | Opciones | Notas |
 |---|---|---|---|---|
-| 3.1 | single_choice | ¿Cuánto estimás que gastás por mes en el cuidado? | Menos de Gs. 500.000 · Gs. 500.000–1.500.000 · Gs. 1.500.000–3.000.000 · Gs. 3.000.000–6.000.000 · Más de Gs. 6.000.000 | |
-| 3.2 | multiple_choice | ¿Qué servicios o apoyos utilizás actualmente? | Terapias especializadas · Cuidador/a particular · Centro de día/institución · Transporte adaptado · Medicación alto costo · Equipamiento médico/tecnología asistiva · No utilizo servicios formales | |
-| 3.3 | multiple_choice | ¿Cómo sostenés los gastos y responsabilidades del cuidado? | Con mi empleo de tiempo completo · Con mi empleo de tiempo parcial · Con trabajo independiente/emprendimiento · Me ayudan mis familiares · No puedo sostenerlo con mis ingresos | |
-| 3.4 | single_choice | ¿En qué franja salarial mensual te ubicás? *(CONFIDENCIAL — analyst-only)* | Sueldo mínimo · Gs. 3.000.000 a 5.000.000 · Gs. 5.000.001–8.000.000 · Gs. 8.000.001–12.000.000 · Gs. 12.000.001–15.000.000 · Gs. 15.000.001–18.000.000 · Gs. 18.000.001–25.000.000 · Gs. 25.000.001–50.000.000 · Gs. 50.000.001 o más | is_sensitive=true; never in org_admin views |
-| 3.5 | rating | ¿Los gastos de cuidado impactan en tu situación económica personal? | 1=Sin impacto · 2=Leve · 3=Moderado · 4=Alto · 5=Muy alto | RE-INDEX |
+| 9.1 | single_choice | ¿Sentís que tu empresa conoce o comprende la realidad del cuidado y la discapacidad de su gente? | Sí, acompañado/a · Parcialmente · No, invisible · Nunca hemos tocado el tema | |
+| 9.2 | multiple_choice (**max_select=3**) | ¿Qué apoyos de la empresa te ayudarían más? | Flexibilidad horaria/remoto · Apoyo económico/convenios · Beneficios terapias/salud · Contención emocional/psicológica · Capacitación y autocuidado · Redes de apoyo/grupos de pares · Información sobre recursos | |
+| 9.3 | single_choice | ¿Estarías dispuesto/a a participar en un grupo de apoyo para cuidadores dentro de la empresa? | Sí, definitivamente · Tal vez · No por ahora · Prefiero mantenerlo en privado | |
+| 9.4 | single_choice | ¿Estarías dispuesto/a a ser voluntario/a en iniciativas y/o redes de apoyo? | Sí · No | |
 
-> **Cambio 7** (3.1): se elimina "Sin gastos significativos" además de "Prefiero no decir".
-> **Cambio 8** (3.3): "Es difícil sostenerlo con mis ingresos" → "No puedo sostenerlo con mis
-> ingresos". Breaking change para datos existentes — ver `OBSERVATIONS.md`.
-> **Cambio 9** (3.4): "Sueldo mínimo – Gs. 5.000.000" se divide en "Sueldo mínimo" y
-> "Gs. 3.000.000 a 5.000.000". Breaking change para datos existentes — ver `OBSERVATIONS.md`.
+## Sección 10 — Comentarios adicionales (`S10`, pos. 100)
 
-## Sección 4 — Tiempo y descanso (top-level)
-> Cond.: **salto-triple** — toda la sección se oculta si 1.1='No' Y 1.6='No' Y 1.13='No'.
+Siempre visible — es el destino del salto "Ninguna de las anteriores" en 4.1.
 
-| Code | Tipo | Pregunta | Opciones |
-|---|---|---|---|
-| 4.1 | single_choice | ¿Cómo describirías tu nivel de descanso habitual? | Descanso bien, me siento recuperado/a · Descanso de forma irregular, pero lo manejo · Me cuesta descansar, me siento cansado/a con frecuencia · Descanso muy poco, el agotamiento afecta mi día a día | RE-INDEX |
-| 4.2 | multiple_choice | ¿Qué aspectos de tu vida se ven más afectados por tu rol de cuidador/a? | Tiempo libre y ocio · Sueño y descanso · Vida social y amistades · Vida en pareja/familiar · Salud física personal · Salud emocional/mental · Desarrollo profesional · Situación económica | |
-| 4.3 | rating | En una escala del 1 al 5, ¿cómo evaluás tu bienestar general en este momento? | 1=Muy mal · 2=Mal · 3=Regular · 4=Bien · 5=Muy bien | RE-INDEX |
-
-## Sección 5 — Impacto en el trabajo (top-level)
-> Cond.: **salto-triple** — toda la sección se oculta si 1.1='No' Y 1.6='No' Y 1.13='No'.
-
-| Code | Tipo | Pregunta | Opciones |
-|---|---|---|---|
-| 5.1 | single_choice | En los últimos 3 meses, ¿con qué frecuencia sentiste que el cuidado afectó tu concentración o rendimiento? | Nunca o casi nunca · Algunas veces al mes · Varias veces por semana · Casi todos los días | RE-INDEX |
-| 5.2 | single_choice | En el último año, ¿faltaste al trabajo por situaciones relacionadas al cuidado? | Nunca · Pocas veces (1–3 veces al año) · Varias veces (4–10 veces al año) · Con frecuencia (más de 10 veces al año) | |
-
-## Sección 6 — Conciencia organizacional (top-level)
-> Cond. (6.1-6.3): **salto-triple** — se ocultan si 1.1='No' Y 1.6='No' Y 1.13='No'.
-> 6.4-6.6: siempre visibles (destino del salto).
-
-| Code | Tipo | Pregunta | Opciones | Notas |
-|---|---|---|---|---|
-| 6.1 | single_choice | ¿Sentís que tu empresa conoce o comprende la realidad del cuidado y la discapacidad de su gente?* | Sí, me siento acompañado/a · Parcialmente, hay cierta comprensión · No, es algo bastante invisible · No, no se puede hablar del tema | RE-INDEX. Cambio 10: última opción reescrita (era "No, nunca se ha hablado del tema"). Breaking change — ver `OBSERVATIONS.md`. |
-| 6.2 | multiple_choice (**max_select=3**) | ¿Qué apoyos de la empresa te ayudarían más? Elegí hasta 3 | Flexibilidad horaria o trabajo remoto · Apoyo económico o convenios/descuentos · Acceso a terapias o salud · Contención/apoyo emocional o psicológico · Capacitación y autocuidado · Redes de apoyo/grupos de pares · Información sobre recursos y servicios disponibles | ⚠️ Ranking → multiple_choice para v1. Ranking widget al backlog. |
-| 6.3 | single_choice | ¿Estarías dispuesto/a a participar en un grupo de apoyo para cuidadores dentro de la empresa? | Sí, definitivamente · Tal vez, si hay más personas en la misma situación · No por ahora · Prefiero mantenerlo en privado | |
-| 6.4 | single_choice | ¿Conocés a algún compañero/a de trabajo que esté al cuidado de una persona con discapacidad o dependiente? | Sí, conozco a varias personas · Sí, conozco a una persona · No conozco a nadie · No estoy seguro/a | Código corregido (era 6.2 duplicado) |
-| 6.5 | single_choice | ¿Considerás que la empresa debería ofrecer apoyos a quienes cuidan a una persona dependiente? | Sí, definitivamente · Tal vez, dependería del caso · No lo considero necesario · No lo sé | Código corregido (era 6.3 duplicado) |
-| 6.6 | single_choice | ¿Estarías dispuesto/a a ser voluntario/a en iniciativas y/o redes de apoyo a personas con discapacidad y/o cuidadores? | Sí · No · Tal vez | Nueva (Cambio 4b, Etapa 3I2) |
-
-## Sección 7 — Para cerrar (top-level)
 | Code | Tipo | Pregunta | Notas |
 |---|---|---|---|
-| 7.1 | text_long | ¿Te gustaría dejar un comentario o sugerencia especial? (opcional) | No entra al store analítico crudo (regla 4 CLAUDE.md) |
+| 10.1 | text_long | ¿Te gustaría dejar un comentario o sugerencia especial? (opcional) | `hint`='Opcional.' — NO entra al store analítico crudo sin categorizar (regla 4 CLAUDE.md) |
 
 ---
 
-## Mapeo a cuasi-identificadores (`responses.qi_*`)
-- `qi_age_bucket` ← A5 (ya en bucket)
-- `qi_sector` ← A4 (área)
-- `qi_zone` ← A1 (departamento — poblado en `submit-survey.ts` desde Etapa 2E)
-- `qi_city` ← A2: **Sprint 3** — se agrega como columna qi en migration futura.
-  Por ahora A2 se captura en `answers` como single_choice.
+## Totales
+
+10 secciones (`type='section'`) + 40 preguntas = **50 filas** en `questions` por encuesta.
+Preguntas por sección: S1=2, S2=7, S3=5, S4=3, S5=4, S6=4, S7=6, S8=4, S9=4, S10=1 → 40.
+
+## Consent versions
+
+- **v1** (`20000000-0000-0000-0000-000000000001`): texto original v2.1, preservado — no se
+  altera para no invalidar `consent_records` ya firmados contra esa versión (regla 5 CLAUDE.md).
+- **v2** (`20000000-0000-0000-0000-000000000002`): texto revisado para el instrumento v3.0.0,
+  asignado a las 3 encuestas seed. Scopes: `["operativo","macro_n1"]` (Modo A).
+
+## Discrepancias mockup vs. Excel resueltas (AP.10)
+
+Reportadas y resueltas con la directora antes de escribir el seed:
+
+1. **Wording de preguntas y opciones**: el Excel corregido es la fuente autoritativa en todos
+   los casos donde difiere del mockup (~30 discrepancias menores de texto).
+2. **Recorrido soloNino**: el mockup marcaba `skipSoloNino:true` en TODA la Sección 5 (incluida
+   5.3). El Excel especifica un recorrido más granular: 5.3 → 8.4 → 9.1 → 9.4 → fin. Resuelto a
+   favor del Excel (ver "Flujo condicional — recorrido soloNino" arriba).
+3. **8.3 "Eventos de recaudación"**: opción presente en el Excel, ausente en el mockup. Incluida.
 
 ## ⚠️ Decisiones pendientes para el director (NO ejecutar sin aprobación)
-- **Ranking widget (6.2):** actual es multiple_choice max_select=3. Cuando se implemente el
-  widget de ranking (drag o 3 dropdowns), 6.2 pasa a tipo `ranking` con JSONB `{rank1, rank2, rank3}`.
-- **qi_city:** migration futura para agregar columna en responses y extender whitelist de agg_segment.
-  Se hace antes de Sprint 3 (dashboard con filtro por ciudad).
-- **Salary analytics:** metodología para calcular "carga económica del cuidado como % del ingreso"
-  es trabajo de metodología de investigación (fuera del scope del código).
-- **RE-INDEX scoring:** algoritmo de composición de los índices (descanso, bienestar, rendimiento,
-  conciencia) — decisión antes de construir los reportes del dashboard.
-- **Formulario de empresa (Relevamiento Empresa):** instrumento separado con PII de contacto.
-  Ejecutar offline para las primeras empresas. Diseño del modelo de datos en el sprint del builder.
+
+- **Ranking widget (9.2):** actual es `multiple_choice` con `max_select=3`. Si se requiere
+  orden de prioridad, pasa a tipo `ranking` (mismo criterio que 6.2 en v2.1).
+- **Motor genérico de formularios (Fase 2, BACKLOG-002):** este contrato es el primer caso de
+  prueba; el intérprete declarativo se generaliza después de validar el wizard de cuidadores.
+- **Migración de datos v2.1 → v3:** NO se ejecuta. v2.1.0-stable permanece intacta; v3 es un
+  instrumento nuevo con seed limpio.
+- **`qi_city`, RE-INDEX scoring, salary analytics:** decisiones heredadas de v2.1, aún abiertas,
+  no se resuelven en esta etapa.

supabase/migrations/20260620000002_form_schema_v3.sql

@@ -0,0 +1,47 @@
+-- Sprint 4 (v3.0.0) — Esquema declarativo del formulario wizard
+-- Extiende questions con tres campos para soporte de instanciación y secciones.
+-- Ver ADR-005: la lógica del flujo vive en datos, el frontend es un renderer.
+
+-- 1. instance_generator: marca la pregunta que genera instancias del mini-wizard.
+--    true en pregunta 4.1 (vínculos familiares); false en todas las demás.
+ALTER TABLE public.questions
+  ADD COLUMN IF NOT EXISTS instance_generator boolean NOT NULL DEFAULT false;
+
+-- 2. instance_of: código de la pregunta generadora de la que depende esta pregunta.
+--    '4.1' en preguntas 4.2 y 4.3 (se repiten una vez por familiar declarado en 4.1).
+--    NULL en todas las preguntas que no forman parte del mini-wizard.
+ALTER TABLE public.questions
+  ADD COLUMN IF NOT EXISTS instance_of text;
+
+-- 3. hint: texto auxiliar que el renderer muestra bajo el enunciado.
+--    Para type='section': descripción del "porqué" de la sección (ADR-005 §4.2, Opción C).
+--    Para preguntas regulares: hint de ayuda ("Podés marcar más de una opción", etc.).
+--    NULL cuando no aplica.
+ALTER TABLE public.questions
+  ADD COLUMN IF NOT EXISTS hint text;
+
+-- ── Vocabulario extendido de conditional_rules (referencia para el motor de flujo) ──
+--
+-- Formato de cada regla:
+--   { "if_question": CODE | CODE[], "op": OPERATOR, "value": VALUE, "action": ACTION }
+--
+-- Operadores:
+--   "eq"       — igualdad simple: la respuesta a if_question == value
+--   "eq_any"   — OR lógico: AL MENOS UNO de los if_question[] == value
+--   "not_in"   — la respuesta a if_question NO está en value (array de strings)
+--   "contains" — la respuesta (multiple_choice) CONTIENE value como uno de los
+--                elementos seleccionados; útil para detectar "Ninguna de las anteriores"
+--   "eq_sole"  — la respuesta (multiple_choice) tiene VALUE como ÚNICO elemento
+--                seleccionado; usado para el recorrido "solo niño sin discapacidad"
+--
+-- Acciones:
+--   "show"    — mostrar esta pregunta/sección cuando la condición se cumple
+--   "hide"    — ocultar esta pregunta/sección cuando la condición se cumple
+--
+-- Semántica de auto-target: la regla afecta a la pregunta/sección que la porta.
+-- Sin campo "target": una pregunta declara su propia condición de visibilidad.
+--
+-- Ejemplo — salto "Ninguna de las anteriores" en 4.1 oculta secciones S5-S7:
+--   { "if_question": "4.1", "op": "not_in",
+--     "value": ["Discapacidad propia", "Familiar con discapacidad", "Adulto mayor"],
+--     "action": "hide" }