Reglas del sistema: condiciones para registrar asistencia

Categoría sugerida: Referencia técnica / Reglas del sistema

Para que el sistema permita registrar la asistencia de un empleado, deben cumplirse todas las siguientes condiciones simultáneamente:

Condición	Detalle	Error si no se cumple
Estado activo	La persona debe tener el campo Activo habilitado en el sistema.	"La asignación de Persona-Cuadrilla no existe 0" / "No se encontró registro de ese empleado."
Contrato vigente	Debe existir una relación persona-contratista activa, dentro del rango de fechas (desde/hasta) configurado.	"La asignación de Persona-Cuadrilla no existe 0"
Atributos obligatorios completos	Si la finca tiene atributos marcados como obligatorios, deben completarse antes de llegar a la foto. Si falta alguno, el flujo de fichada se detiene antes de la cámara.	El botón TOMAR FOTO permanece inactivo.
Biometría registrada	El empleado debe tener su rostro registrado en el sistema previamente (desde Registros Biométricos).	Fallo en el reconocimiento facial.

Condición	Detalle	Error si no se cumple
Finca activa	La finca debe estar en estado activo en el portal.	No aparece en la app.
Acciones configuradas	Debe tener al menos una acción (Entrada o Salida) definida.	"No puede utilizar esa Finca/Puerta pues no tiene Acciones configuradas."
Radio GPS suficiente	El radio recomendado es de 50 a 100 metros o más. Un radio muy pequeño puede impedir que el usuario vea la finca desde la app.	La finca no aparece aunque el usuario esté en el lugar.
Dirección / coordenadas válidas	La dirección debe ser precisa para que el sistema calcule correctamente las coordenadas.	El usuario aparece "fuera de rango" aunque esté físicamente en el lugar.
Usuario asignado (si aplica)	Si el filtro por usuario está activo, el usuario solo verá las fincas que tenga explícitamente asignadas.	La finca no aparece en la app del usuario.

Acción	¿Requiere internet?
Activar modo OFFLINE	Sí — descarga datos a la memoria local.
Registrar fichadas en modo OFFLINE	No — se guardan localmente en el dispositivo.
Salir del modo OFFLINE y sincronizar	Sí — envía los datos locales a la base de datos central.

Regla crítica: Si no hay sincronización exitosa, los datos registrados en modo OFFLINE no aparecerán en los reportes de la consola web.

Perfil	Acceso principal
Administrador / RRHH	Acceso al portal web, reportes y configuración completa.
Supervisor	Opera principalmente la app móvil para registrar asistencia.

Nota: Si un usuario puede fichar pero no ve datos en la web, generalmente es un problema de permisos de su perfil, no un fallo del sistema.

El sistema no es compatible con dispositivos que utilicen el sistema operativo Android GO.
Si se detecta que el dispositivo usa Android GO, no continuar el diagnóstico y escalar directamente.