抓大鹅B3实现

server-rs/crates/shared-contracts/src/match3d_runtime.rs

@@ -9,9 +9,12 @@ pub struct StartMatch3DRunRequest {
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq)]
 #[serde(rename_all = "camelCase")]
 pub struct ClickMatch3DItemRequest {
+    #[serde(default)]
+    pub run_id: Option<String>,
     pub item_instance_id: String,
-    pub client_action_id: String,
-    pub snapshot_version: u64,
+    pub client_snapshot_version: u64,
+    pub client_event_id: String,
+    pub clicked_at_ms: u64,
 }
 
 #[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq)]
@@ -55,13 +58,16 @@ pub struct Match3DRunSnapshotResponse {
     pub profile_id: String,
     pub owner_user_id: String,
     pub status: String,
+    /// 对外 HTTP 快照版本。领域层内部字段名为 board_version，facade 需要在这里完成映射。
+    pub snapshot_version: u64,
     pub started_at_ms: u64,
     pub duration_limit_ms: u64,
+    #[serde(default)]
+    pub server_now_ms: Option<u64>,
     pub remaining_ms: u64,
     pub clear_count: u32,
     pub total_item_count: u32,
     pub cleared_item_count: u32,
-    pub board_version: u64,
     pub items: Vec<Match3DItemSnapshotResponse>,
     pub tray_slots: Vec<Match3DTraySlotResponse>,
     #[serde(default)]
@@ -102,14 +108,18 @@ mod tests {
     #[test]
     fn click_match3d_item_request_uses_camel_case() {
         let payload = serde_json::to_value(ClickMatch3DItemRequest {
+            run_id: Some("run-1".to_string()),
             item_instance_id: "item-1".to_string(),
-            client_action_id: "action-1".to_string(),
-            snapshot_version: 7,
+            client_snapshot_version: 7,
+            client_event_id: "event-1".to_string(),
+            clicked_at_ms: 12_345,
         })
         .expect("payload should serialize");
 
+        assert_eq!(payload["runId"], json!("run-1"));
         assert_eq!(payload["itemInstanceId"], json!("item-1"));
-        assert_eq!(payload["clientActionId"], json!("action-1"));
-        assert_eq!(payload["snapshotVersion"], json!(7));
+        assert_eq!(payload["clientSnapshotVersion"], json!(7));
+        assert_eq!(payload["clientEventId"], json!("event-1"));
+        assert_eq!(payload["clickedAtMs"], json!(12_345));
     }
 }