Files
Genarrative/server-rs/crates/module-big-fish/README.md
高物 3cb3efb4d0 Prune stale docs and update .hermes content
Delete a large set of outdated documentation (many files under docs/ and .hermes/plans/, including audits, design, prd, technical, planning, assets, and todos). Update and consolidate .hermes content: refresh shared-memory pages (decision-log, development-workflow, document-map, pitfalls, project-overview, team-conventions) and several skills/references under .hermes/skills. Also modify AGENTS.md, README.md, UI_CODING_STANDARD.md, docs/README.md and .encoding-check-ignore. Purpose: clean up stale planning/audit material and keep current hermes documentation and related top-level docs in sync.
2026-05-15 06:24:07 +08:00

2.0 KiB
Raw Blame History

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

日期:2026-04-30

1. package 职责

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

  1. 创作会话、锚点包、草稿、资产槽和作品摘要的纯领域类型。
  2. 草稿编译、资产覆盖、发布门禁、字段校验和序列化规则。
  3. Big Fish 运行态一局的服务端真相源规则。
  4. spacetime-modulespacetime-clientapi-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
  2. ../../../docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
  3. ../../../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md

旧阶段设计文档不再作为实现依据。

3. 边界约束

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