RPX ClockIn
Sistema de fichaje de asistencia para trabajadores. Registra entradas y salidas, calcula horas trabajadas y genera la base del cómputo salarial por turnos.
Introducción
RPX ClockIn añade un sistema de fichaje de asistencia para funcionarios y empleados de empresas privadas. Los trabajadores fichan entrada y salida mediante GUI, y el sistema registra los tiempos para calcular las horas trabajadas.
Atención
RPX ClockIn requiere RPX Core. El ID de empleo usado en /clockin debe existir en el JobManager de RPX Core.
- Fichaje de entrada y salida por empleo mediante GUI
- Registro de timestamps de entrada/salida en base de datos
- Cálculo automático de horas trabajadas por turno
- Panel administrativo con logs por empleado y por empleo
- Compatible con el sistema salarial de RPX Economy
Flujo de Fichaje
- 1. El trabajador ejecuta /clockin <jobId> → se abre ClockInMainMenu.
- 2. Pulsa 'Iniciar Turno' → se registra el timestamp de entrada en la BD.
- 3. Durante el turno puede consultar el tiempo transcurrido desde el menú.
- 4. Pulsa 'Terminar Turno' → se registra la salida y se calcula la duración.
- 5. Las horas se acumulan en el registro del ciudadano para el período de pago.
Consejo
Si el jugador se desconecta sin fichar la salida, el sistema puede configurarse para cerrar el turno automáticamente al tiempo de desconexión.
Información
El ID de empleo debe coincidir con el jobId en jobs.yml de RPX Core. Ejemplo: /clockin policia, /clockin medico.
Cómputo Salarial
Las horas fichadas se acumulan en la BD. Al final del período de pago, el sistema calcula el salario multiplicando las horas trabajadas por la tarifa del empleo.
# clockin.yml
pay-period-days: 7
pay-day: SATURDAY
pay-time: "20:00"
auto-close-shift-on-logout: true
max-shift-hours: 8 # Máximo de horas que cuenta un turno (anti-AFK)Atención
El campo salary-base en jobs.yml se interpreta como referencia mensual. RPX ClockIn lo convierte a tarifa por hora para el cómputo real.
Comandos
| Comando | Permiso | Descripción |
|---|---|---|
| /clockin <jobId> | rpx.clockin.use | Abre el menú de fichaje para el empleo indicado. |
| /clockin admin logs <jobId> | rpx.clockin.admin | Registros de fichaje del período actual para un empleo. |
| /clockin admin logs <jobId> <ciudadanoId> | rpx.clockin.admin | Historial de turnos de un ciudadano específico. |
| /clockin admin close <jugador> | rpx.clockin.admin | Fuerza el cierre del turno activo del jugador. |
| /clockin admin delete <turnoId> | rpx.clockin.admin | Elimina un registro de turno incorrecto de la BD. |