§1 Estructura del proyecto

1.1 🗂️ Árbol completo de archivos

Vista jerárquica de los 63 archivos productivos. Tamaños tomados del filesystem real (Mayo 2026).

public_html/reportes/
│
├── 📄 index.php                     30.8 KB · Landing portal · 4 stats globales + 3 cards
├── 📄 DOCUMENTACION.md              22.3 KB · Doc principal · versiones + arquitectura
├── 📄 u120688891_chess.sql         765 MB   · ⚠️ Dump completo de la BD (NO debe estar acá)
│
├── 📂 analisis/                              · ★ Este análisis técnico (v1.0.0)
│   └── v1.0.0/
│       ├── index.html                        · Landing del análisis
│       ├── secciones/                        · 14 secciones HTML
│       ├── diagramas/                        · Diagramas ASCII y SVG
│       └── assets/{css,js}/                  · Estilos compartidos
│
├── 📂 venta/                                 · 💰 Módulo Ventas
│   ├── .htaccess                     1.7 KB · Reglas Apache (deny txt, sql, bak)
│   ├── DOCUMENTACION.md             48.0 KB · Doc detallado de venta (1232 líneas)
│   ├── index.php                    29.9 KB · Listado de períodos sincronizados
│   ├── dashboard.php               147.4 KB · ★ Dashboard principal (3200+ líneas)
│   ├── monitor.php                  16.2 KB · Monitor en vivo del estado de imports
│   ├── reinit_import.php            38.2 KB · UI de importación masiva
│   ├── sync_api.php                 12.7 KB · UI sync de 1 mes
│   ├── sync_api_process.php         17.4 KB · Backend AJAX lote×lote
│   ├── _debug_samarelli.php          7.0 KB · ⚠️ Debug ad-hoc (debe removerse)
│   │
│   ├── config/
│   │   └── database.php              1.4 KB · Constantes DB + API ChessERP + SITE_VERSION
│   ├── includes/
│   │   ├── chess_api_client.php      4.6 KB · Cliente HTTP a ChessERP (login + getVentas)
│   │   ├── data_api.php             50.4 KB · ★ Núcleo: 20+ funciones de queries
│   │   ├── db_reportes.php           1.0 KB · PDO singleton + bootstrap articulos_raw
│   │   └── functions.php             7.1 KB · formatMoney, formatPercent, formatTons, …
│   ├── api/
│   │   └── filter.php               14.4 KB · Endpoint drill-down (supervisor/dep/prov/vend)
│   ├── assets/
│   │   ├── css/style.css            69.6 KB · Estilos del módulo
│   │   └── js/app.js                42.0 KB · Helpers UI (fmtMoney, openTab, fullscreen)
│   └── sql/
│       └── schema_reportes.sql       9.1 KB · DDL de la tabla ventas (~160 cols)
│
├── 📂 caja/                                  · 🏦 Módulo Caja y Bancos (hub + 3 submódulos)
│   ├── DOCUMENTACION.md             16.0 KB · Doc del hub
│   ├── REFERENCIA_EXCEL.md           8.1 KB · Mapa exacto de columnas de cada Excel
│   ├── TROUBLESHOOTING.md            9.2 KB · Guía de re-sync y diagnóstico
│   ├── version.php                   2.3 KB · CAJA_VERSION + changelog inline
│   │
│   ├── index.php                    11.2 KB · Hub con cards a submódulos
│   ├── sync.php                     36.7 KB · UI carga individual (1 mes, 6 Excel)
│   ├── sync_bulk.php                56.6 KB · ★ UI importación masiva multi-mes
│   ├── reset_db.php                 20.2 KB · Panel admin (eliminar/limpiar/drop)
│   ├── dashboard.jsx                21.8 KB · ⚠️ Legado React (debe eliminarse)
│   │
│   ├── _partials/
│   │   └── header.php                5.9 KB · Header sticky compartido con sub-tabs
│   ├── config/
│   │   └── database.php              260 B  · Constantes DB
│   ├── assets/css/style.css         66.4 KB · CSS compartido del módulo
│   │
│   ├── api/                                  · APIs comunes del módulo padre
│   │   ├── _schema.php              21.5 KB · ★ Schema centralizado (10 tablas)
│   │   ├── init.php                  2.1 KB · Crea schema + inicializa sync
│   │   ├── save.php                  3.3 KB · INSERT caja_gastos por lote
│   │   ├── save_raw.php             12.6 KB · INSERT caja_raw_* por lote
│   │   └── get_conceptos.php         2.0 KB · Lee catálogo persistido
│   │
│   ├── 📂 gastos/                            · 💸 Submódulo Gastos
│   │   ├── DOCUMENTACION.md         26.2 KB
│   │   ├── index.php                28.8 KB · Dashboard (Tabulator árbol RUBRO ▸ CONCEPTO)
│   │   └── api/data.php              3.1 KB · Endpoint agregados por año/mes/prov
│   │
│   ├── 📂 tesoreria/                         · 🏦 Submódulo Tesorería (5 pestañas)
│   │   ├── DOCUMENTACION.md          9.8 KB
│   │   ├── index.php                53.8 KB · Dashboard con 5 pestañas
│   │   └── api/
│   │       ├── flujo.php             6.8 KB · Ingresos vs Egresos
│   │       ├── cobros.php            4.6 KB · Formas de pago, contado vs Cta Cte
│   │       ├── origen.php            4.0 KB · Origen de cobros + estado pago
│   │       ├── cajas.php             4.0 KB · Cheques cartera + saldo diario
│   │       └── alertas.php           5.9 KB · Anticipos, runway, anulados, dif. cotiz.
│   │
│   └── 📂 finanzas/                          · 📊 Submódulo Finanzas (3 pestañas)
│       ├── DOCUMENTACION.md          8.1 KB
│       ├── index.php                37.1 KB · Dashboard con 3 pestañas
│       └── api/
│           ├── iva.php               5.5 KB · IVA crédito/débito + saldo técnico
│           ├── percepciones.php      4.2 KB · IIBB/RG3337/RG5329/Municipal
│           ├── centros_costo.php     3.2 KB · Distribución por centro
│           ├── proveedores.php       4.3 KB · Top 30 + concentración + plazo
│           └── cruce_ventas.php      7.0 KB · Margen limpio + $/tonelada
│
├── 📂 cashflow/                              · 💸 Módulo Cashflow
│   ├── DOCUMENTACION.md             18.7 KB
│   ├── version.php                   1.0 KB · CASHFLOW_VERSION = 1.1.0
│   ├── index.php                    51.2 KB · ★ Dashboard (5 KPIs + 2 agings + calendar)
│   ├── sync.php                     14.7 KB · UI upload unificada (?tipo=cliente|proveedor|cheque)
│   ├── reset_db.php                 19.4 KB · Panel admin propio
│   ├── config/database.php           378 B  · Constantes DB
│   └── api/
│       ├── _schema.php               5.6 KB · 4 tablas
│       ├── init.php                  2.1 KB · Crea sync por (tipo, fecha_corte)
│       ├── save.php                 11.4 KB · INSERT lotes (cliente/prov/cheque)
│       ├── data.php                 19.3 KB · ★ Endpoint principal con todo el JSON
│       └── delete-sync.php           1.9 KB · DELETE por (tipo, fecha)
│
├── 📂 articulos/                             · 📦 Catálogo maestro
│   ├── DOCUMENTACION.md             16.4 KB
│   ├── index.php                    19.8 KB · Landing con stats del catálogo
│   ├── sync.php                     14.4 KB · UI carga del Excel (66 cols)
│   ├── config/database.php           342 B  · Constantes DB
│   └── api/
│       ├── _schema.php               7.8 KB · ★ 5 tablas (cross-module)
│       ├── init.php                  1.5 KB · Crea schema + opcional TRUNCATE
│       └── save.php                  8.2 KB · INSERT lotes 66-col con ON DUP KEY UPDATE
│
└── 📂 listas/                                · 🏷️ Listas de precios
    ├── index.php                    14.5 KB · Consultor de precios por lista/agrupación
    ├── sync.php                      76 B   · ⚠️ Stub: redirige a /catalogo/admin/api_sync.php
    ├── config/database.php           967 B  · DB + LISTAS_DISPONIBLES (17 listas)
    └── api/
        ├── _schema.php               4.4 KB · 3 tablas (precios + agrupaciones + sync)
        ├── init.php                  2.3 KB
        ├── precios.php               2.3 KB · Consulta de precios
        └── sync_process.php         11.7 KB · Backend del sync (delegado)

1.2 📐 Convenciones del proyecto

Naming

• _schema.php — función <modulo>_ensure_schema(PDO $pdo) idempotente.
• init.php — crea schema + inicializa registro en tabla *_sincronizaciones.
• save.php / save_raw.php — recibe lotes JSON via POST, inserta y devuelve {ok, insertadas}.
• data.php — endpoint de lectura que devuelve el JSON del dashboard.
• sync.php — UI con SheetJS para parsear Excel cliente-side.
• sync_bulk.php — versión multi-mes.
• reset_db.php — panel admin (delete-period / delete-all / drop).
• version.php — constantes semver (<MOD>_VERSION, <MOD>_VERSION_DATE).
• DOCUMENTACION.md — markdown extenso por módulo.

Estilo de prefijos en BD

Tipos de archivos

1.3 🎭 Responsabilidades por archivo (los críticos)

📊 Módulo Venta

🏦 Módulo Caja

💸 Módulo Cashflow

📦 Módulo Artículos · 🏷️ Listas

1.4 🎨 Assets y dependencias CDN

Librerías externas (todas vía CDN, sin build step)

Logos compartidos

• /assets/images/logos/logo_dia.svg
• /assets/images/logos/logo_noche.svg

Implementación: 2 <img> superpuestos + CSS show/hide según data-theme.

Theming unificado

Todos los HTML usan la misma clave de localStorage:

// Anti-flash de tema (primera línea del <head>)
(function(){
  var t = localStorage.getItem('za-theme') || 'dark';
  document.documentElement.setAttribute('data-theme', t);
})();

Variables CSS comunes: --bg-page, --bg-card, --text-main, --text-muted, --accent, --border.

1.5 📚 Documentación markdown existente