# Correcciones de seguridad e integridad del ERP Coteni

Fecha: 9 de septiembre de 2026.

Se corrigieron los hallazgos del análisis en el código del proyecto. No se ejecutaron migraciones ni se modificaron datos de la base operativa.

## Cambios

- **Instalación y actualización:** las rutas web devuelven 404 antes de conectar a la base. Solo se ejecutan mediante PHP CLI. La instalación requiere `COTENI_ADMIN_PASSWORD` (mínimo 12 caracteres) y no vuelve a sembrar una instalación que ya tenga usuarios. Las actualizaciones conservan las revocaciones de permisos existentes.
- **Permisos:** La clase `AccessPolicy`, cargada desde `app/helpers.php`, centraliza las reglas operativas para vistas, acciones, API y expedientes. Los permisos explícitos de la base limitan las reglas por rol. Se restringieron las requisiciones y viáticos propios de solicitantes, Comercial y RH, los catálogos de RH y el acceso al dashboard ejecutivo.
- **Edición directa:** los módulos integrados redirigen a sus flujos. Las escrituras mediante sus antiguos formularios se rechazan, incluidos cambios directos de estado o acumulados. Se bloqueó el envío de autorizaciones mediante la tabla antigua.
- **Transacciones:** cada acción operativa confirma movimiento, estado, presupuesto y bitácora conjuntamente. Una excepción revierte todo. Folios y servicios respetan la transacción exterior.
- **Concurrencia:** se bloquean las filas relevantes antes de consultar saldos o estados. Se protegen pagos, cobros, caja, recepciones, creación de OC, validación de facturas y asignaciones. Los formularios incluyen un identificador de un solo uso para evitar repetir operaciones ya confirmadas en la misma sesión.
- **Presupuesto:** requisiciones y gastos requieren una partida válida, abierta y suficiente. La suficiencia se vuelve a comprobar al comprometer o ejercer. No se ocultan inconsistencias de compromiso mediante truncamiento a cero. Una cotización mayor libera el compromiso anterior y solicita autorización por el nuevo importe antes de generar OC.
- **Facturas:** se comprueba total contra subtotal más impuestos, pertenencia de recepción a la OC, valor recibido y aceptado, facturas previamente validadas y cuenta por pagar ya generada. Se eliminó la tolerancia automática del 5 %. Una recepción parcial no permite facturar el total de la OC.
- **Activos:** solo se asignan activos disponibles a colaboradores activos del catálogo, sin otra asignación abierta. Asignación, devolución y baja administrativa coordinan sus bloqueos.
- **Documentos:** la descarga comprueba el expediente y los permisos, además de la sesión. Se valida contenido de archivos subidos, se fuerza descarga para formatos que no son PDF o imagen y se evita almacenar la respuesta en caché. Los enlaces antiguos `uploads/` se encaminan a la descarga autenticada; el directorio incluye una regla Apache que bloquea acceso directo.
- **API:** verifica usuario activo, rol y recurso en cada solicitud. La creación valida el JSON y las partidas, usa transacción y registra al titular del token en bitácora. Los errores internos no se entregan al cliente.

## Verificación

La suite `tests/all_regression.php`, ejecutada con `tests/run_regression.ps1`, prueba una copia temporal del ERP contra una instancia MariaDB local independiente. No carga la configuración productiva.

Resultado: **63 comprobaciones aprobadas**. Se verifican compras, recepciones parciales, facturas, pagos, cobros, caja, reautorización de cotizaciones, activos, permisos, API y reversión ante fallos provocados. Dos procesos independientes comprueban movimientos simultáneos sobre un mismo saldo. El resultado se guarda en `storage/maintenance/latest-test-results.txt`.

En Windows con XAMPP:

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\tests\run_regression.ps1
```

La política indicada solo corresponde al proceso de prueba. El script requiere los puertos locales 33379 y 33380 libres, crea su propia base temporal y apaga los procesos que inicia. La contraseña incluida pertenece exclusivamente a esa instancia temporal. Los registros se conservan en una carpeta `coteni-check-*` dentro del directorio temporal del usuario.

Los archivos anteriores se conservaron en `storage/maintenance/before`. No se requiere alterar el esquema de la base operativa para activar estas correcciones.

## Consideraciones de operación

- Recargar los formularios abiertos antes de los cambios. Los identificadores de formulario vencen a las dos horas.
- La valoración de recepciones distribuye el total de la OC, incluidos impuestos, según el valor de sus partidas aceptadas. El esquema actual conserva importes globales de factura; no contiene partidas fiscales para cotejar cada renglón de factura.
- Se preservaron los datos históricos. Si ya existen saldos o asignaciones inconsistentes, deben conciliarse antes de continuar esas operaciones; el código ahora las bloquea en lugar de ocultarlas.
- La suite comprueba el comportamiento PHP y MySQL/MariaDB en una copia aislada. No certifica la configuración Apache/Nginx, HTTPS ni una restauración de respaldos del servidor operativo. En Nginx deben aplicarse restricciones equivalentes a los `.htaccess` incluidos.
## Corrección de carga en el servidor

Se corrigió el HTTP 500 causado por la falta de lectura de grupo en archivos nuevos creados mediante SSHFS. Las clases Transaction, AccessPolicy y FileAccess se cargan desde helpers.php, que conserva los permisos existentes del servidor. Sus archivos individuales quedan como cargadores de compatibilidad; las rutas operativas no dependen de leerlos. No se ampliaron permisos de escritura.

Validación real: https://coteni.ddns.net/erp_coteni_admin_v1/public/ devuelve 302 y login.php devuelve 200. La suite aislada volvió a aprobar 63 comprobaciones después del ajuste.
