Analitica Diccionario de Vistas - Davidcuama/via-coinogas GitHub Wiki

HU-29 · Capa analítica — diccionario de campos y conexión

Dos vistas SQL desnormalizadas (no tablas), de solo lectura, que alimentan el tablero (Power BI o el tablero propio de HU-30). El tablero consulta solo estas vistas, nunca las tablas transaccionales.

Vista analitica_requerimientos

Campo Tipo Descripción
id entero Identificador del requerimiento
consecutivo texto Consecutivo REQ-AAAA-NNNN
solicitante texto Nombre de quien radicó
area texto Área o proyecto
centro_costo_codigo texto Código del centro de costo
centro_costo_nombre texto Nombre del centro de costo
prioridad texto ALTA / MEDIA / BAJA
fecha_solicitud fecha Día en que se radicó
fecha_requerida fecha Día requerido de recepción
anio_solicitud entero Año de la fecha de solicitud
mes_solicitud entero Mes de la fecha de solicitud (1–12)
numero_items entero Cantidad de ítems
total_estimado decimal Suma de los totales de los ítems

Vista analitica_items

Campo Tipo Descripción
id entero Identificador del ítem
requerimiento_id entero ID del requerimiento
consecutivo texto Consecutivo del requerimiento
numero entero N.º del ítem
descripcion texto Qué se solicita
cantidad entero Cantidad pedida
unidad_medida texto Unidad (Unidad, Caja, …)
precio_referencia decimal / nulo Precio unitario, si se conoce
total decimal cantidad × precio_referencia
requiere_calibracion booleano Marca de calibración
es_reembolsable booleano Marca de reembolsable

Rol de base de datos de solo lectura

El rol analitica_lectura solo puede hacer SELECT sobre las dos vistas. Se crea con:

python manage.py crear_rol_analitica --password "<clave-segura>"

Solo aplica a PostgreSQL (producción). Es idempotente.

Conexión desde Power BI Desktop

  1. Obtener datos → PostgreSQL.
  2. Servidor: <host> · Base de datos: via_coinogas.
  3. Usuario: analitica_lectura · Contraseña: la definida arriba.
  4. Modo: Importar.
  5. Seleccionar las vistas analitica_requerimientos y analitica_items.
  6. Relación: analitica_items.requerimiento_id → analitica_requerimientos.id.
⚠️ **GitHub.com Fallback** ⚠️