61 lines
1.2 KiB
Markdown
61 lines
1.2 KiB
Markdown
# 系统模式与约束
|
||
|
||
<!--
|
||
填写指南：
|
||
- 本文件记录跨模块稳定成立的实现模式，而不是一次性的设计草图
|
||
- 优先记录：模块边界、数据流、不变量、扩展路径、禁止破坏的约束
|
||
- 小项目可只保留最关键的 2-3 个部分
|
||
-->
|
||
|
||
## 模块边界
|
||
|
||
<!-- 至少列出主要模块及其职责边界 -->
|
||
|
||
### {{MODULE_1}}
|
||
|
||
- **职责**：{{MODULE_1_DESC}}
|
||
- **输入**：{{MODULE_1_INPUT}}
|
||
- **输出**：{{MODULE_1_OUTPUT}}
|
||
- **不应负责**：{{MODULE_1_NON_GOAL}}
|
||
|
||
## 关键数据流
|
||
|
||
<!-- 描述系统中的主路径；按“输入 -> 处理 -> 输出”写 -->
|
||
|
||
1. {{FLOW_STEP_1}}
|
||
2. {{FLOW_STEP_2}}
|
||
3. {{FLOW_STEP_3}}
|
||
|
||
## 核心不变量
|
||
|
||
<!-- 这些约束一旦被破坏，系统行为就可能失真 -->
|
||
|
||
- {{INVARIANT_1}}
|
||
|
||
## 常见实现模式
|
||
|
||
<!-- 给 AI 明确“这里通常怎么改” -->
|
||
|
||
### {{PATTERN_1}}
|
||
|
||
- **适用场景**：{{PATTERN_1_SCENARIO}}
|
||
- **推荐做法**：{{PATTERN_1_APPROACH}}
|
||
- **避免事项**：{{PATTERN_1_AVOID}}
|
||
|
||
## 扩展路径
|
||
|
||
<!-- 新增功能时，优先走哪些入口或目录 -->
|
||
|
||
1. {{EXTENSION_STEP_1}}
|
||
2. {{EXTENSION_STEP_2}}
|
||
|
||
## 禁止破坏的约束
|
||
|
||
<!-- 记录兼容性、安全性或组织层面的硬约束 -->
|
||
|
||
- {{DO_NOT_BREAK_1}}
|
||
|
||
---
|
||
|
||
**最后更新**：{{DATE}}
|