Familias

Módulo de la app tablet RadiAPS2 para gestionar núcleos familiares en cada vivienda: alta, filtros por barrio y ronda, inicio de visitas e integrantes.

App: RadiAPS2 (tablet) Menú: Censo → Familias

Jerarquía territorial: Área operativa → Centro de salud (si aplica) → Sector → Barrio → Vivienda → Familia → Persona

Relación con Viviendas y Configuración
Cada familia pertenece a una vivienda. El listado respeta el alcance de datos y la ronda actual de Configuración. Desde Viviendas podés entrar ya filtrado por un domicilio.

1. ¿Para qué sirve?

Una familia es el núcleo que vive en una vivienda (identificado por apellido). Desde ella se registran integrantes, visitas y encuestas de la ronda.

Desde esta pantalla podés:

  • Ver familias activas cargadas en la tablet (con conteos de integrantes, visitas y encuestas).
  • Crear familias nuevas asociadas a una vivienda.
  • Editar datos, marcar familia golondrina/migrante o inactivar con motivo.
  • Ir a Integrantes (Personas) y al listado de Visitas.
  • Comenzar Visita: abre el formulario de encuesta/visita de la ronda.
  • Consultar Vacunas (Nomivac) de los integrantes, si hay conexión.
  • Eliminar una familia (baja lógica en cascada sobre personas, visitas y encuestas).

Los datos se guardan en la base local y se sincronizan con el servidor al ejecutar Sincronizar.

2. Cómo acceder

Formas habituales de llegar a Familias:

  1. Menú lateral → sección Censo → Familias.
  2. Desde Viviendas: botón Familias en la tarjeta o fila (abre el listado filtrado por esa vivienda).
  3. Desde Planificación o Diagnóstico, cuando la app te lleva a una familia concreta.

En la cabecera verás Lista de Familias, tu nombre de usuario y el enlace Volver a Viviendas.

3. Qué familias se muestran

El listado aplica varias capas de filtro:

Filtro Efecto
Alcance de datos (Configuración) Con sector actual, solo familias cuya vivienda/barrio pertenece al sector configurado. Con todos los sectores, todas las familias activas de la tablet.
Estado Solo familias activas y que no están en traslado. Las inactivas no aparecen en este listado.
Barrio / Vivienda (selectores) Acotan el listado. Si entraste desde Viviendas, el filtro de vivienda ya viene aplicado.
Tipo / Priorización / Visitas en ronda Filtros operativos del día a día (ver sección 5).
  • La lista se carga de a 50 familias; si hay más, aparece Cargar más.
  • El orden predeterminado es por apellido A–Z.

4. Pantalla principal

Lista de Familias con búsqueda, filtros por barrio, vivienda, tipo, priorización y visitas en ronda
Vista principal: Volver a Viviendas, búsqueda, filtros operativos, total y selector tarjetas/lista.

4.1 Elementos de la interfaz

Elemento Función
Agregar Familia Abre el formulario de alta.
Buscar familias… Filtra por apellido (no distingue mayúsculas/minúsculas).
Todos los barrios Filtra por barrio de la vivienda.
Todas las viviendas Filtra por domicilio concreto.
Todas las familias (tipo) Filtra por tipo URBANA / RURAL (según datos cargados).
Todas las priorizaciones Filtra por priorización de la última visita de la familia.
Visitas en ronda Filtra por cantidad de visitas en la ronda actual (0, 1, 2, 3, más de 3).
Orden Apellido, número de familia o número de casa APS.
Total: N familias Cantidad que coincide con los filtros activos.
Selector de vista Tarjetas o lista (preferencia guardada en la tablet).

4.2 Información en cada familia

Vista tarjetas:

  • Apellido de la familia (título).
  • Badges de número de familia / número de casa si están cargados.
  • Dirección de la vivienda y nombre del barrio.
  • Resumen: Tipo, Integrantes, Visitas (en ronda) y Encuestas.
  • Botones: Editar, Integrantes, Visitas, Comenzar Visita, Vacunas, Eliminar.

Vista lista (más compacta): apellido, dirección/barrio/tipo y conteos en una línea; acciones solo con íconos.

4.3 Tipos de vista

Vista Uso recomendado
Tarjetas Ver conteos y acciones con comodidad; pocos registros o tablet grande.
Lista Muchas familias; más filas visibles a la vez.

5. Filtros, búsqueda y orden

Búsqueda por apellido

  • Campo: Buscar familias…
  • Filtra mientras escribís (con una pequeña demora).
  • Si no hay coincidencias: «No se encontraron familias».
  • Si no hay familias: «No hay familias registradas».

Visitas en ronda

Usa la ronda actual de Configuración. Sirve para encontrar familias sin visita aún (Sin visitas en ronda) o con 1, 2, 3 o más de 3 visitas en esa ronda.

Priorización

La priorización no se edita en el alta de familia: proviene de la última visita (priorizacionVisita). El filtro lista los valores ya presentes en la tablet.

Orden del listado

Opción Comportamiento
Apellido de familia (A–Z) Predeterminado; útil para búsqueda alfabética.
Número de familia Orden numérico del identificador interno de familia.
Número de casa Orden por número APS de la vivienda; útil para recorrido cartográfico.

6. Campos del formulario (Agregar / Editar)

Al pulsar Agregar Familia o Editar, se abre un modal.

Modal Agregar Familia con selectores de barrio y vivienda
Modal Agregar Familia: primero barrio y vivienda; luego apellido, número, tipo y demás campos. Si hay filtro de vivienda activo, suele precargarse.
Campo Obligatorio Descripción
Barrio Sí (para elegir vivienda) Filtra el listado de viviendas del formulario.
Vivienda Sí Domicilio al que pertenece la familia.
Apellido de la familia Sí Identificador principal en listados y visitas.
Número de familia No Número interno/cartográfico de la familia en la vivienda.
Tipo de familia Sí URBANA o RURAL.
Observaciones No Texto libre multilínea.
¿Es familia Golondrina o Migrante? No Sí / No. Marca familias con movilidad temporal o migratoria.
Activa / Inactiva (al editar) — Al inactivar, es obligatorio el motivo. Se inactivan también los integrantes activos (excepto fallecidos).
Motivo de inactivación Sí, si inactiva Mudanza a otra vivienda del sector, a otro centro, a otra área operativa o a otra provincia.
Inactivación en cascada
Al pasar una familia a inactiva, la app confirma cuántos integrantes activos se inactivarán con el mismo motivo. Los fallecidos no se modifican. Las familias inactivas dejan de verse en este listado.

7. Acciones disponibles

7.1 Agregar familia

  1. Agregar Familia.
  2. Elegir barrio → vivienda, apellido, tipo y campos opcionales.
  3. Guardar Familia.

Validaciones: vivienda, apellido y tipo obligatorios.

7.2 Editar familia

  1. Editar.
  2. Modificar datos, vivienda o estado activo/inactivo.
  3. Actualizar Familia.

7.3 Integrantes

  1. Integrantes.
  2. Abre el módulo Personas filtrado por esa familia.

7.4 Visitas

  1. Visitas.
  2. Abre el listado de visitas ya registradas de la familia.

7.5 Comenzar Visita

  1. Comenzar Visita.
  2. Se abre el modal de encuesta: estado de la visita (visitada, rechazo, ausente, casa vacía, no habitable), tipo de entrevista (integral completa o seguimiento), supervisiones y actividades de seguimiento si corresponde.
  3. Al guardar, crea la visita de la ronda y puede continuar a las encuestas individuales / de vivienda.

7.6 Vacunas

Consulta el esquema de vacunación de los integrantes (Nomivac). Requiere conexión a internet; si no hay red, la app lo indica.

7.7 Eliminar familia

  1. Eliminar.
  2. Confirmar el diálogo.

Es una baja lógica: la familia se oculta en la tablet y se informa al servidor al sincronizar, incluyendo personas, visitas y encuestas asociadas.

8. Relación con otros módulos

Vivienda
  └── Familia
        └── Persona
        └── Visita / Encuesta
Módulo Relación
Configuración Alcance de datos y ronda actual (filtros de visitas en ronda).
Viviendas Cada familia pertenece a una vivienda; desde Viviendas entrás filtrado.
Personas Integrantes del núcleo familiar (botón Integrantes).
Visitas / Encuestas Comenzar Visita y listado de visitas; priorización nace de la última visita.
Planificación Familias planificadas del día; acceso rápido a la ficha.
Sincronizar Sube altas, ediciones e inactivaciones/bajas de familias.
Papelera Recuperación de familias eliminadas (Modo Administrador).

9. Sincronización

  • Familias nuevas o editadas quedan pendientes hasta sincronizar.
  • Familias eliminadas se envían como tombstone (baja lógica en cascada).
  • Hasta sincronizar, los cambios solo existen en la tablet.
  • La ronda y el DNI del agente (Configuración) se usan al crear visitas asociadas.
Pantalla Sincronización de Datos con estado por tabla
En Sincronizar, la fila de familias muestra cuántos registros están pendientes de subir.

10. Consejos de uso en terreno

  1. Creá primero la vivienda y después la familia; no se puede guardar sin domicilio.
  2. Usá el filtro Sin visitas en ronda para armar el recorrido del día.
  3. Preferí orden por número de casa cuando recorrés por cartografía APS.
  4. Marcá Golondrina/Migrante solo cuando corresponda al perfil real de la familia.
  5. Antes de eliminar, verificá integrantes y visitas; la baja es en cascada.
  6. Inactivá (no elimines) cuando la familia se mudó: así queda el motivo documentado.

11. Resolución de problemas

Problema Qué revisar
No veo familias de otro sector Alcance en Configuración.
No aparece la vivienda en el alta Creá/sincronizá la vivienda y elegí el barrio correcto en el modal.
No puedo guardar Completá vivienda, apellido y tipo (URBANA/RURAL).
Filtro de visitas en ronda vacío / raro Configurá la ronda actual en Configuración y sincronizá.
No veo una familia que inactivé El listado solo muestra activas; no es un error.
Vacunas falla Necesita internet / acceso a Nomivac; reintentá con Wi‑Fi o datos.
Cambios no llegan al servidor Ejecutá Sincronizar con conexión activa.

12. Glosario

Término Significado
Familia Núcleo domiciliario identificado por apellido, vinculado a una vivienda.
Tipo URBANA / RURAL Clasificación del ámbito de la familia.
Golondrina / Migrante Familia con residencia temporal o movilidad migratoria.
Priorización Nivel de prioridad proveniente de la última visita.
Visitas en ronda Cantidad de visitas registradas en la ronda configurada en la tablet.
idFamilia (UUID) Identificador único de la familia entre tablet y servidor.
Baja lógica / tombstone El registro se oculta localmente y se informa al servidor; puede recuperarse.

Tutorial RadiAPS2 · Módulo Familias · Agosto 2026.