docs: guía de prueba del formulario + lectura del dashboard, seed Fundación

Guía dirigida a dos audiencias: equipo técnico (plan de pruebas del
wizard contra la encuesta sandbox Demo) y Maria Mersan (cómo leer los
7 widgets de Mirada Empresa, k-anonimato, datos sintéticos vs reales).
Incluye también el seed de datos sintéticos de Fundación Solidaridad
ya aplicado en producción (versionado para trazabilidad).

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

docs/guias/GUIA_PRUEBA_FORMULARIO_Y_DASHBOARD.md

@@ -0,0 +1,142 @@
+# Guía — Probar el formulario y leer el dashboard
+## Datos País sobre el Cuidado
+
+> Dos públicos en un documento: **Sección 1** es para el equipo técnico que va a
+> probar el formulario. **Sección 2** es para Maria Mersan (metodología) — cómo
+> leer el dashboard de Mirada Empresa.
+
+---
+
+## Sección 1 — Plan de pruebas del formulario (equipo técnico)
+
+### El link
+
+```
+https://economia-cuidado.inqualityhq.com/?s=30000000-0000-0000-0000-000000000001
+```
+
+Esta es la encuesta **"Empresa Demo S.A."** — un sandbox pensado exactamente para
+esto. **Pueden responderla las veces que quieran.** No es la encuesta real de
+ningún cliente: nada de lo que carguen ahí se mezcla con datos reales.
+
+> ⚠️ No usen el link de Fundación Solidaridad ni el de InQuality para pruebas.
+> El sistema es **anónimo por diseño** (no guarda qué respuesta es de quién), así
+> que una respuesta de prueba enviada a una encuesta real queda mezclada para
+> siempre con datos reales, sin forma de distinguirla ni borrarla después.
+
+### Qué van a ver al entrar
+
+1. **Pantalla de consentimiento** — checkbox operativo (obligatorio) + checkbox de
+   estudio país (opcional). Sin esto no se entra al formulario.
+2. **El wizard** — 10 secciones, 40 preguntas. La mayoría son **obligatorias**
+   (recién activado) excepto la pregunta de barrio (2.3), que es texto libre
+   opcional.
+3. **Pantalla final** — botón "Enviar encuesta".
+
+### Checklist de cosas a probar
+
+- [ ] Completar el formulario entero y enviarlo — confirmar que llega la pantalla
+      de agradecimiento.
+- [ ] Intentar avanzar sin responder una pregunta obligatoria — debe bloquear con
+      mensaje "Este campo es obligatorio."
+- [ ] Dejar el campo de barrio (2.3) vacío y avanzar — **no** debe bloquear (es
+      opcional).
+- [ ] Escribir un barrio que no exista en la lista — debe aceptarse como texto
+      libre, sin error.
+- [ ] Seleccionar Departamento → confirmar que Ciudad se filtra por ese
+      departamento.
+- [ ] Ir hacia atrás con "Anterior" y adelante de nuevo — los valores que ya
+      cargaron deben seguir ahí.
+- [ ] Cerrar la pestaña a mitad de formulario, volver a abrir el link — debe
+      ofrecer retomar donde quedaron (guardado automático).
+- [ ] Probar en el celular (o achicando la ventana del navegador) — los botones y
+      el texto no se deben cortar ni superponer.
+- [ ] Si pueden, prueben con el wifi cortado a mitad de un envío — debe mostrar
+      un mensaje de error claro, no una pantalla rota.
+
+Cualquier cosa rara (texto que no carga, botón que no responde, algo que se ve
+mal en el celular) — repórtenlo con captura de pantalla y en qué pregunta pasó.
+
+### Dónde ver lo que enviaron
+
+- **Lista de respuestas:** `/admin/responses` (filtro por encuesta "Empresa Demo
+  S.A."). Necesita login.
+- **Dashboard:** `/dashboard?survey_id=30000000-0000-0000-0000-000000000001`
+  (ver Sección 2 para cómo leerlo). Con pocas respuestas de prueba, varios
+  números van a aparecer suprimidos — es el umbral de privacidad k≥5 funcionando
+  como debe (ver más abajo), no un bug.
+
+---
+
+## Sección 2 — Cómo leer el dashboard (para Maria)
+
+### Acceso
+
+`https://economia-cuidado.inqualityhq.com/dashboard` — requiere login.
+
+**Importante sobre roles, antes de entrar:** hoy el sistema tiene dos roles
+posibles — `platform_admin` (ve todas las organizaciones, incluido el selector
+"Todos") y `org_admin` (ve solo la organización a la que está asociado). El
+flujo de invitación que ya existe (`/admin/usuarios`) **solo puede crear
+usuarios `org_admin`** — no hay forma, hoy, de autoinvitarse como
+`platform_admin`. Si necesitás ver **varias** organizaciones desde tu propia
+cuenta (no solo Fundación Solidaridad), avisale a Marcos para que te dé acceso
+`platform_admin` directo en la base — el self-service todavía no lo cubre.
+
+### Qué mirar primero
+
+Arriba del dashboard hay un selector de organización. Para ver los datos que
+acabamos de cargar:
+
+```
+/dashboard?survey_id=30000000-0000-0000-0000-000000000003
+```
+
+(o click en "Fundación Solidaridad" en la barra superior).
+
+> 🧪 **Estos son datos sintéticos, no respuestas reales de cuidadores de la
+> Fundación.** Se generaron para que el dashboard tenga algo que mostrar
+> mientras se valida el diseño — no son representativos de la población real
+> de la Fundación todavía. Cuando empecemos a recolectar datos reales, te
+> avisamos explícitamente (así lo acordamos con Marcos).
+
+Las pestañas **Mirada País** y **Mirada Humana** todavía no están construidas
+(dicen "Disponible próximamente") — hoy solo **Mirada Empresa** tiene datos.
+
+### Los 7 indicadores de Mirada Empresa
+
+Cada tarjeta está anclada a una o más preguntas del instrumento (el número de
+pregunta aparece como subtítulo en cada tarjeta, para que puedan rastrear de
+dónde sale el número).
+
+| Tarjeta (como aparece en pantalla) | Pregunta(s) | Qué responde | Cómo leerla |
+|---|---|---|---|
+| **Talento en riesgo** | 7.6 + 7.3 + 7.5 | Métrica compuesta: % de la plantilla cuidadora con señales combinadas de fuga (probabilidad de irse/reducir + ausentismo + carrera frenada). | Es el número "traductor a negocio" — cuanto más alto, más costo de reemplazo en riesgo. Pensado para abrir la conversación con RRHH/dirección, no como diagnóstico aislado. |
+| **Cuidadores en la plantilla** | 4.1 | % de empleados con algún vínculo de cuidado activo (incluye hijo/a menor sin discapacidad, criterio UNFPA). | Es la prevalencia base — el "cuánta gente de mi plantilla está en esto" antes de mirar cualquier otro indicador. |
+| **Punto ciego organizacional** | 9.1 vs. 4.1 | Brecha entre la carga real de cuidado (prevalencia) y la percepción de que la empresa lo nota/apoya. | Si la brecha es grande, hay gente cuidando sin que la organización lo sepa — es el hallazgo central que justifica el dashboard (ver marco conceptual en `docs/dashboard/PROPUESTA_DASHBOARD_v3.md`). |
+| **Señales de impacto laboral** | 7.2, 7.3, 7.6, 7.5 | Desglose de presentismo, ausentismo, probabilidad de salida y carrera frenada — los componentes de "Talento en riesgo" mostrados por separado. | Útil para ver CUÁL señal pesa más en este segmento (¿es ausentismo o es que están rechazando ascensos?). |
+| **Apoyos más demandados** | 9.2 | Qué beneficios pedirían (hasta 3 opciones por persona). | Es el insumo directo para diseñar beneficios — léelo como un ranking, no como un % que suma 100%. |
+| **Dónde se concentra la carga** | 4.1 cruzado con 2.6 (nivel) y 2.7 (modalidad) | % de cuidadores por segmento (jerarquía × modalidad de trabajo). | Mirar si la carga se concentra en niveles operativos vs. gerenciales, y presencial vs. remoto — relevante para política de flexibilidad. |
+| **Disposición a red de apoyo** | 9.3 + 9.4 | % dispuesto a sumarse a un grupo de apoyo interno / hacer voluntariado. | Mide apetito para iniciativas comunitarias internas, no necesidad — alguien puede necesitar apoyo y no querer un grupo. |
+
+### El umbral de privacidad (k≥5)
+
+Todo el dashboard aplica **k-anonimato k≥5**: ningún segmento con menos de 5
+personas se muestra desagregado (aparece suprimido). Esto es una regla de
+diseño no negociable del proyecto (protege a quien respondió, especialmente
+tratándose de datos de salud/discapacidad) — si ves un segmento "vacío" o con
+guion, probablemente es esto, no un error de carga. Con el lote de 50
+respuestas sintéticas la mayoría de los cortes generales van a tener datos,
+pero cruces muy específicos (ej. un departamento + un nivel jerárquico puntual)
+pueden quedar por debajo del umbral.
+
+### Decisión metodológica pendiente (marcada para vos en la propuesta original)
+
+El documento `docs/dashboard/PROPUESTA_DASHBOARD_v3.md` (sección "Decisión
+metodológica pendiente — para Maria") deja abierta una definición: las métricas
+de vínculo de cuidado (4.1) se pueden leer **por persona** ("% de empleados con
+al menos un familiar con discapacidad X") o **por instancia** ("del total de
+familiares cuidados, % con discapacidad X"). Hoy el dashboard usa la lectura
+por persona. Si para tu análisis necesitás la lectura por instancia, es un
+cambio de método de cálculo a definir y construir — avisame cuando lo hayas
+decidido.