A1-A4 补充标准软件开发流程文档

2026-05-09 17:05:44 +08:00
@@ -44,16 +44,30 @@

 ## 2. 软件开发项目流程

-后续所有非微小改动按以下流程推进：
+后续所有非微小改动按标准软件开发流程推进。流程目标不是增加仪式感，而是保证每轮都有清晰需求、可执行方案、可验证结果、可回滚边界和可追溯记录。

-1. 需求收集与边界确认：明确目标用户、业务流程、必须做、暂不做、验收标准。
-2. 需求文档冻结：更新本文件或对应规则文档，形成产品、开发、测试共同事实源。
-3. 执行合同拆分：新建 `issues/YYYY-MM-DD_HH-mm-ss-<slug>.csv`，写清范围、验收、测试、依赖。
-4. 技术方案设计：明确接口、数据模型、权限、状态机、前端入口、回滚策略。
-5. 开发实现：按 Issue 分后端、前端、QA 阶段推进，不顺手做无关改动。
-6. 测试与回归：先单点验证，再业务流程回归，最后做 PC/移动/企业微信入口验证。
-7. 部署与验收：部署后检查 `/ready`、前端资源、关键路径、企业微信真机入口。
-8. 复盘与下一轮规划：把试运行反馈转成新 Issue CSV，不直接插入开发。
+| 阶段 | 目标 | 输入 | 输出 | 门禁 |
+| --- | --- | --- | --- | --- |
+| 1. 需求收集与边界确认 | 明确为什么做、谁使用、解决什么流程问题 | 用户反馈、试运行问题、业务制度、当前 PRD 和模块规约 | 需求描述、目标角色、主流程、必须做、暂不做、验收口径 | 需求不清不得进入开发；高风险歧义必须先澄清 |
+| 2. 需求文档冻结 | 形成产品、开发、测试共同事实源 | 主 PRD、模块规约、产品口径文档、历史 Issue | 更新后的 PRD 或模块规约 | 没有事实源更新，不拆开发 Issue |
+| 3. Issue CSV 执行合同拆分 | 把需求拆成可独立验收的任务 | 已确认需求文档 | `issues/YYYY-MM-DD_HH-mm-ss-<slug>.csv` | CSV 必须校验通过；每个 Issue 写清范围、验收、测试、依赖 |
+| 4. 技术方案设计 | 明确怎么实现和怎么回滚 | Issue CSV、现有代码、数据模型、接口和权限规则 | 实现方案、接口/数据变更说明、风险和回滚策略 | 涉及权限、状态机、迁移、审批规则时必须写回滚策略 |
+| 5. 开发实现 | 按 Issue 实现后端、前端、脚本或文档 | 已批准方案和 Issue CSV | 代码或文档变更、必要测试用例、变更说明 | 不顺手改无关问题；跨端任务先稳定后端契约再接前端 |
+| 6. 代码审查与自查 | 发现行为回归、权限泄漏、状态非法跳转和漏测 | 完整 diff、Issue CSV、测试结果 | Review 意见、修复记录或确认无阻断问题 | 涉及权限模型、workflow、数据迁移、审批规则时必须重点审查 |
+| 7. 测试与回归 | 证明单点和业务链路都可用 | 变更内容、Test_Method、回归脚本、手工验收步骤 | 命令结果、业务流程验证结果、失败项和修复记录 | 后端、前端、PC、移动、企业微信入口按影响范围验证；不能假通过 |
+| 8. 部署与发布准备 | 确认环境、配置、资源和回滚路径可用 | 已验证变更、部署脚本、配置清单、回滚策略 | 部署记录、`/ready` 检查、资源版本、配置复核 | 未部署不得告知用户可去公网或企业微信真机测试 |
+| 9. 业务验收 | 让目标角色按真实路径确认结果 | 已部署环境、验收账号、样例数据、验收清单 | 验收结论、遗留问题、是否进入试运行 | 用户或指定验收人未确认前，不把体验问题视为关闭 |
+| 10. 复盘与下一轮规划 | 把反馈转成下一轮可执行任务 | 验收反馈、线上问题、回归缺口、试运行记录 | 新需求、缺陷清单、下一轮 Issue CSV 草案 | 不直接把反馈插入开发；先回到需求和 Issue CSV |
+
+### 2.1 本项目执行约束
+
+- 所有非微小改动必须先有需求事实源和 Issue CSV 执行合同。
+- 开发前必须说明实现方案；需求或方案不清时先澄清，不靠代码试错。
+- `Dev_Status`、`Review1_Status`、`Regression_Status` 只能在对应验证通过后更新为 `DONE`。
+- 后端变更至少执行 Prisma 校验、语法检查和相关业务回归；前端变更至少执行 typecheck、build，并按影响范围补 Playwright 或人工视觉验证。
+- 涉及 PC、手机、企业微信入口的改动，必须验证入口、布局、deeplink 和移动端体验。
+- 涉及生产、公网、企业微信真机或真实 OCR 的结论，必须以部署后 live smoke 为准；未配置真实条件时必须明确 `SKIP` 和原因。
+- 提交应按清晰主题小批次完成，commit message 使用中文并引用 Issue ID。

 ---