推进 server-rs DDD 分层与新接口接线

server-rs/crates/spacetime-client/README.md

@@ -1,4 +1,4 @@
-# spacetime-client 共享 package 占位说明
+# spacetime-client 共享 package 说明
 
 日期：`2026-04-20`
 
@@ -10,6 +10,15 @@
 2. Axum 与各模块对 reducer、view、订阅的调用适配
 3. 身份透传、连接配置与基础错误处理适配
 
+在 DDD 重构中，本 package 只承接 `WP-SC Spacetime Client`：
+
+1. 把 SpacetimeDB 生成绑定转换成 `api-server` 可消费的 typed facade。
+2. 把 row snapshot / procedure result 转换成 BFF record。
+3. 统一 SDK 调用错误、业务 procedure 错误、缺失快照错误和超时错误。
+4. 不承载领域规则，不直接定义 table / reducer / procedure，不替代 `spacetime-module`。
+
+本轮方案见 [`SERVER_RS_DDD_WP_SC_SPACETIME_CLIENT_REFACTOR_2026-04-29.md`](../../../docs/technical/SERVER_RS_DDD_WP_SC_SPACETIME_CLIENT_REFACTOR_2026-04-29.md)。
+
 ## 2. 当前阶段说明
 
 当前目录已不再只是占位，当前阶段已经落下：
@@ -76,3 +85,5 @@ cargo check -p spacetime-client --manifest-path server-rs\Cargo.toml
 1. `spacetime-client` 只承接 SpacetimeDB 客户端访问适配，不承接具体业务模块的规则实现。
 2. 业务状态真相仍由 `apps/spacetime-module` 管理，业务编排由各模块 package 与 `apps/api-server` 承担。
 3. 不允许把 reducer、view、订阅调用细节重新散落到多个业务模块里各自实现。
+4. 新增 facade 必须等待对应 `spacetime-module` facade 稳定后再接，不提前假设 row shape。
+5. `src/module_bindings/**` 是生成产物，只能通过 SpacetimeDB CLI 生成流程刷新。