jpsoron commited on
Commit
17c36bc
·
unverified ·
2 Parent(s): d5945b98defa71

Merge pull request #11 from MateFerreyra/jps/cron-cirugias

Browse files
.env.example CHANGED
@@ -57,6 +57,9 @@ INTERNACION_REQUESTS_QUEUE=internacion.requests
57
  # event_type_id de las notificaciones salientes de M6. Cada uno lo crea y
58
  # comparte el módulo receptor (M1/M9/M7). Dejar comentado hasta tener el ID
59
  # real: pydantic-settings no trata "KEY=" vacío como None, tira ValidationError.
 
 
 
60
  # HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=
61
  # MONITOREO_ALTA_EVENT_TYPE_ID=
62
  # MONITOREO_BAJA_EVENT_TYPE_ID=
 
57
  # event_type_id de las notificaciones salientes de M6. Cada uno lo crea y
58
  # comparte el módulo receptor (M1/M9/M7). Dejar comentado hasta tener el ID
59
  # real: pydantic-settings no trata "KEY=" vacío como None, tira ValidationError.
60
+ # M7 ya confirmó el suyo por escrito (documentation/integrations/M7_integration.md,
61
+ # event_type_id=19) — se activa descomentando y completando, igual que se hará acá
62
+ # cuando M1/M9 confirmen los suyos.
63
  # HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=
64
  # MONITOREO_ALTA_EVENT_TYPE_ID=
65
  # MONITOREO_BAJA_EVENT_TYPE_ID=
app/config.py CHANGED
@@ -1,3 +1,6 @@
 
 
 
1
  from pydantic_settings import BaseSettings, SettingsConfigDict
2
 
3
 
@@ -8,6 +11,30 @@ class Settings(BaseSettings):
8
  extra="ignore",
9
  )
10
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
11
  # Base de datos (Supabase)
12
  supabase_url: str
13
  supabase_key: str
 
1
+ from typing import get_args
2
+
3
+ from pydantic import model_validator
4
  from pydantic_settings import BaseSettings, SettingsConfigDict
5
 
6
 
 
11
  extra="ignore",
12
  )
13
 
14
+ @model_validator(mode="before")
15
+ @classmethod
16
+ def _blank_non_str_env_vars_fall_back_to_default(cls, data):
17
+ """
18
+ Una variable de entorno declarada pero vacía ("") llega a pydantic-settings
19
+ como si el usuario hubiese provisto ese valor, no como "no seteada" — para
20
+ un campo no-string (int, bool, int | None) eso rompe el arranque entero
21
+ (`ValidationError` en `Settings()`, que tira abajo `main.py` antes de
22
+ levantar cualquier endpoint). Ya pasó dos veces en producción: con los
23
+ `*_event_type_id` y con `RABBITMQ_PORT`/`RABBITMQ_CONSUMER_ENABLED`.
24
+
25
+ Para un campo no-string, "" nunca es un valor válido de todos modos —
26
+ tratarlo como ausente y caer al default declarado es siempre seguro. Los
27
+ campos `str` (`core_service_email`, `internal_tick_secret`, etc.) no se
28
+ tocan: para esos, `""` ya es su semántica normal de "no configurado".
29
+ """
30
+ if not isinstance(data, dict):
31
+ return data
32
+ cleaned = dict(data)
33
+ for name, field in cls.model_fields.items():
34
+ if cleaned.get(name) == "" and str not in (field.annotation, *get_args(field.annotation)):
35
+ cleaned.pop(name)
36
+ return cleaned
37
+
38
  # Base de datos (Supabase)
39
  supabase_url: str
40
  supabase_key: str
app/crud/cama.py CHANGED
@@ -61,6 +61,12 @@ def save(db: Client, cama: Cama) -> Cama:
61
  "contraindicaciones_incompatibles": cama.contraindicaciones_incompatibles,
62
  "ultima_actualizacion": cama.ultima_actualizacion.isoformat() if cama.ultima_actualizacion else None,
63
  "ultimo_movimiento_tipo": cama.ultimo_movimiento_tipo,
 
 
 
 
 
 
64
  }
65
  db.table(_TABLE).update(updates).eq("id", cama.id).execute()
66
  return cama
 
61
  "contraindicaciones_incompatibles": cama.contraindicaciones_incompatibles,
62
  "ultima_actualizacion": cama.ultima_actualizacion.isoformat() if cama.ultima_actualizacion else None,
63
  "ultimo_movimiento_tipo": cama.ultimo_movimiento_tipo,
64
+ # Datos del episodio en curso (ver app/models/cama.py) — necesarios para el
65
+ # payload rico que pide M7 en notify_cama_lista.
66
+ "solicitud_hce_id": cama.solicitud_hce_id,
67
+ "fecha_ingreso": cama.fecha_ingreso.isoformat() if cama.fecha_ingreso else None,
68
+ "alta_tipo": cama.alta_tipo,
69
+ "alta_timestamp": cama.alta_timestamp.isoformat() if cama.alta_timestamp else None,
70
  }
71
  db.table(_TABLE).update(updates).eq("id", cama.id).execute()
72
  return cama
app/integrations/core_events.py CHANGED
@@ -18,7 +18,12 @@ from app.integrations._base import _post
18
  logger = logging.getLogger(__name__)
19
 
20
 
21
- def publish_event(event_type_id: int | None, payload: dict) -> bool:
 
 
 
 
 
22
  if event_type_id is None:
23
  logger.info(
24
  "Evento no publicado (event_type_id todavía no configurado): %s", payload
@@ -27,7 +32,7 @@ def publish_event(event_type_id: int | None, payload: dict) -> bool:
27
 
28
  body = {
29
  "event_type_id": event_type_id,
30
- "publisher_module": "internacion",
31
  "payload": json.dumps(payload),
32
  }
33
  return _post(f"{settings.m10_core_url}/events/log", body) is not None
 
18
  logger = logging.getLogger(__name__)
19
 
20
 
21
+ def publish_event(event_type_id: int | None, payload: dict, publisher_module: str = "internacion") -> bool:
22
+ """
23
+ `publisher_module` default `"internacion"` para los eventos que M1/M9 todavía no
24
+ documentaron con un valor propio. M7 sí lo confirmó por escrito: espera
25
+ `"modulo_6"` (ver `app/integrations/facturacion.py::notify_cama_lista`).
26
+ """
27
  if event_type_id is None:
28
  logger.info(
29
  "Evento no publicado (event_type_id todavía no configurado): %s", payload
 
32
 
33
  body = {
34
  "event_type_id": event_type_id,
35
+ "publisher_module": publisher_module,
36
  "payload": json.dumps(payload),
37
  }
38
  return _post(f"{settings.m10_core_url}/events/log", body) is not None
app/integrations/facturacion.py CHANGED
@@ -1,42 +1,65 @@
1
  """
2
- M7 Facturación — notificación de cama lista para facturar.
3
 
4
- M6 solo informa el evento mínimo de "cama lista" (`POST /api/v1/webhooks/internacion/cama-lista`).
5
- NO enviamos datos del episodio (id de episodio, cobertura, actos médicos): esos los obtiene
6
- M7 directamente de M1/HCE. M6 no actúa de intermediario de esa información.
 
 
 
 
7
  """
8
  from datetime import date, datetime, timezone
9
 
10
  from app.config import settings
11
  from app.integrations import core_events
12
  from app.integrations._base import _post
 
13
 
14
 
15
- def notify_cama_lista(cama_id: int, paciente_id: int) -> bool:
16
  """
17
- Avisa a M7 que una cama quedó lista tras un alta.
 
18
 
19
- `idEventoExterno` es la clave de idempotencia que usa M7: la derivamos de forma estable
20
  (cama + paciente + fecha del alta) para que un reintento del mismo evento no genere un
21
  alta duplicada en facturación.
22
 
23
- Además del webhook REST directo (sin cambios), publica el mismo evento al bus del Core
24
- (CAMA_LISTA) vía `core_events.publish_event`. Es un no-op mientras
25
- `facturacion_cama_lista_event_type_id` no esté configurado — M7 todavía no compartió
26
- su `event_type_id` real (ver `M6_DISEÑO.md` §7).
27
  """
28
  if settings.mock_external_services:
29
  return True
30
- id_evento_externo = f"M6-CAMA-LISTA-{cama_id}-{paciente_id}-{date.today().isoformat()}"
31
- payload = {
 
 
 
32
  "evento": "CAMA_LISTA",
33
  "idEventoExterno": id_evento_externo,
34
- "cama_id": cama_id,
35
  "paciente_id": paciente_id,
36
  "timestamp_evento": datetime.now(timezone.utc).isoformat(),
37
  }
38
  ok_rest = _post(
39
- f"{settings.m7_facturacion_url}/api/v1/webhooks/internacion/cama-lista", payload
40
  ) is not None
41
- core_events.publish_event(settings.facturacion_cama_lista_event_type_id, payload)
 
 
 
 
 
 
 
 
 
 
 
 
 
 
42
  return ok_rest
 
1
  """
2
+ M7 Facturación — notificación de cierre de internación para facturar.
3
 
4
+ Dos canales, con payloads DISTINTOS (ver `notify_cama_lista`):
5
+ - REST directo (`POST /api/v1/webhooks/internacion/cama-lista`): fallback/testing manual
6
+ según M7 (`documentation/integrations/M7_integration.md`) — payload mínimo, sin cambios.
7
+ - Evento del Core (`facturacion.internacion.cama-lista.requested`, `event_type_id=19`):
8
+ la integración final confirmada por M7 — payload rico (`CIERRE_INTERNACION`), con datos
9
+ del episodio que M6 empezó a persistir en la propia fila de `Cama` (ver
10
+ `app/models/cama.py`) precisamente para poder armar este evento.
11
  """
12
  from datetime import date, datetime, timezone
13
 
14
  from app.config import settings
15
  from app.integrations import core_events
16
  from app.integrations._base import _post
17
+ from app.models.cama import Cama
18
 
19
 
20
+ def notify_cama_lista(cama: Cama) -> bool:
21
  """
22
+ Avisa a M7 que una cama quedó lista tras un alta — cierra la internación del lado de
23
+ facturación.
24
 
25
+ `idEventoExterno` es la clave de idempotencia que usa M7: se deriva de forma estable
26
  (cama + paciente + fecha del alta) para que un reintento del mismo evento no genere un
27
  alta duplicada en facturación.
28
 
29
+ El payload del evento del Core incluye `idEpisodioExterno: None` a propósito: M1
30
+ todavía no lo provee en `AltaMedicaWebhook` (pendiente de coordinar — ver
31
+ `M6_DISEÑO.md` §14 y `documentation/M6_INTEGRACION_M1_HCE.md`). M7 confirmó que sin
32
+ ese dato el evento queda pendiente de completar del lado de ellos, no se rechaza.
33
  """
34
  if settings.mock_external_services:
35
  return True
36
+
37
+ paciente_id = cama.paciente_id or 0
38
+ id_evento_externo = f"M6-CIERRE-INT-{cama.id}-{paciente_id}-{date.today().isoformat()}"
39
+
40
+ payload_rest = {
41
  "evento": "CAMA_LISTA",
42
  "idEventoExterno": id_evento_externo,
43
+ "cama_id": cama.id,
44
  "paciente_id": paciente_id,
45
  "timestamp_evento": datetime.now(timezone.utc).isoformat(),
46
  }
47
  ok_rest = _post(
48
+ f"{settings.m7_facturacion_url}/api/v1/webhooks/internacion/cama-lista", payload_rest
49
  ) is not None
50
+
51
+ payload_evento = {
52
+ "evento": "CIERRE_INTERNACION",
53
+ "idEventoExterno": id_evento_externo,
54
+ "idInternacionExterna": cama.solicitud_hce_id,
55
+ "idEpisodioExterno": None, # bloqueante externo — ver docstring
56
+ "idPacienteExterno": str(paciente_id),
57
+ "fechaIngreso": cama.fecha_ingreso.isoformat() if cama.fecha_ingreso else None,
58
+ "fechaAlta": cama.alta_timestamp.isoformat() if cama.alta_timestamp else None,
59
+ "tipoAlta": cama.alta_tipo,
60
+ "timestampEvento": datetime.now(timezone.utc).isoformat(),
61
+ }
62
+ core_events.publish_event(
63
+ settings.facturacion_cama_lista_event_type_id, payload_evento, publisher_module="modulo_6"
64
+ )
65
  return ok_rest
app/integrations/rabbit_consumer.py CHANGED
@@ -41,7 +41,7 @@ def _handle_solicitud(db: Client, payload: dict) -> None:
41
 
42
  def _handle_alta_medica(db: Client, payload: dict) -> None:
43
  data = AltaMedicaWebhook.model_validate(payload)
44
- solicitud_service.procesar_alta_medica(db, data.paciente_id)
45
 
46
 
47
  def _handle_alerta_emergencia(db: Client, payload: dict) -> None:
 
41
 
42
  def _handle_alta_medica(db: Client, payload: dict) -> None:
43
  data = AltaMedicaWebhook.model_validate(payload)
44
+ solicitud_service.procesar_alta_medica(db, data)
45
 
46
 
47
  def _handle_alerta_emergencia(db: Client, payload: dict) -> None:
app/models/cama.py CHANGED
@@ -26,6 +26,10 @@ class Cama:
26
  contraindicaciones_incompatibles: Optional[list] = None,
27
  ultima_actualizacion: Optional[datetime] = None,
28
  ultimo_movimiento_tipo: Optional[str] = None,
 
 
 
 
29
  ):
30
  self.id = id
31
  self.numero = numero
@@ -39,6 +43,14 @@ class Cama:
39
  self.contraindicaciones_incompatibles = contraindicaciones_incompatibles or []
40
  self.ultima_actualizacion = _parse_dt(ultima_actualizacion)
41
  self.ultimo_movimiento_tipo = ultimo_movimiento_tipo
 
 
 
 
 
 
 
 
42
 
43
  @classmethod
44
  def from_dict(cls, d: dict) -> "Cama":
@@ -55,4 +67,8 @@ class Cama:
55
  contraindicaciones_incompatibles=d.get("contraindicaciones_incompatibles") or [],
56
  ultima_actualizacion=d.get("ultima_actualizacion"),
57
  ultimo_movimiento_tipo=d.get("ultimo_movimiento_tipo"),
 
 
 
 
58
  )
 
26
  contraindicaciones_incompatibles: Optional[list] = None,
27
  ultima_actualizacion: Optional[datetime] = None,
28
  ultimo_movimiento_tipo: Optional[str] = None,
29
+ solicitud_hce_id: Optional[str] = None,
30
+ fecha_ingreso: Optional[datetime] = None,
31
+ alta_tipo: Optional[str] = None,
32
+ alta_timestamp: Optional[datetime] = None,
33
  ):
34
  self.id = id
35
  self.numero = numero
 
43
  self.contraindicaciones_incompatibles = contraindicaciones_incompatibles or []
44
  self.ultima_actualizacion = _parse_dt(ultima_actualizacion)
45
  self.ultimo_movimiento_tipo = ultimo_movimiento_tipo
46
+ # Datos del episodio en curso — no hay tabla `episodios` separada; viajan en la
47
+ # propia fila de la cama entre el momento en que ocurren (asignación, alta médica)
48
+ # y el momento en que se necesitan (notify_cama_lista, al completar la limpieza).
49
+ # Ver M6_DISEÑO.md §7.2/§14 (integración real con M7).
50
+ self.solicitud_hce_id = solicitud_hce_id
51
+ self.fecha_ingreso = _parse_dt(fecha_ingreso)
52
+ self.alta_tipo = alta_tipo
53
+ self.alta_timestamp = _parse_dt(alta_timestamp)
54
 
55
  @classmethod
56
  def from_dict(cls, d: dict) -> "Cama":
 
67
  contraindicaciones_incompatibles=d.get("contraindicaciones_incompatibles") or [],
68
  ultima_actualizacion=d.get("ultima_actualizacion"),
69
  ultimo_movimiento_tipo=d.get("ultimo_movimiento_tipo"),
70
+ solicitud_hce_id=d.get("solicitud_hce_id"),
71
+ fecha_ingreso=d.get("fecha_ingreso"),
72
+ alta_tipo=d.get("alta_tipo"),
73
+ alta_timestamp=d.get("alta_timestamp"),
74
  )
app/routers/webhooks.py CHANGED
@@ -58,7 +58,7 @@ def recibir_alta_medica(
58
  db: Client = Depends(get_db),
59
  user: dict = Depends(get_current_user),
60
  ):
61
- cama = solicitud_service.procesar_alta_medica(db, data.paciente_id)
62
  return {
63
  "mensaje": "Alta médica procesada. Cama en limpieza.",
64
  "cama_id": cama.id,
 
58
  db: Client = Depends(get_db),
59
  user: dict = Depends(get_current_user),
60
  ):
61
+ cama = solicitud_service.procesar_alta_medica(db, data)
62
  return {
63
  "mensaje": "Alta médica procesada. Cama en limpieza.",
64
  "cama_id": cama.id,
app/services/cama_service.py CHANGED
@@ -142,9 +142,15 @@ def update_cama(
142
  and nuevo_estado == EstadoCamaEnum.DISPONIBLE.value
143
  and cama.ultimo_movimiento_tipo == "ALTA"
144
  ):
145
- facturacion.notify_cama_lista(cama_id=cama.id, paciente_id=cama.paciente_id or 0)
146
  cama.paciente_id = None
147
  cama.ultimo_movimiento_tipo = None
 
 
 
 
 
 
148
  elif nuevo_estado == EstadoCamaEnum.DISPONIBLE.value and cama.paciente_id:
149
  cama.paciente_id = None
150
  cama.ultimo_movimiento_tipo = None
 
142
  and nuevo_estado == EstadoCamaEnum.DISPONIBLE.value
143
  and cama.ultimo_movimiento_tipo == "ALTA"
144
  ):
145
+ facturacion.notify_cama_lista(cama)
146
  cama.paciente_id = None
147
  cama.ultimo_movimiento_tipo = None
148
+ # Cierra el episodio: estos datos no deben arrastrarse al próximo paciente
149
+ # que ocupe esta cama.
150
+ cama.solicitud_hce_id = None
151
+ cama.fecha_ingreso = None
152
+ cama.alta_tipo = None
153
+ cama.alta_timestamp = None
154
  elif nuevo_estado == EstadoCamaEnum.DISPONIBLE.value and cama.paciente_id:
155
  cama.paciente_id = None
156
  cama.ultimo_movimiento_tipo = None
app/services/solicitud_service.py CHANGED
@@ -9,7 +9,7 @@ from supabase import Client
9
  from app.models.solicitud import Solicitud
10
  from app.models.cama import Cama
11
  from app.models.reserva import ReservaQuirofano
12
- from app.schemas.solicitud import SolicitudHceWebhook, SolicitudResolucionRequest
13
  from app.schemas.enums import EstadoCamaEnum, EstadoReservaEnum
14
  from app.crud import solicitud as solicitud_crud
15
  from app.crud import cama as cama_crud
@@ -197,6 +197,10 @@ def _aprobar_internacion(
197
 
198
  cama.estado = EstadoCamaEnum.OCUPADA.value
199
  cama.paciente_id = sol.paciente_id
 
 
 
 
200
  cama.ultima_actualizacion = datetime.now(timezone.utc)
201
  cama_crud.save(db, cama)
202
 
@@ -262,10 +266,20 @@ def _aprobar_traslado(
262
 
263
  if sol.cama_origen_id:
264
  cama_origen = _get_cama_or_404(db, sol.cama_origen_id)
 
 
 
 
 
265
  cama_origen.estado = EstadoCamaEnum.EN_LIMPIEZA.value
266
  cama_origen.ultimo_movimiento_tipo = "TRASLADO"
267
  cama_origen.ultima_actualizacion = datetime.now(timezone.utc)
268
  cama_crud.save(db, cama_origen)
 
 
 
 
 
269
 
270
  cama_destino.estado = EstadoCamaEnum.OCUPADA.value
271
  cama_destino.paciente_id = sol.paciente_id
@@ -316,7 +330,8 @@ def _aprobar_traslado(
316
 
317
  # ─── Alta médica (desde HCE M1) ────────────────────────────────────────────
318
 
319
- def procesar_alta_medica(db: Client, paciente_id: int) -> Cama:
 
320
  cama = cama_crud.get_by_paciente(db, paciente_id, ["OCUPADA", "CODIGO_ROJO"])
321
  if not cama:
322
  raise HTTPException(
@@ -332,6 +347,11 @@ def procesar_alta_medica(db: Client, paciente_id: int) -> Cama:
332
  estado_previo = cama.estado
333
  cama.estado = EstadoCamaEnum.EN_LIMPIEZA.value
334
  cama.ultimo_movimiento_tipo = "ALTA"
 
 
 
 
 
335
  cama.ultima_actualizacion = datetime.now(timezone.utc)
336
  cama_crud.save(db, cama)
337
  auditoria_crud.registrar(
 
9
  from app.models.solicitud import Solicitud
10
  from app.models.cama import Cama
11
  from app.models.reserva import ReservaQuirofano
12
+ from app.schemas.solicitud import SolicitudHceWebhook, SolicitudResolucionRequest, AltaMedicaWebhook
13
  from app.schemas.enums import EstadoCamaEnum, EstadoReservaEnum
14
  from app.crud import solicitud as solicitud_crud
15
  from app.crud import cama as cama_crud
 
197
 
198
  cama.estado = EstadoCamaEnum.OCUPADA.value
199
  cama.paciente_id = sol.paciente_id
200
+ # Datos del episodio en curso (ver app/models/cama.py) — necesarios más adelante
201
+ # para el payload rico que pide M7 al cerrarse la internación (notify_cama_lista).
202
+ cama.solicitud_hce_id = sol.solicitud_hce_id
203
+ cama.fecha_ingreso = datetime.now(timezone.utc)
204
  cama.ultima_actualizacion = datetime.now(timezone.utc)
205
  cama_crud.save(db, cama)
206
 
 
266
 
267
  if sol.cama_origen_id:
268
  cama_origen = _get_cama_or_404(db, sol.cama_origen_id)
269
+ # El episodio (fecha de ingreso, id de la internación original) es continuo a
270
+ # través de un traslado — se hereda de la cama origen, no de esta solicitud de
271
+ # traslado, para no perder el dato real de cuándo empezó la internación.
272
+ cama_destino.solicitud_hce_id = cama_origen.solicitud_hce_id
273
+ cama_destino.fecha_ingreso = cama_origen.fecha_ingreso
274
  cama_origen.estado = EstadoCamaEnum.EN_LIMPIEZA.value
275
  cama_origen.ultimo_movimiento_tipo = "TRASLADO"
276
  cama_origen.ultima_actualizacion = datetime.now(timezone.utc)
277
  cama_crud.save(db, cama_origen)
278
+ else:
279
+ # Traslado sin cama origen registrada (caso atípico) — se trata como un ingreso
280
+ # nuevo a los fines del episodio.
281
+ cama_destino.solicitud_hce_id = sol.solicitud_hce_id
282
+ cama_destino.fecha_ingreso = datetime.now(timezone.utc)
283
 
284
  cama_destino.estado = EstadoCamaEnum.OCUPADA.value
285
  cama_destino.paciente_id = sol.paciente_id
 
330
 
331
  # ─── Alta médica (desde HCE M1) ────────────────────────────────────────────
332
 
333
+ def procesar_alta_medica(db: Client, data: AltaMedicaWebhook) -> Cama:
334
+ paciente_id = data.paciente_id
335
  cama = cama_crud.get_by_paciente(db, paciente_id, ["OCUPADA", "CODIGO_ROJO"])
336
  if not cama:
337
  raise HTTPException(
 
347
  estado_previo = cama.estado
348
  cama.estado = EstadoCamaEnum.EN_LIMPIEZA.value
349
  cama.ultimo_movimiento_tipo = "ALTA"
350
+ # Datos del episodio en curso (ver app/models/cama.py) — necesarios para el payload
351
+ # rico que pide M7 en notify_cama_lista, que se dispara recién al completar la
352
+ # limpieza (un paso posterior y separado en el tiempo de este alta médica).
353
+ cama.alta_tipo = data.tipo_alta.value
354
+ cama.alta_timestamp = data.timestamp
355
  cama.ultima_actualizacion = datetime.now(timezone.utc)
356
  cama_crud.save(db, cama)
357
  auditoria_crud.registrar(
documentation/M6_DISEÑO.md CHANGED
@@ -243,12 +243,34 @@ Margen de precisión aceptable: con un cron cada 1–5 minutos, una cirugía pue
243
 
244
  ### 7.2 Webhooks salientes (M6 → otros módulos)
245
 
246
- | Evento | Receptor | Endpoint receptor | Cuándo |
247
  |--------|----------|-------------------|--------|
248
- | `SOLICITUD_RESUELTA` | M1 HCE | `POST /hce/solicitudes/{solicitudHceId}/resultado` | Al aprobar o rechazar una solicitud |
249
- | `ALTA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/alta-monitoreo` | Al asignar cama (ingreso o destino de traslado) |
250
- | `BAJA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/baja-monitoreo` | Al dar el alta o al trasladar (cama origen) |
251
- | `CAMA_LISTA` | M7 Facturación | `POST /webhooks/internacion/cama-lista` | Al completar limpieza post-alta (`EN_LIMPIEZA → DISPONIBLE`) |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
252
 
253
  ### 7.3 APIs externas consumidas (REST sincrónico)
254
 
@@ -382,10 +404,9 @@ Ambas tablas necesitan una policy RLS de `SELECT` abierta (`USING (true)`) para
382
 
383
  ## 10. Persistencia
384
 
385
- Tablas principales en PostgreSQL (Supabase): `camas` (incluye quirófanos), `reservas_quirofano`, `solicitudes`, `episodios`, `auditoria`.
386
 
387
- - **`camas`** guarda también los quirófanos (`sector=QUIROFANO`, `tipo=CIRUGIA`). Es la decisión de modelo que explica que `QuirofanoResponse.estado` use `EstadoCamaEnum` y que `ReservaQuirofanoResponse` referencie la cama. Alternativa rechazada: tabla `quirofanos` separada, que duplicaría la máquina de estados de disponibilidad.
388
- - **`episodios`** referencia al paciente y mantiene la lista de camas atravesadas para el reporte a Facturación.
389
  - **`auditoria`** es el log append-only de auditoría de `CAMA`/`SOLICITUD`/`RESERVA_QUIROFANO`, instrumentado explícitamente en la capa de servicios (no triggers, no middleware) para capturar el actor del JWT y el contexto de negocio completo. Registrar un evento es *best-effort*: nunca propaga una excepción que rompa la operación de negocio. Habilitada para Supabase Realtime (§9). Modelo completo, enums y puntos de instrumentación en `docs/superpowers/specs/2026-06-26-auditoria-cama-design.md`.
390
  - La asignación de cama (validar `DISPONIBLE` → set `OCUPADA` + `paciente_id`) se hace en una transacción con bloqueo de fila para evitar doble ocupación.
391
 
@@ -515,3 +536,13 @@ No hay lookup aparte (`GET /roles`, `GET /users/{id}`) ni verificación de JWT d
515
 
516
  36. **Nuevo `cama_service.procesar_transiciones_automaticas`** (§5.4): avanza `RESERVADA→EN_CURSO` y `EN_CURSO→COMPLETADA` según `fecha_hora_inicio`/`fecha_hora_fin_estimada`, reusando `update_reserva_estado` — mismos side-effects que la transición manual, cero lógica de negocio duplicada. Nuevas queries `reserva_crud.get_pendientes_de_inicio`/`get_pendientes_de_fin`.
517
  37. **Nuevo endpoint `POST /api/v1/internal/reservas/tick`** (`app/routers/internal.py`), protegido con secreto compartido (`settings.internal_tick_secret`, header `X-Internal-Token`) en vez de JWT de sesión — no hay usuario humano detrás de un cron. Pensado para dispararse desde un cron externo (GitHub Actions/cron-job.org), no un scheduler en memoria: el deploy en HF Spaces (tier gratuito) duerme el contenedor tras inactividad, y un loop interno se congelaría con él. Verificado en vivo contra la base real: primer tick transicionó reservas vencidas (`{"iniciadas":7,"completadas":7}`), el segundo tick inmediato confirmó la idempotencia (`{"iniciadas":0,"completadas":0}`).
 
 
 
 
 
 
 
 
 
 
 
243
 
244
  ### 7.2 Webhooks salientes (M6 → otros módulos)
245
 
246
+ | Evento | Receptor | Endpoint receptor / evento del bus | Cuándo |
247
  |--------|----------|-------------------|--------|
248
+ | `SOLICITUD_RESUELTA` | M1 HCE | `POST /hce/solicitudes/{solicitudHceId}/resultado` (REST); evento pendiente de `event_type_id` de M1 | Al aprobar o rechazar una solicitud |
249
+ | `ALTA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/alta-monitoreo` (REST); evento pendiente de `event_type_id` de M9 | Al asignar cama (ingreso o destino de traslado) |
250
+ | `BAJA_MONITOREO` | M9 Monitoreo | `POST /webhooks/internacion/baja-monitoreo` (REST); evento pendiente de `event_type_id` de M9 | Al dar el alta o al trasladar (cama origen) |
251
+ | `CAMA_LISTA` / `CIERRE_INTERNACION` | M7 Facturación | `POST /webhooks/internacion/cama-lista` (REST, fallback/testing); evento `facturacion.internacion.cama-lista.requested` (`event_type_id=19`, activo) | Al completar limpieza post-alta (`EN_LIMPIEZA → DISPONIBLE`) |
252
+
253
+ **M7 confirmó su integración por escrito** (`documentation/integrations/M7_integration.md`):
254
+ cola `facturacion.requests`, `event_type_id: 19`, `publisher_module: "modulo_6"`. El
255
+ payload del evento es mucho más rico que el REST (que sigue siendo solo el mínimo de
256
+ siempre): `{evento: CIERRE_INTERNACION, idEventoExterno, idInternacionExterna,
257
+ idEpisodioExterno, idPacienteExterno, fechaIngreso, fechaAlta, tipoAlta, timestampEvento}`
258
+ (`app/integrations/facturacion.py::notify_cama_lista`). `timestampEvento` es obligatorio
259
+ por contrato — M7 rechaza el evento si falta.
260
+
261
+ Para armar ese payload, M6 empezó a persistir datos del episodio en curso directamente en
262
+ la fila de `Cama` (`solicitud_hce_id`, `fecha_ingreso`, `alta_tipo`, `alta_timestamp` —
263
+ ver `app/models/cama.py`), seteados al aprobar la solicitud y al procesar el alta médica,
264
+ y limpiados al cerrar el episodio (`cama_service.py`, tras `notify_cama_lista`). En un
265
+ traslado, el episodio (fecha de ingreso e id de internación original) se **hereda de la
266
+ cama origen**, no de la solicitud de traslado — es la misma internación, solo cambió de
267
+ cama física.
268
+
269
+ **`idEpisodioExterno` viaja como `None`, a propósito:** ningún webhook de M1 lo provee hoy
270
+ (ni `SolicitudHceWebhook` ni `AltaMedicaWebhook` tienen ese campo). Pendiente coordinar
271
+ con M1 que lo agregue a `AltaMedicaWebhook` — ver `documentation/M6_INTEGRACION_M1_HCE.md`.
272
+ M7 confirmó que sin ese dato el evento no se rechaza, queda pendiente de completar del
273
+ lado de ellos.
274
 
275
  ### 7.3 APIs externas consumidas (REST sincrónico)
276
 
 
404
 
405
  ## 10. Persistencia
406
 
407
+ Tablas principales en PostgreSQL (Supabase): `camas` (incluye quirófanos), `reservas_quirofano`, `solicitudes`, `auditoria`.
408
 
409
+ - **`camas`** guarda también los quirófanos (`sector=QUIROFANO`, `tipo=CIRUGIA`). Es la decisión de modelo que explica que `QuirofanoResponse.estado` use `EstadoCamaEnum` y que `ReservaQuirofanoResponse` referencie la cama. Alternativa rechazada: tabla `quirofanos` separada, que duplicaría la máquina de estados de disponibilidad. Además de sus columnas originales, `camas` guarda los datos del **episodio en curso** (`solicitud_hce_id`, `fecha_ingreso`, `alta_tipo`, `alta_timestamp`) — necesarios para el payload rico que M7 pide al cerrar la internación (§7.2, §14). Se setean al aprobar la solicitud y al procesar el alta médica, y se limpian al notificar a M7. Decisión: no se creó una tabla `episodios` separada (mencionada en versiones previas de este documento como plan, nunca implementada) — para el alcance actual (una cama activa = un episodio en curso, sin necesidad de historizar episodios pasados) alcanza con estas columnas en `camas`, siguiendo el mismo patrón ya usado por `ultimo_movimiento_tipo`.
 
410
  - **`auditoria`** es el log append-only de auditoría de `CAMA`/`SOLICITUD`/`RESERVA_QUIROFANO`, instrumentado explícitamente en la capa de servicios (no triggers, no middleware) para capturar el actor del JWT y el contexto de negocio completo. Registrar un evento es *best-effort*: nunca propaga una excepción que rompa la operación de negocio. Habilitada para Supabase Realtime (§9). Modelo completo, enums y puntos de instrumentación en `docs/superpowers/specs/2026-06-26-auditoria-cama-design.md`.
411
  - La asignación de cama (validar `DISPONIBLE` → set `OCUPADA` + `paciente_id`) se hace en una transacción con bloqueo de fila para evitar doble ocupación.
412
 
 
536
 
537
  36. **Nuevo `cama_service.procesar_transiciones_automaticas`** (§5.4): avanza `RESERVADA→EN_CURSO` y `EN_CURSO→COMPLETADA` según `fecha_hora_inicio`/`fecha_hora_fin_estimada`, reusando `update_reserva_estado` — mismos side-effects que la transición manual, cero lógica de negocio duplicada. Nuevas queries `reserva_crud.get_pendientes_de_inicio`/`get_pendientes_de_fin`.
538
  37. **Nuevo endpoint `POST /api/v1/internal/reservas/tick`** (`app/routers/internal.py`), protegido con secreto compartido (`settings.internal_tick_secret`, header `X-Internal-Token`) en vez de JWT de sesión — no hay usuario humano detrás de un cron. Pensado para dispararse desde un cron externo (GitHub Actions/cron-job.org), no un scheduler en memoria: el deploy en HF Spaces (tier gratuito) duerme el contenedor tras inactividad, y un loop interno se congelaría con él. Verificado en vivo contra la base real: primer tick transicionó reservas vencidas (`{"iniciadas":7,"completadas":7}`), el segundo tick inmediato confirmó la idempotencia (`{"iniciadas":0,"completadas":0}`).
539
+
540
+ ### 14.9 Integración real con M7: evento `facturacion.internacion.cama-lista.requested` (2026-07)
541
+
542
+ 38. **M7 confirmó su integración por escrito** (`documentation/integrations/M7_integration.md`): cola `facturacion.requests`, `event_type_id: 19` (activado en config, ya no `None`), `publisher_module: "modulo_6"`. Verificado en vivo: `POST /events/log` contra el Core real con este `event_type_id` devuelve `201`.
543
+ 39. **Payload rico, distinto del REST.** El evento del Core lleva `{evento: CIERRE_INTERNACION, idEventoExterno, idInternacionExterna, idEpisodioExterno, idPacienteExterno, fechaIngreso, fechaAlta, tipoAlta, timestampEvento}` — mucho más rico que el REST de siempre (que M7 documenta como fallback/testing manual y no cambió). `notify_cama_lista` ahora arma **dos payloads distintos** para los dos canales (`app/integrations/facturacion.py`).
544
+ 40. **Nuevas columnas en `camas`: `solicitud_hce_id`, `fecha_ingreso`, `alta_tipo`, `alta_timestamp`** (§10). Sin esto, M6 no tenía cómo reconstruir el payload rico en el momento de `notify_cama_lista` — esos datos ocurrían antes (aprobación de solicitud, alta médica) y se perdían. Se setean en `_aprobar_internacion`/`_aprobar_traslado`/`procesar_alta_medica` y se limpian al cerrar el episodio. En un traslado, se heredan de la cama origen (mismo episodio), no de la solicitud de traslado.
545
+ 41. **`core_events.publish_event` gana el parámetro `publisher_module`** (default `"internacion"`, sin cambiar los otros 3 call sites de M1/M9). M7 es el primero en confirmar por escrito que espera `"modulo_6"`.
546
+ 42. **`solicitud_service.procesar_alta_medica` cambia de firma**: recibe el `AltaMedicaWebhook` completo en vez de solo `paciente_id`, para poder persistir `tipo_alta`/`timestamp` en la cama. Actualizados los dos call sites (`app/routers/webhooks.py`, `app/integrations/rabbit_consumer.py`).
547
+ 43. **Bloqueante externo, documentado explícitamente: `idEpisodioExterno` viaja como `None`.** Ningún webhook de M1 provee ese dato hoy. Pendiente coordinar con M1 que lo agregue a `AltaMedicaWebhook` (ver `documentation/M6_INTEGRACION_M1_HCE.md`). Confirmado con M7 (vía su documentación) que el evento no se rechaza por esto — queda pendiente de completar de su lado.
548
+ 44. **Revierte parcialmente la decisión del changelog #14** ("M6 no es intermediario del episodio... no enviamos idEpisodioExterno"). Esa decisión asumía que el payload rico era una recomendación opcional de M7; ahora M7 confirmó por escrito que es el contrato real de la integración final, no una opción descartable.
documentation/M6_EVENTOS_RABBITMQ.md CHANGED
@@ -149,23 +149,31 @@ La deduplicación por id de origen (`solicitud_hce_id`, etc., exigida en `M6_DIS
149
 
150
  ## 7. Lado saliente: el publisher (`app/integrations/core_events.py`)
151
 
152
- `publish_event(event_type_id: int | None, payload: dict) -> bool`:
153
 
154
  - Si `event_type_id is None` → **no-op**: loguea a nivel `info` y devuelve `True`, sin ningún request HTTP.
155
- - Si hay un id configurado → `POST /events/log` real contra el Core (`{"event_type_id", "publisher_module": "internacion", "payload": json.dumps(payload)}`).
156
 
157
- Los 4 puntos de notificación saliente de M6 (`M6_DISEÑO.md` §7.2) hacen **dual-write**: siguen llamando al webhook REST directo exactamente como antes, y además llaman a `publish_event`:
158
 
159
- | Función | Notificación | Receptor | Config del `event_type_id` |
160
- |---|---|---|---|
161
- | `hce.notify_resultado_solicitud` | `SOLICITUD_RESUELTA` | M1 HCE | `hce_solicitud_resuelta_event_type_id` |
162
- | `monitoreo.notify_alta` | `ALTA_MONITOREO` | M9 Monitoreo | `monitoreo_alta_event_type_id` |
163
- | `monitoreo.notify_baja` | `BAJA_MONITOREO` | M9 Monitoreo | `monitoreo_baja_event_type_id` |
164
- | `facturacion.notify_cama_lista` | `CAMA_LISTA` | M7 Facturación | `facturacion_cama_lista_event_type_id` |
165
-
166
- Las 4 settings de la tercera columna arrancan en `None` (default) — **el evento y la cola de cada uno los crea y comparte el módulo receptor**, no M6 (misma regla que aplica al revés en §2.2). Hoy ninguno de los tres equipos compartió su id.
167
-
168
- **Cómo activar cuando llegue el id real:** cargar el valor en `.env` (o `.env.example` según el entorno) — cero cambios de código. A partir de ahí, la notificación sale por las dos vías (REST + bus) hasta que se coordine con ese equipo cuándo retirar la llamada REST directa.
 
 
 
 
 
 
 
 
169
 
170
  ---
171
 
@@ -180,11 +188,12 @@ RABBITMQ_VHOST=/
180
  INTERNACION_REQUESTS_QUEUE=internacion.requests
181
 
182
  # Publisher saliente — dejar comentado hasta tener el id real (pydantic-settings
183
- # no trata "KEY=" vacío como None, tira ValidationError si se descomenta sin valor)
 
184
  # HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=
185
  # MONITOREO_ALTA_EVENT_TYPE_ID=
186
  # MONITOREO_BAJA_EVENT_TYPE_ID=
187
- # FACTURACION_CAMA_LISTA_EVENT_TYPE_ID=
188
  ```
189
 
190
  Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) son `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD`, ya definidas para el resto de la integración con el Core — no hay settings de usuario/password nuevas para RabbitMQ.
@@ -196,7 +205,8 @@ Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) so
196
  - **Host/puerto/vhost reales del broker RabbitMQ compartido** — sin esto, `RABBITMQ_CONSUMER_ENABLED=true` no puede conectar. Único bloqueante para que el consumer corra contra el broker de verdad.
197
  - **`event_type_id` de M1** (`SOLICITUD_RESUELTA`) — compartir con M6 el id de un evento que M1 debe crear y bindear a su propia cola.
198
  - **`event_type_id` de M9** (`ALTA_MONITOREO`, `BAJA_MONITOREO`) ��� ídem, dos eventos que M9 debe crear.
199
- - **`event_type_id` de M7** (`CAMA_LISTA`) — ídem, un evento que M7 debe crear.
 
200
  - **Coordinar con M1/M9/M2 la migración de sus emisores** hacia los 5 eventos entrantes de §2.2, y una fecha de retiro de los webhooks REST equivalentes una vez confirmada.
201
  - **Cirugía urgente** (§5): decisión pendiente de si migrar a un patrón request/response por eventos, condicionada a acordar el evento de respuesta con M1.
202
 
 
149
 
150
  ## 7. Lado saliente: el publisher (`app/integrations/core_events.py`)
151
 
152
+ `publish_event(event_type_id: int | None, payload: dict, publisher_module: str = "internacion") -> bool`:
153
 
154
  - Si `event_type_id is None` → **no-op**: loguea a nivel `info` y devuelve `True`, sin ningún request HTTP.
155
+ - Si hay un id configurado → `POST /events/log` real contra el Core (`{"event_type_id", "publisher_module", "payload": json.dumps(payload)}`).
156
 
157
+ Los 4 puntos de notificación saliente de M6 (`M6_DISEÑO.md` §7.2) hacen **dual-write**: siguen llamando al webhook REST directo, y además llaman a `publish_event`:
158
 
159
+ | Función | Notificación | Receptor | Config del `event_type_id` | Estado |
160
+ |---|---|---|---|---|
161
+ | `hce.notify_resultado_solicitud` | `SOLICITUD_RESUELTA` | M1 HCE | `hce_solicitud_resuelta_event_type_id` | Pendiente — M1 no compartió su id |
162
+ | `monitoreo.notify_alta` | `ALTA_MONITOREO` | M9 Monitoreo | `monitoreo_alta_event_type_id` | Pendiente — M9 no compartió su id |
163
+ | `monitoreo.notify_baja` | `BAJA_MONITOREO` | M9 Monitoreo | `monitoreo_baja_event_type_id` | Pendiente — M9 no compartió su id |
164
+ | `facturacion.notify_cama_lista` | `CIERRE_INTERNACION` (`facturacion.internacion.cama-lista.requested`) | M7 Facturación | `facturacion_cama_lista_event_type_id` | **Activo — `event_type_id=19`, confirmado por escrito** |
165
+
166
+ El evento/cola de cada notificación lo crea y comparte el módulo receptor, no M6 (misma
167
+ regla que aplica al revés en §2.2). **M7 ya lo hizo** (`documentation/integrations/M7_integration.md`)
168
+ — es el primer caso activado, con `publisher_module: "modulo_6"` (los otros 3 siguen con
169
+ el default `"internacion"` hasta que M1/M9 documenten el suyo). Su payload es distinto
170
+ (más rico) del REST — ver `app/integrations/facturacion.py::notify_cama_lista` y
171
+ `M6_DISEÑO.md` §7.2/§14.9 para el detalle completo, incluido el bloqueante de
172
+ `idEpisodioExterno`.
173
+
174
+ **Cómo activar cuando llegue el id real (M1/M9):** cargar el valor en `.env` — cero
175
+ cambios de código. A partir de ahí, la notificación sale por las dos vías (REST + bus)
176
+ hasta que se coordine con ese equipo cuándo retirar la llamada REST directa.
177
 
178
  ---
179
 
 
188
  INTERNACION_REQUESTS_QUEUE=internacion.requests
189
 
190
  # Publisher saliente — dejar comentado hasta tener el id real (pydantic-settings
191
+ # no trata "KEY=" vacío como None, tira ValidationError si se descomenta sin valor).
192
+ # M7 ya confirmó el suyo por escrito — activo:
193
  # HCE_SOLICITUD_RESUELTA_EVENT_TYPE_ID=
194
  # MONITOREO_ALTA_EVENT_TYPE_ID=
195
  # MONITOREO_BAJA_EVENT_TYPE_ID=
196
+ FACTURACION_CAMA_LISTA_EVENT_TYPE_ID=19
197
  ```
198
 
199
  Las credenciales del broker (`login`/`password` en `aio_pika.connect_robust`) son `CORE_SERVICE_EMAIL`/`CORE_SERVICE_PASSWORD`, ya definidas para el resto de la integración con el Core — no hay settings de usuario/password nuevas para RabbitMQ.
 
205
  - **Host/puerto/vhost reales del broker RabbitMQ compartido** — sin esto, `RABBITMQ_CONSUMER_ENABLED=true` no puede conectar. Único bloqueante para que el consumer corra contra el broker de verdad.
206
  - **`event_type_id` de M1** (`SOLICITUD_RESUELTA`) — compartir con M6 el id de un evento que M1 debe crear y bindear a su propia cola.
207
  - **`event_type_id` de M9** (`ALTA_MONITOREO`, `BAJA_MONITOREO`) ��� ídem, dos eventos que M9 debe crear.
208
+ - ~~`event_type_id` de M7 (`CAMA_LISTA`)~~ — **resuelto**: M7 confirmó `event_type_id=19`, ya activo.
209
+ - **`episodio_id` de M1** — pendiente que M1 agregue este campo a `AltaMedicaWebhook` para poder completar `idEpisodioExterno` en el evento a M7 (hoy viaja `None`). Ver `M6_DISEÑO.md` §14.9 y `documentation/M6_INTEGRACION_M1_HCE.md`.
210
  - **Coordinar con M1/M9/M2 la migración de sus emisores** hacia los 5 eventos entrantes de §2.2, y una fecha de retiro de los webhooks REST equivalentes una vez confirmada.
211
  - **Cirugía urgente** (§5): decisión pendiente de si migrar a un patrón request/response por eventos, condicionada a acordar el evento de respuesta con M1.
212
 
documentation/M6_INTEGRACION_M1_HCE.md CHANGED
@@ -154,6 +154,25 @@ El schema no rechaza combinaciones cruzadas (por ejemplo, mandar campos de `TRAS
154
  | `medico_firmante_id` | integer | **sí** | Médico que firma el alta. |
155
  | `tipo_alta` | `ALTA_MEDICA`\|`ALTA_VOLUNTARIA`\|`TRASLADO_EXTERNO`\|`DEFUNCION` | **sí** | |
156
  | `timestamp` | string (ISO 8601, UTC) | **sí** | Momento del alta. |
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
157
 
158
  ---
159
 
 
154
  | `medico_firmante_id` | integer | **sí** | Médico que firma el alta. |
155
  | `tipo_alta` | `ALTA_MEDICA`\|`ALTA_VOLUNTARIA`\|`TRASLADO_EXTERNO`\|`DEFUNCION` | **sí** | |
156
  | `timestamp` | string (ISO 8601, UTC) | **sí** | Momento del alta. |
157
+ | `episodio_id` | string | **pedido nuevo, ver §4.3** | Id del episodio en M1 — hoy no se envía. |
158
+
159
+ ### 4.3 ⚠️ Pedido nuevo a M1: agregar `episodio_id` a este webhook
160
+
161
+ M7 (Facturación) confirmó su integración real con M6 y pide, para poder facturar,
162
+ `idEpisodioExterno` — el id del episodio clínico en M1. M6 no lo genera ni lo tiene de
163
+ ninguna otra fuente: hoy lo reenvía como `null` a M7 porque **ningún webhook de M1 lo
164
+ provee**.
165
+
166
+ **Pedido:** agregar el campo `episodio_id` (string) a `internacion.alta-medica.registrada`
167
+ (y a su REST equivalente, `POST /webhooks/hce/alta-medica`, si también lo actualizan ahí)
168
+ con el id del episodio que M1 ya maneja internamente. Elegimos el evento de **alta**
169
+ porque es el que efectivamente cierra el episodio — a diferencia del de solicitud, donde
170
+ el episodio recién se está por abrir.
171
+
172
+ Mientras esto no esté disponible, el flujo sigue funcionando igual (M7 confirmó que no
173
+ rechaza el evento por faltar este dato — lo deja pendiente de completar de su lado), pero
174
+ la facturación automática de M7 queda incompleta hasta que se resuelva. Ver
175
+ `M6_DISEÑO.md` §14.9 para el detalle completo del lado de M6.
176
 
177
  ---
178
 
documentation/integrations/M7_integration.md ADDED
@@ -0,0 +1,101 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ Buenas, ya dejamos desplegado el Módulo 7 y lista la integración para recibir el evento de Módulo 6 vía Core/RabbitMQ.
2
+
3
+ Datos generales de M7:
4
+
5
+ URL base pública:
6
+
7
+ ```txt
8
+ https://modulo7-backend.onrender.com
9
+ ```
10
+
11
+ Swagger:
12
+
13
+ ```txt
14
+ https://modulo7-backend.onrender.com/swagger-ui/index.html
15
+ ```
16
+
17
+ OpenAPI:
18
+
19
+ ```txt
20
+ https://modulo7-backend.onrender.com/v3/api-docs
21
+ ```
22
+
23
+ Para endpoints REST, la base es:
24
+
25
+ ```txt
26
+ https://modulo7-backend.onrender.com/api
27
+ ```
28
+
29
+ Para la integración M6 → M7, la forma principal va por eventos usando Core/Módulo 10.
30
+
31
+ Datos del evento creado en Core:
32
+
33
+ ```txt
34
+ event_name: facturacion.internacion.cama-lista.requested
35
+ event_type_id: 19
36
+ queue: facturacion.requests
37
+ publisher_module esperado: modulo_6
38
+ ```
39
+
40
+ Ustedes tienen que publicar el evento en Core usando:
41
+
42
+ ```http
43
+ POST https://api.healthcare.cantero.ar/events/log
44
+ Authorization: Bearer <token>
45
+ Content-Type: application/json
46
+ ```
47
+
48
+ Body de ejemplo:
49
+
50
+ ```json
51
+ {
52
+ "event_type_id": 19,
53
+ "publisher_module": "modulo_6",
54
+ "payload": "{\"evento\":\"CIERRE_INTERNACION\",\"idEventoExterno\":\"M6-CIERRE-INT-000123\",\"idInternacionExterna\":\"INT-000123\",\"idEpisodioExterno\":\"700\",\"idPacienteExterno\":\"10500\",\"fechaIngreso\":\"2026-06-20T14:30:00Z\",\"fechaAlta\":\"2026-06-25T10:00:00Z\",\"tipoAlta\":\"ALTA_MEDICA\",\"timestampEvento\":\"2026-06-25T10:05:00Z\"}"
55
+ }
56
+ ```
57
+
58
+ Importante: el campo `payload` tiene que viajar como string JSON, no como objeto JSON directo.
59
+
60
+ Payload interno recomendado:
61
+
62
+ ```json
63
+ {
64
+ "evento": "CIERRE_INTERNACION",
65
+ "idEventoExterno": "M6-CIERRE-INT-000123",
66
+ "idInternacionExterna": "INT-000123",
67
+ "idEpisodioExterno": "700",
68
+ "idPacienteExterno": "10500",
69
+ "fechaIngreso": "2026-06-20T14:30:00Z",
70
+ "fechaAlta": "2026-06-25T10:00:00Z",
71
+ "tipoAlta": "ALTA_MEDICA",
72
+ "timestampEvento": "2026-06-25T10:05:00Z"
73
+ }
74
+ ```
75
+
76
+ Campos mínimos que necesitamos para poder continuar el flujo:
77
+
78
+ ```txt
79
+ idPacienteExterno
80
+ idEpisodioExterno
81
+ idInternacionExterna
82
+ fechaIngreso
83
+ fechaAlta
84
+ tipoAlta
85
+ timestampEvento
86
+ ```
87
+
88
+ Con `idPacienteExterno` e `idEpisodioExterno`, M7 consulta a M1 para obtener cobertura, episodio y actos médicos. Después M7 factura usando su propio ABM de obras sociales, planes, convenios y nomenclador.
89
+
90
+ No necesitamos que M6 nos mande obra social, plan, convenio, precios, copagos ni montos. Eso lo resuelve M7.
91
+
92
+ Como fallback/manual testing, también dejamos estos endpoints REST disponibles:
93
+
94
+ ```http
95
+ POST https://modulo7-backend.onrender.com/api/v1/webhooks/internacion/cama-lista
96
+ POST https://modulo7-backend.onrender.com/api/integracion/internacion/cierre-episodio
97
+ ```
98
+
99
+ Pero para la integración final usemos el evento de Core con `event_type_id: 19`.
100
+
101
+ Detalle importante: si el evento viene sin `timestampEvento` o `timestamp_evento`, M7 lo rechaza porque es obligatorio por contrato.
tests/factories.py CHANGED
@@ -26,6 +26,10 @@ def make_cama(**overrides) -> SimpleNamespace:
26
  "contraindicaciones_incompatibles": [],
27
  "ultima_actualizacion": _NOW,
28
  "ultimo_movimiento_tipo": None,
 
 
 
 
29
  }
30
  data.update(overrides)
31
  return SimpleNamespace(**data)
 
26
  "contraindicaciones_incompatibles": [],
27
  "ultima_actualizacion": _NOW,
28
  "ultimo_movimiento_tipo": None,
29
+ "solicitud_hce_id": None,
30
+ "fecha_ingreso": None,
31
+ "alta_tipo": None,
32
+ "alta_timestamp": None,
33
  }
34
  data.update(overrides)
35
  return SimpleNamespace(**data)
tests/test_config.py ADDED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ """
2
+ Tests de `app/config.py::Settings._blank_non_str_env_vars_fall_back_to_default`.
3
+
4
+ Contexto real: dos incidentes en producción (HF Spaces) donde una env var declarada
5
+ pero vacía tiró abajo el arranque entero de la app (`ValidationError` en `Settings()`,
6
+ antes de que `main.py` llegue a levantar cualquier endpoint) — primero con los
7
+ `*_event_type_id`, después con `RABBITMQ_PORT`/`RABBITMQ_CONSUMER_ENABLED`.
8
+ """
9
+ from app.config import Settings
10
+
11
+ _REQUIRED = {"supabase_url": "https://x.supabase.co", "supabase_key": "x", "jwt_secret": "x"}
12
+
13
+
14
+ def test_int_vacio_cae_al_default():
15
+ s = Settings(**_REQUIRED, rabbitmq_port="")
16
+ assert s.rabbitmq_port == 5672
17
+
18
+
19
+ def test_bool_vacio_cae_al_default():
20
+ s = Settings(**_REQUIRED, rabbitmq_consumer_enabled="")
21
+ assert s.rabbitmq_consumer_enabled is False
22
+
23
+
24
+ def test_int_or_none_vacio_cae_a_none():
25
+ s = Settings(**_REQUIRED, facturacion_cama_lista_event_type_id="")
26
+ assert s.facturacion_cama_lista_event_type_id is None
27
+
28
+
29
+ def test_str_vacio_se_conserva_tal_cual():
30
+ """Para campos str, "" ya es la semántica normal de "no configurado" — no tocar."""
31
+ s = Settings(**_REQUIRED, core_service_email="")
32
+ assert s.core_service_email == ""
33
+
34
+
35
+ def test_int_con_valor_real_no_se_toca():
36
+ s = Settings(**_REQUIRED, rabbitmq_port="6672")
37
+ assert s.rabbitmq_port == 6672
38
+
39
+
40
+ def test_int_or_none_con_valor_real_no_se_toca():
41
+ s = Settings(**_REQUIRED, facturacion_cama_lista_event_type_id="19")
42
+ assert s.facturacion_cama_lista_event_type_id == 19
tests/test_core_events.py CHANGED
@@ -5,8 +5,11 @@ de que los 4 puntos de notificación (`hce.notify_resultado_solicitud`,
5
  mismo request REST que hoy, sin cambios observables, mientras el `event_type_id`
6
  correspondiente esté en `None` (default actual — ver `M6_DISEÑO.md` §7).
7
  """
 
 
8
  from app.config import settings
9
  from app.integrations import core_events, facturacion, hce, monitoreo
 
10
 
11
 
12
  # ─── publish_event: no-op mientras no haya event_type_id ──────────────────
@@ -122,24 +125,68 @@ def test_notify_baja_sigue_llamando_rest_igual_que_antes(monkeypatch):
122
  assert publish_calls[0][0] is None
123
 
124
 
125
- def test_notify_cama_lista_sigue_llamando_rest_igual_que_antes(monkeypatch):
 
126
  monkeypatch.setattr(settings, "mock_external_services", False)
127
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", None)
128
  rest_calls = []
129
- publish_calls = []
130
  monkeypatch.setattr(
131
  "app.integrations.facturacion._post",
132
  lambda url, payload: rest_calls.append((url, payload)) or {"ok": True},
133
  )
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
134
  monkeypatch.setattr(
135
  "app.integrations.core_events.publish_event",
136
- lambda event_type_id, payload: publish_calls.append((event_type_id, payload)) or True,
 
 
 
137
  )
138
 
139
- ok = facturacion.notify_cama_lista(cama_id=315, paciente_id=7)
 
 
 
 
 
 
 
 
 
140
 
141
- assert ok is True
142
- assert len(rest_calls) == 1
143
  assert len(publish_calls) == 1
144
- assert publish_calls[0][0] is None
145
- assert publish_calls[0][1]["cama_id"] == 315
 
 
 
 
 
 
 
 
 
 
5
  mismo request REST que hoy, sin cambios observables, mientras el `event_type_id`
6
  correspondiente esté en `None` (default actual — ver `M6_DISEÑO.md` §7).
7
  """
8
+ from datetime import datetime, timezone
9
+
10
  from app.config import settings
11
  from app.integrations import core_events, facturacion, hce, monitoreo
12
+ from tests.factories import make_cama
13
 
14
 
15
  # ─── publish_event: no-op mientras no haya event_type_id ──────────────────
 
125
  assert publish_calls[0][0] is None
126
 
127
 
128
+ def test_notify_cama_lista_sigue_llamando_rest_con_payload_minimo(monkeypatch):
129
+ """El REST directo es fallback/testing manual según M7 — payload mínimo, sin cambios."""
130
  monkeypatch.setattr(settings, "mock_external_services", False)
131
  monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", None)
132
  rest_calls = []
 
133
  monkeypatch.setattr(
134
  "app.integrations.facturacion._post",
135
  lambda url, payload: rest_calls.append((url, payload)) or {"ok": True},
136
  )
137
+ monkeypatch.setattr("app.integrations.core_events.publish_event", lambda *a, **k: True)
138
+
139
+ cama = make_cama(id=315, paciente_id=7)
140
+ ok = facturacion.notify_cama_lista(cama)
141
+
142
+ assert ok is True
143
+ assert len(rest_calls) == 1
144
+ url, payload = rest_calls[0]
145
+ assert url == f"{settings.m7_facturacion_url}/api/v1/webhooks/internacion/cama-lista"
146
+ assert payload == {
147
+ "evento": "CAMA_LISTA",
148
+ "idEventoExterno": payload["idEventoExterno"],
149
+ "cama_id": 315,
150
+ "paciente_id": 7,
151
+ "timestamp_evento": payload["timestamp_evento"],
152
+ }
153
+
154
+
155
+ def test_notify_cama_lista_publica_evento_rico_con_datos_del_episodio(monkeypatch):
156
+ """El evento del Core (event_type_id=19, confirmado por M7) lleva el payload rico
157
+ CIERRE_INTERNACION con los datos del episodio persistidos en la Cama."""
158
+ monkeypatch.setattr(settings, "mock_external_services", False)
159
+ monkeypatch.setattr(settings, "facturacion_cama_lista_event_type_id", 19)
160
+ monkeypatch.setattr("app.integrations.facturacion._post", lambda *a, **k: {"ok": True})
161
+ publish_calls = []
162
  monkeypatch.setattr(
163
  "app.integrations.core_events.publish_event",
164
+ lambda event_type_id, payload, publisher_module="internacion": publish_calls.append(
165
+ (event_type_id, payload, publisher_module)
166
+ )
167
+ or True,
168
  )
169
 
170
+ cama = make_cama(
171
+ id=315,
172
+ paciente_id=7,
173
+ solicitud_hce_id="HCE-SOL-00123",
174
+ fecha_ingreso=datetime(2026, 6, 20, 14, 30, tzinfo=timezone.utc),
175
+ alta_tipo="ALTA_MEDICA",
176
+ alta_timestamp=datetime(2026, 6, 25, 10, 0, tzinfo=timezone.utc),
177
+ )
178
+
179
+ facturacion.notify_cama_lista(cama)
180
 
 
 
181
  assert len(publish_calls) == 1
182
+ event_type_id, payload, publisher_module = publish_calls[0]
183
+ assert event_type_id == 19
184
+ assert publisher_module == "modulo_6"
185
+ assert payload["evento"] == "CIERRE_INTERNACION"
186
+ assert payload["idInternacionExterna"] == "HCE-SOL-00123"
187
+ assert payload["idEpisodioExterno"] is None # bloqueante externo — M1 no lo provee aún
188
+ assert payload["idPacienteExterno"] == "7"
189
+ assert payload["fechaIngreso"] == "2026-06-20T14:30:00+00:00"
190
+ assert payload["fechaAlta"] == "2026-06-25T10:00:00+00:00"
191
+ assert payload["tipoAlta"] == "ALTA_MEDICA"
192
+ assert "timestampEvento" in payload and payload["timestampEvento"] # siempre presente
tests/test_rabbit_consumer.py CHANGED
@@ -72,7 +72,7 @@ def test_dispatch_alta_medica(monkeypatch):
72
  calls = []
73
  monkeypatch.setattr(rabbit_consumer, "get_db", lambda: "FAKE_DB")
74
  monkeypatch.setattr(
75
- solicitud_service, "procesar_alta_medica", lambda db, paciente_id: calls.append(paciente_id)
76
  )
77
  payload = {
78
  "paciente_id": 7,
 
72
  calls = []
73
  monkeypatch.setattr(rabbit_consumer, "get_db", lambda: "FAKE_DB")
74
  monkeypatch.setattr(
75
+ solicitud_service, "procesar_alta_medica", lambda db, data: calls.append(data.paciente_id)
76
  )
77
  payload = {
78
  "paciente_id": 7,
tests/test_solicitudes.py CHANGED
@@ -6,8 +6,11 @@ disparan llamadas a módulos externos (Core/HCE/Monitoreo); esos se cubren con
6
  tests dedicados que mockean la capa de integraciones.
7
  """
8
  from datetime import datetime, timezone
 
 
9
  from fastapi.testclient import TestClient
10
 
 
11
  from tests.factories import make_cama, make_solicitud
12
 
13
  PREFIX = "/api/v1/solicitudes"
@@ -106,6 +109,64 @@ def test_resolver_solicitud_aprobar_ok(client: TestClient, admin_headers, monkey
106
  assert data["accion"] == "APROBAR"
107
 
108
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
109
  def test_resolver_solicitud_rechazar_ok(client: TestClient, admin_headers, monkeypatch):
110
  sol = make_solicitud()
111
  monkeypatch.setattr("app.crud.solicitud.get_by_id", lambda db, num: sol)
 
6
  tests dedicados que mockean la capa de integraciones.
7
  """
8
  from datetime import datetime, timezone
9
+ from unittest.mock import MagicMock
10
+
11
  from fastapi.testclient import TestClient
12
 
13
+ from app.services import solicitud_service
14
  from tests.factories import make_cama, make_solicitud
15
 
16
  PREFIX = "/api/v1/solicitudes"
 
109
  assert data["accion"] == "APROBAR"
110
 
111
 
112
+ def test_resolver_solicitud_aprobar_setea_episodio_en_la_cama(client: TestClient, admin_headers, monkeypatch):
113
+ """
114
+ Datos necesarios para el payload rico que M7 pide en notify_cama_lista
115
+ (idInternacionExterna, fechaIngreso) — se persisten en la propia Cama al aprobar,
116
+ porque se necesitan recién más adelante, al completar la limpieza.
117
+ """
118
+ sol = make_solicitud(solicitud_hce_id="HCE-SOL-001")
119
+ saved_camas = []
120
+ monkeypatch.setattr("app.crud.solicitud.get_by_id", lambda db, num: sol)
121
+ monkeypatch.setattr("app.crud.cama.get_by_id", lambda db, cid: make_cama(estado="DISPONIBLE"))
122
+ monkeypatch.setattr(
123
+ "app.crud.cama.save", lambda db, c: saved_camas.append(c) or c
124
+ )
125
+ monkeypatch.setattr("app.crud.solicitud.save", lambda db, s: s)
126
+ monkeypatch.setattr("app.integrations.core.validate_patient", lambda pid: {"id": pid})
127
+ monkeypatch.setattr("app.integrations.hce.get_contraindicaciones", lambda pid: [])
128
+ monkeypatch.setattr("app.integrations.hce.notify_movimiento", lambda *a, **k: None)
129
+ monkeypatch.setattr("app.integrations.hce.notify_resultado_solicitud", lambda *a, **k: None)
130
+ monkeypatch.setattr("app.integrations.monitoreo.notify_alta", lambda *a, **k: None)
131
+
132
+ resp = client.patch(f"{PREFIX}/SOL-00001", json={"accion": "APROBAR"}, headers=admin_headers)
133
+
134
+ assert resp.status_code == 200
135
+ assert saved_camas[0].solicitud_hce_id == "HCE-SOL-001"
136
+ assert saved_camas[0].fecha_ingreso is not None
137
+
138
+
139
+ def test_aprobar_traslado_hereda_episodio_de_la_cama_origen(monkeypatch):
140
+ """
141
+ El episodio (idInternacionExterna/fechaIngreso para M7) es continuo a través de un
142
+ traslado: se hereda de la cama origen, no de la solicitud de traslado — si no, se
143
+ perdería el dato real de cuándo empezó la internación original.
144
+ """
145
+ fecha_ingreso_original = datetime(2026, 6, 20, 14, 30, tzinfo=timezone.utc)
146
+ cama_origen = make_cama(id=101, estado="OCUPADA", solicitud_hce_id="HCE-SOL-ORIGINAL", fecha_ingreso=fecha_ingreso_original)
147
+ cama_destino = make_cama(id=202, estado="DISPONIBLE")
148
+ sol = make_solicitud(
149
+ tipo="TRASLADO", solicitud_hce_id="HCE-SOL-TRASLADO", cama_origen_id=101, cama_destino_solicitada_id=202,
150
+ )
151
+
152
+ def _get_cama(db, cid):
153
+ return cama_origen if cid == 101 else cama_destino
154
+
155
+ monkeypatch.setattr("app.crud.cama.get_by_id", _get_cama)
156
+ monkeypatch.setattr("app.crud.cama.save", lambda db, c: c)
157
+ monkeypatch.setattr("app.integrations.hce.get_contraindicaciones", lambda pid: [])
158
+ monkeypatch.setattr("app.integrations.hce.notify_movimiento", lambda *a, **k: None)
159
+ monkeypatch.setattr("app.integrations.hce.notify_resultado_solicitud", lambda *a, **k: None)
160
+ monkeypatch.setattr("app.integrations.monitoreo.notify_alta", lambda *a, **k: None)
161
+ monkeypatch.setattr("app.integrations.monitoreo.notify_baja", lambda *a, **k: None)
162
+
163
+ solicitud_service._aprobar_traslado(MagicMock(), sol, None, None, resuelto_por=1, accion="APROBAR")
164
+
165
+ # El destino hereda el episodio del origen — no el solicitud_hce_id de ESTE traslado.
166
+ assert cama_destino.solicitud_hce_id == "HCE-SOL-ORIGINAL"
167
+ assert cama_destino.fecha_ingreso == fecha_ingreso_original
168
+
169
+
170
  def test_resolver_solicitud_rechazar_ok(client: TestClient, admin_headers, monkeypatch):
171
  sol = make_solicitud()
172
  monkeypatch.setattr("app.crud.solicitud.get_by_id", lambda db, num: sol)