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.
2.0 KiB
2.0 KiB
module-big-fish 独立模块 package 说明
日期:2026-04-30
1. package 职责
module-big-fish 是大鱼吃小鱼创作与运行态规则模块 package,负责:
- 创作会话、锚点包、草稿、资产槽和作品摘要的纯领域类型。
- 草稿编译、资产覆盖、发布门禁、字段校验和序列化规则。
- Big Fish 运行态一局的服务端真相源规则。
- 为
spacetime-module、spacetime-client和api-server提供稳定领域边界。
2. 当前阶段说明
当前 DDD 物理拆分已经收口:
src/domain.rs承接创作阶段、锚点、资产槽、草稿、会话、作品摘要、发布门禁和运行态领域类型。src/commands.rs承接会话、消息、草稿、资产、发布、游玩记录和运行态输入 DTO。src/application.rs承接锚点推断、默认草稿编译、资产覆盖、资产槽构造、字段校验、序列化与运行态真相源规则。src/errors.rs承接应用错误、字段错误和中文错误文案。src/events.rs承接发布门禁和运行态领域事件。src/lib.rs只保留模块声明、公开导出和测试,继续保持module_big_fish::*公开 API。
当前文档入口
当前长期工程口径已融合到:
- ../../../docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md
- ../../../docs/【玩法创作】平台入口与玩法链路-2026-05-15.md
- ../../../docs/【开发运维】本地开发验证与生产运维-2026-05-15.md
旧阶段设计文档不再作为实现依据。
3. 边界约束
module-big-fish不直接调用图片生成、OSS、HTTP、SSE 或 SpacetimeDB SDK。- 领域函数只处理纯规则和可序列化领域事实。
- 表、procedure、route、前端 client 和绑定 shape 由外层 adapter 承接。