5.4 KiB

Raw Blame History

07 — E2E 实测：商机核心域主流程

Type: task Status: resolved Blocked by: 05

Question

按 spec-flows.md（票 04 冻结版）执行核心域全部主流程的 API 级实测（Python 脚本 .scratch/opportunity-e2e/e2e-core.py，复用 seed 数据与 debug token）：

流程覆盖：四视图 + 自定义视图（浏览 + F15 全 CRUD，票 04 U07 改判）→ 新建商机（直接创建，含 convertible-leads 关联线索下拉接口）→ 详情各子表读 → 写跟进（回收锚点刷新）→ 切阶段（连跳/回退）→ 方案卡建/改/提交 → 现场勘察 → 团队成员增改 → 暂缓/取消暂缓 → 抛公海/领取 → 关闭/重启 → 移交；
每流程按票 04 拍的断言深度断言，三档结论（✅ / ⚠ / ❌）；判 ❌ 前必须核对 flat 实际路径（地图「判定纪律」）；
前置（票 04 U04 决议）：MinIO 凭据已提供（admin），执行前设 CRM_MINIO_AK/SK 环境变量重启后端，F08 附件流程不 SKIP；
原型期望与实现不一致处：截取请求/响应证据，入缺陷清单（P0/P1/P2 初判）。

产出：e2e-core.py + 报告章节草稿 .scratch/opportunity-e2e/report-core.md。只记录不修复。

Answer

（20260828 实测完成 + 同日 F08 补跑）产出 e2e-core.py（六轮迭代，✅53→81；F08 补跑修复后 ✅81→86）+ report-core.md + e2e-core-result.json。核心域 F01-F15 全部实测，最终 ✅ 86 / ⚠ 12 / ❌ 6 · 缺陷 17 条（P1×9 / P2×8）· SKIP 0。复现：python seed-opportunity.py && python e2e-core.py。

缺陷清单（只记录不修复）

P1（9 条）

F11 添加关联客户无对应端点（404）——原型 A3-1-1-2-4 有按钮（/api/opportunity/customer/add）
F11 客户搜索无对应端点（404）——添加弹窗第一步（/api/opportunity/customer/search）
F11 设为主要意向客户无对应端点（404）——原型 A3-1-1-1-2（/api/opportunity/customer/set-primary）
F12 添加团队成员无对应端点（404）——原型 A3-1-1-1-8 +添加成员（/api/opportunity/team/add）
F12 移除团队成员无对应端点（404）
F12 编辑团队成员角色无对应端点（404）
F05 暂缓态商机编辑未被拦截（PRD §3.3 受限出边违反，code=0 成功）
F14 暂缓态可直接关闭（迁移边约束缺失，§3.3 违反）
F14 禁领规则版本未生效（allowFreeClaim=0 发布后仍可自由领取）

P2（7 条） 10. F01 新建必填校验以系统异常（500 类「系统内部错误」）实现而非参数错误提示 11. F03 PUBLIC_POOL 看板合计未按视图状态口径过滤（summary=7 vs 视图内公海态=2） 12. F04 detail 联动字段未回显：节点停留天数/下阶段名/方案卡状态/方案预算/是否关注/最近跟进（PRD §7.9） 13. F09 方案卡提交后主表 schemeBudget/schemeCardStatus 未回显（多卡取值口径待人工核 P2-3；与 12 同根因） 14. F10 勘察次数需调用方传入（add 必填 surveySeq），与「次数自动生成」拍板（P1-2）不符 15. F10 现场勘察补充说明未强制必填（与拍板 P1-3 相反：空说明竟成功） 16. F13 oplog 未覆盖流转操作（A2 历经 release/claim/assign/close/reopen/handover 仅 2 条 ROW_CHANGE 留痕且 fieldName=null） 17. F08 attachment/add 可选参数 bizType 缺省即 50001（Controller 声明 optional vs 表 biz_type NOT NULL 无默认，契约矛盾；正路径须显式传值域 OPP/FOLLOW_UP/SITE_SURVEY/SCHEME_CARD）

契约事实（供票 08/10/11）

规则族：ruleCode 系统生成只读（入参侧忽略），识别/反查用 ruleName；publish=保存并发布（form 绑定完整 DTO，只传 id 报 64008「规则名称不能为空」）；save-draft 是 Result（data=null），反查草稿按 ruleName+status=1
方案卡：selectable-templates 元素模板 ID 字段=templateId（无 id）；customerId 写入必填 + 一客户一卡约束（66009）；草稿与已提交均可编辑（card_status<3）；submit 校验模板必填动态字段（66007）
编辑：/api/opportunity/edit 为 OpportunityDTO 整体 form 绑定——detail 全量回传时 LocalDateTime 值须 ISO 格式（空格→T），否则 40001 类型转换失败
自定义视图：/api/preference/view/save JSON body + scopeKey 是 @RequestParam（save/set-default/delete 都要 params 传）；save 为 upsert 语义；list 出参不回显 scopeKey 字段
勘察：surveySeq 必填（调用方传）；surveyDesc 非必填（实测与拍板相反）
状态机：CAS 守卫生效（前置态已变被拒「当前状态不允许此操作」）；已关闭不可 resume ✓；E1-E9 主边全通过
U01 复核：新建初始 oppStatus=2（推进中），与 seed 现象一致

F08 补跑（20260828 凭据到位，SKIP 已清零）

用户提供的凭据实锤 AK=admin / SK=Itc@123456（消息里的「minio」实指 MinIO 密码；minio/minioadmin 均被服务端 InvalidAccessKeyId 拒绝）。后端带 $env:CRM_MINIO_AK='admin'; $env:CRM_MINIO_SK='Itc@123456' 重启后，脚本注入 E2E_MINIO_AK/SK 重跑 F08 全链：upload（MinIO 直传）→ attachment/add → list → delete → download 全部 ✅。新事实：FileInfoDTO 出参主键=fileId（String）；缺陷 17 见上（bizType 契约矛盾，P2）。复现：凭据注入后 python e2e-core.py F08（自动走全链分支）。

5.4 KiB Raw Blame History