# 📖 Módulos Funcionales y Flujos

## 5.1 Módulos Principales

### 🔹 Módulo de Inventario (Bienes)

Gestión completa de items del almacén con:
- CRUD de bienes
- Código SAP único
- Código de barras generado automáticamente
- Niveles de stock mínimo/máximo
- Categorización (EPP y general)
- Ubicaciones jerárquicas
- Imágenes de productos

### 🔹 Módulo de Préstamos

Flujo completo de préstamos de equipos:

```
Solicitud → Pendiente → Aprobado → Despachado → Devuelto
                    ↘ Rechazado
                    ↘ Cancelado
```

- Registro de solicitante
- Autorización por supervisor
- Despacho por administrador
- Devolución con observaciones

### 🔹 Módulo de Dotaciones (EPP)

Provisión de equipos de protección personal:

```
Solicitud → Pendiente → Aprobado → Despachado → Entregado
                    ↘ Rechazado
                    ↘ Cancelado
```

- Registro de tallas de uniformes por trabajador
- Tracking de dotaciones entregadas
- Historial por usuario

### 🔹 Módulo de Transferencias

Movimiento de items entre ubicaciones:

```
Solicitud → Pendiente → Aprobado → Completado
                    ↘ Cancelado
```

- Ubicación origen y destino
- Embarcaciones para transporte
- Devolución opcional

### 🔹 Módulo de Alimentos

Gestión de alimentación para operaciones:
- Registro de insumos alimentarios
- Asignación a trabajadores
- Control de inventario

### 🔹 Módulo de Reportes

Múltiples reportes con exportación CSV:

| Reporte | Descripción |
|---------|-------------|
| Inventario | Lista completa de bienes con stock |
| Inventario Mensual | Resumen mensual de movimientos |
| Stock | Estado actual de inventarios |
| Operaciones | Resumen de todas las operaciones |
| Transferencias | Detalle de transferencias |
| Préstamos | Estado de préstamos activos |
| Dotaciones | Historial de dotaciones |
| Seguimiento | Tracking de items |

---

## 5.3 Flujos de Usuario Principales

### Flujo de Préstamo

```
1. Supervisor inicia operación (/asignacion/iniciar)
2. Busca trabajador por cédula (/asignacion/solicitante)
3. Selecciona tipo "Préstamo"
4. Agrega items al carrito
5. Confirma operación
6. Admin revisa en /administracion
7. Admin despacha -> stock se reduce
8. Trabajador devuelve -> stock se incrementa
```

### Flujo de Dotación

```
1. Supervisor inicia operación
2. Busca trabajador (debe tener tallas registradas)
3. Selecciona tipo "Dotación"
4. Sistema sugiere items según perfil EPP
5. Confirma operación
6. Admin despacha
7. Stock se ajusta automáticamente
```

### Flujo de Transferencia

```
1. Supervisor inicia operación
2. Selecciona tipo "Transferencia"
3. Define ubicación origen y destino
4. Asocia embarcación si es necesario
5. Confirma operación
6. Admin aprueba
7. Items transferidos
```

---

*Última actualización: Marzo 2026*
