docs: reorder & testing

pkg/model/order/order.go

@@ -2,8 +2,50 @@ package order
 
 import (
 	"encoding/json"
+
+	"github.com/google/uuid"
 )
 
+// MessageTypeUserGamesCommand is the authenticated gateway message type
+// used to send a batch of in-game commands to the engine through
+// `POST /api/v1/user/games/{game_id}/commands`. The signed payload is
+// a FlatBuffers `order.UserGamesCommand`.
+const MessageTypeUserGamesCommand = "user.games.command"
+
+// MessageTypeUserGamesOrder is the authenticated gateway message type
+// used to validate / store a batch of in-game orders through
+// `POST /api/v1/user/games/{game_id}/orders`. The signed payload is a
+// FlatBuffers `order.UserGamesOrder`.
+const MessageTypeUserGamesOrder = "user.games.order"
+
+// UserGamesCommand is the typed payload of MessageTypeUserGamesCommand.
+// `GameID` selects the running engine container; `Commands` is the
+// player command batch executed atomically by the engine. The `Actor`
+// field present in the engine's JSON shape is rebuilt by backend from
+// the runtime player mapping — clients never carry it.
+type UserGamesCommand struct {
+	// GameID identifies the running game for this batch.
+	GameID uuid.UUID `json:"game_id"`
+
+	// Commands is the player command batch.
+	Commands []DecodableCommand `json:"cmd"`
+}
+
+// UserGamesOrder is the typed payload of MessageTypeUserGamesOrder.
+// Mirrors `UserGamesCommand` plus an `UpdatedAt` field that lets the
+// engine reject stale order submissions.
+type UserGamesOrder struct {
+	// GameID identifies the running game for this batch.
+	GameID uuid.UUID `json:"game_id"`
+
+	// UpdatedAt is the client-side timestamp used for stale-order
+	// detection on the engine side.
+	UpdatedAt int `json:"updatedAt"`
+
+	// Commands is the player order batch.
+	Commands []DecodableCommand `json:"cmd"`
+}
+
 type Order struct {
 	// TODO: check with already stored order, if any, and generate an error, if newer order exists
 	UpdatedAt int                `json:"updatedAt"`