Ilia Denisov
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.
93 lines
3.4 KiB
Go
93 lines
3.4 KiB
Go
package notify
|
|
|
|
import (
|
|
"time"
|
|
|
|
flatbuffers "github.com/google/flatbuffers/go"
|
|
"github.com/google/uuid"
|
|
|
|
fb "scrabble/pkg/fbs/scrabblefb"
|
|
)
|
|
|
|
// The constructors below build one Intent per live event, FlatBuffers-encoding
|
|
// the payload with the shared scrabblefb schema. Keeping the encoding here lets
|
|
// the game/social/lobby services emit events without importing the wire schema.
|
|
|
|
// YourTurn announces to userID that it is their turn in game gameID, with the
|
|
// turn's nominal deadline.
|
|
func YourTurn(userID, gameID uuid.UUID, deadline time.Time) Intent {
|
|
b := flatbuffers.NewBuilder(64)
|
|
gid := b.CreateString(gameID.String())
|
|
fb.YourTurnEventStart(b)
|
|
fb.YourTurnEventAddGameId(b, gid)
|
|
fb.YourTurnEventAddDeadlineUnix(b, deadline.Unix())
|
|
b.Finish(fb.YourTurnEventEnd(b))
|
|
return Intent{UserID: userID, Kind: KindYourTurn, Payload: b.FinishedBytes(), EventID: eventID()}
|
|
}
|
|
|
|
// OpponentMoved tells userID that seat just committed a move in game gameID,
|
|
// summarising it (the client refetches the full state).
|
|
func OpponentMoved(userID, gameID uuid.UUID, seat int, action string, score, total int) Intent {
|
|
b := flatbuffers.NewBuilder(64)
|
|
gid := b.CreateString(gameID.String())
|
|
act := b.CreateString(action)
|
|
fb.OpponentMovedEventStart(b)
|
|
fb.OpponentMovedEventAddGameId(b, gid)
|
|
fb.OpponentMovedEventAddSeat(b, int32(seat))
|
|
fb.OpponentMovedEventAddAction(b, act)
|
|
fb.OpponentMovedEventAddScore(b, int32(score))
|
|
fb.OpponentMovedEventAddTotal(b, int32(total))
|
|
b.Finish(fb.OpponentMovedEventEnd(b))
|
|
return Intent{UserID: userID, Kind: KindOpponentMoved, Payload: b.FinishedBytes(), EventID: eventID()}
|
|
}
|
|
|
|
// ChatMessage delivers a stored chat message (or nudge) to userID.
|
|
func ChatMessage(userID, gameID, senderID uuid.UUID, id, kind, body string, createdAt time.Time) Intent {
|
|
b := flatbuffers.NewBuilder(128)
|
|
idOff := b.CreateString(id)
|
|
gid := b.CreateString(gameID.String())
|
|
sid := b.CreateString(senderID.String())
|
|
kindOff := b.CreateString(kind)
|
|
bodyOff := b.CreateString(body)
|
|
fb.ChatMessageStart(b)
|
|
fb.ChatMessageAddId(b, idOff)
|
|
fb.ChatMessageAddGameId(b, gid)
|
|
fb.ChatMessageAddSenderId(b, sid)
|
|
fb.ChatMessageAddKind(b, kindOff)
|
|
fb.ChatMessageAddBody(b, bodyOff)
|
|
fb.ChatMessageAddCreatedAtUnix(b, createdAt.Unix())
|
|
b.Finish(fb.ChatMessageEnd(b))
|
|
return Intent{UserID: userID, Kind: KindChatMessage, Payload: b.FinishedBytes(), EventID: eventID()}
|
|
}
|
|
|
|
// Nudge tells userID that fromUserID nudged them in game gameID.
|
|
func Nudge(userID, gameID, fromUserID uuid.UUID) Intent {
|
|
b := flatbuffers.NewBuilder(64)
|
|
gid := b.CreateString(gameID.String())
|
|
from := b.CreateString(fromUserID.String())
|
|
fb.NudgeEventStart(b)
|
|
fb.NudgeEventAddGameId(b, gid)
|
|
fb.NudgeEventAddFromUserId(b, from)
|
|
b.Finish(fb.NudgeEventEnd(b))
|
|
return Intent{UserID: userID, Kind: KindNudge, Payload: b.FinishedBytes(), EventID: eventID()}
|
|
}
|
|
|
|
// MatchFound tells userID that game gameID, which they are seated in, has
|
|
// started (an auto-match pairing or a robot substitution).
|
|
func MatchFound(userID, gameID uuid.UUID) Intent {
|
|
b := flatbuffers.NewBuilder(64)
|
|
gid := b.CreateString(gameID.String())
|
|
fb.MatchFoundEventStart(b)
|
|
fb.MatchFoundEventAddGameId(b, gid)
|
|
b.Finish(fb.MatchFoundEventEnd(b))
|
|
return Intent{UserID: userID, Kind: KindMatchFound, Payload: b.FinishedBytes(), EventID: eventID()}
|
|
}
|
|
|
|
// eventID returns a best-effort correlation id for one emitted event.
|
|
func eventID() string {
|
|
if id, err := uuid.NewV7(); err == nil {
|
|
return id.String()
|
|
}
|
|
return ""
|
|
}
|