Actualizar README con cambios v1.1.0: Informe de Ingresos y config centralizada
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 8s
All checks were successful
build-and-deploy / build-and-deploy (push) Successful in 8s
This commit is contained in:
75
README.md
75
README.md
@@ -25,10 +25,11 @@ Esta aplicación sigue el principio de delegar **todos los cálculos, agregacion
|
|||||||
|
|
||||||
### 📈 Informes y Dashboards
|
### 📈 Informes y Dashboards
|
||||||
|
|
||||||
- **Panorama Facturador**: Vista consolidada de totales financieros, inversiones, depósitos y rechazos
|
- **Panorama Facturador**: Vista consolidada de totales financieros, inversiones, depósitos y rechazos (9 queries de Metabase)
|
||||||
- **Informe de Ingresos**: Análisis detallado por tipo de café (uva, oreado, mojado, verde)
|
- **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
|
- **Comparativa de Cosechas**: Comparación histórica entre temporadas
|
||||||
- **Explorador de Datos**: Navegación interactiva de tablas y metadatos
|
- **Explorador de Datos**: Navegación interactiva de tablas y metadatos
|
||||||
|
- **Metabase Debug**: Herramienta de debugging para verificar queries configuradas
|
||||||
|
|
||||||
### 🔐 Seguridad
|
### 🔐 Seguridad
|
||||||
|
|
||||||
@@ -98,9 +99,13 @@ analiticaNucleo/
|
|||||||
│ ├── server/
|
│ ├── server/
|
||||||
│ │ ├── api/
|
│ │ ├── api/
|
||||||
│ │ │ └── metabase/ # Endpoints de Metabase
|
│ │ │ └── metabase/ # Endpoints de Metabase
|
||||||
│ │ │ ├── panorama.post.ts
|
│ │ │ ├── panorama.post.ts # 9 queries Panorama
|
||||||
│ │ │ ├── cards.get.ts
|
│ │ │ ├── informe.post.ts # 8 queries Informe
|
||||||
│ │ │ └── databases.get.ts
|
│ │ │ ├── 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/
|
│ │ └── utils/
|
||||||
│ │ └── metabase.ts # Utilidades para API de Metabase
|
│ │ └── metabase.ts # Utilidades para API de Metabase
|
||||||
│ ├── public/ # Archivos estáticos (iconos, PWA)
|
│ ├── public/ # Archivos estáticos (iconos, PWA)
|
||||||
@@ -208,13 +213,40 @@ Ver [DEPLOYMENT.md](./DEPLOYMENT.md) para más detalles.
|
|||||||
|
|
||||||
## 📊 Integración con Metabase
|
## 📊 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_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_QUERIES_COMPARATIVA_COSECHAS.md](./METABASE_QUERIES_COMPARATIVA_COSECHAS.md) - Queries de comparativa
|
||||||
- [METABASE_API_ENDPOINTS.md](./METABASE_API_ENDPOINTS.md) - Referencia completa de endpoints
|
- [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
|
### Flujo de Datos
|
||||||
|
|
||||||
```
|
```
|
||||||
@@ -341,11 +373,36 @@ Para reportar issues o solicitar features:
|
|||||||
|
|
||||||
## 🔄 Changelog
|
## 🔄 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
|
### v1.0.0 - 2025-01
|
||||||
|
|
||||||
#### Agregado
|
#### Agregado
|
||||||
- ✨ Panorama Facturador con 9 queries de Metabase
|
- ✨ Panorama Facturador con 9 queries de Metabase
|
||||||
- ✨ Informe de Ingresos detallado
|
|
||||||
- ✨ Comparativa de Cosechas
|
- ✨ Comparativa de Cosechas
|
||||||
- ✨ PWA instalable con offline support
|
- ✨ PWA instalable con offline support
|
||||||
- ✨ Autenticación con Authentik
|
- ✨ Autenticación con Authentik
|
||||||
@@ -353,7 +410,7 @@ Para reportar issues o solicitar features:
|
|||||||
|
|
||||||
#### Modificado
|
#### Modificado
|
||||||
- 🔧 Refactorización completa a filosofía "Metabase calcula TODO"
|
- 🔧 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
|
- 🔧 Migración a Nuxt 4
|
||||||
|
|
||||||
#### Corregido
|
#### Corregido
|
||||||
|
|||||||
Reference in New Issue
Block a user