Stage 6: gateway edge (Connect/FB, platform auth, sessions, push bridge, admin) #6

2026-06-02T20:39:26Z

developer commented

2026-06-02 20:39:26 +00:00

Stage 6 — gateway edge. New public ingress (Connect/FlatBuffers over h2c), the backend REST surface + the live-event push stream opened for the first time. Framework + a representative vertical slice end-to-end (auth telegram/guest/email, profile, submit_play/state, lobby enqueue/poll, chat, all five push events, admin passthrough); remaining ops reuse the same transcode pattern in Stage 7. New shared scrabble/pkg (push proto + FlatBuffers payloads), internal/notify + internal/pushgrpc (gRPC :9090), guest = durable is_guest row excluded from stats (migration 00005), email-as-login. Decisions baked into PLAN/ARCHITECTURE/FUNCTIONAL(+ru)/TESTING/READMEs. CI green required before merge.

Stage 6 — gateway edge. New public ingress (Connect/FlatBuffers over h2c), the backend REST surface + the live-event push stream opened for the first time. Framework + a representative vertical slice end-to-end (auth telegram/guest/email, profile, submit_play/state, lobby enqueue/poll, chat, all five push events, admin passthrough); remaining ops reuse the same transcode pattern in Stage 7. New shared `scrabble/pkg` (push proto + FlatBuffers payloads), `internal/notify` + `internal/pushgrpc` (gRPC :9090), guest = durable `is_guest` row excluded from stats (migration 00005), email-as-login. Decisions baked into PLAN/ARCHITECTURE/FUNCTIONAL(+ru)/TESTING/READMEs. CI green required before merge.

developer added 1 commit 2026-06-02 20:39:26 +00:00

Stage 6: gateway edge (Connect/FlatBuffers over h2c, platform/email/guest auth, sessions, rate-limit, admin passthrough, live push bridge)

Tests · Go / test (push) Successful in 8s

Details

Tests · Integration / integration (push) Successful in 11s

Details

Tests · Go / test (pull_request) Successful in 6s

Details

Tests · Integration / integration (pull_request) Successful in 10s

Details

408da3f201

New public ingress and the first network edge. Framework + a vertical slice of
operations end-to-end; remaining ops reuse the same transcode pattern in Stage 7.

Contracts (new module scrabble/pkg):
- push.proto (backend->gateway gRPC server-stream) + scrabble.fbs (FlatBuffers
  edge payloads), committed generated Go; buf/flatc Makefiles (dev-time codegen).

Backend:
- REST handlers on the /api/v1 groups: internal session endpoints
  (telegram/guest/email login -> mint, resolve, revoke) and the user slice
  (profile, submit_play, state, lobby enqueue/poll, chat).
- internal/notify in-process Publisher hub + internal/pushgrpc gRPC server
  (BACKEND_GRPC_ADDR) streaming your_turn/opponent_moved/chat/nudge/match_found;
  emission in game.commit, social, matchmaker.
- migration 00005 accounts.is_guest; guests are durable rows excluded from stats;
  ProvisionGuest; email-as-login (RequestLoginCode/LoginWithCode).

Gateway (new module scrabble/gateway):
- Connect Gateway service over h2c (Execute + Subscribe), FlatBuffers<->JSON
  transcode registry, Telegram initData HMAC validator (seam), session cache,
  token-bucket rate limiter (3 classes), push fan-out hub, backend REST + push
  gRPC client, admin Basic-Auth reverse proxy.

go.work: use ./pkg, ./gateway + replace scrabble/pkg. CI: gateway/**, pkg/**
path filters; unit build/vet/test span all three modules. Docs (PLAN,
ARCHITECTURE, FUNCTIONAL+ru, TESTING, READMEs) updated; gateway/pkg unit tests +
guest/email-login integration tests.

owner approved these changes 2026-06-02 20:42:27 +00:00

developer merged commit 19ae8f04a2 into master

2026-06-02 20:43:00 +00:00

developer referenced this issue from a commit

2026-06-06 08:31:31 +00:00

Stage 17: UI defect fixes (russian variant, Telegram theme/nav/banner, reconnect, hint zoom, plaque, history, transitions, per-game cache)

developer referenced this pull request

2026-06-06 08:31:50 +00:00

Stage 17: test-contour verification & defect fixes #19

developer referenced this issue from a commit

2026-06-06 12:08:43 +00:00

Stage 17 (contour round 4a): quick fixes