Kafka y eventos
Arquitectura orientada a eventos para desacoplar notificación de ventas y procesamiento asíncrono de pagos.
Tópicos
| Tópico | Productor | Consumidor | Evento |
|---|---|---|---|
orden-eventos |
ms-venta | ms-pago (ms-pago-group) |
orden.creada |
pago-eventos |
ms-pago | (extensión futura) | pago.aprobado / pago.rechazado |
Formato: JSON (EventoOrden, EventoPago). Clave: ordenId.
Flujo híbrido (POS)
- Síncrono: ms-venta → Feign → ms-pago (
POST /api/v1/pagos/registrar) — respuesta inmediata al cajero. - Asíncrono: ms-venta publica
orden.creadaen Kafka. - ms-pago consume; si el pago ya existió por Feign → skip (idempotencia).
- Si no existía (API legacy
/api/v1/ordenes) → procesa y publicapago-eventos.
Arranque DEV
docker network create market-dev-net
cd kafka
docker compose -f compose-dev.yml up -d
| URL | Uso |
|---|---|
| http://localhost:41085 | Kafka UI |
| localhost:41092 | Bootstrap servers (apps Maven) |
Config MS: spring.kafka.bootstrap-servers: localhost:41092
Probar eventos
Opción A — POS: venta en Angular → ver mensaje en Kafka UI → topic orden-eventos.
Opción B — API legacy:
POST http://localhost:18080/api/v1/ordenes
Content-Type: application/json
{"usuarioId": 1, "total": 25.50, "detalles": []}
Logs ms-venta: status=published — ms-pago: status=consumed / processed.
Observabilidad Kafka
- Exporter: puerto 41308 (DEV)
- Prometheus job:
kafka-exporter-dev - PromQL:
kafka_consumergroup_lag
PROD
cd kafka
docker compose up -d
Broker host: 28092 — UI: 28085
Evidencias (curso)
- Kafka UI con topic y mensaje JSON
- Logs productor (ms-venta) y consumidor (ms-pago)
- Diagrama secuencia venta → Kafka → pago
- (Opcional) métrica lag en Grafana