# 📊 Documento de Especificación de Tablero BI
**Nombre del tablero:** [Nombre del Tablero]
**Autor:** [Tu nombre]
**Fecha de creación:** [dd/mm/yyyy]
**Última actualización:** [dd/mm/yyyy]
**Versión actual:** vX.X
---
## 🔹 Especificación de Gráficos
### 1. Nombre del gráfico: `[Nombre del gráfico]`
**🎯 Objetivo del gráfico**
> Describe brevemente el propósito de este gráfico.
> _Ejemplo: Mostrar la evolución mensual de ventas por región._
**🧼 Criterios de selección de datos**
> ¿Qué filtros o condiciones se aplican para que los datos aparezcan aquí?
> _Ejemplo: Se incluyen solo las ventas confirmadas del año en curso._
**🗄️ Fuente de datos**
> ¿De dónde se obtienen los datos?
> _Ejemplo: Vista `vw_ventas_mensuales` en PostgreSQL (`erp_ventas`)._
**📅 Frecuencia de actualización**
> _Ejemplo: Diario / Semanal / Mensual / Tiempo real._
**🕒 Rango temporal mostrado**
> _Ejemplo: Últimos 12 meses / Año actual / Seleccionable._
**🧮 Campos clave utilizados**
- `fecha_transaccion`
- `monto_total`
- `region`
**📌 Indicadores clave (KPI asociados)**
- **Nombre del KPI:** [Ej. Margen Bruto Mensual]
- **Meta esperada:** ≥ [valor]
- **Semáforo/alerta:** [describir si aplica]
**🔗 Interacciones del gráfico**
> ¿Este gráfico filtra otros? ¿Tiene drill-downs?
> _Ejemplo: Al hacer clic en una barra, se filtra el gráfico inferior por producto._
**🔐 Control de acceso / visibilidad**
> ¿Quién puede ver este gráfico?
> _Ejemplo: Sólo roles de "Gerente" o "Supervisor"._
**📌 Supuestos del negocio**
> ¿Qué supuestos se aplican en los datos?
> _Ejemplo: Se considera venta activa solo si el pago fue confirmado._
**🧪 Validación de datos**
> _Ejemplo: Se revisa mensualmente contra el reporte oficial del ERP._
**👥 Responsables**
- **Funcional:** [Nombre - Área]
- **Técnico:** [Nombre - Data/BI]
**💬 Feedback / mejoras sugeridas**
> _Ejemplo: “Agregar filtro por tipo de cliente.” (Sugerencia de Finanzas, abril 2025)_
**📝 Notas adicionales**
> Otros detalles relevantes que no entren en los campos anteriores.
---
### 2. Nombre del gráfico: `[Repetir sección anterior por cada gráfico]`
---
## 📁 Historial de Versiones
| Versión | Fecha | Autor | Cambios realizados |
|---------|-------------|------------|----------------------------------------------------------|
| v1.0 | 09/05/2025 | Artu | Documento inicial con especificación de los gráficos. |
| v1.1 | 12/05/2025 | Artu | Se agregó gráfico de rentabilidad por producto. |
| v1.2 | [dd/mm/yyyy] | [Nombre] | [Descripción de la modificación] |
---