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
- ✅ Uso de prepared statements en la mayoría de consultas (seguro contra SQL injection)
- ✅ Anti-bot: Honeypot + time-check en formulario de reclamaciones
- ✅ PHPMailer con SMTP y embedded images
- ✅ Dockerizado con nginx + PHP-FPM + PostgreSQL
- ✅ Multi-tenant por subdominio bien implementado
- ✅ PDF generation con dompdf
- ✅ Correlativos dinámicos con reinicio por año
- ✅ Cache-busting con versionado de assets
💡 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 🔗