Dashboard QA-OMA

Aplicación web para visualizar el estado de ejecución del Programa Anual de Auditorías de Aseguramiento de la Calidad de la OMA. Sin backend, sin login, sin credenciales: los datos se cargan subiendo el Excel de control (hojas AUDITORIAS_<año> + HALLAZGOS_<año>: 2024, 2025, 2026…) y quedan guardados en el navegador de quien la abre (IndexedDB). Para actualizarla, se vuelve a cargar el Excel — reemplaza todo lo que había, igual que la primera versión de la app (100% local, sin backend), pero ahora desplegada en la web.

Historial: la app pasó por una versión intermedia con Supabase (Postgres en la nube, login, edición en vivo multi-dispositivo) entre agosto y septiembre de 2026. Se retiró — ver git log — porque requería mantener un proyecto Supabase aparte; el modelo actual vuelve a "el Excel es la fuente de verdad", adaptado para funcionar desplegado en la web.

Arquitectura

• Frontend: HTML/CSS/JS plano (sin build step), Bootstrap 5, Chart.js, DataTables, SheetJS — servido como sitio estático (GitHub Pages / Vercel).
• Datos: IndexedDB, en el propio navegador (js/dataService.js). No hay servidor, no hay credenciales que configurar. Limitación real: los datos NO se sincronizan entre dispositivos — si se abre la app en otro computador o celular, hay que volver a cargar el Excel ahí también.
• Carga de datos: botón "📂 Cargar Excel" (o la pantalla inicial si todavía no hay nada cargado) — sube el .xlsx con las hojas AUDITORIAS_<año> y HALLAZGOS_<año> (puede traer una o varias vigencias), lo procesa en el navegador (js/excelParser.js + js/matching.js + js/excelImport.js) y reemplaza solo las vigencias que trae: las demás quedan intactas.
• Vigencias (años): el selector "Vigencia" del encabezado cambia el año que muestran todas las pestañas. Con 2 o más años cargados aparece la pestaña Comparativo de Vigencias (tabla de indicadores con Δ contra el año anterior + gráficos lado a lado; no usa los filtros globales).
• Edición puntual: los formularios "+ Nueva Auditoría/Inspección/ Hallazgo" y el clic sobre una fila siguen disponibles para ajustes entre una carga de Excel y la siguiente — se guardan en IndexedDB igual que la carga masiva.

Puesta en marcha

No hay ningún paso de configuración: se abre index.html (local o desplegado) y la propia app pide el Excel la primera vez.

Desplegar a GitHub Pages: ver .github/workflows/deploy.yml — activa Pages con "Source: GitHub Actions" en Settings → Pages, y cada push a main publica la app automáticamente (sin secrets que configurar).

Desplegar a Vercel: en vercel.com, "Add New… → Project" → importa este repo de GitHub. Es un sitio 100% estático (sin framework, sin build command) — Vercel lo detecta solo. Se puede desplegar en paralelo a GitHub Pages sin conflicto (mismo repo, dos URLs distintas).

Estructura del proyecto

SATENA_QA_Dashboard/
├── index.html                Estructura y layout de toda la app
├── styles.css                 Sistema visual (paleta corporativa, responsive, impresión)
├── data.js                     Configuración visual (colores por categoría, reglas de clasificación)
├── README.md                     Este archivo
├── .github/workflows/
│   └── deploy.yml                  Publica a GitHub Pages en cada push a main
├── assets/fonts/               IBM Plex Sans/Mono autoalojadas (sin depender de Google Fonts)
├── vendor/                Librerías de terceros ya descargadas (sin CDN externo en runtime)
│   Bootstrap 5 · Chart.js 4 · SheetJS (xlsx) · DataTables + jQuery · jsPDF · html2canvas · FileSaver
└── js/
    ├── utils.js                  Normalización de texto, fechas, formato — funciones puras
    ├── excelParser.js              Lee las hojas AUDITORIAS_2026 / HALLAZGOS_2026 del Excel
    ├── matching.js                   Clasificación canónica + vínculo hallazgo->auditoría por nombre
    ├── excelImport.js                  Junta lo anterior en objetos listos para guardar
    ├── dataService.js                    Fuente de datos: IndexedDB por vigencia (fetch/save/delete)
    ├── statusEngine.js                     Cálculo del estado real de cada auditoría
    ├── kpiEngine.js                          Cálculo de KPIs y agregaciones para gráficos
    ├── charts.js                              Renderizado de todos los gráficos (Chart.js)
    ├── comparativo.js                           Comparativo de vigencias (tabla + datos de gráficos)
    ├── tables.js                                Tablas dinámicas (DataTables) + export a Excel
    ├── filters.js                                Filtros globales
    ├── exportPdf.js                               Exportación del dashboard a PDF
    └── app.js                                      Orquestación: carga, edición, render

Modelo de datos

El Excel de control tiene 2 hojas (ver js/excelParser.js para el detalle exacto de columnas):

Hoja	Contenido
AUDITORIAS_<año>	Una fila por auditoría/inspección: Estatus, Programada/No programada, Tipo (Auditoria QA / Inspección), Clasificación, Auditado, Ciudad, Modalidad, Fecha Proyectada, Ejecución Reprogramada, Servicios y, opcional, Cierre.
HALLAZGOS_<año>	Una fila por hallazgo (NC/OB), vinculado a su auditoría por nombre (si varias auditorías comparten nombre, desempata el ID de la columna ID AUDITORIA) — condición, estado (Abierto/Cerrado/Cierre Parcial), causa raíz, fechas de notificación/cierre, etc.

This is the beginning of the README. Read the rest at the original. Read the full README ↗