motor-de-encuestas/SEED_SPEC.md

SEED_SPEC.md — Contrato del instrumento "Mapeo de Cuidadores" v2

Versión 2 — incorpora revisión de la colega (Jun 2026). Reemplaza la v1 (34 preguntas). 44 preguntas · 8 secciones · Códigos únicos corregidos. 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 3 opciones; solo "Sí" dispara el bloque.
• 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).

Estructura condicional (3 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
• Secciones A, 2, 3, 4, 5, 6, cierre: top-level, siempre visibles.

---

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 · Prefiero no decir	qi_age_bucket
A6	single_choice	¿Con qué género te identificás?	Femenino · Masculino · No binario/Otro · Prefiero no decir
A7	single_choice	¿Cuál es tu modalidad de trabajo actual?	Presencial · Remoto (home office) · Híbrido

Sección 1 — Prevalencia: cuidado y discapacidad (sensible)

Code	Tipo	Cond.	Pregunta	Opciones	is_sensitive
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 · Prefiero no decir	✅
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 · 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 · Prefiero no decir	✅
1.6	single_choice	trigger	¿Tenés algún familiar cercano (hijo/a, pareja, hermano/a, padre/madre) que viva con discapacidad?*	Sí · No · Prefiero no decir	✅
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 · 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 · Prefiero no decir
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

Sección 2 — Intensidad y rol del cuidado (top-level)

Code	Tipo	Pregunta	Opciones
2.1	single_choice	¿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.4	single_choice	¿Contás con apoyo de otras personas para el cuidado?	Sí, apoyo familiar suficiente · Algo de apoyo, no suficiente · No, soy el/la único/a responsable · Tengo apoyo contratado
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 · Prefiero no decir

Sección 3 — Impacto económico del cuidado (top-level)

Code	Tipo	Pregunta	Opciones	Notas
3.1	single_choice	¿Cuánto estimás que gastás por mes en el cuidado?	Sin gastos significativos · 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 · Prefiero no decir
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 · Es difícil sostenerlo con mis ingresos
3.4	single_choice	¿En qué franja salarial mensual te ubicás? (CONFIDENCIAL — analyst-only)	Sueldo mínimo – Gs. 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 · Prefiero no decir	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

Sección 4 — Tiempo y descanso (top-level)

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

Sección 5 — Impacto en el trabajo (top-level)

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

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, nunca se ha hablado del tema	RE-INDEX
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)

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)

---

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.

⚠️ 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.