架构收敛批第2步: 模块表残留引用八处改指——存档序列化断点键登记单源改「承载件常量登记」; 冒险结构三层结构改指实现类头注; 术语表效果端口件机制归属改指实现类文件头注; 战斗结算删架构文档模块行尾巴; code-conventions 组合根成员与边界改指各件头注; AGENTS.md 导航行与红线行、doc-conventions 唯一源行同步依赖规则形态措辞; architecture 测试域自引用与架构图 region 标签改「目录归属」; archify 重渲染 ok errors=0。凭据: --docs 能力审计红项26=「模块归属」节锚待第3步迁移(删节导致, 非本步缺陷), 其余闸与基线一致

This commit is contained in:
DKChan committed 2026-11-09 02:00:14 +08:00
1 parent 14637151e7
commit d7d5242fe9
10 files changed
+58 -58

No files matched your search

+1 -1
View File
@@ -18,7 +18,7 @@
设计稿与实现同尺度:功能 = 类(状态 + 行为 + 信号),类是封装的最小交付单位。工具性纯函数只允许挂在明确的宿主类下(静态装配器/工厂),不允许无主散落。
### 1.3 依赖单向,核心写调用完成
依赖方向唯一:`views →(信号)→ 组合根 →(写调用)→ core`。视图零核心写调用(纯 setter / 信号外发优先);"读核心状态 → 拼展示文案"集中于装配器(presenter);核心写接口(settle_batch / player_request_refresh / runner 推进)只允许在组合根出现——组合根=main.gd+其构造注入的组合根拆件(成员与边界见架构文档「模块归属·呈现层」),视图不得直连拆件。
依赖方向唯一:`views →(信号)→ 组合根 →(写调用)→ core`。视图零核心写调用(纯 setter / 信号外发优先);"读核心状态 → 拼展示文案"集中于装配器(presenter);核心写接口(settle_batch / player_request_refresh / runner 推进)只允许在组合根出现——组合根=main.gd+其构造注入的组合根拆件(成员与边界见各件文件头注),视图不得直连拆件。
### 1.4 命名 = 领域命名,禁止系统 ID 前缀
文件名与类名禁止 `a1_`/`b1_`/`c1_` 等系统 ID 前缀(`a1_board_generator.gd` → `board_generator.gd`)。设计追溯不靠前缀:代码↔设计的追溯由 GDD 文档承担,系统 ID 只作为文档的追溯锚;文件头注不承担追溯职责,不写任何文档链接(§1.4.1)。豁免:D2 schema 类与 autoload;文档/夹具登记名(如 b4_golden)属文档层。