docs: reorder & testing

pkg/schema/fbs/report.fbs

@@ -1,10 +1,7 @@
 // report reflects model/report/Report data object
-namespace report;
+include "common.fbs";
 
-struct UUID {
-  hi:uint64;
-  lo:uint64;
-}
+namespace report;
 
 table RouteEntry {
   key:uint64;
@@ -184,7 +181,7 @@ table LocalGroup {
   range:float32 = null;
   speed:float32;
   mass:float32;
-  id:UUID (required);
+  id:common.UUID (required);
   state:string;
   fleet:string;
 }
@@ -213,7 +210,7 @@ table Report {
   other_science:[OtherScience];
   local_ship_class:[ShipClass];
   other_ship_class:[OthersShipClass];
-  battle:[UUID];
+  battle:[common.UUID];
   bombing:[Bombing];
   incoming_group:[IncomingGroup];
   local_planet:[LocalPlanet];
@@ -228,4 +225,14 @@ table Report {
   unidentified_group:[UnidentifiedGroup];
 }
 
+// GameReportRequest is the signed-gRPC request payload for
+// `MessageTypeUserGamesReport`. Gateway transcodes this into the
+// engine's `?player=&turn=` query string after resolving the caller's
+// race name from the runtime player mapping; only `game_id` and `turn`
+// travel on the wire.
+table GameReportRequest {
+  game_id:common.UUID (required);
+  turn:uint32;
+}
+
 root_type Report;