抓大鹅B3实现

docs/technical/MATCH3D_CREATION_AND_RUNTIME_MINIMAL_IMPLEMENTATION_2026-04-30.md

@@ -190,8 +190,8 @@ Rust DTO 只承载 HTTP contract 和跨 crate 稳定模型，不直接暴露 `mo
 8. `draft_json: String`，序列化草稿结果。
 9. `last_assistant_reply: String`。
 10. `published_profile_id: String`，未发布为空字符串。
-11. `created_at: i64`。
-12. `updated_at: i64`。
+11. `created_at: Timestamp`。
+12. `updated_at: Timestamp`。
 
 ## 5.2 `match3d_agent_message`
 
@@ -204,7 +204,7 @@ Rust DTO 只承载 HTTP contract 和跨 crate 稳定模型，不直接暴露 `mo
 3. `role: String`，建议值：`user`、`assistant`、`system`。
 4. `kind: String`，建议值：`text`、`action`、`error`。
 5. `text: String`。
-6. `created_at: i64`。
+6. `created_at: Timestamp`。
 
 ## 5.3 `match3d_work_profile`
 
@@ -227,8 +227,8 @@ Rust DTO 只承载 HTTP contract 和跨 crate 稳定模型，不直接暴露 `mo
 13. `config_json: String`。
 14. `publication_status: String`，建议值：`Draft`、`Published`。
 15. `play_count: u32`。
-16. `updated_at: i64`。
-17. `published_at: i64`，未发布为 `0`。
+16. `updated_at: Timestamp`。
+17. `published_at: Option<Timestamp>`，未发布为 `None`。
 
 ## 5.4 `match3d_runtime_run`
 
@@ -250,8 +250,8 @@ Rust DTO 只承载 HTTP contract 和跨 crate 稳定模型，不直接暴露 `mo
 12. `cleared_item_count: u32`。
 13. `failure_reason: String`，建议值为空、`TimeUp`、`TrayFull`。
 14. `snapshot_json: String`，序列化 `Match3DRunSnapshot`。
-15. `created_at: i64`。
-16. `updated_at: i64`。
+15. `created_at: Timestamp`。
+16. `updated_at: Timestamp`。
 
 ## 5.5 `match3d_play_record`
 
@@ -687,6 +687,14 @@ F3 运行态即时反馈分支可以先用本地 mock snapshot 开发，但必
 2. 与 `module-match3d` 规则接线。
 3. `spacetime build` 或仓库现有等价脚本通过。
 
+B3 当前落地状态：
+
+1. `server-rs/crates/spacetime-module/src/match3d/` 已承载 Match3D 的表、procedure 输入输出类型和 procedure 实现，并由 `server-rs/crates/spacetime-module/src/lib.rs` 挂载导出。
+2. `migration.rs` 已纳入 `match3d_agent_session`、`match3d_agent_message`、`match3d_work_profile`、`match3d_runtime_run` 四张表，后续字段变更继续按 `SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md` 追加兼容字段。
+3. 运行态 `start_match3d_run`、`click_match3d_item`、`stop_match3d_run`、`finish_match3d_time_up` 通过适配层调用 `module-match3d` 的领域规则，SpacetimeDB 层只负责归属校验、事务写入、权威快照持久化和 procedure JSON 返回。
+4. B3 对外仍返回当前首版快照字段 `snapshotVersion / clientSnapshotVersion` 对应语义；`module-match3d` 内部的 `board_version` 只在适配层中转换，避免影响并行中的 B4/F3 接入。
+5. SpacetimeDB module 的有效验收命令是 `spacetime build --module-path crates/spacetime-module`；不要用普通 native `cargo test -p spacetime-module` 作为验收口径，因为该 crate 会链接 SpacetimeDB 宿主符号。
+
 ### F1：创作入口与 Agent UI
 
 写入范围：