# Issue CSV 规则（hyb-oa）

本项目使用 Issue CSV 作为需求驱动与执行合同。

## 连续型 Issue 原则

GOV8 后默认采用“少量长期连续合同 + 多行任务 + 阶段收口”，避免每次聊天、小反馈或单点修正都创建新 CSV。

- 同类型、同目标、同风险域的问题进入同一个连续 CSV。
- 一个连续 CSV 最多承载一个治理流，不混入无关业务域。
- 只有跨业务域、跨风险等级、跨里程碑，或当前治理流阶段性收口后，才新建下一版 CSV。
- 旧 Issue CSV 不删除、不批量回写、不移动到归档目录；它们是历史审计证据。
- 当前可执行合同以 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md` 标注的“当前活跃治理流”为准。

当前优先治理流：

| 治理流 | 建议/当前文件 | 用途 |
| --- | --- | --- |
| `GOV8` | `2026-05-13_16-31-09-gov8-system-governance.csv` | 文档、流程、Issue 管理和审计治理 |
| `R7E` | 待新建连续 CSV | 真实扩大试运行 |
| `ORG8` | 待新建连续 CSV | 组织账号和权限主数据 |
| `WF8` | 待新建连续 CSV | 审批与通知增强 |
| `BIZ8` | 待新建连续 CSV | 报销/OCR/财务/项目轻量增强 |
| `QAOPS8` | 待新建连续 CSV | 测试、发布、运维和上线准备 |

## 必填列（全部必填）
- `ID`
- `Title`
- `Description`
- `Acceptance`
- `Test_Method`
- `Tools`
- `Dev_Status`
- `Review1_Status`
- `Regression_Status`
- `Files`
- `Dependencies`
- `Notes`

## 状态值
仅允许：`TODO | DOING | DONE`

## 字段规范
- `ID`：唯一标识（如 `A1`、`A2`）。
- `Acceptance`：可判定完成与否。
- `Test_Method`：必须可复现（命令或明确步骤）。
- `Tools`：优先写实际工具/SDK；不可自动化则写 `manual`。
- `Files`：必须给出实际路径范围或哨兵值，不能留空。
- `Dependencies`：**统一 JSON 数组字符串**（不再使用 `A1|A2`）。

## 哨兵值
- `Files`: `N/A | external | TBD | module:<name> | <glob>`
- `Dependencies`: `[]`
- `Notes`: `none`
- `Tools`: `manual | none`

## Review 与 Regression
- `Review1_Status`：Issue 实现后的单项验证。
- `Regression_Status`：全部相关变更合并后的回归验证。

仅在 `Test_Method` 实测通过后，状态可标记 `DONE`。

## CSV 格式约束
- 字段含英文逗号时，必须用双引号包裹。
- 字段内多值可用 `|`。
- UTF-8 编码。

## 权威读取顺序
- **当前执行合同**：优先查看 `docs/文档索引.md` 和 `docs/文档事实源状态矩阵.md` 标注的当前活跃治理流；不要只按文件时间最新判断。
- **历史蓝图链**：P5 相关只把 [2026-02-09_13-39-02-p5-blueprint-v3.csv](/home/shunli/Projects/hyb-oa/issues/2026-02-09_13-39-02-p5-blueprint-v3.csv:1) 视为权威完成态；[2026-02-09_11-17-07-p5-blueprint.csv](/home/shunli/Projects/hyb-oa/issues/2026-02-09_11-17-07-p5-blueprint.csv:1) 和 [2026-02-09_12-34-42-p5-blueprint-v2.csv](/home/shunli/Projects/hyb-oa/issues/2026-02-09_12-34-42-p5-blueprint-v2.csv:1) 保留为历史快照，不再单独作为当前待办来源。
- **试运行链**：本地/外部试运行相关优先串读 `R70 -> R71 -> R73 -> R74 -> R75 -> R76 -> R77 -> R78 -> R79 -> R80 -> R82 -> R83-R86 -> R87 -> R88 -> R89 -> R90/R91`，不要只看单一 CSV 判断系统状态。
- **跨文档事实源**：业务能力现状优先结合 [历史功能状态矩阵.md](/home/shunli/Projects/hyb-oa/docs/历史功能状态矩阵.md:1)、[试运行覆盖矩阵.csv](/home/shunli/Projects/hyb-oa/docs/trialrun/试运行覆盖矩阵.csv:1) 和 [人工试运行报告.md](/home/shunli/Projects/hyb-oa/docs/trialrun/人工试运行报告.md:1) 阅读。

## 历史合同处理原则
- 不批量回改旧 CSV 的 `TODO/DOING/DONE` 来伪造一致性。
- 若后续合同替代前一版合同，在新合同或索引文档里补“superseded / authoritative”说明。
- 需要做全局状态判断时，以最新合同、覆盖矩阵和试运行报告交叉验证，不以单个旧 CSV 为准。