docs: reorder & testing

pkg/schema/fbs/notification.fbs

@@ -1,54 +1,67 @@
 // notification contains shared FlatBuffers payloads published by
-// Notification Service toward the gateway client event stream.
+// Notification Service toward the gateway client event stream. Each
+// table mirrors one catalog kind defined in
+// `backend/internal/notification/catalog.go`; the table name is the
+// camel-case form of the kind with the `Event` suffix.
+
+include "common.fbs";
+
 namespace notification;
 
-table GameTurnReadyEvent {
-  game_id:string;
-  turn_number:int64;
+table LobbyInviteReceivedEvent {
+  game_id:common.UUID (required);
+  inviter_user_id:common.UUID (required);
 }
 
-table GameFinishedEvent {
-  game_id:string;
-  final_turn_number:int64;
+table LobbyInviteRevokedEvent {
+  game_id:common.UUID (required);
 }
 
 table LobbyApplicationSubmittedEvent {
-  game_id:string;
-  applicant_user_id:string;
+  game_id:common.UUID (required);
+  application_id:common.UUID (required);
 }
 
-table LobbyMembershipApprovedEvent {
-  game_id:string;
+table LobbyApplicationApprovedEvent {
+  game_id:common.UUID (required);
 }
 
-table LobbyMembershipRejectedEvent {
-  game_id:string;
+table LobbyApplicationRejectedEvent {
+  game_id:common.UUID (required);
 }
 
-table LobbyMembershipBlockedEvent {
-  game_id:string;
-  membership_user_id:string;
+table LobbyMembershipRemovedEvent {
   reason:string;
 }
 
-table LobbyInviteCreatedEvent {
-  game_id:string;
-  inviter_user_id:string;
-}
-
-table LobbyInviteRedeemedEvent {
-  game_id:string;
-  invitee_user_id:string;
-}
-
-table LobbyRaceNameRegistrationEligibleEvent {
-  game_id:string;
-  race_name:string;
-  eligible_until_ms:int64;
+table LobbyMembershipBlockedEvent {
+  game_id:common.UUID (required);
+  reason:string;
 }
 
 table LobbyRaceNameRegisteredEvent {
   race_name:string;
 }
 
-root_type GameTurnReadyEvent;
+table LobbyRaceNamePendingEvent {
+  race_name:string;
+  expires_at:string;
+}
+
+table LobbyRaceNameExpiredEvent {
+  race_name:string;
+}
+
+table RuntimeImagePullFailedEvent {
+  game_id:common.UUID (required);
+  image_ref:string;
+}
+
+table RuntimeContainerStartFailedEvent {
+  game_id:common.UUID (required);
+}
+
+table RuntimeStartConfigInvalidEvent {
+  game_id:common.UUID (required);
+  reason:string;
+}