§1 🎯 Resumen ejecutivo

El sistema de reportes de Zonas Áridas es una BI casera modular construida sobre PHP 8 + MariaDB en hosting compartido (Hostinger), con frontend vanilla JS + Tabulator 6.3 + Chart.js 4.4. Está funcionando en producción, alineado al milímetro con ChessERP, y resuelve análisis de venta, gastos, tesorería, cashflow e impuestos.

Fortalezas

• Arquitectura modular bien definida: cada módulo tiene su config/database.php, api/_schema.php idempotente y sync independiente.
• Fórmula ChessERP unificada como constantes PHP reutilizables en data_api.php y filter.php.
• Bootstrap cross-module: venta/db_reportes.php dispara articulos_ensure_schema() para que los JOINs no fallen.
• Schema v2 de caja con todas las tablas raw históricas + caja_audit_log + caja_cajeros denormalizado.
• Tabulator + Chart.js eliminó ~500 KB de bundle React manteniendo todas las features (árbol, virtual scroll, bottomCalc).
• Documentación markdown extensa y versionado semver real en cada módulo (version.php con changelog inline).

Riesgos principales

• CRÍTICO Credenciales hardcoded en config/database.php (multiplicado en 5 archivos) — incluye API ChessERP.
• CRÍTICO Sin autenticación: los endpoints reset_db.php, sync.php, save.php son públicos. El session_start está comentado.
• CRÍTICO Dump SQL completo (765 MB) servido como archivo estático en /reportes/u120688891_chess.sql — descargable por cualquiera.
• ALTO Algunas queries interpolan variables: WHERE sync_id=$sid en caja/api/save.php:63 y otros (mitigado por cast a int, pero es mala práctica).
• ALTO 5 copias de las constantes de BD (venta · caja · cashflow · articulos · listas) — divergen ya (ej. UPLOAD_MAX_MB solo en venta).
• ALTO caja/dashboard.jsx (~22 KB) sigue versionado en producción aunque ya no se usa (legado React).

§2 📐 Alcance del análisis

Esta auditoría cubre todo lo que vive bajo /public_html/reportes/:

§3 📈 Métricas del proyecto

Volumen de código por módulo

Volumen de datos en BD (Mayo 2026)

📊 Dump SQL en producción El archivo u120688891_chess.sql pesa 765 MB (volcado completo con datos). Sirve como respaldo manual pero no debe quedar accesible en el doc root (riesgo de exfiltración total). Ver §10 hallazgo SEC-03.

§4 🧩 Mapa de módulos

Cada tarjeta linkea a la sección detallada con flujos, fórmulas, BD y mejoras.

Dependencias cross-module

                        ┌──────────────────────────┐
                        │   u120688891_chess (BD)  │
                        └────────────┬─────────────┘
                                     │
       ┌───────────┬──────────┬──────┴──────┬──────────┬────────────┐
       ▼           ▼          ▼             ▼          ▼            ▼
  ┌────────┐  ┌────────┐  ┌────────┐  ┌──────────┐ ┌─────────┐ ┌──────────┐
  │ VENTA  │  │  CAJA  │  │CASHFLOW│  │ARTICULOS │ │ LISTAS  │ │  Hub /   │
  │        │  │ (hub)  │  │        │  │ catálogo │ │ precios │ │ landing  │
  └───┬────┘  └───┬────┘  └───┬────┘  └────┬─────┘ └────┬────┘ └─────┬────┘
      │           │           │            │            │            │
      │           │           │            │            │            │
      ▼ JOIN articulos_raw ───┘            │            │            │
      │                                    │            │            │
      ▼ db_reportes.php → articulos_ensure_schema() ◄───┘            │
      │                                                              │
      ▼ filter.php / dashboard.php                                   │
                                                                     │
  CAJA   ──► cashflow lee caja_raw_egresos_caja (saldo de caja) ─────┤
  CAJA   ──► finanzas lee ventas (cruce rentabilidad)                │
  CASHFLOW ► lee ventas (cruce comercial 6 meses)                    │
                                                                     │
  landing (/reportes/index.php) ── usa stats de los 3 grandes ───────┘

§5 ⚠️ Hallazgos prioritarios

Top issues que valen la pena resolver primero. Detalle completo en §10 Análisis de errores.

§6 🚀 Roadmap propuesto al segundo nivel

Plan en 4 fases ordenadas por impacto y dependencias. Detalle completo en §11 y §12.

Fase 0 — Hardening (1–2 semanas)

Fase 1 — Refactor de plataforma compartida (3–4 semanas)

Fase 2 — Capa BI estable (4–6 semanas)

Fase 3 — Inteligencia y proyecciones (6–8 semanas)

Esfuerzo total estimado: 14–20 semanas-persona. ROI esperado: reducción del 70% en horas mensuales dedicadas a consolidar reportes manualmente + detección temprana de problemas de cobranza/margen.