6.6 KiB
6.6 KiB
验收标准（AC）— 依据 prd.md v1.24，14 条 FR 全覆盖
格式：Given/When/Then；编号 AC-{FR后缀}-{序号}；每条 FR ≥1 正常 + ≥1 异常/边界。 分期标注同 FR：①一期 ②二期 ③三期。
AC-001 用户需求管理（FR-001，复用+②）
- AC-001-1（正常路径）
- Given：业务部门在系统创建用户需求并提交评审
- When：全员评审通过（userReview）
- Then：status=active；revieweddate 落库（=审批时间口径）；二期后 activateddate 同步落库
- AC-001-2（异常路径）
- Given：需求处于 reviewing
- When：评审不通过（revieweResult=0）
- Then：需求关闭，closedby/closeddate/closedreason 落库
AC-002 需求讨论会与纪要 MD（FR-002，②）
- AC-002-1（正常路径）
- Given：已创建会议（关联用户需求）
- When：上传 .md 会议纪要（可多次）
- Then：zt_file(objectType=meeting) 新增附件；列表显示操作人（addedBy）/操作时间（addedDate）/会议人（users）；点击在线渲染；zt_meeting.url 刷新为最新一份
- AC-002-2（边界）
- Given：上传 PDF/图片格式纪要
- Then：维持下载查看，不渲染
- AC-002-3（异常/匹配）
- Given：需求 ID=12，存在关联需求 112 的会议
- When：查看需求 12 的「需求讨论会议」tab
- Then：仅列出 FIND_IN_SET 精确匹配需求 12 的会议，不误中 112
AC-003 PRD 文档管理（FR-003，复用+②）
- AC-003-1（正常路径）
- Given：PRD 定稿（pmassist 产出 .md）
- When：经 /common/upload 上传至需求（FileTypes.story/userStory）
- Then：附件列表可见可下载；生成时间记入工作日志 MD（prd_version 类，FR-011）
- AC-003-2（边界）
- Given：同一需求上传多版 PRD
- Then：多份按上传时间排列，历史均可下载
AC-004 需求级 AI 工作量指标（FR-004，①+②）
- AC-004-1（正常路径）
- Given：框架完成评估
- When：调 /zt-story-expand/saveOrUpdate（含 aiParticipationRate）
- Then：zt_story_expand 落库，含 ai_participation_rate 新列
- AC-004-2（幂等）
- Given：同 storyId 已存在记录
- When：再次提交
- Then：更新不新增（一行记录）
- AC-004-3（异常）
- Given：需求 requirementStatus=finished
- When：再次提交变更
- Then：拒绝（沿用现有 finished 锁定规则）
AC-005 验收标准与测试用例管理（FR-005，复用）
- AC-005-1（验证）
- Given：研发需求已录入验收标准（verify）与用例
- Then：详情页展示验收标准富文本；用例评审链（story-case）可流转
AC-006 研发任务双通道（FR-006，②）
- AC-006-1（正常路径）
- Given：合法 aiBatchAdd 报文（含 devel/test 任务）
- When：提交
- Then：任务批量创建：status=wait、创建人=ai、estimate=aiEvaluationTime；响应返回 taskIds；测试任务指派测试人员
- *AC-006-2（异常路径）
- Given：storyId 不存在或 type 非法
- Then：整批拒绝，code≠0，零入库
- AC-006-3（防重）
- Given：同 storyId+name+type 已存在
- Then：跳过并记入 skipped，其余正常创建
AC-007 任务级 AI 工时（FR-007，豁免验证）
- AC-007-1（正常路径）
- When：aiBatchAdd 创建任务
- Then：zt_task.estimate=报文 aiEvaluationTime（标准字段直接可用，无扩展表）
- AC-007-2（豁免）
- Then：数据库中不存在 zt_task_extend 表（CHG-019 不建）
AC-008 AI 代码审查报告 MD（FR-008，②）
- AC-008-1（正常路径）
- Given：需求下全部开发任务完工
- When：uploadBind 上传审查 MD（objectType=aiCodeReview）
- Then：zt_file 落附件；code_review_url 刷新；code_review_status 写入（pass/reject）；详情页在线查看
- AC-008-2（SOP 卡点）
- Given：code_review_status≠pass（NULL 或 reject）
- Then：「提交测试报告」按钮禁用
- AC-008-3（多轮回炉）
- Given：第 1 轮 reject 后修复
- When：上传第 2 轮报告
- Then：url 刷新为最新；历史多份保留；extra.round 递增
- AC-008-4（异常）
- Given：缺 storyId 或 objectType 非法
- Then：拒绝并返回错误
AC-009 测试任务与 BUG（FR-009，复用）
- AC-009-1（验证）
- Then：BUG 全流程可走通：提交→指派→修复→复测→验收（bugYs）
AC-010 测试类文档 4 字段（FR-010，②）
- AC-010-1（用例/模版）
- Then：测试用例（testCase）与报告模版（testReport）可查看、可下载，不可上传覆盖
- AC-010-2（提交）
- When：上传填完的报告（testReportSubmit）
- Then：test_report_submit_url 刷新；FR-014 判定该项齐备
- AC-010-3（其他文档）
- When：上传其他测试文档（testOther）
- Then：test_other_url 刷新，可查看下载
AC-011 AI 工作日志 MD（FR-011，②）
- AC-011-1（正常路径）
- Given：框架节点产出日志 MD
- When：upload_md.py --type aiWorkLog 上传
- Then：zt_file(aiWorkLog) 落附件、work_log_url 刷新、在线查看
- AC-011-2（时效）
- Then：事件产生即传，不做月末批量补传；人工按钮为备选通道
AC-012 工作量指标完成率统计（FR-012，③）
- AC-012-1（正常路径）
- Given：zt_story_month_workload 当月有数据、考勤可用
- When：查询完成率
- Then：=Σ(月度工作量指数)÷(团队可用工作天数×5)；测试人员不计入产出方
AC-013 九岗位绩效报表（FR-013，③）
- AC-013-1（规则配置化）
- Given：zt_perf_config 已灌入 7.5 权重规则
- Then：✅ 项自动产出；权重/阈值改动仅需改配置
- AC-013-2（对拍验收）
- Given：最近 1~2 个已线下考核月份
- Then：系统算分与线下 Excel 一致或差异可解释
AC-014 大型需求文档齐备自动核查（FR-014，③）
- AC-014-1（正常路径）
- Given：大型需求（指数>20）五类文档齐全
- When：月度核查
- Then：五类全 ✓、不扣分、写 zt_doc_check 快照
- AC-014-2（扣分）
- Given：缺 2 份
- Then：扣 4 分（每份 2 分）写 zt_month_score.scopeJson
- AC-014-3（判定源正确性）
- Then：《需求测试报告》以 zt_file(testReportSubmit) 为准（非 testReport 模版）；《AI 文档更新记录》以 zt_file(aiWorkLog) 中 doc_update 类为准
- AC-014-4（异议）
- Given：对判定结果申诉
- When：技术负责人复核撤销
- Then：回滚对应扣分并留痕