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