35 lines
1.8 KiB
Markdown
35 lines
1.8 KiB
Markdown
# 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](../../../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](../../../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 承接。
|