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

Platform (iGaming): arquitecturahold · settlebatched settlemoney in / outeventsPlatform Coreidentity · wallet · responsible gamingRonin Rushcrash gameSpotKickPvP duelSkyBiz Payoutsmoney in / outKafkaversioned eventsplatform-contractsnpm 0.3.0
  • 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

  1. 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.

  2. 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í.

  3. 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.

Stack

  • NestJS
  • PostgreSQL
  • Kafka
  • Redis
  • Docker Compose
  • Prometheus
  • Grafana
  • Helm
  • ArgoCD