Files

T

Ilia Denisov 1079878654 R6(c): drop dead opponent_moved scalars (seat/action/score/total)

These pre-R4 summary scalars on OpponentMovedEvent were redundant with the
move/game delta and read by nobody — the UI codec and mock take only
move/game/bag_len, and the gateway forwards the push payload verbatim. Removed
from scrabble.fbs, the notify emit (notify/events.go) and the round-trip test;
regenerated the FB Go + TS bindings. No prod data, so the wire-slot renumber is
free and there is no DB change.

2026-06-10 17:06:25 +02:00

fbs

R6(c): drop dead opponent_moved scalars (seat/action/score/total)

2026-06-10 17:06:25 +02:00

proto

R6(a): de-stage code, docs, READMEs; split stage6_test

2026-06-10 16:56:03 +02:00

telemetry

R6(a): de-stage code, docs, READMEs; split stage6_test

2026-06-10 16:56:03 +02:00

buf.gen.yaml

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

2026-06-02 22:38:24 +02:00

buf.yaml

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

2026-06-02 22:38:24 +02:00

go.mod

Stage 12: observability & performance (OTel/OTLP, domain metrics, guest GC)

2026-06-04 14:22:15 +02:00

go.sum

Stage 12: observability & performance (OTel/OTLP, domain metrics, guest GC)

2026-06-04 14:22:15 +02:00

Makefile

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

2026-06-02 22:38:24 +02:00

README.md

R6(a): de-stage code, docs, READMEs; split stage6_test

2026-06-10 16:56:03 +02:00

README.md

pkg

Shared wire contracts for the Scrabble platform (module scrabble/pkg), imported by both backend and gateway. It carries no logic — only the generated message types and the schemas they come from.

Layout

proto/push/v1/    # backend -> gateway live-event gRPC channel (Push.Subscribe)
                  #   committed generated Go (*.pb.go, *_grpc.pb.go)
fbs/scrabble.fbs  # FlatBuffers edge payloads (one `scrabblefb` namespace)
fbs/scrabblefb/   # committed generated Go for the schema

proto/push/v1 is the single gRPC server-stream the backend exposes and the gateway subscribes to (Event{user_id, kind, payload, event_id}); the payload is an opaque FlatBuffers body the gateway forwards verbatim.
proto/telegram/v1 is the Telegram connector's RPC contract (including ValidateLoginWidget for the web Login Widget sign-in).
fbs holds the client↔gateway request/response and event payloads as FlatBuffers tables. The backend encodes the push payloads from these types; the gateway transcodes the rest to and from the backend's JSON; the UI generates TypeScript from the same .fbs.

Generated code

Committed (CI only builds it); regenerate dev-time after editing the schemas:

make -C pkg tools   # go install protoc-gen-go + protoc-gen-go-grpc
make -C pkg gen     # buf generate (proto) + flatc (fbs)

flatc is pinned to 23.5.26 to match the github.com/google/flatbuffers Go runtime in go.mod; generating with another version is refused.

Workspace wiring

scrabble/pkg is a bare-path module (no dot), so — like scrabble-solver — it cannot be fetched as a versioned dependency. go.work carries use ./pkg and replace scrabble/pkg v0.0.0 => ./pkg; consumers require scrabble/pkg v0.0.0.