File size: 7,512 Bytes
9f05894 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | # Guía de integración: publicar eventos a Internación (M6) desde Monitoreo (M9)
**Health Grid · Módulo 6 (Internación y Gestión de Camas) — para el equipo de Módulo 9**
> Esta guía es para el equipo de **Monitoreo (M9)**: explica cómo publicar los eventos que le corresponden a M9 en el bus del Core (M10) para que M6 los procese. La cola y los eventos **ya están creados** en el Core — no hace falta dar de alta nada, solo publicar. Para el contrato genérico del bus (login, formato de mensajes) ver [`M10_integration.md`](integrations/M10_integration.md).
---
## 1. Qué le corresponde a M9
M9 tiene **dos** eventos hacia M6, ambos relacionados al código rojo:
| `event_type_id` | `name` | Cuándo se dispara |
|---|---|---|
| **16** | `internacion.alerta-emergencia.detectada` | Un sensor/regla de monitoreo detecta una emergencia en un paciente internado |
| **17** | `internacion.alerta-resuelta.notificada` | La emergencia se estabiliza |
Estos eventos reemplazan, en paralelo durante la transición, a los webhooks REST que M9 llama hoy: `POST /api/v1/webhooks/monitoreo/alerta-emergencia` y `POST /api/v1/webhooks/monitoreo/alerta-resuelta`. **Esos endpoints REST siguen activos** — no hace falta migrar de un día para el otro; M9 puede seguir usándolos mientras integra la publicación por bus, y ambos caminos conviven hasta que se coordine el retiro del REST.
M6 ya tiene la cola `internacion.requests` creada y ambos eventos dados de alta y bindeados a esa cola. **M9 no necesita crear ninguna cola ni evento propio para esto** — solo necesita publicar.
---
## 2. Prerrequisito: tu propia cuenta de servicio en el Core
M9 necesita su propia cuenta en el Core (M10) con permiso `events:log:publish`. Se loguea como cualquier otro cliente:
```http
POST /auth/login
Content-Type: application/json
{ "email": "<cuenta-servicio-m9@...>", "password": "<...>" }
```
Respuesta `200`:
```json
{ "token": "eyJhbGciOiJSUzI1NiIs...", "user": { "id": 15, "email": "...", ... } }
```
Guardar el `token` y usarlo como `Authorization: Bearer <token>` en la publicación (§3). El token del Core dura 24 h — renovar el login cuando expire.
---
## 3. Cómo publicar cada evento
### 3.1 Alerta de emergencia detectada (`event_type_id: 16`)
```http
POST /events/log
Authorization: Bearer <token de tu cuenta de servicio>
Content-Type: application/json
{
"event_type_id": 16,
"publisher_module": "monitoreo",
"payload": "{\"paciente_id\":123,\"observaciones\":\"Frecuencia cardíaca sostenida > 120 por 2 minutos\",\"timestamp\":\"2026-07-10T14:00:00Z\"}"
}
```
### 3.2 Alerta resuelta (`event_type_id: 17`)
```http
POST /events/log
Authorization: Bearer <token de tu cuenta de servicio>
Content-Type: application/json
{
"event_type_id": 17,
"publisher_module": "monitoreo",
"payload": "{\"paciente_id\":123,\"motivo_resolucion\":\"Paciente estabilizado\",\"timestamp\":\"2026-07-10T14:05:00Z\"}"
}
```
Notar: `payload` va **como string JSON** (no como objeto anidado) — es el formato que exige el Core para todo `POST /events/log`, no algo específico de M6.
Respuesta `201` en ambos casos:
```json
{
"id": 91,
"event_type_id": 16,
"publisher_module": "monitoreo",
"payload": "...",
"status": "pending",
...
}
```
Con eso, el Core enruta el mensaje a `internacion.requests` (ya bindeado) y M6 lo procesa de forma asíncrona. No hay respuesta síncrona sobre el resultado del procesamiento — es fire-and-forget, igual que hoy son los webhooks REST.
---
## 4. Contrato de payload
### 4.1 `internacion.alerta-emergencia.detectada` (id 16)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `paciente_id` | integer | **sí** | Id del paciente en el Core. M6 lo usa para localizar la cama actual del paciente. |
| `observaciones` | string | no | Texto libre, contexto de la alerta (opcional). |
| `timestamp` | string (ISO 8601, UTC) | sí | Momento de detección de la emergencia. |
```json
{
"paciente_id": 123,
"observaciones": "Frecuencia cardíaca sostenida > 120 por 2 minutos",
"timestamp": "2026-07-10T14:00:00Z"
}
```
### 4.2 `internacion.alerta-resuelta.notificada` (id 17)
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| `paciente_id` | integer | **sí** | Mismo paciente de la alerta de emergencia. |
| `motivo_resolucion` | string | no | Texto libre (opcional). |
| `timestamp` | string (ISO 8601, UTC) | sí | Momento de resolución. |
```json
{
"paciente_id": 123,
"motivo_resolucion": "Paciente estabilizado",
"timestamp": "2026-07-10T14:05:00Z"
}
```
---
## 5. Qué hace M6 al recibir cada evento
**Alerta de emergencia (16):**
1. Busca la cama `OCUPADA` del paciente (`paciente_id`). Si no tiene cama asignada, el mensaje se descarta (equivalente al `404` que hoy devuelve el REST) — no hay retry automático de M6 hacia M9.
2. La marca en estado `CODIGO_ROJO` y registra el evento en la historia clínica del paciente (M1).
**Alerta resuelta (17):**
1. Busca la cama en `CODIGO_ROJO` del paciente. Si no encuentra ninguna (por ejemplo, la alerta ya se resolvió antes), el mensaje se descarta — no hay error visible del lado de M9.
2. La cama vuelve a `OCUPADA`.
**Orden de los eventos:** publicar primero `alerta-emergencia.detectada` y, cuando corresponda, `alerta-resuelta.notificada` para el mismo `paciente_id`. Si `alerta-resuelta` llega sin que exista una cama en `CODIGO_ROJO` (por ejemplo, por un reordenamiento de mensajes en el bus), M6 no encuentra qué resolver y descarta el mensaje — no hay reconciliación automática. Publicar en orden evita este caso.
---
## 6. Errores comunes
| Síntoma | Causa probable |
|---|---|
| `401` al publicar | Token vencido o cuenta sin permiso `events:log:publish` |
| `400` al publicar | Falta `event_type_id` o `publisher_module` en el body de `POST /events/log` |
| El evento se publica (`201`) pero M6 nunca actúa | Para `alerta-emergencia`: verificar que el paciente tenga una cama `OCUPADA` real en M6. Para `alerta-resuelta`: verificar que exista una cama en `CODIGO_ROJO` para ese paciente (puede que la alerta de emergencia no haya llegado, o haya llegado después) |
| Necesito saber si M6 procesó bien el evento | Hoy no hay canal de respuesta — es fire-and-forget. Si tu flujo necesita confirmación, seguir usando el REST directo mientras tanto |
---
## 7. Checklist de integración
- [ ] Cuenta de servicio de M9 en el Core, con permiso `events:log:publish`.
- [ ] Login (`POST /auth/login`) y manejo de renovación del token (24 h).
- [ ] Publicar `POST /events/log` con `event_type_id: 16` al detectar una emergencia.
- [ ] Publicar `POST /events/log` con `event_type_id: 17` al resolverse la emergencia, para el mismo `paciente_id`.
- [ ] Publicar los eventos en orden (emergencia antes que resuelta) para el mismo paciente.
- [ ] Coordinar con el equipo de M6 cuándo dejar de llamar también a los REST directos (`/webhooks/monitoreo/alerta-emergencia`, `/webhooks/monitoreo/alerta-resuelta`) — mientras tanto, no hay problema en llamar a ambos.
---
## 8. Referencias
- [`M6_EVENTOS_RABBITMQ.md`](M6_EVENTOS_RABBITMQ.md) — infraestructura completa de M6 en el bus (los 5 eventos entrantes, no solo los de M9).
- [`integrations/M10_integration.md`](integrations/M10_integration.md) — tutorial genérico del bus de eventos del Core.
- [`M6_DISEÑO.md`](M6_DISEÑO.md) §5.7 — flujo de negocio de código rojo; §7.5 — contexto de la migración de webhooks REST a eventos.
|