Barrios

Módulo de la app tablet RadiAPS2 para gestionar la subdivisión territorial entre el sector y las viviendas.

App: RadiAPS2 (tablet) Menú: Barrios

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

Relación con Configuración
El listado depende del alcance de datos y del sector configurados en Configuración. Revisá ese tutorial si no ves los barrios esperados.

1. ¿Para qué sirve?

Un barrio es la unidad territorial intermedia entre el sector y las viviendas. Cada vivienda debe pertenecer a un barrio.

Desde esta pantalla podés:

  • Ver los barrios cargados en la tablet.
  • Crear barrios nuevos en terreno.
  • Editar nombre, sector y observaciones.
  • Ir al listado de viviendas de un barrio.
  • Eliminar un barrio (baja lógica, con efecto en cascada sobre sus viviendas).

Los barrios se guardan en la base local de la tablet y se sincronizan con el servidor cuando ejecutás Sincronizar.

2. Cómo acceder

  1. Abrí el menú lateral (ícono de hamburguesa, arriba a la izquierda).
  2. Elegí Barrios.

En la cabecera verás el título Lista de Barrios y tu nombre de usuario (datos de Configuración).

Menú lateral de RadiAPS2 con la sección Censo expandida y la opción Barrios
Menú lateral → sección Censo → Barrios.

3. Qué barrios se muestran

El listado depende del alcance de datos configurado en Configuración:

Alcance en Configuración Barrios visibles
Sector actual (predeterminado) Solo barrios del área operativa y sector del agente configurado en la tablet.
Todos los sectores del área Todos los barrios activos de la tablet (sin filtrar por sector).
  • No se listan barrios eliminados (baja lógica).
  • El orden es alfabético por nombre.

4. Pantalla principal

Lista de Barrios: botón Agregar, búsqueda y selector de vista en tarjetas
Vista principal: título, botón Agregar Barrio, búsqueda y selector de vista. Si no hay barrios cargados, aparece el mensaje No hay barrios registrados.

4.1 Elementos de la interfaz

Elemento Función
Agregar Barrio Abre el formulario de alta.
Buscar barrios… Filtra en tiempo real por nombre (no distingue mayúsculas/minúsculas).
Selector de vista Alterna entre tarjetas y lista (la preferencia se guarda en la tablet).
Tarjeta / fila de barrio Muestra nombre, cantidad de viviendas y observaciones (si hay).
Botones de acción Editar, Viviendas, Eliminar.

4.2 Información en cada barrio

Vista tarjetas:

  • Nombre del barrio.
  • Cantidad de viviendas, por ejemplo: (3 viviendas).
  • Observaciones (texto libre), si fueron cargadas.
  • Botones: Editar, Viviendas, Eliminar.

Vista lista (más compacta):

  • Nombre en la primera línea.
  • Segunda línea: cantidad de viviendas y observaciones (truncadas si son largas).
  • Mismos tres botones, solo con íconos (sin texto), para ahorrar espacio.

4.3 Tipos de vista

Vista Ícono Uso recomendado
Tarjetas Cuadrícula Lectura cómoda, pocos barrios o pantalla grande.
Lista Viñetas Muchos barrios; más filas visibles a la vez.

La elección queda recordada aunque cierres la app.

Lista de Barrios en modo vista lista con el ícono de viñetas activo
Vista lista (ícono de viñetas): más compacta, útil cuando hay muchos barrios.

5. Filtros y búsqueda

Búsqueda por nombre

  • Campo: Buscar barrios…
  • Comportamiento: filtra mientras escribís.
  • Busca solo en el nombre del barrio (no en observaciones ni en sector).
  • Si no hay coincidencias: «No se encontraron barrios».
  • Si no hay barrios cargados: «No hay barrios registrados».

Filtro por sector (alcance de datos)

No hay un dropdown extra en esta pantalla: el filtro por sector/área viene de Configuración → Alcance de datos (sector actual vs. todos los sectores del área). Ver sección 3.

6. Campos del barrio (formulario)

Al agregar o editar, se abre un modal con los siguientes campos.

Modal Agregar Barrio con campos Sector, Nombre y Observaciones
Modal Agregar Barrio: sector (precargado desde Configuración), nombre obligatorio y observaciones opcionales. Al editar, los mismos campos en el modal Actualizar Barrio.

6.1 Campos visibles

Campo Obligatorio Descripción
Centro de salud Sí*, si el área tiene centros Lista desplegable con los centros del área. Al elegir uno, se cargan los sectores de ese centro. Solo aparece si existen centros de salud para el área.
Sector Sí, si hay sectores Sector territorial al que pertenece el barrio. Con centros, primero hay que elegir centro.
Nombre del barrio Sí Texto identificatorio (ej.: Barrio Norte, Villa Esperanza).
Observaciones No Texto libre, multilínea (referencias, límites, notas para el equipo).

6.2 Valores por defecto al crear

Al pulsar Agregar Barrio, el formulario suele precargar:

  • Área operativa y sector del agente (desde Configuración).
  • Centro de salud del agente, si corresponde.

Podés cambiarlos antes de guardar.

6.3 Datos internos (no editables en pantalla)

Dato Uso
idBarrio (UUID) Identificador único para sincronización con el servidor.
idArea / idSector Vinculación territorial.
Agente responsable / creación Trazabilidad de quién cargó el registro.
syncStatus / syncDate Estado de sincronización (pending, synced, etc.).
eliminado Marca de baja lógica si fue eliminado.

7. Acciones disponibles

7.1 Agregar barrio

  1. Agregar Barrio.
  2. Completar centro (si aplica), sector, nombre y opcionalmente observaciones.
  3. Guardar Barrio.

Validaciones: nombre obligatorio; centro obligatorio si hay centros; sector obligatorio si hay sectores en la lista.

7.2 Editar barrio

  1. Editar en la tarjeta o fila.
  2. Modificar los campos permitidos.
  3. Actualizar Barrio.

Al editar un barrio antiguo, si el sector no se puede inferir del centro, el formulario muestra los sectores del área para que puedas corregir la asignación.

7.3 Ver viviendas del barrio

  1. Viviendas (ícono de casa).
  2. Abre la pantalla Viviendas filtrada por ese barrio.

Desde ahí podés cargar direcciones, georreferenciar, etc.

7.4 Eliminar barrio

  1. Eliminar.
  2. Confirmar en el diálogo.
Importante
  • Es una baja lógica: el barrio deja de verse en el listado; al sincronizar se informa al servidor.
  • Se eliminan en cascada las viviendas del barrio y, según corresponda, familias, visitas y encuestas.
  • Para recuperar: Papelera (menú Datos, Modo Administrador), con opción de restaurar solo el barrio o incluir dependientes.

8. Relación con otros módulos

Sector
  └── Barrio
        └── Vivienda
              └── Familia
                    └── Persona
Módulo Relación
Configuración Define área, sector, centro y alcance de datos (qué barrios ves).
Viviendas Cada vivienda pertenece a un barrio; desde Barrios entrás filtrado.
Diagnóstico Detecta viviendas sin barrio válido y propone correcciones.
Sincronizar Sube barrios nuevos, modificados o eliminados al servidor.
Papelera Recuperación de barrios eliminados (Modo Administrador).
Importar / Exportar Intercambio de datos entre tablets o respaldo.

9. Sincronización

  • Barrios nuevos o editados quedan con estado pending hasta sincronizar.
  • Barrios eliminados se envían al servidor como tombstone (baja lógica).
  • Hasta sincronizar, los cambios solo existen en la tablet.
  • Conviene sincronizar antes de cambiar de dispositivo o reinstalar la app.
Pantalla Sincronización de Datos con estado de conexión, resumen y tablas pendientes
Pantalla Sincronizar (pestaña inferior o menú): estado de red, totales (sincronizados / pendientes) y detalle por tabla. Los barrios con cambios locales aparecen como pendientes hasta ejecutar la sync.

10. Consejos de uso en terreno

  1. Nombrá barrios de forma clara para todo el equipo (evitá duplicados con nombres muy parecidos).
  2. Usá observaciones para límites geográficos o referencias.
  3. Si el área tiene varios sectores, revisá en Configuración el alcance de datos.
  4. Antes de eliminar un barrio, verificá familias activas; la eliminación es en cascada.
  5. Preferí vista lista si tenés decenas de barrios en un mismo sector.

11. Resolución de problemas

Problema Qué revisar
No veo barrios que cargó otro agente Alcance en Configuración (sector actual vs. todos los sectores).
No puedo elegir sector Elegí primero el centro de salud (si el área tiene centros).
El barrio no aparece en el servidor Ejecutá Sincronizar y revisá conexión / servidor activo.
Eliminé un barrio por error Papelera (Modo Administrador) → restaurar.
Viviendas «huérfanas» Diagnóstico → asignar a barrio existente o crear barrio provisorio.

12. Glosario

Término Significado
Barrio Subdivisión del sector donde se agrupan viviendas.
Sector Unidad operativa del agente dentro del área (a veces ligada a un centro de salud).
Baja lógica / tombstone El registro se marca eliminado pero puede sincronizarse y recuperarse.
UUID (idBarrio) Identificador único del barrio entre tablet y servidor.

Tutorial RadiAPS2 · Módulo Barrios · Agosto 2026.