Caso de estudio
Platform (iGaming)
Monedero, identidad y contratos comunes a todos los juegos
Exactamente una vezliquidación en pruebas, con Core detenido a mitad de rondaentrega al menos una vez con consumidores idempotentes (un único efecto)
Demo en vivo
Core es un servicio backend: se le ve funcionar a través de Ronin Rush y SpotKick, que reservan y liquidan contra él.
Qué es y qué resuelve
La columna vertebral común de los juegos: Platform Core gestiona identidad, un monedero de doble entrada con holds, liquidación y juego responsable; platform-contracts define eventos versionados y la API del monedero; platform-infra lo despliega todo. Los juegos reservan y liquidan contra Core en vez de tener cada uno su propia lógica de dinero.
Arquitectura
- Ronin Rush → Platform Core (hold · settle)
- SpotKick → Platform Core (batched settle)
- SkyBiz Payouts → Platform Core (money in / out)
- Platform Core → Kafka (events)
- Ronin Rush → Kafka
- SpotKick → Kafka
- SkyBiz Payouts → Kafka
- platform-contracts → Platform Core
Tres decisiones técnicas
Holds antes de liquidar
Los juegos reservan fondos primero y liquidan después (de uno en uno o agrupado) con un periodo de gracia: 1.800 s desde la caducidad del hold, siempre que la intención de liquidación se registrara antes. Si un juego cae entre la apuesta y el resultado, los saldos se mantuvieron conciliados en las pruebas de fallos.
Contratos como paquete publicado
Los eventos versionados, el OpenAPI del monedero y un kit de tests de contrato se publican como @danigil/platform-contracts, así juegos y Core evolucionan sin romperse entre sí.
JWT RS256 con JWKS
Core firma los tokens y publica sus claves, así cada juego verifica la identidad por su cuenta sin llamar a Core en cada petición.
Pruebas, con cifras
- 200 operaciones concurrentes.
- Reintentos idempotentes y carreras entre settle y caducidad.
- 11 mutaciones detectadas.
- Pruebas de extremo a extremo con Kafka.
- E2E aceptado: Core caído durante una ronda de Ronin, liquidación exactamente una vez al recuperarlo (entrega al menos una vez con consumidores idempotentes, un único efecto); 16 transacciones y 33 asientos conciliados, sin retenciones abiertas.
Verificado
- Core v0.2.0: pagos desde house con comisión, grants por jugador, juego responsable. Solo EUR.
- platform-contracts 0.3.0 es público en npm; platform-infra es público.
- GitOps: Core v0.2.0 (por digest) y Ronin desplegados en k3s local con Helm y ArgoCD; cambio y rollback por Git aplicados automáticamente; secretos fuera de Git y migraciones como Jobs.
Lo que no se afirma
- Hoy solo admite EUR.
- Sin verificar todavía: Kafka, workers y webs en Kubernetes; staging en el NAS.
- Las cifras salen de pruebas, no de tráfico en producción.