From 646057188e06baff4771ebac4fe2dcd467659900 Mon Sep 17 00:00:00 2001
From: josedario87 <jodarioel87@gmail.com>
Date: Mon, 27 Oct 2025 17:24:04 -0600
Subject: [PATCH] Actualizar README con cambios v1.1.0: Informe de Ingresos y
 config centralizada

---
 README.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++-------
 1 file changed, 66 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 5ab65a0..d93b7e4 100644
--- a/README.md
+++ b/README.md
@@ -25,10 +25,11 @@ Esta aplicación sigue el principio de delegar **todos los cálculos, agregacion
 
 ### 📈 Informes y Dashboards
 
-- **Panorama Facturador**: Vista consolidada de totales financieros, inversiones, depósitos y rechazos
-- **Informe de Ingresos**: Análisis detallado por tipo de café (uva, oreado, mojado, verde)
+- **Panorama Facturador**: Vista consolidada de totales financieros, inversiones, depósitos y rechazos (9 queries de Metabase)
+- **Informe de Ingresos**: Análisis detallado con filtros avanzados por tipo, estado, fechas, clientes, ubicaciones y calidades (8 queries de Metabase)
 - **Comparativa de Cosechas**: Comparación histórica entre temporadas
 - **Explorador de Datos**: Navegación interactiva de tablas y metadatos
+- **Metabase Debug**: Herramienta de debugging para verificar queries configuradas
 
 ### 🔐 Seguridad
 
@@ -98,9 +99,13 @@ analiticaNucleo/
 │   ├── server/
 │   │   ├── api/
 │   │   │   └── metabase/      # Endpoints de Metabase
-│   │   │       ├── panorama.post.ts
-│   │   │       ├── cards.get.ts
-│   │   │       └── databases.get.ts
+│   │   │       ├── panorama.post.ts      # 9 queries Panorama
+│   │   │       ├── informe.post.ts       # 8 queries Informe
+│   │   │       ├── query-config.get.ts   # Config de queries
+│   │   │       ├── cards.get.ts          # Lista de cards
+│   │   │       └── databases.get.ts      # Databases disponibles
+│   │   ├── config/
+│   │   │   └── metabase-queries.ts       # Config centralizada de queries
 │   │   └── utils/
 │   │       └── metabase.ts    # Utilidades para API de Metabase
 │   ├── public/                # Archivos estáticos (iconos, PWA)
@@ -208,13 +213,40 @@ Ver [DEPLOYMENT.md](./DEPLOYMENT.md) para más detalles.
 
 ## 📊 Integración con Metabase
 
-La aplicación se integra con Metabase mediante su API REST. Todas las queries están documentadas en:
+La aplicación se integra con Metabase mediante su API REST. Todas las queries están documentadas en archivos Markdown y centralizadas en código:
+
+### Documentación de Queries
 
 - [METABASE_QUERIES_PANORAMA.md](./METABASE_QUERIES_PANORAMA.md) - 9 queries del Panorama Facturador
-- [METABASE_QUERIES_INFORME_INGRESOS.md](./METABASE_QUERIES_INFORME_INGRESOS.md) - Queries de informe detallado
+- [METABASE_QUERIES_INFORME_INGRESOS.md](./METABASE_QUERIES_INFORME_INGRESOS.md) - 8 queries del Informe de Ingresos
 - [METABASE_QUERIES_COMPARATIVA_COSECHAS.md](./METABASE_QUERIES_COMPARATIVA_COSECHAS.md) - Queries de comparativa
 - [METABASE_API_ENDPOINTS.md](./METABASE_API_ENDPOINTS.md) - Referencia completa de endpoints
 
+### Configuración Centralizada
+
+Los nombres de las queries están definidos en `server/config/metabase-queries.ts`:
+
+```typescript
+export const METABASE_QUERIES = {
+  panorama: {
+    totales_financieros_principales: 'panorama_totales_financieros_principales',
+    totales_ingreso_compra: 'panorama_totales_ingreso_compra',
+    // ... 9 queries total
+  },
+  informe: {
+    totales_ingreso_compra: 'Informe Ingresos - Totales Ingreso y Compra',
+    totales_monetarios: 'Informe Ingresos - Totales Monetarios',
+    // ... 8 queries total
+  }
+}
+```
+
+**Beneficios:**
+- ✅ Single source of truth para nombres de queries
+- ✅ Búsqueda automática por nombre en Metabase
+- ✅ Fácil actualización si cambian nombres
+- ✅ Type-safe en TypeScript
+
 ### Flujo de Datos
 
 ```
@@ -341,11 +373,36 @@ Para reportar issues o solicitar features:
 
 ## 🔄 Changelog
 
+### v1.1.0 - 2025-10-27
+
+#### Agregado
+- ✨ Configuración centralizada de queries en `server/config/metabase-queries.ts`
+- ✨ Endpoint `/api/metabase/informe` con 8 queries para Informe de Ingresos
+- ✨ Endpoint `/api/metabase/query-config` para exponer config de queries al frontend
+- ✨ Página de Informe de Ingresos activada con sistema de filtros avanzados:
+  - Filtros por fecha (desde/hasta)
+  - Filtros por tipo de café (uva, mojado, oreado, verde)
+  - Filtros por estado (pagado, pendiente)
+  - Granularidad temporal (día/semana/mes)
+  - Incluir/excluir anulados
+- ✨ Tab "Queries Informe" en Metabase Debug
+- ✨ Integración con layout informe (context menu, visibilidad de secciones)
+
+#### Modificado
+- 🔧 Refactorización de `panorama.post.ts` para usar configuración centralizada
+- 🔧 Actualización de `metabase-debug.vue` para buscar queries por config centralizado
+- 🔧 Mejora de stats en Metabase Debug (5 contadores + colores dinámicos)
+- 🔧 Composables `useIngresosMetrics` y `useRechazosMetrics` marcados como obsoletos
+
+#### Corregido
+- 🐛 Fix imports relativos en `server/` para compilación correcta
+- 🐛 Fix detección de queries faltantes en Metabase Debug
+- 🐛 Eliminación de composables legacy de panorama.vue
+
 ### v1.0.0 - 2025-01
 
 #### Agregado
 - ✨ Panorama Facturador con 9 queries de Metabase
-- ✨ Informe de Ingresos detallado
 - ✨ Comparativa de Cosechas
 - ✨ PWA instalable con offline support
 - ✨ Autenticación con Authentik
@@ -353,7 +410,7 @@ Para reportar issues o solicitar features:
 
 #### Modificado
 - 🔧 Refactorización completa a filosofía "Metabase calcula TODO"
-- 🔧 Eliminación de composables de métricas legacy
+- 🔧 Eliminación de composables de métricas de componentes
 - 🔧 Migración a Nuxt 4
 
 #### Corregido