From 7534fd60157096dab2c6f06214acfff84d1a5370 Mon Sep 17 00:00:00 2001
From: ila <ila2002@qq.com>
Date: Sat, 8 Aug 2026 08:56:29 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BB=BA=E7=AB=8B=E4=B8=9A=E5=8A=A1?=
 =?UTF-8?q?=E8=A7=84=E5=88=99=E4=B8=8E=E6=9C=AF=E8=AF=AD=E9=A1=B5=20(#2)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Business-Rules-and-Glossary.-.md | 53 ++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 Business-Rules-and-Glossary.-.md

diff --git a/Business-Rules-and-Glossary.-.md b/Business-Rules-and-Glossary.-.md
new file mode 100644
index 0000000..875d56b
--- /dev/null
+++ b/Business-Rules-and-Glossary.-.md
@@ -0,0 +1,53 @@
+# 业务规则与术语
+
+## 本页用途
+
+解释 DevHarness 中容易混淆的术语、状态和不可破坏的流程规则。新项目复制模板后，应把项目自身的业务术语、状态和关键约束补充到本页。
+
+## 核心术语
+
+| 术语 | 含义 | 不要误解为 |
+|---|---|---|
+| Epic | 完整产品目标和长期路线 | 可以直接实施的单个任务 |
+| MVP | 第一个可交付范围及集成边界 | 任意里程碑名称 |
+| 单元任务 | 唯一正式实施单位，可独立测试和回退 | 临时聊天待办 |
+| 事实来源 | 某类信息被正式维护的位置 | 多处内容可以随意覆盖 |
+| Wiki 主源 | 长期开发文档首先修改的位置 | 本地 docs 的备份副本 |
+| docs 镜像 | 从 Wiki 单向生成的浏览副本 | 可以直接编辑并反向同步的文档 |
+| 待验收 | 实现和测试已完成，等待用户确认 | 已完成并可关闭 |
+| 未验证部分 | 本次无法真实覆盖的行为 | 可以省略的测试备注 |
+
+## 工单状态
+
+| 状态 | 含义 | 可以进入下一状态的条件 |
+|---|---|---|
+| 待确认 | 目标或方案仍需用户选择 | 用户明确确认方案 |
+| 待实施 | 方案已确认，尚未修改 | 工作区和范围检查完成 |
+| 进行中 | 正在实现、测试或同步文档 | 验收标准逐项检查完成 |
+| 阻塞 | 满足规则定义的持续阻塞条件 | 阻塞解除并更新工单 |
+| 待验收 | 代码、测试、归档和证据已完成 | 用户明确验收 |
+| 已完成 | 用户已验收并完成父任务同步 | 无 |
+
+## 稳定业务规则
+
+- 没有确认方案和单元任务工单，不修改产品行为。
+- 一个单元任务只解决一个可独立验证和回退的问题。
+- 需求、接口、数据、安全边界或验收标准变化时先更新工单。
+- 长期文档必须先修改 Wiki，再导出本地镜像。
+- 测试结果必须真实；未执行的验证必须明确记录。
+- 用户未明确验收前，工单保持开启。
+- 初级程序员可以理解和验证低风险修改，但高风险决策仍由 Agent 分析并等待人工确认。
+
+## 新项目需要补充什么
+
+复制模板后，至少补充：
+
+- 项目的用户和核心目标；
+- 业务名词及容易混淆的概念；
+- 主要对象和状态；
+- 关键状态流转；
+- 必须始终满足的业务规则；
+- 数据保留、权限和安全边界；
+- 典型输入、输出和失败示例。
+
+业务规则必须由项目负责人确认，Agent 可以整理和举例，但不能根据代码自行臆造。