# module-big-fish 独立模块 package 说明

日期：`2026-04-30`

## 1. package 职责

`module-big-fish` 是大鱼吃小鱼创作与运行态规则模块 package，负责：

1. 创作会话、锚点包、草稿、资产槽和作品摘要的纯领域类型。
2. 草稿编译、资产覆盖、发布门禁、字段校验和序列化规则。
3. Big Fish 运行态一局的服务端真相源规则。
4. 为 `spacetime-module`、`spacetime-client` 和 `api-server` 提供稳定领域边界。

## 2. 当前阶段说明

当前 DDD 物理拆分已经收口：

1. `src/domain.rs` 承接创作阶段、锚点、资产槽、草稿、会话、作品摘要、发布门禁和运行态领域类型。
2. `src/commands.rs` 承接会话、消息、草稿、资产、发布、游玩记录和运行态输入 DTO。
3. `src/application.rs` 承接锚点推断、默认草稿编译、资产覆盖、资产槽构造、字段校验、序列化与运行态真相源规则。
4. `src/errors.rs` 承接应用错误、字段错误和中文错误文案。
5. `src/events.rs` 承接发布门禁和运行态领域事件。
6. `src/lib.rs` 只保留模块声明、公开导出和测试，继续保持 `module_big_fish::*` 公开 API。

## 当前文档入口

当前长期工程口径已融合到：

1. [../../../docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md](../../../docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md)
2. [../../../docs/【玩法创作】平台入口与玩法链路-2026-05-15.md](../../../docs/【玩法创作】平台入口与玩法链路-2026-05-15.md)
3. [../../../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md](../../../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md)

旧阶段设计文档不再作为实现依据。
## 3. 边界约束

1. `module-big-fish` 不直接调用图片生成、OSS、HTTP、SSE 或 SpacetimeDB SDK。
2. 领域函数只处理纯规则和可序列化领域事实。
3. 表、procedure、route、前端 client 和绑定 shape 由外层 adapter 承接。