# Modulo: Employees (Recursos Humanos)

**Odoo Module:** hr
**Version:** 1.1
**Categoria:** Human Resources/Employees
**Es Aplicacion:** Si

---

## 1. Descripcion General

El modulo **hr** es el nucleo de gestion de recursos humanos de Odoo.
Centraliza informacion de empleados, departamentos, puestos y estructura organizacional.

### Funcionalidades Principales:
- **Empleados (hr.employee):** Gestion completa con sistema de versiones
- **Departamentos (hr.department):** Estructura jerarquica organizacional
- **Puestos de Trabajo (hr.job):** Definicion de cargos y vacantes
- **Ubicaciones (hr.work.location):** Lugares de trabajo
- **Categorias/Tags:** Clasificacion de empleados
- **Tipos de Contrato:** Configuracion de contratos
- **Planes de Actividad:** Onboarding/Offboarding

---

## 2. Dependencias

### 2.1 Dependencias Explicitas (manifest)

| Modulo | Tipo | Descripcion |
|--------|------|-------------|
| base_setup | Requerido | Configuracion base |
| digest | Requerido | Resumenes por correo |
| phone_validation | Requerido | Validacion telefonos |
| resource_mail | Requerido | Recursos y correo |
| web | Requerido | Interfaz web |

### 2.2 Dependencias Implicitas

| Modelo Externo | Campo | Modulo Origen |
|---------------|-------|---------------|
| res.users | user_id | base |
| res.company | company_id | base |
| res.partner | work_contact_id | base |
| resource.resource | resource_id | resource |

---

## 3. Modelos Principales

### 3.1 HR Core

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| hr.employee | Empleados | hr_employee.py |
| hr.employee.public | Vista publica empleados | hr_employee_public.py |
| hr.department | Departamentos | hr_department.py |
| hr.job | Puestos de trabajo | hr_job.py |
| hr.version | Versiones de empleado | hr_version.py |

### 3.2 Configuracion

| Modelo | Descripcion | Archivo |
|--------|-------------|---------|
| hr.work.location | Ubicaciones de trabajo | hr_work_location.py |
| hr.employee.category | Categorias/Tags | hr_employee_category.py |
| hr.contract.type | Tipos de contrato | hr_contract_type.py |
| hr.departure.reason | Razones de partida | hr_departure_reason.py |
| hr.payroll.structure.type | Tipos estructura salarial | hr_payroll_structure_type.py |

---

## 4. Sistema de Versiones

El modulo implementa control de versiones para auditar cambios en empleados:

| Campo | Descripcion |
|-------|-------------|
| version_ids | Historico de versiones |
| current_version_id | Version actual |
| date_version | Fecha efectiva de version |
| is_current/is_past/is_future | Estados de version |

---

## 5. Tipos de Empleado (employee_type)

| Tipo | Descripcion |
|------|-------------|
| employee | Empleado regular |
| worker | Trabajador |
| student | Estudiante |
| trainee | Aprendiz |
| contractor | Contratista |
| freelancer | Freelancer |

---

## 6. Tipos de Contrato Predeterminados

| Tipo | Descripcion |
|------|-------------|
| Permanent | Permanente |
| Temporary | Temporal |
| Interim | Interino |
| Seasonal | Estacional |
| Full-Time | Tiempo completo |
| Part-Time | Tiempo parcial |

---

## 7. Grupos de Seguridad

| Grupo | Permiso |
|-------|---------|
| group_hr_user | Officer: Gestionar empleados |
| group_hr_manager | Administrador HR |

---

## 8. Planes de Actividad

### Onboarding:
- Setup IT Materials
- Plan Training
- Training

### Offboarding:
- Organize knowledge transfer
- Take Back HR Materials

---

## 9. Estadisticas del Modulo

| Metrica | Valor |
|---------|-------|
| Lineas de codigo modelos | 4,135 |
| Modelos principales | 10+ |
| Campos en hr.employee | 100+ |
| Complejidad | MEDIA-ALTA |

---

**Referencias:**
- Fuente: `addons/hr/`
- Manifest: `addons/hr/__manifest__.py`