Configuración

Pantalla central de la app tablet RadiAPS2 donde se define el perfil operativo del agente y de la tablet: territorio, ronda, alcance de datos y acceso local.

App: RadiAPS2 (tablet) Menú: Configuración
Importante
La configuración se guarda siempre en la tablet, incluso sin internet. La vinculación del agente con el servidor (UUID / responsable) se completa al sincronizar.

1. ¿Para qué sirve?

Configuración define quién sos y dónde trabajás en el sistema. Esos datos se usan en toda la app:

  • Nombre del agente en la cabecera de las pantallas.
  • Filtro territorial de barrios, viviendas, familias, personas y visitas.
  • Ronda activa para visitas, encuestas y KPIs del inicio.
  • Identificación al sincronizar con el servidor (DNI, apellido, nombre).
  • Protección opcional con usuario y contraseña local al abrir la app.

2. Cómo acceder

  1. Menú lateral → Configuración.
  2. O desde el acceso directo en la pantalla de inicio si está disponible.

Al entrar, la app carga catálogos (zonas, áreas, centros, sectores, rondas) y los datos guardados en whoami.

3. Estructura del formulario

El formulario está organizado en bloques, de arriba hacia abajo:

  1. Territorio: Zona → Área → Centro de salud (si aplica) → Sector.
  2. Cobertura: Planta o Guardia.
  3. Alcance de datos: sector actual o todos los sectores.
  4. Datos personales: Apellido, nombre, DNI, supervisor intermedio.
  5. Ronda actual.
  6. Autenticación local (opcional).

4. Territorio (Zona, Área, Centro, Sector)

Los campos son dependientes en cascada: al cambiar uno superior, se reinician los inferiores.

Pantalla Configuración: selectores de Zona, Área y Sector en cascada
Parte superior del formulario: territorio en cascada (Zona → Área → Sector). Los campos inferiores se habilitan al completar los anteriores.
Campo Obligatorio Descripción
Zona Sí Primera selección. Muestra código y nombre. Al elegirla, carga las áreas de esa zona.
Área Sí Área operativa del agente. Habilitada solo después de elegir zona. Precarga estabbase del área.
Centro de salud Condicional Aparece solo si el área tiene centros de salud. Filtra los sectores disponibles del centro elegido.
Sector Sí Sector territorial de trabajo. Con centros de salud, requiere centro seleccionado primero.

Diagnóstico de sectores del centro

Si el área tiene centros, debajo del selector de centro aparece el botón Diagnosticar sectores de este centro. Sirve para soporte técnico: compara sectores activos/inactivos en la tablet vs. catálogo remoto y ayuda a detectar inconsistencias de UUID o sectores faltantes.

Sectores inactivos (modo reparación)

Si no hay sectores visibles tras elegir área/centro, puede aparecer Mostrar sectores inactivos para reparación. Al activarlo:

  • Se listan también sectores marcados como inactivos en el catálogo.
  • Aparecen etiquetados como (inactivo) en el dropdown.
  • Permite recuperar una configuración histórica cuando el sector fue desactivado en el servidor.

5. Cobertura

Campo obligatorio con dos opciones:

  • Planta
  • Guardia

Se envía al servidor en la sincronización como dato del agente.

6. Alcance de datos

Define qué registros ves en listados y KPIs de la app. Es una de las opciones más importantes para el día a día.

Opción Efecto
Usar solamente los datos del sector actual Filtra barrios, viviendas, familias, personas, visitas y KPIs por la zona/área/sector configurados arriba. Es el modo predeterminado para trabajo habitual en un solo sector.
Usar todos los datos de todos los sectores Muestra todo lo cargado en la tablet, sin filtrar por sector. Útil para supervisores o tablets con datos de varios sectores importados.
Relación con otros tutoriales
El alcance de datos afecta directamente lo que ves en Barrios, Viviendas, Familias y la pantalla de inicio.
Pantalla Configuración: selector de Cobertura y opciones de Alcance de datos
Cobertura (Planta / Guardia) y Alcance de datos: define si los listados muestran solo el sector actual o toda la información cargada en la tablet.

7. Datos personales del agente

Pantalla Configuración: campos Apellido, Nombre y DNI del agente
Datos personales del agente: apellido, nombre, DNI y supervisor intermedio. Se usan en la cabecera y al sincronizar.
Campo Obligatorio Descripción
Apellido Sí Apellido del agente sanitario. Aparece en cabeceras y se sincroniza al servidor.
Nombre Sí Nombre del agente.
DNI Sí Documento del agente. Se usa para resolver el UUID del usuario en el servidor al sincronizar.
Supervisor intermedio No Texto libre con el nombre del supervisor de referencia.

8. Ronda actual

Selector de la ronda operativa vigente (catálogo descargado del servidor o embebido). Afecta filtros de visitas, encuestas y contadores «visitas en ronda» en otras pantallas.

Si la ronda guardada ya no existe en el catálogo, la app la limpia automáticamente al cargar Configuración.

9. Autenticación local (opcional)

Bloque para proteger el acceso a la tablet con credenciales propias de la app (no confundir con login del servidor web).

Campo Descripción
Usuario Nombre de usuario local (opcional).
Contraseña Si ya hay contraseña guardada, dejar en blanco mantiene la actual. Al escribir una nueva, aparece confirmación.
Confirmar contraseña Solo visible cuando se ingresa una contraseña nueva. Debe coincidir.
Email de recuperación Opcional; reservado para recuperación futura.
Requerir autenticación al iniciar Checkbox. Si usuario y contraseña están configurados, hay que marcarlo para que aparezca la pantalla de login al abrir la app.

10. Guardar y cancelar

  • Guardar Configuración: valida campos obligatorios y persiste en la base local (whoami). Luego redirige al inicio.
  • Cancelar: recarga los datos desde la base, descartando cambios no guardados en pantalla.

Validaciones al guardar

  • Apellido y nombre completos.
  • DNI completado.
  • Zona, área y sector seleccionados.
  • Cobertura seleccionada.
  • Si se ingresa contraseña nueva, debe coincidir con la confirmación.

Qué pasa después de guardar

  • Los datos quedan disponibles offline de inmediato.
  • La cabecera de la app se actualiza con el nuevo nombre.
  • Al sincronizar, el servidor puede vincular el DNI con el UUID del agente y reasignar responsables locales.

11. Impacto en el resto de la app

Configuración Dónde se nota
Zona / Área / Sector Filtros territoriales, altas de barrios/viviendas, sync.
Alcance de datos Cantidad de registros visibles en listados y KPIs.
Ronda Filtros de visitas, planificación, contadores por ronda.
Apellido / Nombre / DNI Cabecera, sync, identificación en servidor.
Autenticación local Pantalla de login al abrir la app.

12. Problemas frecuentes

Problema Qué revisar
No puedo elegir área Seleccioná primero la zona.
No puedo elegir sector Con centros de salud, elegí primero el centro. Si la lista está vacía, probá «Mostrar sectores inactivos».
No veo barrios de otro sector Cambiá Alcance de datos a «todos los sectores» o reconfigurá el sector en Configuración.
El login no aparece al abrir la app Usuario + contraseña configurados y checkbox Requerir autenticación marcado.
Apellido mal en el servidor Corregí en Configuración, guardá y sincronizá (los datos del agente van en headers de sync).
Carga lenta al abrir Configuración Normal en tablets con catálogo grande; la pantalla muestra el paso de carga en curso.

13. Glosario

Término Significado
whoami Registro único en la tablet con la configuración del agente y la tablet.
idUsuarioUUID Identificador del agente en el servidor; se adopta al sincronizar tras guardar DNI.
Alcance de datos Filtro global: sector actual vs. todos los sectores cargados.
Ronda Período operativo de visitas (ej. ronda anual del programa).

Tutorial RadiAPS2 · Configuración · Agosto 2026.