🔗 Nexus

← Volver a notas
4 KB 25/05/2026 19:19
🔗

dx-libro_reclamaciones — Análisis de Código

Repo: dannyelito/dx-libro_reclamaciones
Stack: PHP 8.2 vanilla MVC + PostgreSQL + Docker
Último commit: d65bd7e — marzo 2026
Funcionalidad: Libro de reclamaciones virtual multi-tenant (Indecopi Perú)


📋 ¿Qué hace?

Sistema SaaS para que empresas gestionen su libro de reclamaciones obligatorio (Indecopi). Cada cliente tiene su subdominio, los consumidores llenan un formulario, y el admin de la empresa gestiona las reclamaciones. Incluye generación de PDF, notificaciones por email, y panel SuperAdmin.


🏗️ Arquitectura

PHP 8.2 MVC (vanilla)
├── app/Core/       → Router, Database, Config, Mail, Tenant
├── app/Controllers/ → Admin, Api, Claim, Login, SuperAdmin, User
├── app/Views/      → 16 templates PHP
├── PostgreSQL 15    → Docker
└── nginx           → Docker (puerto 8080)

Dependencias: dompdf, phpmailer, phpdotenv


🐛 Bugs y Problemas Encontrados

🔴 Críticos

# Bug Archivo Línea Detalle
1 Contraseñas en texto plano LoginController.php 28 $password === $user['password_hash'] compara en texto plano ANTES de password_verify. Si alguien tiene acceso a la DB y ve el hash, no debería poder hacer login con el hash directo. Pero con esta lógica, si cambias el hash por uno conocido, haces login sin saber la contraseña real.
2 API key en URL (GET) ApiController.php 13 $_GET['api_key'] permite pasar la API key en la URL. Esto queda en logs del servidor, historial del navegador, referer headers. Debería ser solo por Header.

🟡 Medios

# Bug Archivo Línea Detalle
3 Subida de archivos sin validación MIME ClaimController.php 79-80 Solo valida extensión (PATHINFO_EXTENSION). Podrían subir un .php renombrado como .jpg y ejecutarlo si el servidor no está bien configurado.
4 Sin regeneración de sesión tras login LoginController.php 36 No hay session_regenerate_id() después del login. Vulnerable a session fixation.
5 Redirect sin exit después de header() AdminController.php 9, 32 header('Location: ...') sin exit. Si hay output previo, el redirect falla y el script sigue ejecutándose.
6 SuperAdmin: consulta directa sin prepared statement SuperAdminController.php 14 $db->query("SELECT * FROM tenants...") — aunque es una query fija, inconsistente con el resto del código que usa prepared statements.

🟢 Bajos / Mejoras

# Mejora Archivo Detalle
7 Sin CSRF tokens ClaimController Los formularios no tienen tokens CSRF. Un atacante podría enviar reclamaciones falsas en nombre de usuarios legítimos.
8 Múltiples session_start() Varios Cada controller llama session_start() manualmente. Debería iniciarse una sola vez en un front controller.
9 Error info en producción Database.php die("Error de conexión: " . $e->getMessage()) muestra detalles de la DB al usuario en caso de error.
10 API key en variable de entorno .env La API key está en texto plano en el .env del repo. Si el repo se filtra, la API key queda expuesta.

✅ Lo que está bien hecho


💡 Recomendaciones

Prioridad Qué hacer Dónde Tiempo
🔴 Eliminar comparación en texto plano, solo password_verify LoginController.php 5 min
🔴 Quitar $_GET['api_key'], solo por Header ApiController.php 5 min
🟡 Agregar session_regenerate_id() tras login LoginController.php 2 min
🟡 Validar MIME real de archivos subidos ClaimController.php 15 min
🟢 Agregar exit después de todos los header('Location:') Varios 5 min
🟢 Front controller único con session_start() global index.php 30 min

Análisis generado por Nexus 🔗