# Manual de Usuario
## Sistema de Gestión de Armamento y Elementos

## 1. Introducción
El sistema centraliza la administración de inventario, personal, documentos legales, asignaciones, reportes y procesos de trazabilidad dentro de empresas de seguridad.

La versión actual permite:
- Gestionar sedes, ubicaciones (armerillos/almacenes), armas y empleados.
- Controlar la **Cadena de Custodia** y trazabilidad detallada de armamento.
- Realizar **Inventarios periódicos** con evidencia fotográfica.
- Administrar documentos legales: portes de armas.
- Visualizar alertas de vencimiento y lista negra documental.
- Generar actas PDF de asignación, devolución, inventarios y trazabilidad.
- Gestionar paz y salvo con aprobación automática o manual.
- Consultar auditoría de acciones críticas.
- Almacenar imágenes y documentos en Cloudflare R2.

## 2. Tipos de usuario
- **Superadmin**: acceso global a todas las empresas, sedes, auditoría y administración completa.
- **Admin**: administra la operación de su empresa o de la sede autorizada.
- **Usuario**: consulta o ejecuta flujos operativos permitidos (armereros, custodios, etc.).

Las pantallas, botones y datos visibles cambian según el rol, la empresa y la sede asociada.

## 3. Requisitos
- Navegador actualizado: Chrome, Edge o Firefox.
- Conexión estable a internet.
- Credenciales activas.
- Permiso de cookies en el navegador.

## 4. Acceso al sistema

### 4.1 Iniciar sesión
1. Abra la URL del sistema.
2. Ingrese correo electrónico y contraseña.
3. Haga clic en **Iniciar sesión**.
4. Si el usuario está activo, se abrirá el panel principal.

### 4.2 Recuperar contraseña
1. En el login haga clic en **Olvidé mi contraseña**.
2. Escriba su correo.
3. Abra el enlace recibido por email.
4. Defina la nueva contraseña.

### 4.3 Cierre por inactividad
- La sesión se cierra automáticamente tras **10 minutos** sin actividad por seguridad.

## 5. Estructura de la interfaz

### 5.1 Barra superior
- Notificaciones documentales (campana).
- Menú de perfil y cierre de sesión.

### 5.2 Menú lateral
Módulos principales:
- **Inicio**: Resumen operativo.
- **Empleados**: Maestro de personal.
- **Armas**: Gestión de armamento.
- **Documentos**: Portes de armas.
- **Asignaciones**: Control de entrega y devolución de elementos.
- **Custodia**: Trazabilidad y movimientos de armas.
- **Inventarios**: Verificación física de stock.
- **Paz y Salvo**: Proceso de retiro de empleados.
- **Reportes**: Consultas y exportación de datos.
- **Panel Admin**: Sedes, Empresas, Usuarios, Códigos (Admin/Superadmin).

## 6. Uso del sistema

### 6.1 Sedes y Ubicaciones
El sistema permite organizar los elementos por su ubicación física:
- **Sedes**: Sucursales o bases principales de la empresa.
- **Ubicaciones**: Puntos específicos dentro de una sede (ej: Armerillo Principal, Almacén de Tránsito).

Cada ubicación está asociada a una sede y puede tener un **Custodio** responsable asignado.

### 6.2 Armas y Trazabilidad
Además de los datos técnicos del arma (Serial, Marca, Modelo, etc.), el sistema mantiene:
- **Ubicación Actual**: Dónde se encuentra el arma físicamente.
- **Custodio Actual**: Quién es el responsable legal del arma en este momento.
- **Historial de Movimientos**: Registro completo desde su ingreso al sistema.

#### 6.2.1 Trazabilidad
Desde el módulo de Armas o Cadena de Custodia, puede acceder a la **Trazabilidad** de un arma específica para ver su "hoja de vida", incluyendo cada traslado, asignación o mantenimiento realizado.

### 6.3 Cadena de Custodia
Este módulo garantiza que siempre se sepa quién tiene un arma y dónde está.

#### 6.3.1 Registrar Estado Inicial (Ingreso)
Se usa para dar de alta la ubicación y custodio inicial de un arma que ya existe en el sistema pero no tiene trazabilidad previa.

#### 6.3.2 Registrar Traslado
Permite mover un arma:
- **Interno**: Entre ubicaciones o custodios de la misma empresa/sede.
- **Externo**: Hacia otras empresas o sedes.
- Requiere definir: Origen, Destino, Motivo y quién autoriza.

### 6.4 Inventarios
Permite realizar auditorías físicas del armamento en stock.

1. **Crear Inventario**: Defina la fecha, empresa y ubicación (o toda la empresa).
2. **Registrar Verificación**: Seleccione el arma pendiente y registre su estado físico (Excelente, Bueno, etc.) y si fue encontrada.
3. **Evidencia**: Puede cargar hasta **3 fotos** por arma verificada.
4. **Cierre**: Una vez terminada la verificación, marque como "Completado" o "Con Novedades".
5. **PDF**: Genere el acta de inventario con el detalle de lo encontrado y las novedades registradas.

### 6.5 Documentos y Alertas
El sistema controla la vigencia de:
- **Portes**: Asociados a las armas.

**Semaforización:**
- **Rojo**: Vencimiento crítico (menos de 30 o 90 días según el documento).
- **Naranja**: Vencimiento próximo.
- **Vencido**: Aparece en la lista negra y bloquea asignaciones operativas.

### 6.6 Asignaciones
Gestión de entrega de elementos a empleados para servicio.
- El sistema valida automáticamente que el arma tenga su Porte activo.
- Si hay documentos vencidos, el sistema emitirá una alerta.
- Al finalizar, se genera un **Acta de Entrega/Devolución** con firmas digitales.

### 6.7 Paz y Salvo
Controla que un empleado no tenga pendientes antes de retirarse.
- Revisa automáticamente si tiene armas asignadas.
- Verifica la vigencia de los documentos asociados.
- Si hay pendientes, queda en estado "Pendiente de Revisión" para que un Admin lo gestione.
- Genera documento PDF con el paz y salvo aprobado.

## 7. Archivos y Almacenamiento
- Las fotos de evidencia, firmas y soportes se guardan en la nube (R2).
- Límite de tamaño para PDFs: **1 MB**.
- Las imágenes se optimizan automáticamente al subir.

## 8. Buenas Prácticas
- Registre cada traslado de arma en la **Cadena de Custodia** inmediatamente.
- Realice **Inventarios** semanales o mensuales para asegurar la integridad del stock.
- Mantenga las **Firmas y Logos** actualizados para que los documentos PDF sean válidos legalmente.
- Use el campo de **Observaciones** para documentar cualquier anomalía en los elementos.