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

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