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 +10 -6
- app/routers/quirofanos.py +23 -0
- app/routers/webhooks.py +1 -2
- app/schemas/reserva.py +19 -0
- app/services/cama_service.py +83 -0
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).
|
| 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`
|
| 10 |
-
|
| 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={
|
| 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)
|