# elego/oca-hr architecture

> Architecture diagram of the GitHub repository elego/oca-hr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/elego/oca-hr
- Repository: https://github.com/elego/oca-hr

## Overview

This repository is a suite of Odoo HR addons, not one application with a single end-to-end workflow. Users configure and operate separate attendance, employee, leave, payroll, and related HR capabilities; results include reports, records, and generated periods. The graph emphasizes documented addon capabilities and sampled internal behavior. Some listed addons are unported, and most source files were not sampled, so their internal call relationships are intentionally not inferred.

Main entry points: [`hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py`](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py) (Time Analysis), [`hr_holidays_imposed_days/models/hr_imposed_holidays.py`](https://github.com/elego/oca-hr/blob/10.0/hr_holidays_imposed_days/models/hr_imposed_holidays.py) (Imposed Holidays), [`hr_public_holidays/wizards/public_holidays_next_year_wizard.py`](https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/wizards/public_holidays_next_year_wizard.py) (Next-Year Wizard), [`hr_period/models/hr_fiscal_year.py`](https://github.com/elego/oca-hr/blob/10.0/hr_period/models/hr_fiscal_year.py) (Fiscal Periods)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance"]
  node_autoclose["Close Attendance<br/>[hr_attendance.py]"]
  node_attendance_reason["Attendance Reasons"]
  node_rfid["RFID Attendance<br/>[hr_employee.py]"]
  node_time_report[("Time Analysis")]
  node_hr_attendance[("Attendance Records<br/>Odoo model")]
end

subgraph group_people["Employee Records"]
  node_employee_fields["Employee Details<br/>[hr_employee.py]"]
  node_employee_id["Employee ID<br/>[hr_employee.py]"]
  node_employee_calendar["Calendar Planning<br/>[hr_employee.py]"]
  node_employee_experience["Experience Records<br/>[hr_experience.py]"]
  node_hr_employee[("Employee Records<br/>Odoo model")]
end

subgraph group_leave["Leave Management"]
  node_leave_hours["Hourly Leave<br/>[hr_holidays.py]"]
  node_leave_days["Leave Day Calculation<br/>[hr_holidays.py]"]
  node_imposed_leave["Imposed Holidays"]
  node_public_holidays["Public Holidays"]
  node_holiday_wizard["Next-Year Wizard"]
  node_hr_holidays[("Leave Records<br/>Odoo model")]
  node_hr_holidays_public[("Public Holiday Records<br/>Odoo model")]
end

subgraph group_payroll["Payroll"]
  node_fiscal_year["Fiscal Periods<br/>[hr_fiscal_year.py]"]
  node_payroll_register["Payroll Register"]
  node_worked_days["Timesheet Import<br/>[hr_payslip.py]"]
  node_payslip_state["Payslip State"]
  node_hr_period[("HR Period<br/>Odoo model")]
end

subgraph group_other["Other HR"]
  node_recruitment["Candidate Applications<br/>[hr_applicant.py]"]
  node_expenses["Expense Invoices<br/>[hr_expense.py]"]
  node_skills["Employee Skills<br/>[hr_skill.py]"]
  node_resume["Resume Reports<br/>[report_resume.py]"]
end

node_hr_user(("HR User"))
node_resource_calendar_attendance[("Calendar Attendance<br/>Odoo model")]

node_hr_user -->|"closes stale"| node_autoclose
node_hr_user -->|"records reasons"| node_attendance_reason
node_hr_user -->|"uses RFID"| node_rfid
node_hr_user -->|"compares time"| node_time_report
node_hr_user -->|"maintains records"| node_employee_fields
node_hr_user -->|"identifies employees"| node_employee_id
node_hr_user -->|"plans calendars"| node_employee_calendar
node_hr_user -->|"records experience"| node_employee_experience
node_hr_user -->|"requests hours"| node_leave_hours
node_hr_user -->|"calculates leave"| node_leave_days
node_hr_user -->|"imposes days"| node_imposed_leave
node_hr_user -->|"manages holidays"| node_public_holidays
node_hr_user -->|"generates holidays"| node_holiday_wizard
node_hr_user -->|"sets periods"| node_fiscal_year
node_hr_user -->|"reviews payroll"| node_payroll_register
node_hr_user -->|"imports worked days"| node_worked_days
node_hr_user -->|"changes payslip state"| node_payslip_state
node_hr_user -->|"manages applications"| node_recruitment
node_hr_user -->|"processes expenses"| node_expenses
node_hr_user -->|"manages skills"| node_skills
node_hr_user -->|"runs resume reports"| node_resume
node_time_report -->|"reads attendance"| node_hr_attendance
node_time_report -->|"reads employees"| node_hr_employee
node_time_report -->|"reads schedules"| node_resource_calendar_attendance
node_fiscal_year -->|"creates periods"| node_hr_period
node_imposed_leave -->|"creates leave"| node_hr_holidays
node_holiday_wizard -->|"creates holidays"| node_hr_holidays_public

click node_autoclose "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_autoclose/models/hr_attendance.py"
click node_attendance_reason "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_reason/models/hr_attendance_reason.py"
click node_rfid "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_rfid/models/hr_employee.py"
click node_time_report "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py"
click node_employee_fields "https://github.com/elego/oca-hr/blob/10.0/hr_employee_firstname/models/hr_employee.py"
click node_employee_id "https://github.com/elego/oca-hr/blob/10.0/hr_employee_id/models/hr_employee.py"
click node_employee_calendar "https://github.com/elego/oca-hr/blob/10.0/hr_employee_calendar_planning/models/hr_employee.py"
click node_employee_experience "https://github.com/elego/oca-hr/blob/10.0/hr_experience/models/hr_experience.py"
click node_leave_hours "https://github.com/elego/oca-hr/blob/10.0/hr_holidays_hour/models/hr_holidays.py"
click node_leave_days "https://github.com/elego/oca-hr/blob/10.0/hr_holidays_compute_days/models/hr_holidays.py"
click node_imposed_leave "https://github.com/elego/oca-hr/blob/10.0/hr_holidays_imposed_days/models/hr_imposed_holidays.py"
click node_public_holidays "https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/models/hr_public_holidays.py"
click node_holiday_wizard "https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/wizards/public_holidays_next_year_wizard.py"
click node_fiscal_year "https://github.com/elego/oca-hr/blob/10.0/hr_period/models/hr_fiscal_year.py"
click node_payroll_register "https://github.com/elego/oca-hr/blob/10.0/hr_payroll_register/report/report_payroll_register.py"
click node_worked_days "https://github.com/elego/oca-hr/blob/10.0/hr_worked_days_from_timesheet/models/hr_payslip.py"
click node_payslip_state "https://github.com/elego/oca-hr/blob/10.0/hr_payslip_change_state/wizard/hr_payslip_change_state.py"
click node_recruitment "https://github.com/elego/oca-hr/blob/10.0/hr_recruitment_candidate_multi_applicant/models/hr_applicant.py"
click node_expenses "https://github.com/elego/oca-hr/blob/10.0/hr_expense_invoice/models/hr_expense.py"
click node_skills "https://github.com/elego/oca-hr/blob/10.0/hr_skill/models/hr_skill.py"
click node_resume "https://github.com/elego/oca-hr/blob/10.0/hr_resume/report/report_resume.py"
click node_hr_attendance "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/models/hr_attendance.py"
click node_hr_employee "https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/models/hr_employee.py"
click node_hr_period "https://github.com/elego/oca-hr/blob/10.0/hr_period/models/hr_period.py"
click node_hr_holidays "https://github.com/elego/oca-hr/blob/10.0/hr_holidays_compute_days/models/hr_holidays.py"
click node_hr_holidays_public "https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/models/hr_public_holidays.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_autoclose,node_attendance_reason,node_rfid,node_time_report,node_hr_attendance,node_hr_user toneBlue
class node_employee_fields,node_employee_id,node_employee_calendar,node_employee_experience,node_hr_employee,node_resource_calendar_attendance toneAmber
class node_leave_hours,node_leave_days,node_imposed_leave,node_public_holidays,node_holiday_wizard,node_hr_holidays,node_hr_holidays_public toneMint
class node_fiscal_year,node_payroll_register,node_worked_days,node_payslip_state,node_hr_period toneRose
class node_recruitment,node_expenses,node_skills,node_resume toneIndigo
```

## Components

### Attendance

- [Close Attendance](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_autoclose/models/hr_attendance.py): `hr_attendance_autoclose/models/hr_attendance.py`
- [Attendance Reasons](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_reason/models/hr_attendance_reason.py): `hr_attendance_reason/models/hr_attendance_reason.py`
- [RFID Attendance](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_rfid/models/hr_employee.py): `hr_attendance_rfid/models/hr_employee.py`
- [Time Analysis](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py): `hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py`
- [Attendance Records](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/models/hr_attendance.py): Odoo model · `hr_attendance_report_theoretical_time/models/hr_attendance.py`

### Employee Records

- [Employee Details](https://github.com/elego/oca-hr/blob/10.0/hr_employee_firstname/models/hr_employee.py): `hr_employee_firstname/models/hr_employee.py`
- [Employee ID](https://github.com/elego/oca-hr/blob/10.0/hr_employee_id/models/hr_employee.py): `hr_employee_id/models/hr_employee.py`
- [Calendar Planning](https://github.com/elego/oca-hr/blob/10.0/hr_employee_calendar_planning/models/hr_employee.py): `hr_employee_calendar_planning/models/hr_employee.py`
- [Experience Records](https://github.com/elego/oca-hr/blob/10.0/hr_experience/models/hr_experience.py): `hr_experience/models/hr_experience.py`
- [Employee Records](https://github.com/elego/oca-hr/blob/10.0/hr_attendance_report_theoretical_time/models/hr_employee.py): Odoo model · `hr_attendance_report_theoretical_time/models/hr_employee.py`

### Leave Management

- [Hourly Leave](https://github.com/elego/oca-hr/blob/10.0/hr_holidays_hour/models/hr_holidays.py): `hr_holidays_hour/models/hr_holidays.py`
- [Leave Day Calculation](https://github.com/elego/oca-hr/blob/10.0/hr_holidays_compute_days/models/hr_holidays.py): `hr_holidays_compute_days/models/hr_holidays.py`
- [Imposed Holidays](https://github.com/elego/oca-hr/blob/10.0/hr_holidays_imposed_days/models/hr_imposed_holidays.py): `hr_holidays_imposed_days/models/hr_imposed_holidays.py`
- [Public Holidays](https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/models/hr_public_holidays.py): `hr_public_holidays/models/hr_public_holidays.py`
- [Next-Year Wizard](https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/wizards/public_holidays_next_year_wizard.py): `hr_public_holidays/wizards/public_holidays_next_year_wizard.py`
- [Leave Records](https://github.com/elego/oca-hr/blob/10.0/hr_holidays_compute_days/models/hr_holidays.py): Odoo model · `hr_holidays_compute_days/models/hr_holidays.py`
- [Public Holiday Records](https://github.com/elego/oca-hr/blob/10.0/hr_public_holidays/models/hr_public_holidays.py): Odoo model · `hr_public_holidays/models/hr_public_holidays.py`

### Payroll

- [Fiscal Periods](https://github.com/elego/oca-hr/blob/10.0/hr_period/models/hr_fiscal_year.py): `hr_period/models/hr_fiscal_year.py`
- [Payroll Register](https://github.com/elego/oca-hr/blob/10.0/hr_payroll_register/report/report_payroll_register.py): `hr_payroll_register/report/report_payroll_register.py`
- [Timesheet Import](https://github.com/elego/oca-hr/blob/10.0/hr_worked_days_from_timesheet/models/hr_payslip.py): `hr_worked_days_from_timesheet/models/hr_payslip.py`
- [Payslip State](https://github.com/elego/oca-hr/blob/10.0/hr_payslip_change_state/wizard/hr_payslip_change_state.py): `hr_payslip_change_state/wizard/hr_payslip_change_state.py`
- [HR Period](https://github.com/elego/oca-hr/blob/10.0/hr_period/models/hr_period.py): Odoo model · `hr_period/models/hr_period.py`

### Other HR

- [Candidate Applications](https://github.com/elego/oca-hr/blob/10.0/hr_recruitment_candidate_multi_applicant/models/hr_applicant.py): `hr_recruitment_candidate_multi_applicant/models/hr_applicant.py`
- [Expense Invoices](https://github.com/elego/oca-hr/blob/10.0/hr_expense_invoice/models/hr_expense.py): `hr_expense_invoice/models/hr_expense.py`
- [Employee Skills](https://github.com/elego/oca-hr/blob/10.0/hr_skill/models/hr_skill.py): `hr_skill/models/hr_skill.py`
- [Resume Reports](https://github.com/elego/oca-hr/blob/10.0/hr_resume/report/report_resume.py): `hr_resume/report/report_resume.py`

### Other components

- **HR User**
- **Calendar Attendance**: Odoo model

## Connections

- HR User → Close Attendance: closes stale (evidence: `README.md`)
- HR User → Attendance Reasons: records reasons (evidence: `README.md`)
- HR User → RFID Attendance: uses RFID (evidence: `README.md`)
- HR User → Time Analysis: compares time (evidence: `README.md`)
- HR User → Employee Details: maintains records (evidence: `README.md`)
- HR User → Employee ID: identifies employees (evidence: `README.md`)
- HR User → Calendar Planning: plans calendars (evidence: `README.md`)
- HR User → Experience Records: records experience (evidence: `README.md`)
- HR User → Hourly Leave: requests hours (evidence: `README.md`)
- HR User → Leave Day Calculation: calculates leave (evidence: `README.md`)
- HR User → Imposed Holidays: imposes days (evidence: `README.md`)
- HR User → Public Holidays: manages holidays (evidence: `README.md`)
- HR User → Next-Year Wizard: generates holidays (evidence: `README.md`)
- HR User → Fiscal Periods: sets periods (evidence: `README.md`)
- HR User → Payroll Register: reviews payroll (evidence: `README.md`)
- HR User → Timesheet Import: imports worked days (evidence: `README.md`)
- HR User → Payslip State: changes payslip state (evidence: `README.md`)
- HR User → Candidate Applications: manages applications (evidence: `README.md`)
- HR User → Expense Invoices: processes expenses (evidence: `README.md`)
- HR User → Employee Skills: manages skills (evidence: `README.md`)
- HR User → Resume Reports: runs resume reports (evidence: `README.md`)
- Time Analysis → Attendance Records: reads attendance (evidence: `hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py`)
- Time Analysis → Employee Records: reads employees (evidence: `hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py`)
- Time Analysis → Calendar Attendance: reads schedules (evidence: `hr_attendance_report_theoretical_time/reports/hr_attendance_theoretical_time_report.py`)
- Fiscal Periods → HR Period: creates periods (evidence: `hr_period/models/hr_fiscal_year.py`)
- Imposed Holidays → Leave Records: creates leave (evidence: `hr_holidays_imposed_days/models/hr_imposed_holidays.py`)
- Next-Year Wizard → Public Holiday Records: creates holidays (evidence: `hr_public_holidays/wizards/public_holidays_next_year_wizard.py`)
