Mate11 commited on
Commit
e3b077e
·
1 Parent(s): dbf9f42

Integración M2: cancelacion sin auth + endpoint reserva auto sin auth

Browse files

- turnos.py: docstring actualizado con flujo correcto M2
- webhooks.py: sacar autenticación de POST /turnos/{id}/cancelacion
- quirofanos.py + reserva.py + cama_service.py: nuevo endpoint
POST /quirofanos/reservas sin auth — M6 elige el quirófano libre
automáticamente dado hospital_id, horario y specialty_id opcional

app/integrations/turnos.py CHANGED
@@ -1,14 +1,18 @@
1
  """
2
  M2 Turnos — reprogramación de turno quirúrgico.
3
 
 
 
 
 
 
 
 
4
  M6 no cancela turnos en M2: la cancelación siempre llega como webhook entrante
5
- (POST /turnos/{turno_id}/cancelacion). Lo único que M6 le pide a M2 es reprogramar
6
- un turno cuando una cirugía urgente desplaza a una reserva programada (la cirugía
7
- desplazada no se cancela, se mueve a un nuevo horario).
8
 
9
- Contrato tomado de `documentation/M2_openapi.json` (`PATCH /appointments/{id}/reschedule`):
10
- body `{starts_at, ends_at}` en formato `"YYYY-MM-DD HH:mm:ss"`, response
11
- `{message, notification_id}`.
12
  """
13
  import logging
14
  import uuid
 
1
  """
2
  M2 Turnos — reprogramación de turno quirúrgico.
3
 
4
+ M2 es quien inicia el agendamiento de quirófano: llama a `POST /quirofanos/reservas`
5
+ para que M6 reserve el quirófano. M6 no inicia ninguna llamada hacia M2 para ese flujo.
6
+
7
+ Lo único que M6 le pide a M2 es reprogramar un turno cuando una cirugía urgente
8
+ desplaza a una reserva programada que M2 ya conocía (la cirugía desplazada no se
9
+ cancela, se mueve a un nuevo horario).
10
+
11
  M6 no cancela turnos en M2: la cancelación siempre llega como webhook entrante
12
+ (POST /turnos/{turno_id}/cancelacion).
 
 
13
 
14
+ Contrato tomado de `documentation/integrations/openapi_docs/M2_openapi.json`
15
+ (`PATCH /appointments/{id}/reschedule`).
 
16
  """
17
  import logging
18
  import uuid
app/routers/quirofanos.py CHANGED
@@ -14,6 +14,7 @@ from app.schemas.cama import (
14
  )
15
  from app.schemas.reserva import (
16
  ReservaQuirofanoCreateRequest,
 
17
  ReservaEstadoUpdateRequest,
18
  ReservaQuirofanoResponse,
19
  ReservasListResponse,
@@ -26,6 +27,28 @@ logger = logging.getLogger(__name__)
26
  router = APIRouter(prefix="/quirofanos", tags=["Quirófanos"])
27
 
28
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
29
  # ─── Disponibilidad (debe ir ANTES de /{quirofano_id}) ─────────────────────
30
 
31
  @router.get(
 
14
  )
15
  from app.schemas.reserva import (
16
  ReservaQuirofanoCreateRequest,
17
+ ReservaProgramadaAutoRequest,
18
  ReservaEstadoUpdateRequest,
19
  ReservaQuirofanoResponse,
20
  ReservasListResponse,
 
27
  router = APIRouter(prefix="/quirofanos", tags=["Quirófanos"])
28
 
29
 
30
+ # ─── Reserva con asignación automática — sin auth (llamado por M2) ────────
31
+
32
+ @router.post(
33
+ "/reservas",
34
+ response_model=ReservaQuirofanoResponse,
35
+ status_code=status.HTTP_201_CREATED,
36
+ summary="[M2] Solicitar cirugía programada — M6 asigna el quirófano automáticamente",
37
+ responses={
38
+ 409: {"description": "Sin quirófano disponible en el horario solicitado"},
39
+ 422: {"description": "Prioridad URGENTE no permitida"},
40
+ },
41
+ )
42
+ def crear_reserva_auto(
43
+ data: ReservaProgramadaAutoRequest,
44
+ db: Client = Depends(get_db),
45
+ ):
46
+ reserva, created = cama_service.create_reserva_auto(db, data)
47
+ resp = ReservaQuirofanoResponse.model_validate(reserva)
48
+ http_status = status.HTTP_201_CREATED if created else status.HTTP_200_OK
49
+ return JSONResponse(content=resp.model_dump(mode="json"), status_code=http_status)
50
+
51
+
52
  # ─── Disponibilidad (debe ir ANTES de /{quirofano_id}) ─────────────────────
53
 
54
  @router.get(
app/routers/webhooks.py CHANGED
@@ -145,13 +145,12 @@ def recibir_cirugia_urgente(
145
  "/turnos/{turno_id}/cancelacion",
146
  response_model=CancelacionQuirofanoResponse,
147
  summary="[M2] Cancelar reserva de quirófano por turno",
148
- responses={401: {"description": "No autenticado"}, 404: {"description": "Reserva no encontrada"}, 409: {"description": "Reserva no cancelable"}},
149
  )
150
  def cancelar_reserva_quirofano(
151
  turno_id: int,
152
  data: CancelacionQuirofanoRequest,
153
  db: Client = Depends(get_db),
154
- user: dict = Depends(get_current_user),
155
  ):
156
  logger.info("[M2→M6] Webhook cancelación quirófano recibida: turno_id=%s motivo=%r", turno_id, data.motivo)
157
  try:
 
145
  "/turnos/{turno_id}/cancelacion",
146
  response_model=CancelacionQuirofanoResponse,
147
  summary="[M2] Cancelar reserva de quirófano por turno",
148
+ responses={404: {"description": "Reserva no encontrada"}, 409: {"description": "Reserva no cancelable"}},
149
  )
150
  def cancelar_reserva_quirofano(
151
  turno_id: int,
152
  data: CancelacionQuirofanoRequest,
153
  db: Client = Depends(get_db),
 
154
  ):
155
  logger.info("[M2→M6] Webhook cancelación quirófano recibida: turno_id=%s motivo=%r", turno_id, data.motivo)
156
  try:
app/schemas/reserva.py CHANGED
@@ -21,6 +21,25 @@ class ReservaQuirofanoCreateRequest(BaseModel):
21
  return self
22
 
23
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
24
  class ReservaEstadoUpdateRequest(BaseModel):
25
  estado: EstadoReservaEnum
26
  observaciones: Optional[str] = None
 
21
  return self
22
 
23
 
24
+ class ReservaProgramadaAutoRequest(BaseModel):
25
+ """Request para que M6 elija automáticamente el quirófano disponible."""
26
+ turno_id: int
27
+ paciente_id: int
28
+ medico_cirujano_id: int
29
+ fecha_hora_inicio: datetime
30
+ fecha_hora_fin_estimada: datetime
31
+ prioridad: PrioridadQuirofanoEnum
32
+ hospital_id: str
33
+ specialty_id: Optional[int] = None
34
+ observaciones: Optional[str] = None
35
+
36
+ @model_validator(mode="after")
37
+ def validar_rango_fechas(self):
38
+ if self.fecha_hora_inicio >= self.fecha_hora_fin_estimada:
39
+ raise ValueError("fecha_hora_inicio debe ser anterior a fecha_hora_fin_estimada")
40
+ return self
41
+
42
+
43
  class ReservaEstadoUpdateRequest(BaseModel):
44
  estado: EstadoReservaEnum
45
  observaciones: Optional[str] = None
app/services/cama_service.py CHANGED
@@ -17,6 +17,7 @@ from app.schemas.cama import (
17
  )
18
  from app.schemas.reserva import (
19
  ReservaQuirofanoCreateRequest,
 
20
  ReservaEstadoUpdateRequest,
21
  CirugiaUrgenteWebhook,
22
  )
@@ -487,6 +488,88 @@ def create_reserva(
487
  return reserva, True
488
 
489
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
490
  def get_reserva(db: Client, cama_id: int, reserva_id: int) -> ReservaQuirofano:
491
  _get_cama_or_404(db, cama_id)
492
  r = reserva_crud.get_by_cama_and_id(db, cama_id, reserva_id)
 
17
  )
18
  from app.schemas.reserva import (
19
  ReservaQuirofanoCreateRequest,
20
+ ReservaProgramadaAutoRequest,
21
  ReservaEstadoUpdateRequest,
22
  CirugiaUrgenteWebhook,
23
  )
 
488
  return reserva, True
489
 
490
 
491
+ def create_reserva_auto(
492
+ db: Client, data: ReservaProgramadaAutoRequest, actor: dict | None = None
493
+ ) -> tuple[ReservaQuirofano, bool]:
494
+ """
495
+ Crea una reserva programada eligiendo automáticamente el quirófano disponible.
496
+ M6 busca el primer quirófano libre en el horario solicitado dentro del hospital,
497
+ con preferencia por la especialidad indicada si se provee.
498
+ Retorna (reserva, created). created=False si ya existía (idempotencia por turno_id).
499
+ """
500
+ if data.prioridad.value == "URGENTE":
501
+ raise HTTPException(
502
+ status_code=422,
503
+ detail={
504
+ "codigo": "PRIORIDAD_URGENTE_NO_PERMITIDA",
505
+ "mensaje": "La prioridad URGENTE no puede asignarse desde este endpoint",
506
+ },
507
+ )
508
+
509
+ existing = reserva_crud.get_activa_por_turno(db, data.turno_id)
510
+ if existing:
511
+ return existing, False
512
+
513
+ quirofanos = cama_crud.get_quirofanos(
514
+ db,
515
+ hospital_id=data.hospital_id,
516
+ exclude_estados=["FUERA_DE_SERVICIO", "BAJA_PERMANENTE", "EN_LIMPIEZA"],
517
+ )
518
+ if not quirofanos:
519
+ raise HTTPException(
520
+ status_code=409,
521
+ detail={
522
+ "codigo": "SIN_QUIROFANO_COMPATIBLE",
523
+ "mensaje": "No hay quirófanos operables para el hospital indicado",
524
+ },
525
+ )
526
+
527
+ def _orden_quirofano(q: Cama) -> int:
528
+ if data.specialty_id is not None and q.specialty_id == data.specialty_id:
529
+ return 0
530
+ return 1
531
+
532
+ candidatos = sorted(quirofanos, key=_orden_quirofano)
533
+
534
+ for quirofano in candidatos:
535
+ solapadas = reserva_crud.get_superpuestas(
536
+ db, quirofano.id, data.fecha_hora_inicio, data.fecha_hora_fin_estimada
537
+ )
538
+ if not solapadas:
539
+ create_data = ReservaQuirofanoCreateRequest(
540
+ turno_id=data.turno_id,
541
+ paciente_id=data.paciente_id,
542
+ medico_cirujano_id=data.medico_cirujano_id,
543
+ fecha_hora_inicio=data.fecha_hora_inicio,
544
+ fecha_hora_fin_estimada=data.fecha_hora_fin_estimada,
545
+ prioridad=data.prioridad,
546
+ observaciones=data.observaciones,
547
+ )
548
+ reserva = reserva_crud.create_programada(db, quirofano.id, create_data)
549
+ auditoria_crud.registrar(
550
+ db,
551
+ entidad=EntidadAuditoriaEnum.RESERVA_QUIROFANO.value,
552
+ entidad_id=reserva.id,
553
+ cama_id=quirofano.id,
554
+ evento=TipoEventoAuditoriaEnum.RESERVA_CREADA.value,
555
+ estado_nuevo=reserva.estado,
556
+ paciente_id=reserva.paciente_id,
557
+ actor=actor,
558
+ descripcion=f"Reserva programada asignada automáticamente a quirófano {quirofano.id}",
559
+ detalle={"turno_id": reserva.turno_id, "prioridad": reserva.prioridad},
560
+ hospital_id=quirofano.hospital_id,
561
+ )
562
+ return reserva, True
563
+
564
+ raise HTTPException(
565
+ status_code=409,
566
+ detail={
567
+ "codigo": "SIN_QUIROFANO_DISPONIBLE",
568
+ "mensaje": "No hay quirófanos disponibles en el horario solicitado",
569
+ },
570
+ )
571
+
572
+
573
  def get_reserva(db: Client, cama_id: int, reserva_id: int) -> ReservaQuirofano:
574
  _get_cama_or_404(db, cama_id)
575
  r = reserva_crud.get_by_cama_and_id(db, cama_id, reserva_id)