🎲 Bakuryu Games — Documentación

Arquitectura

VPS1 (46.250.236.252) — Frontend lógico: auth, wallet, domino-service (Go)

VPS2 (84.46.240.189) — Cerebro AI: DominoAI, TTS, coach (Python)

Comunicación via WireGuard wg1 (10.10.0.0/24)

Servicios

/api/inference/ → :8000 — Inferencia OpenRouter/Ollama

/api/anticheat/ → :8002 — Anti-cheat engine

/api/trainer/ → :8003 — Bot trainer

/api/stockfish/ → :8004 — Análisis de ajedrez

/api/domino/ → :8006 — Domino Venezolano

/ollama/ → :11434 — LLM local

Features Implementadas

✅ Session Management (WS+Redis)

✅ Per-game ELO/risk (user_ratings)

✅ Email verification SMTP (mailcow)

✅ Bot Replacement + Reconexión

✅ Anti-abuse disconnect tracking

✅ Modo espectador (ocultar fichas)

✅ Variantes Block/Draw/AllFives

✅ Rematch + Match history + Replay

✅ Torneos automáticos

✅ Hash chain público

✅ TTS Piper 21 voces EN+ES

✅ Self-play pipeline nocturno

✅ Domino Story Mode (5 capítulos)

Endpoints Clave

GET  /health                    — Health check
GET  /spectate                  — Lobby público espectador
GET  /games/{id}/replay         — Replay partida
GET  /tournaments               — Listar torneos
POST /tournaments/create        — Crear torneo
GET  /domino/levels             — Niveles de dificultad
POST /domino/bot/move           — Movimiento del bot
POST /domino/coach/suggest      — Coach "¿Qué jugaría?"
POST /domino/coach/analyze      — Análisis post-partida
GET  /domino/story/chapters     — Capítulos Story Mode
POST /domino/story/chapter/{id}/start  — Iniciar capítulo
POST /domino/story/chapter/{id}/complete — Completar capítulo

Tracker de Desarrollo

http://84.46.240.189:8080/tracker.html

Repositorio

Código fuente en /bakuryu/ai/

AGENTS.md — Memoria del proyecto

ERRORS.md — Bitácora de errores

PLAN.md — Plan de desarrollo