How lethimytram/erp-project-human-resources works
Project Type and Purpose
• This is a full-stack, enterprise HRM (Human Resource Management) application built as a set of custom Odoo addons (modules) on top of the Odoo 18.3 Python framework, backed by PostgreSQL 13+.
• It automates end-to-end HR processes: recruitment, employee profile management, contracts, attendance, leave management and payroll (including tax/insurance calculations and external API integration).
File‐Structure Insights
• Top‐level artifacts
• “Business Process (BPMN)” folder – detailed process flows for core workflows (e.g., recruitment, payroll calculation).
• “Report and Demo Odoo” folder – Excel templates used to import or demo sample data for each HR sub-domain.
• README emphasizes Odoo modules, PostgreSQL schema (hr_employee, hr_contract, hr_recruitment, hr_attendance, hr_leave, hr_payslip) and the Python-based payroll rules engine.
Main Components
a. Presentation Layer
– Web Browser (HR staff, managers, employees)
– Odoo Web Client (QWeb + JavaScript)
b. Application / Business Logic Layer (Odoo Server)
– Core Odoo framework (ORM, Controllers, Views)
– Custom HRM addons:
• hr_recruitment
• hr_employee (profiles, departments)
• hr_contract
• hr_attendance
• hr_leave
• hr_payslip + Payroll Rule Engine
– API Modules (external system connectors: tax, insurance, SSO)
c. Data Layer
– PostgreSQL database (tables as above, linked via FKs)
d. Modeling & Demo Data Artifacts
– Excel import templates for demo/reporting
Relationships & Data Flows
• User → Web Client: HTTP/HTTPS requests to Odoo controllers
• Web Client → Business Logic: RPC calls (JSON) to Odoo server
• Business Logic → Database: ORM CRUD operations on core/hr tables
• Business Logic → External API: REST/SOAP calls for payroll integrations
• Data Import: Excel → Odoo import wizards → ORM
• Reporting: ORM queries → QWeb reports/PDF/dashboards
Architectural Patterns & Principles
• Layered Architecture (Presentation / Application / Data)
• Modular Addon Design (each HR domain in its own module)
• BPMN for process orchestration; UML for requirements traceability
• Single Source of Truth (PostgreSQL with referential integrity)
• Extensibility via Odoo’s plugin mechanism