# Guía Rápida - Módulo HR/Payroll

## 🚀 Inicio Rápido

### Paso 1: Ejecutar SQL de Tablas
```bash
# En phpMyAdmin o línea de comandos MySQL
mysql -u usuario -p nombre_bd < crear_tablas_rrhh_nomina.sql
```

### Paso 2: Acceder al Menú
En el sidebar del ERP, busca **RECURSOS HUMANOS** con submenu:
- Empleados
- Departamentos
- Puestos/Posiciones
- Tipos de Nómina
- Registro de Faltas
- Generador de Nóminas

---

## 📋 Flujo Recomendado (Primer Uso)

### 1️⃣ Configuración Inicial (Una sola vez)

#### A) Crear Departamentos
```
Menú → RECURSOS HUMANOS → Departamentos → "Nuevo Departamento"
```
Ejemplos:
- Administración
- Ventas
- Producción
- Recursos Humanos

#### B) Crear Puestos
```
Menú → RECURSOS HUMANOS → Puestos/Posiciones → "Nuevo Puesto"
```
Asociar cada puesto a un departamento y definir salario base:
- Gerente General: $50,000
- Contador: $25,000
- Vendedor: $15,000
- Operario: $10,000

#### C) Crear Tipos de Nómina
```
Menú → RECURSOS HUMANOS → Tipos de Nómina → "Nuevo Tipo"
```
Pre-configurados:
- ✅ Nómina Mensual (30 días)
- ✅ Nómina Quincenal (15 días)
- ✅ Nómina Semanal (7 días)

### 2️⃣ Carga de Empleados (Una sola vez o cuando entra nuevo)

```
Menú → RECURSOS HUMANOS → Empleados → "Nuevo Empleado"
```

**Información a completar:**

| Sección | Campos | Obligatorio |
|---------|--------|------------|
| Personal | Código, ID, Nombre | ✅ |
| Personal | Email, Teléfono | ❌ |
| Laboral | Puesto, Departamento, F. Ingreso | ✅ |
| Laboral | Tipo de Contrato | ✅ |
| Salarial | Salario Mensual | ✅ |
| Salarial | Horas Diarias | ✅ |
| Bancaria | Banco, Cuenta (para transferencias) | ❌ |

### 3️⃣ Registrar Control de Asistencia (Diario/Semanal)

```
Menú → RECURSOS HUMANOS → Registro de Faltas → "Registrar Falta"
```

**Al final de cada mes, registrar:**
- Faltas (ausencias sin justificación)
- Retrasos (llegadas tarde)
- Permisos (autorizados)
- Incapacidades (médicas)

**Importante**: Marcar como "Justificado" si la falta es autorizada
- ✅ Justificado = No descuenta salario
- ❌ No Justificado = Descuenta días trabajados

### 4️⃣ Generar Nómina Mensual (Una vez por mes)

```
Menú → RECURSOS HUMANOS → Generador de Nóminas → "Generar Nueva Nómina"
```

**Pasos:**

1. **Ingresa datos:**
   - Número (ej: NOM-2024-01)
   - Tipo: Mensual (default)
   - Período: 01/01/2024 a 31/01/2024
   - Fecha Pago: (opcional)

2. **Sistema calcula automáticamente:**
   - Días trabajados (restando faltas no justificadas)
   - Salario proporcional
   - Descuentos (AFP 10%)
   - Salario neto

3. **Resultado:** Nómina BORRADOR

### 5️⃣ Revisar Detalles

```
Ver → Click ojo en nómina
```

Ver:
- Detalle por concepto (Sueldo, AFP, etc.)
- Resumen por empleado
- Totales generales

**Validar:**
- ✅ Montos correctos
- ✅ Empleados incluidos
- ✅ Descuentos aplicados

### 6️⃣ Procesar Nómina

```
En estado BORRADOR → Click botón "Procesar"
```
Estado: BORRADOR → **PROCESADA**

### 7️⃣ Pagar Nómina

```
En estado PROCESADA → Click botón "Pagar"
```
Estado: PROCESADA → **PAGADA**

Se registra automáticamente:
- Fecha de pago
- Empleados pagados
- Resumen de pagos

---

## 💡 Casos de Uso Típicos

### Caso 1: Empleado Llega Tarde
```
1. Ir a: Registro de Faltas
2. Crear falta:
   - Empleado: Nombre
   - Fecha: Día del retraso
   - Tipo: RETRASO
   - Horas: 1 (si llegó una hora tarde)
   - Justificado: ✅ (si es autorizado)
3. Guardar
```
→ Afecta nómina solo si NO está justificado

### Caso 2: Empleado Solicita Permiso
```
1. Ir a: Registro de Faltas
2. Crear falta:
   - Tipo: PERMISO
   - Justificado: ✅ (siempre)
3. Guardar
```
→ NO afecta salario (siempre justificado)

### Caso 3: Empleado Incapacidad Médica
```
1. Ir a: Registro de Faltas
2. Crear falta:
   - Tipo: INCAPACIDAD
   - Horas: 8 (día completo)
   - Justificado: ✅
3. Guardar
```
→ NO afecta salario (justificado por medicina)

### Caso 4: Cambio de Puesto (Ascenso)
```
1. Ir a: Empleados → Editar
2. Cambiar:
   - Puesto (nuevo)
   - Salario Mensual (nuevo)
3. Guardar
```
→ Se registra automáticamente en historial

### Caso 5: Empleado se va de la empresa
```
1. Ir a: Empleados → Editar
2. Agregar:
   - Fecha de Salida
3. Cambiar Estado a: Inactivo
4. Guardar
```
→ No aparecerá en próximas nóminas

---

## 📊 Reportes Disponibles

### Por Implementar
1. **Reporte de Nóminas por Período**
   - Totales mensuales
   - Comparativas

2. **Análisis de Costos**
   - Costo total de personal
   - Costo por departamento
   - Costo por puesto

3. **Reporte de Asistencia**
   - Faltas justificadas/no justificadas
   - Análisis de ausentismo
   - Por empleado, departamento, período

---

## 🔧 Troubleshooting

### Problema: "No hay empleados para generar nómina"
**Solución:**
1. Verificar que hay empleados activos (Estado = Activo)
2. Ir a Empleados → Verificar status
3. Si están inactivos, cambiar a Activo

### Problema: Las faltas no se restan del salario
**Solución:**
1. Verificar que la falta esté marcada como "NO Justificado"
2. Si está justificada (✅), no descuenta (comportamiento correcto)
3. En Registro de Faltas → Editar → Desmarcar "Justificado"

### Problema: Nómina dice 0 empleados
**Solución:**
1. Verificar que hay empleados con puesto asignado
2. El puesto debe tener salario_base > 0
3. Ejecutar en SQL:
```sql
SELECT COUNT(*) FROM empleados WHERE id_empresa = 1 AND activo = 1;
```

### Problema: No puedo eliminar una nómina
**Solución:**
1. Solo se pueden eliminar nóminas en estado BORRADOR
2. Si está PROCESADA o PAGADA, no se puede eliminar
3. Opción: Crear nueva nómina correcta

---

## 🎓 Términos Importantes

| Término | Significado |
|---------|------------|
| **Salario Bruto** | Sueldo sin descuentos |
| **Salario Neto** | Sueldo después de descuentos |
| **AFP** | Fondo de Pensiones (descuento típico 10%) |
| **Día Trabajado** | Día no afectado por falta no justificada |
| **Concepto** | Línea de pago/descuento en nómina |
| **Estado BORRADOR** | Nómina editable, no procesada |
| **Estado PROCESADA** | Nómina lista para pagar |
| **Estado PAGADA** | Nómina completada |

---

## 📞 Contacto y Soporte

Para dudas sobre:
- **Cálculos**: Ver MODULO_RRHH_NOMINA.md
- **Campos**: Ver MODULO_RRHH_NOMINA.md
- **Flujo**: Este documento
- **Base de datos**: Ver crear_tablas_rrhh_nomina.sql

---

**Última actualización**: 2024
**Versión**: 1.0