Skip to Content
Catalog / HR · Human Resources / AlShayebCo HR Mobile API
AlShayebCo HR Mobile API
alshayeb_hr_mobile

AlShayebCo HR Mobile API

Turn Odoo HR into a mobile app: attendance, time off, tasks, payslips, approvals

v19.0.1.0.0 AlShayebco Human Resources

Odoo 19 controller-only module exposing ~28 type='jsonrpc' routes under /hr_attendance/mobile/* across five controllers (mobile, leave, manager, tasks, payslips) plus a shared _common.py providing a safe_endpoint error-handling decorator, manager_scope_for() role resolution and employee_filter_for() domain helper. Models extend company (attendance_live_tracking_mode selection) and settings (module_* feature toggles for fleet, expenses, tracking and Enterprise payroll). Depends on hr_attendance, hr_attendance_gps_geofence, project, hr_holidays, auth_totp and hr_payroll. Pairs with the hr_attendance_gps_geofence core (which keeps the geofence write paths) and sibling modules for expenses, fleet and live GPS tracking.

Overview

Field and office staff rarely sit at a desk, yet they still need to clock in, request time off, track tasks and check payslips. This module is the secure JSON-RPC backend that powers the AlShayebCo HR Flutter mobile app, exposing a complete set of /hr_attendance/mobile/* endpoints over Odoo's standard HR, attendance, time-off, project and payroll data. Employees self-serve from their phone while managers approve attendance and leave on the go, and every request is gated by the employee's existing Odoo HR roles so access matches the back office exactly.

Workflow

Hr Leave

To Approve
Second Approval
Approved
Refused
Cancelled

Key Features

  • Mobile check-in status feed with company geofence config, live-tracking mode and last-attendance summary.
  • Paginated attendance history including justification and approval details for the logged-in employee.
  • Self-service time off: browse leave types, see allocated/used/remaining balances, file requests and cancel them.
  • Multi-company and multi-employee context so one login can switch between linked companies and employee records.
  • Manager approvals on the phone: batch-approve or reject outside-company attendances and confirm or refuse pending leaves.
  • Role-scoped manager views (HR manager sees all, attendance officer sees their company, team lead sees their team).
  • My-tasks workspace: list assigned project tasks, view details, move kanban stage, log progress notes and attach files.
  • Payslip self-service: list payslip history and download the rendered payslip PDF (when Enterprise payroll is installed).
  • Public 2FA finalisation endpoint that completes login for TOTP-protected accounts after the standard authenticate step.
  • Configurable mobile live-tracking policy per company (off, foreground, while checked in, or background opt-in).

Technical Details

Technical Name alshayeb_hr_mobile
Version 19.0.1.0.0
License LGPL-3
Domain HR · Human Resources

Security

The module adds no records or menus of its own, so it ships no access-control CSV. Every endpoint is a JSON-RPC route requiring an authenticated Odoo user (auth='user'); the only public route is the 2FA finalisation step used during login. Authorisation reuses the employee's existing Odoo HR roles: data is always read and written as the calling user, and manager actions are scope-checked per record (HR Manager sees all employees, Attendance Officer sees their company, a team lead sees only direct reports) before any privileged operation runs.

Dependencies

hr_attendance hr_attendance_gps_geofence project hr_holidays auth_totp hr_payroll