Employee Image Attendance Module

Overview

This Odoo module enhances the standard attendance system by capturing and storing employee images during check-in. It provides a user-friendly interface for viewing attendance records along with the captured images.

Screenshots

Main Attendance Form

Check-In Confirmation

Manual Date Selection

Features

• Quick Attendance Mode: Fast check-in/out using employee search and camera capture.
• Auto-Pairing: Smart logic automatically pairs check-ins with check-outs (even if done out of order).
• Missed Attendance Support: dedicated buttons for "Missed Check In" and "Missed Check Out".
• Manual Backdating: Custom date/time selector for correcting missed attendance records options.
• Photo Evidence: Securely stores a photo validation for every single action.
• Creator Tracking: Tracks exactly who (Super/Admin) performed the scan for the employee.

Technical Details

Models

- New model `hr.attendance.photo`: Staging area for raw photo scans before pairing.

- Extended `hr.attendance` with `check_in_image` and `check_out_image` fields.

Views

1. List View (`list`)

   - Shows simple list of all photo records.

   - Color-coded status (Draft vs Paired).

2. Form View (`form`)

   - Detailed view of the specific scan event.

   - "Pair" button to manually resolve issues.

JavaScript Implementation

The module uses a modern OWL Component (`AttendanceForm`):

• Real-time camera feed access.
• Smart search combo-box for Employees and Creators.
• Client-side validation preventing double-submission.

Installation

1. Install the module.
2. Go to **Attendance > Quick Attendance**.
3. Grant browser camera permissions when prompted.

Menu Structure

- Main Menu: Attendance

  - Sub-menu: **Quick Attendance** (The main scanning interface)

  - Sub-menu: **Attendance Photos** (The raw logs inspection view)

Dependencies

• hr_attendance
• web

Security

- Basic access rights for attendance records

- Camera access managed through browser permissions

Contributing

Contributions are welcome! Please follow these steps:

1. Fork the repository
2. Create a new branch for your feature
3. Submit a pull request

Support

For support and questions, please contact the module maintainer or raise an issue in the repository.

License

This module is licensed under the MIT License.