文档设计(架构审查5.1封装修复·用户裁): 设计讨论结论落档两交付——①处置记录 reports/处置-架构审查5.1封装修复-2026-11-03.md(总判据六条/根因定稿三无叠加/普查五处 core 105行107处19符号+presentation 227行出卡/逐项裁决记录/19符号行为归属总表/架构锚点; 接收方=需求卡片-架构审查5.1封装修复-2026-11-03.md+待办清单架构审查优化讨论条目, 卡片成立即退役); ②code-conventions.md 新增 §1.6 拆分交接与封装边界(条一拆分交接定义=职责边界+交接定义双齐备才算拆分合格, 先例=BoardInstaller 引用束注入; 条二封装边界=跨对象禁访问下划线成员只走公开面)——本批修复与后续闸件共同依据; GDD 零改动; 文档域闸全绿(8闸 all_green)

This commit is contained in:
DKChan committed 2026-11-03 05:39:07 +08:00
1 parent 6261b36ecd
commit 3be3f3e7c1
2 files changed
+99

No files matched your search

+6
View File
@@ -34,6 +34,12 @@
### 1.5 禁止事实约定
任何"大家默认这么做"的惯例必须成文进本文件(或 AGENTS.md)才算存在。写代码时发现未成文但必须遵守的约定 → 当场补条文,不许靠惯性延续。
### 1.6 拆分交接与封装边界
本节管拆分类改动的交接面与封装面,与 §1.1 拆分判据(职责轴)配合使用:§1.1 管怎么切,本节管切完之后件与件之间怎么往来。
1. **拆分交接定义**:拆出一个新类时,交付物必须同时写明职责边界与交接定义——新类构造时需要哪些依赖,由拆出它的类在构造它时一次交给它;新类需要回调拆出它的类的哪些方法,以 Callable 形式交付。两者齐备才算拆分合格。为什么:只切职责不定义交接,新件会伸手回原类内部拿东西,封装从拆件那天起就破了。正面先例=装板件的引用束注入(表数据、随机流、装板所需对象与出错回调一次性交付——架构文档「战斗编排域拆件定稿」节 BoardInstaller 行在册)。
2. **封装边界**:任何代码不得访问其他对象的下划线成员;跨对象往来只走公开方法与属性。为什么:下划线只是命名约定,语言不设防、无编译期检查——此条是封装硬纪律,违者即红。
---
## 2. 契约纪律——跨层/跨类调用的语义