scrabble-game

Multiplatform Scrabble game. Players arrive from a platform (Telegram first; later VK/MAX/iOS/Android) or from standalone web (email / guest). The game supports English Scrabble, Russian Scrabble and Эрудит.

Components

• gateway — the only public ingress: anti-abuse, platform authentication (resolves the player and injects X-User-ID), routing to backend, and an admin surface behind Basic Auth. (added in a later stage)
• backend — internal-only service that owns every domain concern and embeds the scrabble-solver engine library in-process.
• ui — pure-HTML5 client (plain Svelte + Vite), embeddable in platform webviews and packageable to native via Capacitor. (added in a later stage)
• platform/* — per-platform side-services (e.g. the Telegram bot). (added in a later stage)

Documentation (sources of truth)

• docs/ARCHITECTURE.md — global architecture, transport, security, cross-service contracts.
• docs/FUNCTIONAL.md (+ _ru) — per-domain user stories.
• docs/TESTING.md — test layers and the per-stage CI gate.
• PLAN.md — the staged implementation plan and stage tracker.
• CLAUDE.md — project guide and the mandatory per-stage workflow.

Build & test

go build ./backend/...  # per module (the workspace spans several modules)
go vet ./backend/...
gofmt -l .              # must print nothing
go test -count=1 ./backend/...

Run the backend locally

go run ./backend/cmd/backend     # serves /healthz and /readyz on :8080

Configuration is read from the environment: BACKEND_HTTP_ADDR (default :8080), BACKEND_LOG_LEVEL (debug|info|warn|error, default info).