Genarrative/server-rs/crates/module-big-fish/README.md

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/technical/SERVER_RS_DDD_WP_BF_RUNTIME_BACKEND_TRUTH_2026-04-29.md
2. ../../../docs/technical/SERVER_RS_DDD_WP_BF_AND_G2_DRIFT_CLEANUP_2026-04-30.md

3. 边界约束

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