Viviendas

Módulo de la app tablet RadiAPS2 para registrar domicilios: dirección, número APS, georreferenciación y vínculo con familias.

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

1. ¿Para qué sirve?

Una vivienda es el domicilio donde viven una o más familias. Es la unidad geográfica que el agente visita en terreno.

Desde esta pantalla podés:

• Ver las viviendas cargadas en la tablet (con cantidad de familias por domicilio).
• Crear viviendas nuevas en campo.
• Editar dirección, barrio, teléfono, número APS, GPS y estado deshabitada.
• Ir al listado de familias de una vivienda.
• Eliminar una vivienda (baja lógica en cascada sobre familias, visitas y encuestas asociadas).

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

2. Cómo acceder

Hay tres formas habituales de llegar a Viviendas:

1. Menú lateral (ícono hamburguesa) → sección Censo → Viviendas.
2. Desde Barrios: botón Viviendas en la tarjeta o fila de un barrio (abre el listado filtrado por ese barrio).
3. Desde Planificación o Diagnóstico, cuando la app te redirige a editar una vivienda concreta.

En la cabecera verás Lista de Viviendas, tu nombre de usuario y el enlace Volver a Barrios para regresar al módulo anterior.

3. Qué viviendas se muestran

El listado depende de dos capas de filtro:

• No se listan viviendas eliminadas (baja lógica).
• El orden predeterminado es por número de casa (APS); podés cambiarlo (ver sección 5).
• La lista se carga de a 50 viviendas; si hay más, aparece Cargar más.

4. Pantalla principal

4.1 Elementos de la interfaz

4.2 Información en cada vivienda

Vista tarjetas:

• Dirección (título principal).
• Etiqueta Casa N si tiene número APS cargado.
• Etiqueta roja DESHABITADA si está marcada sin habitantes.
• Barrio al que pertenece.
• Familias asignadas: cantidad y apellidos (si hay).
• Botones: Editar, Familias, Eliminar.

Vista lista (más compacta):

• Dirección en la primera línea.
• Segunda línea: barrio · casa · cantidad de familias · deshabitada (si aplica).
• Mismos tres botones, solo con íconos.

4.3 Tipos de vista

La elección queda recordada aunque cierres la app.

5. Filtros, búsqueda y orden

Búsqueda por dirección y número APS

• Ambos campos filtran mientras escribís (con una pequeña demora para no recargar en cada tecla).
• La búsqueda por dirección actúa sobre el texto de la dirección.
• La búsqueda por número de casa actúa sobre el campo Número de APS.
• Si no hay coincidencias: «No se encontraron viviendas».
• Si no hay viviendas cargadas: «No hay viviendas registradas».

Filtro por barrio

El dropdown Todos los barrios restringe el listado a un barrio. Si llegaste desde Barrios → Viviendas, ese barrio ya viene preseleccionado.

Orden del listado

6. Campos del formulario (Agregar / Editar)

Al pulsar Agregar Vivienda o Editar, se abre un modal con los siguientes campos.

7. Acciones disponibles

7.1 Agregar vivienda

1. Agregar Vivienda.
2. Elegir barrio, completar dirección y campos opcionales.
3. Opcional: marcar Sin habitantes o capturar GPS.
4. Guardar Vivienda.

Validaciones: barrio y dirección obligatorios.

7.2 Editar vivienda

1. Editar en la tarjeta o fila.
2. Modificar los campos necesarios (incluido cambiar de barrio si hubo error de asignación).
3. Actualizar Vivienda.

Desde Diagnóstico, la app puede abrir directamente la edición de una vivienda sin barrio válido (editIdVivienda en la ruta).

7.3 Ver familias de la vivienda

1. Familias (ícono de grupo).
2. Abre el módulo Familias filtrado por esa vivienda.

7.4 Eliminar vivienda

1. Eliminar (ícono rojo).
2. Confirmar en el diálogo de advertencia.

Es una baja lógica: la vivienda deja de verse en la tablet y se informa al servidor al sincronizar. El mensaje advierte que también afecta familias, visitas y encuestas asociadas.

8. Relación con otros módulos

Barrio
  └── Vivienda
        └── Familia
              └── Persona

9. Sincronización

• Viviendas nuevas o editadas quedan con estado pending hasta sincronizar.
• Viviendas eliminadas se envían como tombstone (baja lógica en cascada).
• Hasta sincronizar, los cambios solo existen en la tablet.
• Las coordenadas GPS y el número APS viajan con el registro al servidor.

10. Consejos de uso en terreno

1. Cargá el número APS en el mismo orden que recorrés el barrio; facilita la planificación.
2. Capturá GPS al llegar al domicilio, no desde la vereda opuesta.
3. Usá Sin habitantes solo para casas permanentemente vacías, no para ausencias temporales.
4. Si tenés cientos de viviendas, preferí vista lista y el filtro por barrio.
5. Antes de eliminar, verificá que no queden familias activas que deban trasladarse.

11. Resolución de problemas

12. Glosario

Tutorial RadiAPS2 · Módulo Viviendas · Agosto 2026.