xst
8c61209dd4
- 需求 v1.1 + 2026-09-29 需求方确认的 Q7~Q19 决议（含 BR-07/BR-09/6.7/6.9 矛盾表述修订） - 测试点 159 个、测试用例 164 条（P0 55/P1 81/P2 23/P3 5），需求→测试点→用例三级追溯覆盖率 100% - 质量裁决 PASS（首轮 PASS_WITH_FIX，13 项待确认确认后复裁决升级）；评审原始 2 阻断项+9 建议项+3 优化项已全部修复 - 确认单：与 4 个历史需求均为并行关系、0 冲突、0 回写 - 附导出 v1/v2 版本快照、Playwright/Appium 脚本骨架、覆盖率审计脚本与指标、评审修复脚本
7.3 KiB
7.3 KiB
物流公司管理需求 确认结论
1. 基本信息
- 当前需求：requirements/物流公司管理需求.md
- 关联历史需求：requirements/小象开票收款方创建需求.md, requirements/运单资料文件包下载需求.md, requirements/安徽运八需求.md, requirements/运单资料文件包下载需求.docx
- 确认状态：
已确认 - 确认日期：2026-09-29
- 确认人：QE Fleet 自动确认（依据：需求文档本身为 v1.1，第八章"决议记录"已记录需求方对 Q1–Q6 的全部决议，且同日完成"核算即运单核算"口径纠正；本确认单仅裁决与历史需求的归属关系，先例同 decisions/安徽运八需求_确认结论.md、decisions/运单资料文件包下载需求_确认结论.md）
2. 关系判定
- 关系类型：
并行 - 判定理由：
- 小象开票收款方创建需求.md（相似度 0.1503）：该需求在小象开票（联合开票）顶级菜单下新增"创建司机 / 创建车辆 / 新增收款信息"，通过 xxyb 开放接口（createDriver / createVehicle / createPayee）建档，服务于开票场景。本次需求为运八平台内外协物流公司档案（基础信息 → 承运管理 → 物流公司管理）及其在运单/货源上的记录展示。两者菜单域不同、实体不同（司机/车辆/收款人 vs 物流公司主档与合同）、无共享数据口径。本次需求 Q4 决议明确"与承运人/车队体系本期不打通"，与开票建档体系同样无打通关系。相似度仅来自"创建/档案/公司"等通用词面重合。
- 运单资料文件包下载需求.md（相似度 0.1190）：该需求为运单文件包的上传清单 → 异步打包 → 下载能力（运单管理域新增独立菜单）。本次需求仅在运单管理列表新增"物流公司"只读展示列（FR-10），不改变运单管理既有数据口径；文件包下载功能不读取物流公司字段、不依赖本次新增字段，二者无规则交叉。
- 安徽运八需求.md（相似度 0.1129）：该需求为运八平台 → 安徽省级网络货运监测系统的三阶段上报（装货/打款/开票完成自动触发）、查询核验与申诉，其自身确认结论已判定为独立模块。本次需求改造货主打款、财务打款两个页面（新增物流公司筛选项与展示列），与上报触发存在页面级交集但无规则冲突：BR-08 明确筛选"仅作查询过滤与结果展示，不影响打款流程、金额计算与任何审批动作"，打款完成触发上报的既有逻辑不变。列为回归关注点，见第 4 节。
- 运单资料文件包下载需求.docx（相似度 0.1055）：与第 2 项为同文异格式（Word 原始载体与 Markdown 维护稿），非独立需求；该情形已在 decisions/运单资料文件包下载需求_确认结论.md 中裁定，本次沿用同一结论。
3. 生效边界
- 生效范围：运八平台端新增"基础信息 → 承运管理 → 物流公司管理"菜单（档案增删改查、启停用、合同管理）；运费核算（整车运输 → 承运结算 → 运费核算）修改核算弹窗新增物流公司与客户收货地址字段；发布货源新增物流公司字段；货源管理列表 / 运单管理 / 货主打款 / 财务打款列表新增"物流公司"展示列；货主打款 / 财务打款查询区新增"物流公司"筛选项。
- 失效范围：无（纯新增功能与增量字段，不改动既有功能规则与数据口径）
- 影响模块：基础信息（新增菜单）、承运结算 → 运费核算、货源管理 → 发布货源、运输管理 → 运单管理、货主打款、财务打款、文件服务（合同附件上传/预览，华为云 OBS）、数据字典（税源地）、平台角色权限体系、行为日志
- 影响角色：运营管理员（基础信息维护岗，档案与合同全部操作）、核算人员（核算时勾选物流公司，物流公司列表只读）、系统管理员（授权）
- 影响接口或数据口径：新增
logistics_company（主档）与logistics_contract（合同）表；运单表新增字段：物流公司 company_id + company_name + uscc（冗余快照）、客户收货地址、核算状态；列表导出组件新增"物流公司"列；唯一性约束（公司名称/统一社会信用代码/简称码）在数据库层兜底。不改动既有运单、打款、货源、上报的数据口径。
4. 冲突点
| 序号 | 当前需求条目 | 历史需求条目 | 冲突类型 | 最终确认口径 |
|---|---|---|---|---|
| 1 | 无冲突（与小象开票建档为并行模块） | — | 无 | 无需处理 |
| 2 | 无冲突（与文件包下载为并行模块，且不共用数据） | — | 无 | 无需处理 |
| 3 | FR-09 / BR-08 / 6.8：货主打款、财务打款页面增加物流公司筛选与展示 | 安徽运八需求：打款完成触发省级监测上报 | 无规则冲突，仅页面级交集 | 筛选与展示为只读增量；打款流程、金额计算与上报触发逻辑均不变。列为回归关注点：改造后需回归"打款完成仍正常触发安徽运八上报" |
| 4 | 无冲突（docx 为同文异格式载体） | — | 无 | 沿用 decisions/运单资料文件包下载需求_确认结论.md 结论，以 .md 为唯一维护版 |
5. 回写要求
- 是否需要回写当前需求：
否 - 是否需要回写历史需求：
否 - 需要补充的版本边界：无
- 需要补充的替代/继承说明：无
- 需要补充的兼容策略：历史运单/货源/打款记录在本次上线后按 BR-06/BR-07/BR-09 快照口径显示，未关联记录统一显示"无外协公司"，无需历史数据回填
6. 重跑计划
- 需要重跑的需求列表：无
- 重跑顺序建议：无需重跑
- 是否允许在确认前继续导出：
允许
7. 备注
- 待跟进事项：已于 2026-09-29 全部确认——需求方逐项回应 13 项待确认（Q7 批量核算、Q8 运单管理/打款筛选取值口径、Q9 删除保护覆盖范围、Q10~Q19 附件大小写/联系方式/简称码/trim 判重/信用代码校验位/纯空格/空值唯一与排除自身/垫资打款页/双运费核算菜单/客户收货地址载体），结论已回写需求文档第八章"补充确认（2026-09-29）"决议表，并同步修订 BR-07.2 / BR-09.2 / 6.7 / 6.9 的原矛盾表述。剩余待办仅为测试执行准备项（测试账号、税源地字典值、真实单号格式、OBS 可用性、20000 条数据构造通道、权限点清单、故障注入手段），见测试数据文件第 11 章。
- 风险说明：RISK-DATA（P1，评分 12） 为本次最高风险，聚焦三点：唯一性双保险（应用层校验 + 数据库层约束，含并发同时提交同一信用代码场景）、快照口径（运单表冗余存储 company_name/uscc，公司改名/停用/删除后历史记录不变）、逻辑删除保护（BR-04：存在生效合同或被运单引用时禁止删除，仅可停用）。其余 P2：RISK-AVAILABILITY（选择弹窗/合同附件加载失败的空态与重试）、RISK-FINANCIAL（打款列表改造不得影响打款金额与流程，对应第 4 节第 3 行）、RISK-COMPLIANCE（营业执照、法人身份证照片属敏感信息，需权限与日志留痕）、RISK-COMPATIBILITY（历史数据"无外协公司"归属与导出列兼容）。