Caso de estudio

SpotKick

Duelo PvP de penaltis en tiempo real con commit-reveal

0 duplicadosen cargos o premios, en pruebas con respuestas perdidas y reiniciosentrega al menos una vez con consumidores idempotentes (un único efecto)

Demo en vivo

Demo con dinero ficticio: fichas ficticias, sin dinero real ni premios. +18. Juega con responsabilidad.

Alojada en mi propio servidor: la primera carga tras un rato sin uso puede tardar algo más.

Abrir en otra pestaña ↗

Qué es y qué resuelve

Un duelo de penaltis jugador contra jugador en tiempo real: tres rondas y muerte súbita. Los dos eligen a la vez, así que el sistema debe impedir reaccionar a la jugada rival, aguantar desconexiones y pagar cada premio una sola vez (entrega al menos una vez con consumidores idempotentes, comprobado en pruebas).

Versión para negocios: SpotKick →

Arquitectura

SpotKick: arquitecturaWebSocketWebSocketat-least-onceBrowser ANext.jsBrowser BNext.jsAPI instanceNestJS · Socket.IOAPI instanceNestJS · Socket.IORedisqueue · presence · adapterPostgreSQLledger · row locksOutbox workersversioned eventsPlatform Corebatched settle
  • Browser A → API instance (WebSocket)
  • Browser B → API instance (WebSocket)
  • API instance → Redis
  • API instance → Redis
  • API instance → PostgreSQL
  • API instance → PostgreSQL
  • PostgreSQL → Outbox workers
  • Outbox workers → Redis (at-least-once)
  • API instance → Platform Core

Dibujado a partir del diagrama de arquitectura del README del repositorio.

Tres decisiones técnicas

  1. Commit-reveal para elecciones simultáneas

    Cada jugador envía primero el hash de su elección más una sal aleatoria, y revela ambas solo cuando están los dos hashes, así nadie puede elegir después de ver la jugada rival. Si alguien no revela a tiempo, se aplica una elección de respaldo auditable.

  2. Escrow en un libro mayor de doble entrada

    Las apuestas se bloquean de forma atómica al empezar la partida y se pagan al ganador o se devuelven si se abandona, con claves de idempotencia para que un reintento tenga un único efecto: sin cobros dobles en las pruebas.

  3. Salas escalables en horizontal

    Varias instancias de NestJS comparten presencia, colas e instantáneas redactadas por Redis y el adaptador Redis de Socket.IO, así un jugador puede reconectarse a cualquier instancia.

Pruebas, con cifras

  • 200 partidas simultáneas y 400 conexiones sin errores, repartidas entre dos instancias de la API.
  • Respuestas perdidas, reinicios y autoexclusión sin cargos ni premios duplicados.
  • 14 comprobaciones por mutación.

Verificado

  • Integrado con Platform Core mediante liquidación agrupada.
  • El modo individual es provably fair: la zona del portero se deriva con HMAC-SHA256 de la semilla del servidor, la del cliente y un contador, y la semilla del servidor se revela al final para que cualquiera pueda verificarla.

Lo que no se afirma

  • Operación con dinero real ni auditoría externa. Todas las fichas son ficticias.
  • Las cifras salen de pruebas, no de tráfico en producción.

Stack

  • NestJS 11
  • Socket.IO + Redis
  • Next.js 15
  • React 19
  • Framer Motion
  • PostgreSQL
  • Docker
  • GitHub Actions
  • Vitest
  • Playwright
  • k6