Etapa 2 Backend Wiring: WS → Engine

GameManager integrado como puente entre WebSocket y motor de juego. Redis para persistencia de partidas activas y gRPC handlers reales para consultas entre servicios.

✓ Estado: Completado

9 packages build vet tests pasando

go build ./services/domino-service/... + go vet + go test — ALL CLEAN.

GameManager

Nuevo en internal/ws/game_manager.go. Gestiona ciclo de vida completo:

CreateGame — crea ManagedGame con creator como North
JoinGame — asigna posición libre (East/South/West)
StartGame — llena slots vacíos con bots, inicia engine.Round
PlayTile / PassTurn / BuyTile — delega a engine, log Moves a DB, broadcast estado
Trigger automático de bot si el turno pasa a IA
Gestión de fin de ronda: cálculo de score, persistencia, broadcast

WebSocket Handlers

Mensajes WS enrutados a GameManager en internal/ws/messages.go:

play_tile → mg.PlayTile(userID, tile, boardEnd)
pass_turn → mg.PassTurn(userID)
buy_tile → mg.BuyTile(userID)
start_game → mg.StartGame() via REST path
Username extraído de JWT y almacenado en Client.Username

Redis Persistence

Nuevo internal/ws/redis_store.go:

Snapshot JSON completo de ManagedGame (engine.Game + Round + player mapping)
saveToRedisLocked() — tras cada broadcast de estado
LoadAllActive() — restaura partidas activas al arrancar server
deleteFromRedisLocked() — al finalizar partida
Key pattern: domino:game:{gameID} con TTL 72h

gRPC Handlers Reales

Implementados en internal/server/grpc.go mediante proto proto/domino/domino.proto:

GetGameState — devuelve estado de partida activa (score, ronda, variante)
GetGameResult — devuelve resultado final si la partida terminó
ListActiveGames — lista resumen de partidas activas
Servicio registrado con reflection habilitado en no-prod

DB Persistence

LogMove() — registra cada jugada en domino.game_moves
FinishGame() — finaliza partida en domino.games
Ambos llamados desde GameManager tras cada acción

Testing

TestBotVsBotCompleteGame — partida completa bot vs bot (~0.34s con 10ms delay)
TestBotMovesProgressGame — validación de progresión de bots
9 packages compilando, todos los tests pasando

Archivos Nuevos/Modificados

NUEVOS:
  internal/ws/game_manager.go      — Bridge WS → Engine + bot orquestación
  internal/ws/game_manager_test.go — E2E bot vs bot tests
  internal/ws/redis_store.go        — Redis save/load/delete
  proto/domino/domino.proto         — Proto definición servicio gRPC
  proto/gen/domino/                 — Go stubs generados

MODIFICADOS:
  internal/ws/messages.go           — play_tile, pass_turn, buy_tile handlers
  internal/ws/connect.go           — HubHandler con GameManager
  internal/ws/hub.go               — Client.Username
  internal/ws/hub_test.go          — Constructor actualizado
  internal/ws/ws_test.go           — Constructor actualizado
  internal/ws/ws_integration_test.go — Constructor actualizado
  internal/server/grpc.go          — Implementación DominoServiceServer
  internal/api/router.go           — gameManager injectado
  internal/api/handlers.go         — handleCreateGame llama gm.CreateGame()
  cmd/server/main.go               — Wire Redis, GameManager, gRPC state

← Volver a d.bakuryu.com