feat: 根目录文档、脚本、gitignore

This commit is contained in:
2026-10-08 16:15:33 +08:00
commit e98660ce4e
284 changed files with 26838 additions and 0 deletions
@@ -0,0 +1,28 @@
# Round 1
## Plan
- WWH 填充度:完整(What/Why/How 见 desc.md;架构边界已由用户确认)
- 本轮目标:产出 PRD v1.0 初稿(全链路+分期),13 条 FR 骨架,差异点清单
- 需要读取的资产:SRC-001/002(已读)、codemap/domainmap 索引(核查=无关)、codes/zentao 摸底结论(2026-07-22 两轮探查,沿用)
- 需要提出的问题:FR/分期确认(P0)、绩效体系关系(P1)、鉴权(P1,二期前)
- 本轮 FR 范围:FR-001~013 全新增
## Do
- 资产读取:assets/codemap/_index.yaml、assets/domainmap/_index.yaml(均 fly-home-flow,不引用)
- 分析:SOP 14 步→13 条 FR;缺口三分法(扩展表/附件通道/绩效接入)
- 产出:outputs/prd.md v1.0(15 章齐全:背景/目标/角色/范围/方案/FR/数据模型DDL/口径/差异点/风险/里程碑/证据映射/资产引用);desc.md;materials_index.md
- 提问:questions/round_1.yaml
## Check
- 目标覆盖:SOP 8 类数据项 → FR 全覆盖(6 复用、4 缺口新建、3 绩效三期)
- 证据充分性:关键结论带 [SRC]/[ZT] 证据;角色诉求部分 [ASSUMPTION] 已标
- 逻辑一致性:FR 分期与第 4 章范围一致;DDL 与 SRC-001 数据项一致
- FR 编号连续(001-013);AC 覆盖 0/13 → Round 2 批量生成(ac_batch 未跳过)
- 端覆盖矩阵 ✅、差异点清单 ✅、mermaid ✅
## Act
- 更新 session.yaml(round=1、fr_count=13)、summary.md
- 等待人类确认 Q1-1(P0)→ 确认后 Round 2:AC 批量生成(Given/When/Then)+ 章节细化
## 补充(用户质询后)
- 用户问「是否结合了现有代码工作流程」→ 自查结论:复用/缺口判断有代码证据,但 SOP 步骤与系统工作流的逐步映射缺失 → 已在 prd.md 增补 **6.3 SOP 步骤 × 现有工作流映射**(14 步逐步对上 zt_story stage 状态机、userReview、验收链 testSubmitVerified→storyProductUserYs→storyYs、任务生命周期、需求的一生;结论:11/14 步现有可承载,缺口即一期 3 新表)
@@ -0,0 +1,21 @@
# Round 2 — AC 批量生成
## Plan
- 前置:Q1-1(P0)已由用户确认关闭(PRD v1.24 + dev_plan v4.0)
- 目标:14 条 FR 全部生成 Given/When/Then 验收标准(每 FR ≥1 正常 + ≥1 异常/边界)
## Do
- 逐 FR 将规则翻译成 AC:FR-001~014 共 33 条 AC(正常 14 + 异常/边界/验证 19),含关键规则点:
- AC-002-3 FIND_IN_SET 防误匹配;AC-004-2 幂等、AC-004-3 finished 锁定
- AC-006-2 整批拒绝、AC-006-3 防重;AC-007-2 zt_task_extend 不存在的豁免验证
- AC-008-2 SOP 卡点(未 pass 禁提测试报告)、AC-008-3 多轮回炉
- AC-013-2 对拍验收;AC-014-3 判定源正确性(testReportSubmit)、AC-014-4 异议回滚
- 产出:outputs/acceptance.md;FR→AC 覆盖矩阵回填 prd.md 第 13 章
## Check
- 覆盖:14/14 FR 有 AC(覆盖率 100%);每 FR ≥1 正常 + ≥1 异常/边界
- 一致性:AC 与 PRD v1.24 规则逐条对齐(CHG-014~025 已融入)
## Act
- session.yaml:round=2、ac_count=24、ac_coverage=14/14
- 待用户审 AC → 定稿模式(E):prd_final.md