# spacetime-module 主工程 package 占位说明

日期：`2026-04-20`

## 1. package 职责

`spacetime-module` 是新后端的 SpacetimeDB 主工程 package，后续负责：

1. 聚合各独立模块 package 的表定义
2. 聚合各独立模块 package 的 reducer
3. 聚合各独立模块 package 的 view / 读模型
4. 生成可发布的 SpacetimeDB wasm 模块

## 2. 当前阶段说明

当前提交仅完成目录占位，不提前进入具体 schema 与 reducer 实现。

后续与本 package 直接相关的任务包括：

1. 建立模块聚合入口
2. 设计表、reducer、view 的聚合方式
3. 接入身份 claims 透传
4. 接入本地开发与发布脚本

## 3. 边界约束

1. `spacetime-module` 只聚合状态模型，不直接承接 HTTP、Cookie、Header、OSS、短信、微信、LLM 等外部副作用。
2. 每个业务模块优先在自己的 `packages/module-*` 中定义状态与规则，再由主工程聚合。
3. 主工程不重新吞并各模块实现细节，避免回到单大包结构。