Skip to content

feat(auditoria): nueva sección operativa con métricas comparativas, widgets configurables y tendencias (Feature/metrics audit proposed section)#196

Open
asmulever wants to merge 5 commits intooscarchapp:mainfrom
asmulever:feature/metrics-audit-proposed-section
Open

feat(auditoria): nueva sección operativa con métricas comparativas, widgets configurables y tendencias (Feature/metrics audit proposed section)#196
asmulever wants to merge 5 commits intooscarchapp:mainfrom
asmulever:feature/metrics-audit-proposed-section

Conversation

@asmulever
Copy link

Resumen

Este PR incorpora una nueva sección de Auditoría Operativa (antes métricas), orientada a análisis diario/mensual con comparación de períodos y lectura ejecutiva de performance para soporte de decisiones.

Qué cambia

  • Se agrega nueva ruta y vista para Auditoría (metrics_audit).
  • Se actualiza navegación en toolbar de Métricas a Auditoría.
  • Se incorpora pantalla con:
    • KPIs diarios (creadas, confirmadas, canceladas, facturación),
    • comparación contra período previo,
    • tablas de auditoría diaria y mensual,
    • bloques de resumen ejecutivo.
  • Se añaden visualizaciones de tendencia mediante barras normalizadas.
  • Se agrega control de visualización de widgets (tabla/barras/resumen) y vistas por período (diaria/mensual/combinada).
  • Se corrigen estilos de contraste para asegurar legibilidad en modo claro/oscuro.

Valor funcional

  • Centraliza información operativa clave en una sola vista.
  • Acelera detección de variaciones de demanda, cancelación e ingresos.
  • Mejora comunicación entre operación, producto y negocio con indicadores comparables.

Archivos relevantes

  • pms/views.py
  • pms/urls.py
  • pms/templates/main.html
  • pms/templates/metrics_audit.html
  • pms/statics/css/style.css
  • pms/tests.py
  • docs/pr-5-metrics-audit.md

Validación / pruebas

  • Pruebas automáticas de la sección:
    • render de vista y secciones esperadas,
    • cálculo de métricas diarias,
    • generación de filas de auditoría diaria y mensual.
  • Comando ejecutado:
    • python manage.py test pms.tests.MetricsAuditTests
  • Resultado esperado: tests en verde y sin regresiones funcionales en navegación.

Información para Deploy

  • No requiere migraciones de base de datos.
  • No agrega variables de entorno nuevas.
  • No introduce dependencias externas.
  • Riesgo medio-bajo: cambio visible en navegación + nueva vista de reporting.
  • Recomendado smoke test de UI post-deploy para validar contraste y toggles de widgets.

Smoke test recomendado post-deploy

  1. Verificar item Auditoría en toolbar y acceso correcto a la vista.
  2. Validar visualización de KPIs diarios y comparativas.
  3. Probar cambio entre vistas diaria/mensual/combinada.
  4. Activar/desactivar widgets (tabla, barras, resumen) y confirmar comportamiento.
  5. Revisar legibilidad en modo claro y oscuro.

Documentación

Existe documentación detallada para PM/Arquitectura y Deploy en:

  • docs/pr-5-metrics-audit.md

- Nueva vista de metricas con comparativas de periodos

- Nueva ruta y acceso desde navbar

- Template de auditoria con KPIs y tablas diaria/mensual

- Ajustes visuales de la interfaz en archivos de estilo y layout

- Cobertura de tests para validar calculos y estructura
…va con UX configurable

Resumen ejecutivo:

- Renombra el acceso de navegación de 'Métricas' a 'Auditoría' para alinear semántica de negocio.

- Transforma la pantalla en un tablero de auditoría con foco en lectura operativa diaria y mensual.

Mejoras funcionales implementadas:

- Nuevos KPIs derivados: tasa de cancelación, ticket promedio, picos de facturación y acumulados por ventana de análisis.

- Controles de visualización: vista diaria, mensual y combinada; con widgets activables (tabla, barras y resumen ejecutivo).

- Visualizaciones de tendencia mediante barras normalizadas para reservas y facturación, sin dependencias externas.

Mejoras técnicas:

- Extensión de MetricsAuditView para calcular métricas comparativas y porcentajes listos para UI.

- Ajuste de estilos responsive para mantener legibilidad y jerarquía visual en desktop/móvil.

- Actualización de pruebas de la vista para reflejar el nuevo contenido renderizado.

Documentación incluida:

- docs/pr-5-metrics-audit.md con alcance, archivos tocados, pruebas y valor esperado para PM/Arquitectura.
Ajusta badges, botones de toolbar, tablas, KPIs y barras de la vista de Auditoría para usar variables de tema y mejorar accesibilidad visual.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant