DXQ QiXian · Requirement Delta

01 策略模块需求 — 飞书 260910 版本变更说明

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

变更一新增厦门金属版模板

1. 创建入口(对应主文档 1.4)

列表页按钮由 1 个变为 2 个并列按钮:

按钮显示逻辑前端交互
创建业务策略无约束打开「选择策略类型」弹窗,确认后进入 厦门物资版基本信息页(原逻辑)
创建业务策略-金属无约束打开「选择策略类型」弹窗,确认后进入 厦门金属版基本信息页

2. 基本信息页 — 项目信息 / 系统信息

金属版项目信息、系统信息与物资版 完全一致,不做改动(业务策略号、业务策略名称、公司、购销方式、部门、核算组、人员;系统信息 6 字段)。

3. 基本信息页 — 策略信息(金属版独立配置,对应主文档 2.11)

金属版策略信息与物资版 完全分开,不含物资版的:风险预案、备注、执行时间、交易策略、期货组、是否生成现货申请、采购/销售定价方式、采购/销售结算类型、采购/销售结算周期、采购/销售基差。

通用字段(4 类业务一致)

套保类型(下拉)、业务类型(下拉)、策略起止日期(日期框,录时间段)。

差异化字段矩阵

字段名称 控件类型 基差正套&销售敞口 基差反套&成本敞口 基差对锁 价格转换
计划建仓区间文本框✓✓——
期现止盈数值框,整数,可为 0✓✓——
期现止损数值框,整数,可为 0✓✓——
分批建仓计划多行文本✓✓——
策略逻辑多行文本✓✓—✓
供应商搜索框——✓ 单选✓ 单选
客商搜索框—✓ 单选✓ 单选✓ 单选
单吨浮盈亏金额输入框,两位小数,可为负✓———
预计周转周期文本框✓———
计划销售区域多行文本✓———
可供采购供应商文本框✓✓——
交货时间日期框(时间点)—✓——
预计采购成本金额输入框,两位小数,不可为负—✓——
采购基差数值框,可正可负可为 0,两位小数——✓—
销售基差数值框,可正可负可为 0,两位小数——✓—
钢厂定价政策多行文本———✓
对客户的定价政策多行文本———✓
期货开平仓计划多行文本———✓
原型图疑点 原型图中基差反套&成本敞口、基差对锁、价格转换三张图的套保类型/业务类型下拉值误画为「正套 / 基差正套&销售敞口」,应为各图标题对应值,落图以标题为准。

4. 采购明细页 — 金属版字段(对应主文档 3.7)

金属版基本信息页无采购定价方式字段,采购明细 tab 固定展示。

现货信息(均可编辑,按业务类型差异化)

业务类型现货信息字段
基差正套&销售敞口品名、数量、期货数量、现货成本(sSpotCosts,金额输入框,两位小数)
基差反套&成本敞口品名、数量、期货数量
基差对锁品名、数量、期货数量
价格转换品名、数量、期货数量

期货信息(4 类业务统一,仅 4 个字段,无开仓价上限/下限)

字段名称是否可改
期货交易品种是
合约号是
买卖方向否
开平方向否

5. 销售明细页 — 金属版字段(对应主文档 4.7)

现货信息(4 类业务统一,均可编辑):品名、数量、期货数量(无单价/加价/价格指标/现货成本/套保比例)。

2026-10-08 更正 飞书原文「新增-业务策略单-销售明细页」原型图现货列为 品名、数量、期货数量(期货数量红标必填,正整数),本行原表述「无期货数量」系整理时误读;前端 saleDetail.vue 金属版已补列并同步校验/合计/新增行初始化。

期货信息(4 类业务统一,仅 4 个字段,无开仓价上限/下限):

字段名称是否可改
期货交易品种是
合约号是
买卖方向否
开平方向否

「复制采购明细」按钮按物资版既有显示条件(采购、销售明细 tab 并存即显示)执行,金属版两个 tab 均固定展示。

6. 后端接口与字段映射(260924 后端提供)

创建金属版业务策略

POST /esc/fds/strategy/add_js

入参、响应与物资版 POST /esc/fds/strategy/add 完全一致:

参数类型必填说明
sHedgingTypestring是套保类型(字典 fds.hedging.type)
sHedgingBusiTypestring是业务类型(字典 fds.hedging.business.type)
sPurSaleModestring是购销方式(字典 trade.pur.sal.mode)

响应:res.data = { sId, sSheetStatus, sCode },创建成功后携带 sId 跳转金属版基本信息页。

接口复用说明 · 260924 确认

除上述创建接口外,金属版单据的其余接口 全部复用物资版(详情 get、保存 modify、切换业务类型 modifyHedgingBusiType、提交校验 submitCheck、提交 submit、删除 removes、撤销 withdrawal、撤单 cancel、版本维护 backup、复制 copies、明细 good/futures 全部接口及 copyPurDetail)。

get 响应返回 sStrategyType:'1' 厦门物资 / '2' 建发金属(即本文档「金属版」),详情页据此分支渲染模板;仅 get 返回(列表 queryPage 不返回,列表 / 查询区不使用,260924 确认)。

金属版策略信息字段映射

业务类型字典与码值 统一复用物资版 fds.hedging.business.type;差异化矩阵中「基差正套&销售敞口」对应码值 10/50、「基差反套&成本敞口」对应 20/60,按场景组判断字段显隐。

策略信息字段后端字段类型备注
套保类型sHedgingTypestring复用物资版
业务类型sHedgingBusiTypestring字典与码值统一复用物资版;矩阵「基差正套&销售敞口」= 码值 10/50 场景组、「基差反套&成本敞口」= 20/60
策略起止日期sStrategyStartDate / sStrategyEndDatestring起止两个日期字段,yyyy-MM-ddTHH:mm:ss(2026-10-08 更正格式:原 yyyy-MM-dd)
计划建仓区间sPlanWarehousingRangestring文本框
期现止盈sFdsStopProfit—复用物资版
期现止损sFdsStopLoss—复用物资版
分批建仓计划sBatchWarehousingPlanstring多行文本
策略逻辑sStrategyLogicstring多行文本
供应商sSupplierId / sSupplierNamestring复用物资版,单选;仅基差对锁 / 价格转换使用(260924 确认:基差正套&销售敞口移除,改用可供采购供应商)
客商sCustomerId / sCustomerNamestring复用物资版,单选
单吨浮盈亏sPerTonFloatProfitLossnumber金额输入框,两位小数,可输入负数
预计周转周期sExpectedTurnoverCyclestring文本框
计划销售区域sPlanSaleAreastring多行文本
可供采购供应商sAvailablePurchaseSupplierstring文本框;基差正套&销售敞口、基差反套&成本敞口两场景使用(260924 变更:正套场景由供应商改为本字段)
交货时间sDeliveryTimestring(date-time)日期框(时间点),前端传 yyyy-MM-ddTHH:mm:ss(260924 确认字段、2026-10-08 更正格式)
预计采购成本sExpectedPurchaseCostnumber金额输入框,两位小数,不可输入负数
采购基差sPurBasis—复用物资版(基差对锁)
销售基差sSaleBasis—复用物资版(基差对锁)
钢厂定价政策sSteelFactoryPricingPolicystring多行文本
对客户的定价政策sCustomerPricingPolicystring多行文本
期货开平仓计划sFuturesOpenClosePlanstring多行文本

金属版采购现货明细字段映射

字段名称接口字段类型说明
现货成本sSpotCostsnumber金额输入框,两位小数;仅基差正套&销售敞口(码值 10/50)展示与保存(260929 已确认)
待后端确认金属版后端字段已于 260929 全部确认完毕(见文末说明)。

变更二采购/销售明细改为所有业务类型都填写(物资版 + 金属版)

位置原规则260910 新规则
采购明细 tab主文档 3.1 基本信息页填写了采购定价方式时才显示该 tab 变更 所有业务类型均显示采购明细 tab
销售明细 tab主文档 4.1 基本信息页销售定价方式显示时才显示该 tab 变更 所有业务类型均显示销售明细 tab
基本信息页采购字段区块主文档 2.5 套保类型 = 正套/未定 时填写 变更 所有业务类型均需填写
基本信息页销售字段区块主文档 2.6 套保类型 = 反套/未定 时填写 变更 所有业务类型均需填写
维持不变 「供应商(套保类型=未定时不显示)」「客商(套保类型=未定时不显示)」的字段级显隐备注保留原规则(需求未提及调整)。

变更三查询区 / 列表区删除「N8 项目号」

位置变更
1.2 查询区字段删除「N8 项目号」筛选项(飞书原文 N8 项目号,标注 260910 更新)
1.3 列表区字段删除「N8 项目号」列
1.6 列表查询接口请求参数删除 sProjectCode;响应字段删除 sProjectCode
2.3 基本信息页通用字段删除「n8 项目号」字段(原 n8 勾稽后自动写入、只读)
2.10 表单字段映射删除 sProjectCode 字段映射行
替代字段不新增「云钢项目号」筛选/列

备查不纳入本次前端记录的 260910 变更(后端逻辑)

以下内容飞书同属 260910 变更,但按本文档整理范围(仅前端字段/按钮/交互)不展开,仅备查:

  1. 非期现业务自动生成链路新增「云钢项目号」层(n8 项目号 ↔ 云钢项目号勾稽),新增「云钢项目信息同步 n8」接口。
  2. 版本维护提交:策略不再直接推送 n8,生效推送移至云钢项目提交处;N8 合同版维勾稽关系同步调整。
  3. 提交校验:采购销售一致性校验取消「套保类型=未定」限制(内贸/非内贸加工两类场景均放开)。
  4. 策略执行:以销定购业务需先生成执行状态的项目申请单,再生成现货申请单。

已确认待产品确认(金属版原型疑点)

状态均已确认并落文档。
基础确认
  • 单吨浮盈亏控件为数值框(260924 细化为金额输入框,可输负数);
  • 基差对锁的采购基差、销售基差为必填;
  • 金属版采购明细「现货成本」为金额输入框(两位小数,正数,仅基差正套&销售敞口展示,260929 已确认)。
260924 第二批

① 除创建接口 add_js 外,金属版其余接口全部复用物资版,get 响应返回 sStrategyType('1' 厦门物资 / '2' 建发金属);② 供应商统一单选(原型「基差正套&销售敞口多选」口径取消);③ 单吨浮盈亏=金额输入框(两位小数,可输负数)、预计采购成本=金额输入框(两位小数,不可输负数);④ 业务类型等字典及码值统一复用物资版(矩阵「基差正套&销售敞口」= 码值 10/50、「基差反套&成本敞口」= 20/60)。

260924 第三批

基差正套&销售敞口场景移除「供应商」字段,改用「可供采购供应商」(sAvailablePurchaseSupplier,文本框);「供应商」仅保留基差对锁 / 价格转换(单选)。

260924 第四批

sDeliveryTime(交货时间)前端传 yyyy-MM-dd → yyyy-MM-ddTHH:mm:ss(2026-10-08 更正,后端时间格式统一带 T);sStrategyType 仅 get 返回用于详情页模板区分,列表 queryPage 不返回、其他场景不使用。

2026-10-08 销售明细更正

对应第 5 节:核对飞书原文 260910 原型图确认销售明细页现货信息为「品名、数量、期货数量」(期货数量红标必填正整数,无套保比例/现货成本),第 5 节原「无期货数量」表述系整理误读已更正;前端 saleDetail.vue 金属版已补「期货数量」(sFdsQty,整数框)并同步校验/新增行/合计行。

同期两个明细页期货信息「合约号」选中后补 stopEditing,解决金属版期货明细仅品种/合约号可编辑时整行编辑不退出、rowValueChanged 不触发导致无法保存的问题。

已关闭待后端确认(260924 审查 / 260929 全部关闭)

金属版前端开发依赖的后端接口与字段已全部齐备并关闭待确认:

  1. 260924 各批确认关闭:创建接口 add_js、除创建外全部复用物资版接口、sStrategyType 仅 get 返回、sStrategyStartDate/sStrategyEndDate 起止日期两字段、各字段映射与单选/文本框口径。
  2. 260929 确认关闭:金属版采购明细「现货成本」字段名落地为 sSpotCosts(金额输入框,两位小数,good/add、good/modify 均支持)。金属版后端字段已全部齐备。