docs: add spacetime client package placeholder

This commit is contained in:
2026-04-21 00:56:11 +08:00
parent 41d9d88757
commit 17a033ecc7
3 changed files with 34 additions and 5 deletions

View File

@@ -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 基础能力

View File

@@ -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. 已冻结边界

View File

@@ -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、订阅调用细节重新散落到多个业务模块里各自实现。