⚙️ Guía para Administradores - Configuración

Configuración Inicial del Sistema

1. Instalación del Módulo

Ruta: Apps → Buscar "HR Hub Attendance" → Instalar

Dependencias requeridas:

• hr (RRHH)
• hr_attendance (Asistencias)
• hr_holidays (Ausencias)
• mail (Mensajería)

2. Configurar Ubicaciones de Trabajo

Ruta: Asistencias → Configuración → Ubicaciones de Trabajo

Crear nueva ubicación:

Nombre: Oficina Central
Latitud: 12.1234567
Longitud: -86.2345678
Radio de tolerancia: 100 metros
Activo: ✅

Visualización en mapa:

┌─────────────────────────────────────┐
│  🗺️ Mapa de Ubicación               │
│                                     │
│      🏢 Oficina Central             │
│         ⭕ (100m)                   │
│                                     │
│  Coordenadas:                       │
│  Lat: 12.1234567                    │
│  Lng: -86.2345678                   │
│                                     │
│  Empleados asignados: 25            │
└─────────────────────────────────────┘

3. Configurar Empleados

Ruta: Empleados → [Empleado] → Pestaña Asistencia

Activar:

• ✅ Control de asistencia
• ✅ Validación de ubicación
• Ubicaciones permitidas: [Seleccionar ubicaciones]
• Modo de asistencia: Fijo / Flexible / Remoto
• Tolerancia de distancia: 100 metros

4. Configuración Global

Ruta: Asistencias → Configuración → Ajustes

Geolocalización:

Tolerancia de distancia: 100 metros
Precisión GPS mínima: 20 metros
Validar ubicación en check-in: ✅
Validar ubicación en check-out: ❌ (opcional)

Seguridad:

Límite de dispositivos por empleado: 1
Hash de integridad: ✅ Activo
Registro de auditoría: ✅ Completo
Retención de logs: 365 días

Notificaciones:

Enviar email al activar licencia: ✅
Enviar email al suspender licencia: ✅
Enviar email al revocar licencia: ✅
Notificar a RRHH en auto-activación: ✅

5. Configurar Webhooks (Opcional)

Ruta: Asistencias → Configuración → Webhooks

Para integrar con sistemas externos:

Nombre: Sistema Nómina
URL: https://nomina.tuempresa.com/webhook/attendance
Método: POST
Autenticación: Bearer Token
Token: eyJ0eXAiOiJKV1QiLCJhbGc...

Eventos:
✅ Check-in
✅ Check-out
❌ Break start
❌ Break end

Auditoría y Trazabilidad

Consultar Audit Logs

Ruta: Asistencias → Auditoría → Logs de Auditoría

Filtros útiles:

• Por empleado: employee_id = "Juan Pérez"
• Por acción: action_type = "device_registered"
• Por fecha: create_date >= "2025-11-01"

Tipos de acciones registradas:

• device_registered → Dispositivo registrado
• device_activated → Dispositivo activado
• device_suspended → Dispositivo suspendido
• device_revoked → Dispositivo revocado
• license_activated → Licencia activada
• license_suspended → Licencia suspendida
• license_revoked → Licencia revocada
• access_granted → Acceso otorgado
• access_denied → Acceso denegado

Consultar Chatter de un Registro

1. Abrir licencia o dispositivo
2. Scroll hacia abajo → Pestaña Chatter
3. Ver historial completo:
   • Mensajes
   • Actividades
   • Cambios de estado
   • Notificaciones enviadas

Mantenimiento y Tareas Programadas

Cron Jobs Configurados

Ruta: Configuración → Técnico → Cron Jobs

Reportes e Informes

Generar Informes

Ruta: Asistencias → Informes

Tipos disponibles:

1. Resumen mensual - Horas trabajadas por empleado
2. Detalle diario - Registros diarios de asistencia
3. Horas extra - Horas extra por empleado
4. Informe legal - Cumplimiento normativo español
5. Análisis de ubicaciones - Registros por ubicación
6. Dispositivos activos - Estado de dispositivos