删除hook,框架改动
This commit is contained in:
@@ -25,35 +25,22 @@
|
||||
|
||||
| 篇 | 文档 | 解决什么 |
|
||||
|----|------|----------|
|
||||
| 00 | 本文 README | 定位、适用范围、一页纸总则、与既有文档的关系 |
|
||||
| 00 | 本文 README | 定位、怎么读、与既有文档的关系 |
|
||||
| — | [一页纸总则.md](./一页纸总则.md) | **七大总则 + 适用边界**(由 `CLAUDE.md` 常驻加载,设计取舍时对照) |
|
||||
| 01 | [01-架构总则与分层.md](./01-架构总则与分层.md) | 七大架构总则;前后端参考分层;依赖方向与稳定依赖 |
|
||||
| 02 | [02-可扩展性与配置化.md](./02-可扩展性与配置化.md) | 扩展模式(注册表/策略/管线/工厂/事件)何时用;配置化与去硬编码;避免过度设计 |
|
||||
| 03 | [03-数据权威·错误处理·演进.md](./03-数据权威·错误处理·演进.md) | 数据权威(前后端);错误处理与可观测;演进与重构;反模式与审查清单 |
|
||||
|
||||
---
|
||||
|
||||
## 一页纸:七大总则
|
||||
## 一页纸总则
|
||||
|
||||
1. **单一权威数据源(SSOT)**:同一业务数据只有一个计算/写入处,其他只读;缺失即显式失败,不兜底掩盖。
|
||||
2. **单向依赖**:分层自上而下依赖,稳定的被依赖、易变的作依赖方;**禁止环形依赖**。
|
||||
3. **职责单一、边界清晰**:一个职能只在一个模块实现,别处**调用而非重造**。
|
||||
4. **关注点分离**:决策与机制分离、数据与表现分离、编排与算法分离。
|
||||
5. **对扩展开放、对修改封闭(OCP)**:用注册/策略/管线**加**能力,不改动已稳定的核心。
|
||||
6. **配置优先于硬编码**:会变、复用、无语义的值一律外提为常量/配置,用数据驱动行为。
|
||||
7. **显式失败优于隐式兜底**:关键路径缺数据就报错/返回 `null`,把问题暴露在最近处。
|
||||
**七大总则与适用边界已独立成篇:[一页纸总则.md](./一页纸总则.md)。**
|
||||
|
||||
> 这七条互相支撑:**SSOT + 显式失败**保正确,**单向依赖 + 职责单一 + 关注点分离**保清晰,
|
||||
> **OCP + 配置化**保可演进。任何设计取舍,回到这七条对照。
|
||||
该文件由 `CLAUDE.md` 通过 `@import` 常驻每次会话上下文,是总则的权威源;本 README 只负责导航,不重复抄写总则(避免两处不同步)。总则的展开见 [01-架构总则与分层.md](./01-架构总则与分层.md)。
|
||||
|
||||
---
|
||||
|
||||
## 适用范围与边界
|
||||
|
||||
- **适用**:子游戏自身的前后端业务代码(玩法逻辑、对局编排、收发包处理、表现层、共享算法)。
|
||||
- **不覆盖**:平台框架代码(不可改)、平台接入契约(见各端 `development-guide/`)。
|
||||
- **与硬约束的关系**:ES5、`require` 守卫、可编辑范围、成败标志 `data.success` 等**硬红线**仍以
|
||||
`development-guide/` 为准;本套是**方法论层**,与之互补不冲突。
|
||||
|
||||
## 与既有文档的关系
|
||||
|
||||
| 文档 | 定位 |
|
||||
|
||||
Reference in New Issue
Block a user