# Checklist de puesta en marcha – ERP COTENI V1.1 Operativa

## 1. Infraestructura
- [ ] PHP 8.2 o superior.
- [ ] Extensiones: `pdo_mysql`, `mbstring`, `json`, `fileinfo`, `zip`.
- [ ] MySQL 8 o MariaDB compatible.
- [ ] Apache/Nginx con HTTPS.
- [ ] Preferentemente configurar el DocumentRoot directamente en `public/`.
- [ ] Permisos de escritura para `storage/uploads`.

## 2. Instalación
- [ ] Ajustar `config/config.php`.
- [ ] Cambiar `cron_key` por una clave aleatoria fuerte.
- [ ] Ejecutar por consola `php public/install.php` en instalación limpia, con `COTENI_ADMIN_PASSWORD` definida, o `php public/upgrade.php` si viene de la V1.
- [ ] Ingresar con `admin@coteni.local`.
- [ ] Usar una contraseña inicial propia de al menos 12 caracteres; cambiar cualquier credencial predeterminada heredada desde **Mi cuenta**.
- [ ] Eliminar o renombrar `install.php` y `upgrade.php`.

## 3. Catálogos antes de operar
- [ ] Áreas y departamentos.
- [ ] Puestos y colaboradores.
- [ ] Proveedores.
- [ ] Clientes.
- [ ] Proyectos.
- [ ] Centros de costo.
- [ ] Categorías de gasto.
- [ ] Bancos y formas de pago.
- [ ] Partidas presupuestales.

## 4. Matriz de autorización
- [ ] Validar montos de requisiciones.
- [ ] Validar autorización de gastos directos.
- [ ] Validar autorización de pagos.
- [ ] Validar autorización de viáticos.
- [ ] Configurar niveles adicionales si Dirección lo requiere.

## 5. Prueba piloto obligatoria
Realizar un circuito completo antes de liberar a todos los usuarios:

`REQ → autorización → 2/3 cotizaciones → selección → OC → recepción → factura → CxP → autorización de pago → pago → cierre`

También probar:
- [ ] Solicitud de facturación → CxC → cobro.
- [ ] Compra marcada como activo → alta automática → resguardo → devolución.
- [ ] Baja de colaborador con activo asignado (debe bloquearse).
- [ ] Viático → autorización → anticipo → comprobación → cierre.
- [ ] Caja chica → salida → comprobante → reembolso.
- [ ] Contrato próximo a vencer → alerta.

## 6. Respaldos
- [ ] Respaldo diario de MySQL.
- [ ] Respaldo de `storage/uploads`.
- [ ] Si se migró desde V1, conservar también respaldo de `public/uploads`.
- [ ] Ejecutar prueba de restauración antes de declarar producción.

## 7. Notificaciones y correo
- [ ] Configurar ejecución de `cron.php`.
- [ ] Confirmar alertas internas.
- [ ] Si habrá correo, configurar relay/servicio de correo del servidor y activar `mail.enabled`.
- [ ] Realizar prueba de envío.

## 8. PWA
- [ ] HTTPS activo.
- [ ] Abrir el ERP desde Chrome/Edge/Safari compatible.
- [ ] Instalar como aplicación en equipo piloto.
- [ ] Validar acceso en Windows/macOS y móvil.

## 9. API
- [ ] Generar token únicamente si existe una integración real.
- [ ] Guardar el token en secreto; el ERP solo lo muestra una vez.
- [ ] Definir fecha de expiración.
- [ ] Probar primero endpoints GET antes de usar POST.

## 10. Liberación
- [ ] Dirección valida Dashboard/BI.
- [ ] Administración valida compras/gastos/contratos.
- [ ] Contabilidad valida factura/CxP/CxC.
- [ ] Tesorería valida pagos/cobros/caja.
- [ ] RH valida activos y bajas.
- [ ] Usuarios reciben una capacitación corta sobre requisiciones, comprobaciones y viáticos.

## Controles incorporados
- [ ] Recargar formularios abiertos antes de esta actualización.
- [ ] Asociar partida presupuestal suficiente a requisiciones y gastos.
- [ ] Confirmar la nueva autorización cuando una cotización aumente el importe.
- [ ] Validar la factura contra el valor de la recepción aceptada; la OC debe incluir impuestos en su total.
- [ ] Apache debe respetar los archivos `.htaccess`; en Nginx configurar las restricciones equivalentes y proteger `public/uploads`.
- [ ] Revisar saldos y asignaciones históricos si ya presentaban inconsistencias: estas correcciones no reescriben datos anteriores.
