Feature/dashboard occupancy

[asmulever]

Resumen

Este PR incorpora en Dashboard un indicador de % de ocupación para exponer rápidamente el estado operativo de habitaciones y facilitar decisiones diarias de revenue y disponibilidad.

Qué cambia

• Se agrega el cálculo de ocupación en backend tomando habitaciones con reservas activas sobre el total de habitaciones.
• Se incorpora un nuevo widget en Dashboard con el porcentaje formateado.
• Se contempla el caso de borde sin habitaciones configuradas (ocupación = 0%) para evitar divisiones por cero.
• Se mantiene el comportamiento existente del resto de widgets.

Valor funcional

• Visibilidad inmediata del nivel de ocupación del establecimiento.
• Mejor soporte para decisiones operativas (ventas, pricing, disponibilidad).
• Métrica simple y accionable para seguimiento diario.

Archivos relevantes

• pms/views.py
• pms/templates/dashboard.html
• pms/statics/css/style.css
• pms/tests.py
• docs/pr-2-dashboard-occupancy.md

Validación / pruebas

• Pruebas automáticas cubriendo:
  • cálculo correcto del porcentaje con habitaciones y reservas mixtas,
  • comportamiento cuando no existen habitaciones (retorno 0),
  • renderización del widget en Dashboard.
• Resultado esperado: cálculo consistente y visualización estable.

Información para Deploy

• No requiere migraciones de base de datos.
• No agrega variables de entorno nuevas.
• No introduce dependencias externas.
• Riesgo bajo de despliegue (cambio acotado a cálculo + render de dashboard).

Consideraciones operativas

• La métrica depende de la calidad de datos de reservas/estados en la base actual.
• Recomendado validar en staging con dataset representativo para confirmar lectura esperada por operación.

Documentación

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

• docs/pr-2-dashboard-occupancy.md