Agenda: cierre rápido de agendas por médico, lista de espera, duraciones 30/45/60, checklist de estados con bitácora y auto-refresh 30s

- BloqueosModal: alta multi-médico, rango repetible por día de la semana,
  motivos predefinidos, edición/borrado y cierre rápido desde la cabecera
  de cada columna (todo el día / resto del día / rango).
- skeen.lista.espera + panel y modal en la agenda: prioridad, franja, rango
  de fechas, agendar precargado, avisar por WhatsApp y aviso cuando se
  libera un hueco compatible.
- duration en skeen.cita (0 = la del servicio): la cita ocupa sus bloques de
  15 min reales en las 4 vistas, con celdas de continuación.
- Checklist de estados (Agendada → Confirmada → En cabina → En consulta →
  Completada) con avance/retroceso, cancelación y no-show con confirmación,
  y bitácora de quién/cuándo en skeen.cita.state.log.
- Etiquetas del sistema legacy alineadas (Canceló / Lista de espera / En
  cabina) en badges de agenda y dashboard.
- Auto refresco silencioso cada 30 s (pausable, se pospone con modales,
  escritura o drag) en citas + bloqueos + lista de espera en un solo request.

odoo-addons/skeen_citas/models/bloqueo.py

@@ -3,21 +3,81 @@
 from odoo import models, fields, api, _
 from odoo.exceptions import ValidationError
 
+# Motivos predefinidos (el legacy usaba 7 = Vacaciones y 8 = Horario de comida)
+MOTIVO_SELECTION = [
+    ('vacaciones', 'Vacaciones'),
+    ('junta', 'Junta'),
+    ('comida', 'Comida'),
+    ('personal', 'Personal'),
+    ('otro', 'Otro'),
+]
+
 
 class SkeenCitaBloqueo(models.Model):
+    """Bloqueo de agenda de un médico para una fecha concreta.
+
+    Un registro = un médico × una fecha. Los bloqueos creados juntos (varios
+    médicos y/o un rango de fechas con repetición semanal) comparten el campo
+    `grupo`, lo que permite editarlos o eliminarlos como serie.
+    """
     _name = 'skeen.cita.bloqueo'
     _description = 'Bloqueo de Agenda por Médico'
-    _order = 'date desc'
+    _order = 'date desc, time_from'
 
     doctor_id = fields.Many2one('hr.employee', string='Médico', required=True)
     date = fields.Date(string='Fecha', required=True, index=True)
     all_day = fields.Boolean(string='Todo el día', default=False)
     time_from = fields.Float(string='Desde', default=9.0)
     time_to = fields.Float(string='Hasta', default=10.0)
-    motivo = fields.Char(string='Motivo')
+    motivo_tipo = fields.Selection(MOTIVO_SELECTION, string='Motivo', default='otro')
+    motivo = fields.Char(string='Detalle del motivo')
+    grupo = fields.Char(string='Grupo', index=True, copy=False,
+                        help='Identificador de la serie (médicos y fechas creados juntos).')
+    created_by = fields.Char(string='Creado por', readonly=True, copy=False)
 
     @api.constrains('time_from', 'time_to', 'all_day')
     def _check_horas(self):
         for b in self:
-            if not b.all_day and b.time_to <= b.time_from:
-                raise ValidationError(_('La hora final debe ser mayor a la inicial'))
+            if not b.all_day:
+                if b.time_to <= b.time_from:
+                    raise ValidationError(_('La hora final debe ser mayor a la inicial'))
+                if b.time_from < 0 or b.time_to > 24:
+                    raise ValidationError(_('Las horas deben estar dentro del día'))
+
+    @api.constrains('doctor_id', 'date', 'all_day', 'time_from', 'time_to')
+    def _check_sin_citas(self):
+        """No se puede bloquear un rango que ya tiene citas activas.
+
+        Evita "cerrar la agenda" dejando citas dentro del bloqueo. Al editar un
+        bloqueo se ignora a sí mismo (no tiene citas asociadas, pero el dominio
+        es el mismo que usa la validación de citas).
+        """
+        Citas = self.env['skeen.cita']
+        if self.env.context.get('skeen_skip_bloqueo_citas'):
+            return
+        for b in self:
+            if not b.doctor_id or not b.date:
+                continue
+            domain = [
+                ('doctor_id', '=', b.doctor_id.id),
+                ('date', '=', b.date),
+                ('state', 'not in', ('cancelled', 'no_show', 'waitlist')),
+            ]
+            if not b.all_day:
+                domain += [('time', '<', b.time_to)]
+            citas = Citas.search(domain).filtered(
+                lambda c: b.all_day or (c.time + c._duracion() / 60.0) > b.time_from
+            )
+            if citas:
+                raise ValidationError(_(
+                    'Hay %(n)s cita(s) agendadas en ese horario con %(doc)s. '
+                    'Reprograma o cancela esas citas antes de bloquear.'
+                ) % {'n': len(citas), 'doc': b.doctor_id.name})
+
+    def nombre_motivo(self):
+        """Texto legible del motivo para la UI y los mensajes de validación."""
+        self.ensure_one()
+        etiqueta = dict(MOTIVO_SELECTION).get(self.motivo_tipo or '', '')
+        if self.motivo and etiqueta:
+            return '%s — %s' % (etiqueta, self.motivo)
+        return self.motivo or etiqueta or 'agenda bloqueada'