DXQ QiXian · Requirement Delta

02 现货模块需求 — 飞书版本变更说明

来源 飞书 Wiki · 260910 / 260930 / 261009 维护人 钱巧玲 整理时间 2026-09-20 / 2026-10-10 对照基线 02现货模块需求.md(260910) 范围 前端字段 / 按钮 / 交互

版本飞书版本表原文一览

现货模块飞书线上文档本次共涉及三版变更,其中 260910 为结构性更改,260930 / 261009 为本次新增同步内容:

260910
结构性更改 · 已于 2026-09-20 同步
① 采购申请工作台拆分以购定销和以销订购;② 销售申请工作台数据源全部更换为云钢项目明细;③ 策略模板修改,无空销售/采购明细;④ 以购定销采购现货申请单-加工类型需增加销售明细。
260930
本次新增同步 · 2026-10-10
删掉项目申请单字段,只用云钢项目号。
261009
本次新增同步 · 2026-10-10
提交新增校验点,n8 有要求。
整理范围 仅梳理前端需要的字段、按钮显示与交互逻辑;后端中间校验、后置条件、接口勾稽关系调整不展开。

变更一采购现货申请工作台拆分「以购定销 / 以销定购」主文档 §1

1. 以购定销工作台(原工作台调整)

2. 以销定购工作台(新工作台)

列表新增两列新增,其余与以购定销一致:

字段名称类型备注
云钢项目号文本取云钢项目明细数据
n8项目号文本取云钢项目明细匹配的 n8 项目号,如未匹配则空

变更二销售现货申请工作台数据源整体更换主文档 §5.1 / 5.3

列表区 5 个字段备注批量追加「260910 修改:不存在无销售品名的明细」,即「无销售明细」分支全部作废:

字段调整后取值
品名取销售明细品名原「无销售明细取采购明细品名」作废
策略销售数量取销售明细数量原「无则显示 0.00」作废
剩余可申报数量策略销售数量-已申报数量原无销售明细计算分支作废
期货交易品种取销售明细行下带期货品种原「无则放空」作废
合约号取销售明细行下带期货合约原「无则放空」作废

变更三策略模板无空明细 —— 明细页「无明细」分支全作废主文档 §3.2 / 7.2

260910 起不再存在无采购/销售明细的策略,明细页品名一律不可更改:

位置作废的分支
采购商品明细页主文档 3.2 品名取采购明细行品名且不再可更改(原「无采购明细取销售明细品名」「内贸加工时可按期现品种关联改品名」规则作废,「更改范围」标注 260910 作废);单价/加价/价格指标的「无采购明细自行写入/弹窗选取」分支作废
销售商品明细页主文档 7.2 品名取销售明细行品名且不可更改(原无销售明细两档分支作废);单价/加价/价格指标的「无销售明细」分支作废
采购商品明细页现货信息主文档 3.2 新增两字段(以销定购显示):云钢项目号、n8项目号(文本,必填,不可改,代入工作台数据)
原文笔误 飞书原文采购明细页「加价」「价格指标」备注中各有一条写作「不存在无销售品名的明细」,疑为复制销售侧文字的笔误;本同步按采购侧口径「不存在无采购品名的明细」处理。

变更四以购定销-加工类型新增「销售明细」页主文档 §3.6

变更五其他配套调整

位置变更
采购基本信息页主文档 §2.1 标题调整为「以购定销以销定购通用」(260910 修改),字段表本身无 260910 标记变化
现货申请单执行主文档 §9.2 260910 增加:以购定销采购现货申请单需倒生成云钢项目,根据申请明细写入项目采购/销售明细

变更六260930 删掉项目申请单字段,只用云钢项目号主文档 §3.2 / 7.2

跨模块口径 飞书版本表原文只有一句「删掉项目申请单字段,只用云钢项目号」,正文未在现货各页标注 260930 标记,属跨模块口径(与 07项目申报模块需求.md 260930 同源)。
位置调整
采购商品明细页现货信息主文档 §3.2 「云钢项目号」「n8项目号」保持 260910 新增、以销定购显示不变;两字段作为项目唯一标识来源,后续不再单列「项目申请单号」类字段
销售商品明细页现货信息主文档 §7.2 销售现货信息原只展示「业务策略单号」,不涉及项目申请单字段;本版本不新增字段
口径留痕

本地 02现货模块需求.md 现货各字段表原本就没有「项目申请单」字段,故正文无字段增删;本条仅作口径留痕(现货侧统一以云钢项目号 / n8项目号 标识项目)。

注意:主文档 §9.1 版本维护仍写「上游策略单(项目申请单)状态=已审核」,该措辞出自 260930 之前的版本表,07项目申报模块需求.md 已把「项目申请单号」字段删除,此处措辞未随 260930 更新,属已知口径滞后项,暂不改写(主文档 11.1 #8)。

变更七261009 提交新增校验点主文档 §2.4 / 6.4 提交按钮

飞书版本表原文「提交新增校验点,n8 有要求」,正文落在采购现货申请单-提交的中间校验最后一条:

采购/销售明细不可存在相同云钢项目号下现货品名重复 ----- 261009 新增,n8 有校验
项说明
落点采购现货申请单提交(§2.4)中间校验;采购/销售共用,采购基本信息页提交时该校验同时作用于销售明细(若存在)
口径同一张申请单内,相同「云钢项目号」下现货品名不允许重复。即判定维度是「云钢项目号 + 品名」组合唯一,不是单张单内品名全局唯一
前端处理后端校验 该校验由后端接口校验,前端不做本地拦截,提交失败时直接展示后端返回信息
n8 侧飞书原文「n8 有校验」:n8 侧同样会做校验,与后端一致
口径已定 主文档 §11.1 未记该校验点为待确认(原文已写明是 261009 新增),本次按「后端校验、前端不实现」定稿。

清单对前端的影响(待办)

#版本影响
1260910采购工作台拆两个 tab/页面:以购定销(策略明细打横+策略类型过滤)、以销定购(云钢项目明细打横,多两列)
2260910以购定销查询区加「云钢项目号」;列表删「期货交易品种/合约号」两列
3260910创建申请单前置校验加「同一策略号」判断
4260910销售工作台数据源换云钢项目明细(接口待后端确认)
5260910采购/销售明细页品名一律不可改,「无明细」兼容分支可下线;采购明细页加以销定购两字段显隐
6260910加工类型以购定销申请单新增「销售明细」页签(新增销售明细功能)
7260910接口字段名(云钢项目入参、以销定购出参、销售工作台分页、倒生成云钢项目回显)均待后端确认,见主文档 11.1 #4–#7
8260930现货侧统一以「云钢项目号 / n8项目号」标识项目,不再出现项目申请单字段(现货页面字段表无增删,仅口径留痕)
9261009提交按钮新增「相同云钢项目号下现货品名不可重复」校验,由后端接口校验,前端不实现本地拦截,提交失败时展示后端返回信息