From 17a033ecc7a1c82d8a47e633ef07bdabb5f51729 Mon Sep 17 00:00:00 2001 From: kdletters Date: Tue, 21 Apr 2026 00:56:11 +0800 Subject: [PATCH] docs: add spacetime client package placeholder --- .../01_M0_M2_FOUNDATION_AND_AUTH.md | 3 +- server-rs/README.md | 8 +++--- server-rs/packages/spacetime-client/README.md | 28 +++++++++++++++++++ 3 files changed, 34 insertions(+), 5 deletions(-) create mode 100644 server-rs/packages/spacetime-client/README.md diff --git a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md index b053b98a..9cc41e39 100644 --- a/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md +++ b/backend-rewrite-tasklist/01_M0_M2_FOUNDATION_AND_AUTH.md @@ -85,7 +85,8 @@ 交付物：[../server-rs/packages/platform-oss/README.md](../server-rs/packages/platform-oss/README.md) - [x] 创建 `packages/platform-llm` 交付物：[../server-rs/packages/platform-llm/README.md](../server-rs/packages/platform-llm/README.md) -- [ ] 创建 `packages/spacetime-client` +- [x] 创建 `packages/spacetime-client` + 交付物：[../server-rs/packages/spacetime-client/README.md](../server-rs/packages/spacetime-client/README.md) - [ ] 创建 `packages/tests-support` ### Axum 基础能力 diff --git a/server-rs/README.md b/server-rs/README.md index 4047f752..acd75fe8 100644 --- a/server-rs/README.md +++ b/server-rs/README.md @@ -14,7 +14,7 @@ ## 2. 当前阶段说明 -当前目录已经完成以下二十三项初始化： +当前目录已经完成以下二十四项初始化： 1. 为新后端预留正式目录并把路径固定到仓库结构中。 2. 创建虚拟 workspace `Cargo.toml`，后续 package 会逐项挂入。 @@ -39,12 +39,12 @@ 21. 创建 `packages/platform-auth/` 目录占位，固定鉴权平台适配 package 落位。 22. 创建 `packages/platform-oss/` 目录占位，固定 OSS 平台适配 package 落位。 23. 创建 `packages/platform-llm/` 目录占位，固定大模型平台适配 package 落位。 +24. 创建 `packages/spacetime-client/` 目录占位，固定 SpacetimeDB 客户端适配 package 落位。 后续任务会继续在本目录内按顺序补齐： -1. `packages/spacetime-client` -2. `packages/tests-support` -3. `scripts/*` +1. `packages/tests-support` +2. `scripts/*` ## 3. 已冻结边界 diff --git a/server-rs/packages/spacetime-client/README.md b/server-rs/packages/spacetime-client/README.md new file mode 100644 index 00000000..572fcc33 --- /dev/null +++ b/server-rs/packages/spacetime-client/README.md @@ -0,0 +1,28 @@ +# spacetime-client 共享 package 占位说明 + +日期：`2026-04-20` + +## 1. package 职责 + +`spacetime-client` 是 SpacetimeDB 客户端适配 package，后续负责： + +1. 生成 bindings 后的客户端访问封装 +2. Axum 与各模块对 reducer、view、订阅的调用适配 +3. 身份透传、连接配置与基础错误处理适配 + +## 2. 当前阶段说明 + +当前提交仅完成目录占位，不提前进入 bindings 生成、调用封装与订阅实现。 + +后续与本 package 直接相关的任务包括： + +1. 设计 bindings 生成与更新流程 +2. 设计 reducer、view、订阅的统一调用接口 +3. 设计身份透传与连接配置策略 +4. 设计 Axum / worker / 测试环境下的客户端复用方式 + +## 3. 边界约束 + +1. `spacetime-client` 只承接 SpacetimeDB 客户端访问适配，不承接具体业务模块的规则实现。 +2. 业务状态真相仍由 `apps/spacetime-module` 管理，业务编排由各模块 package 与 `apps/api-server` 承担。 +3. 不允许把 reducer、view、订阅调用细节重新散落到多个业务模块里各自实现。