货权管理平台 · 需求汇总

一、功能概述

在原「仅控最低值（下限）」的货值预警基础上，扩展支持「最高值（上限）」监控，形成区间管控：货值需落在 [最低控货值, 最高控货值] 区间内方为正常，跌出下沿或涨破上沿均触发预警。

二、三种监控模式

• 仅控最小值（下限）：仅设置最低控货值及其预警线
• 仅控最大值（上限）：仅设置最高控货值及其预警线
• 双向同时控制：两者都设置
• 不可都不控（至少启用一侧）

三、触发公式

下限：当前货值 v < 最低控货值 L × P% 时触发

上限：当前货值 v > 最高控货值 H × Q% 时触发

百分数为占各自基准值的比例，直接作为乘数（如 110 表示 110%）。

四、级别与深浅

• 一级＝最深＝最严重＝必填（兜底红线）；三级＝最浅＝最先触发
• 下限内部：P1 < P2 < P3（一级百分数最小）
• 上限内部：Q3 < Q2 < Q1（一级百分数最大）

五、双基准

• 最低值与最高值允许设置不同的基准值（如最低基准＝贷款额，最高基准＝评估值）
• 跨方向比较需用绝对值触发线（基准 × 百分数）而非直接比百分数，因分母可能不同

六、双侧核心约束（同时设置时）

最低控货值 L × P3% < 最高控货值 H × Q3%

即最低最浅预警线 < 最高最浅预警线，保证安全区间 [L×P3%, H×Q3%] 存在、上下限预警不交叉；并自动蕴含红线不交叉 L×P1% < H×Q1%。

七、数值填写要求与示例

• 单侧：百分数 > 0；级别内部有序；一级必填，二三级选填
• 双侧：除第六点约束外，至少启用一侧、一级必填

银行押品示例：贷款额 100 万，要求货值不低于 120 万 → 最低基准 100 万，三级/二级/一级百分数 130 / 125 / 120（货值 <130 / <125 / <120 万分别触发轻 / 中 / 重预警）。

八、预警文案

• 全部为「已触发」单一状态（无未触发/预告），触发规则才生成预警
• 下限（现有，不改）：目前检测{项目}上的所有货物的最低控货值为{L}元，当前货值已经低于{P}%的最低控货值，请您及时关注该项目。
• 上限（新增，镜像，仅换方向词）：目前检测{项目}上的所有货物的最高控货值为{H}元，当前货值已经高于{Q}%的最高控货值，请您及时关注该项目。
• 双向触发时：下限、上限各生成一条独立预警记录，不合并

九、各页面变更说明

各页面变更说明

一、功能概述

为质检单与磅单定义标准化的数据字段，支持 PC 端与小程序端的录入、识别、展示与存档。质检单指标采用通用键值对结构，不同货物类型（棉花/煤/粮等）按实物样张定义指标项，页面代码无需调整。

二、质检单字段要求（均非必填）

基本信息（固定 7 字段）：

• 单据编号：文本，≤ 50 字符
• 日期：日期型
• 货物品名：文本，≤ 50 字符
• 规格等级：文本，≤ 50 字符
• 检验批量大小：数字
• 单位：文本，≤ 10 字符
• 质检说明：文本，≤ 200 字符

质检指标值（键值对 map<string,string>）：可任意键值对，键名与值均 ≤ 50 字符。常见货物示例：

• 棉花：毛衣分 / 公定衣分 / 含杂率 / 马克隆值
• 煤：热值 / 硫含量 / 灰分 / 挥发分

质检单「货物品名」填「籽棉」时，自动预填棉花 4 项指标（毛衣分/公定衣分/含杂率/马克隆值）。

三、磅单字段要求（均非必填）

固定 10 个字段：

• 磅单编号：文本，≤ 50 字符
• 车牌号：文本，≤ 50 字符
• 货物品名：文本，≤ 50 字符
• 规格等级：文本，≤ 50 字符
• 毛重：文本（数字 + 单位，如「25.8 吨」），≤ 50 字符
• 皮重：文本（数字 + 单位），≤ 50 字符
• 净重：文本（数字 + 单位），≤ 50 字符，由「毛重 − 皮重」自动计算
• 毛重时间：日期时间型
• 皮重时间：日期时间型
• 过磅员：文本，≤ 50 字符

附件：jpg、png、pdf、rar、zip、jpeg 格式，单个文件 ≤ 40M。

四、录入联动规则

• 单据名称预设「磅单 / 质检单」选项，点击自动填入输入框
• 输入含「磅单」/「过磅单」→ 展开磅单 10 字段；含「质检单」→ 展开质检单字段 + 指标键值对

五、AI 识别填充

小程序单据取证页在字段卡底部提供「AI 识别填充」按钮，从拍摄照片识别并回填字段值；磅单自动算净重（毛重 − 皮重）。

六、涉及页面

关键页面截图

凭证记录详情抽屉（过磅单）

一、功能概述

为记录管理各 Tab 的列表与详情补充「记录id」字段，并支持按记录id 查询；小程序端「我的事项」页面的记录卡片展示记录id，方便现场作业人员按记录id 定位自己的待办/已办记录。

二、记录管理 - 列表

• 待处理记录 / 已归档记录 / 待提交记录 / 待修正记录 / 已作废记录 各 Tab 列表第一列改为「记录id」
• 记录id 格式：JL + 8 位日期 + 3 位流水（如 JL20260803007）
• 搜索区新增「记录id」输入框，支持精准查询
• 列表「详情」按钮保持现有交互（打开已归档详情弹窗）

三、记录管理 - 详情

• 已归档记录详情弹窗顶部「已存档」右侧展示记录id（格式同上）
• 记录id 与时间、地点、事项类型等基本信息并列展示

四、小程序「我的事项」

• 「我的事项」页面展示当前用户相关的全部记录
• 页面顶部展示当前项目 + 货权编号（与抵押物详情页一致）
• Tab 切换：待处理 / 已驳回 / 已完成 / 待修正 / 已作废，与 PC 端记录管理对齐
• 每条记录卡片展示：记录id、记录内容、记录时段、预警、操作按钮（作废/继续记录/提交）
• 底部 Tab 栏「我的事项」入口（原系统已有该位置）

五、涉及页面

关键页面截图

PC 端：记录管理列表（含记录id列）

小程序：我的事项

一、功能概述

在货物出入库过程中，存在「调拨出库 → 在途 → 调拨入库」的流转场景。本需求建立在途货物的概念，通过「在途货物明细」Tab（其下仅一个「在途」子 Tab），以调拨出库记录为行跟踪在途货物，并在调拨入库与数据修正审核时校验在途状态与记录绑定关系，防止重复入库或状态异常。

二、入口与菜单

• 入库操作增加二级分类「调拨入库」（与现有「调拨出库」对应）
• 新增「在途货物明细」Tab，其下仅一个「在途」子 Tab：以调拨出库记录为行，展示货物明细 / 出库时间 / 在途时长 / 是否已入库 / 入库时间
• 调拨入库在「添加货物管理记录」页发起：选二级分类「调拨入库」后，须先选择调拨出库记录（仅列出仍在途的出库记录）
• 选择调拨出库记录后，将该出库记录的货物明细与物流信息（发货地 / 收货地 / 运输工具 / 车号）一并带入调拨入库表单，均为只读、不可修改

三、小程序端入库流程（选择分类 + 选择调拨出库信息）

小程序端进行入库时，同样遵循「调拨出库 → 在途 → 调拨入库」的流转逻辑：在入库表单中选择入库类型为「调拨入库」（与 PC 端「二级分类」对应）后，需先选择调拨出库记录（仅列出仍在途的出库记录）；选中后该出库记录的整批货物明细自动带入表单，且只读、不可修改，提交时校验必须已选出库记录。

• 入库表单「入库类型」含「普通入库 / 调拨入库 / 产成品入库」，选择「调拨入库」即进入调拨入库流程
• 点击「选择调拨出库记录」弹出列表，仅列出仍在途的调拨出库记录（已完成入库的不出现）
• 选中后整批货物明细（品名 / 规格 / 重量 / 数量 / 库位）自动带入，标记为「不可修改」；同时带入发货地 / 收货地 / 运输工具 / 车号等物流信息（只读）
• 底部提交校验：调拨入库必须已选择调拨出库记录，否则提示禁止提交

四、在途与 1 对 1 规则

• 在途单元：一笔调拨出库记录（可含多品类货物明细）= 一个在途批次
• 出库二级分类「调拨出库」→ 出库后该记录进入在途（状态：在途中）
• 「调拨入库」→ 与对应出库记录 1 对 1 绑定，该出库记录状态变为「已入库」并写入入库时间
• 公式：仍在途 = 已出库记录数 − 已入库记录数（按记录计，出库与入库严格 1 对 1）
• 时间口径：出库时间、入库时间均以该记录的「记录开始时间」为准；已入库时 在途时长 = 入库时间 − 出库时间，仍在途时长为出库至今的累计时长

五、查询能力

• 在途明细（以调拨出库记录为行，每行可折叠查看货物明细）：支持按「调拨出库记录id」「出库仓库」「发货地」「收货地」「车号」「运输工具」「是否已入库」「出库时间」查询
• 折叠的货物明细支持按「货物品名」「规格等级」筛选（日期指出库时间）

六、校验规则

• 调拨入库时：校验所选调拨出库记录是否仍在途且未被其他调拨入库绑定；不通过则提示并禁止入库
• 修正数据审核时：影响在途的仅「调拨入库」「调拨出库」两类记录；修正后可能出现「原来够调拨入库、修正后不够」的情况，审核时需复判在途状态与数量，不通过则提示并禁止
• 调拨出库的锁定约束：当一条「调拨出库」已被一条「调拨入库」关联绑定（即该出库记录状态为「已入库」），则该调拨出库不能被作废；且在修正数据时不能修改其出库的类型，避免破坏与调拨入库的 1 对 1 绑定关系

七、涉及页面

关键页面截图

抵押物详情页 · 在途货物明细（「在途」子 Tab，逐条展示调拨出库记录、在途状态/时长/入库时间；截图待原型更新后重制）

一、功能概述

货物管理记录之间存在业务关联（如「出库预报」关联后续的「出库」与「调拨入库」）。本需求支持在小程序端录入记录时选择关联其他记录，并在 PC 端记录详情页统一展示关联关系，区分「已关联」和「被关联」两类，方便追溯记录的上下游关系。

二、小程序端关联记录

• 录入记录时提供「关联记录」选择入口，可从已创建记录中选取并建立关联
• 关联关系为双向：A 记录关联 B 记录后，B 记录的详情中会显示被 A 关联
• 支持在提交前新增、删除关联记录

三、PC 端记录详情展示

• 记录详情弹窗新增「关联记录」模块，列表展示关联的记录
• 区分两类关联关系：已关联（本记录关联了哪些记录）、被关联（哪些记录关联了本记录）
• 列表列：关联类型 / 记录ID / 事项分类 / 记录发生时间 / 地点 / 记录人 / 操作
• 「查看」按钮可打开对应关联记录的详情

四、涉及页面

关键页面截图

记录详情弹窗 · 关联记录模块（被关联 / 已关联）

一、功能概述

事业部集团版工作台支持以「单位 / 子企业」为维度汇总数据。页面顶部新增「数据范围」树形选择控件，按集团 → 区域公司 → 子企业的层级展示可选项，切换后下方所有板块均按所选单位范围重新统计，实现集团 → 单位的下钻查看。

二、数据范围选择规则

• 选项来源：模拟集团企业下的完整单位树（集团总部 / 区域公司 / 子企业），用户可任选企业下的所有单位
• 全部：展示该用户在整家企业下可见的全部数据（默认选中）
• 单选单位（如某子企业）：仅展示该单位数据
• 多选单位：汇总所有勾选单位的数据
• 独立勾选：树仅为视觉分组，父节点不可勾选；每个叶子单位单独勾选，互不级联，父节点不显示任何半选状态。选中哪些单位即汇总展示哪些单位的数据
• 默认行为：人员登录后默认「全部」，进入即看到其在整个企业下可见的全部数据；通过筛选（单选 / 多选单位）切换为所选单位范围内的全部数据

三、受影响的板块（均随数据范围联动刷新）

• 顶部统计卡片（本企业创建档案 / 其他企业创建档案：现有货物品类、现存货物总货值、进行中货权档案）
• 项目中货物数量走势图（出入库统计按单位过滤）
• 现有货物库存
• 仓库中货物分布
• 现场记录分布

四、涉及页面

一、功能概述

在中棉项目的「货物库存&货值」Tab 统计区增加五项皮棉相关累计统计，用于反映籽棉入库总量、按衣分率折算的理论出皮棉量，以及已出皮棉量、待出皮棉量，帮助业务人员掌握加工转化进度。该组统计仅在中棉项目展示。

二、五项统计计算口径

• 累计籽棉入库量 = Σ(货物品名=籽棉 的入库重量)（主计量单位），仅统计籽棉
• 平均衣分率 = Σ(每次籽棉入库量 × 每次籽棉公定衣分率) ÷ 累计籽棉入库总量，即按入库量加权的公定衣分率（毛衣分率仅作录入项，不参与统计加权）
• 累计理论出皮棉量 = 累计籽棉入库总量 × 平均衣分率（等价于 Σ(每次籽棉入库量 × 对应衣分率)）
• 累计已出皮棉量 = Σ(货物品名=皮棉 的入库重量)（主计量单位），仅统计皮棉
• 待出皮棉量 = 累计理论出皮棉量 − 累计已出皮棉量

三、口径自洽关系

平均衣分率 = Σ(每次籽棉入库量 × 每次籽棉公定衣分率) ÷ 累计籽棉入库总量（按入库量加权，以公定衣分率为准，为根输入）；累计理论出皮棉量 = 累计籽棉入库总量 × 平均衣分率，与「二」中 Σ(每次籽棉入库量 × 对应公定衣分率) 完全相等；待出皮棉量 = 累计理论出皮棉量 − 累计已出皮棉量。口径首尾闭合、自洽。

四、适用范围

• 仅限中棉项目：非中棉项目不展示该组统计

五、各页面变更说明

一、功能概述

系统支持按「记录类型」为项目人员配置审核权限范围。权限为「可管理档案」的人员，可在人员列表中通过「设置记录类型」弹窗，设定其可审核的记录类型。弹窗选项分三部分：①「全部」（默认）；②「影响货物数量变化的记录」——入库 / 出库 / 盘点 / 在库移位，只能整体勾选；③「不影响货物数量变化的记录」——入库 / 出库 / 盘点 / 在库移位 / 巡检 / 货权牌记录 / 其他，可分别勾选，勾选「其他」可补充自定义类型。该配置直接影响「记录管理」待处理记录中「确认信息」按钮的可见性——仅被授予该记录类型审核权限的人员可见。

二、权限与入口条件

• 人员「权限」字段取值见需求8 人员管理四项：可现场记录 / 可查看档案、现场记录 / 可管理档案、现场记录 / 可查看档案
• 「设置记录类型」按钮仅在人员权限 = 「可管理档案、现场记录」时显示；其余权限的人员操作栏不出现该按钮
• 入口位置：抵押物详情页 → 人员管理 Tab → 列表操作列

三、设置记录类型弹窗交互规则

• 弹窗标题「设置记录类型」，用于勾选该人员可审核的记录类型；选项分为三部分
• 第一部分「全部」（默认勾选）：勾选后该人员可审核所有类型的记录，下方两个分组置灰不可选
• 第二部分「影响货物数量变化的记录」：包含 入库 / 出库 / 盘点 / 在库移位 四类，只能整体勾选，不可单独选择；勾选后该人员可审核上述四类记录
• 第三部分「不影响货物数量变化的记录」：包含 入库 / 出库 / 盘点 / 在库移位 / 巡检 / 货权牌记录 / 其他，可分别勾选，勾选中的类型即为其可审核范围
• 勾选「其他」：展开扩展输入框，可输入不在预置列表中的自定义记录类型，多个类型之间以中文顿号「、」隔开

四、「其他」类型记录的匹配规则

• 「其他」代表预置类型（入库 / 出库 / 盘点 / 巡检 / 在库移位 / 货权牌记录）之外的扩展记录类型
• 若勾选「其他」且未输入任何自定义类型：表示所有「其他」类型的记录该人员均可审核
• 若勾选「其他」且已输入若干类型：该人员仅可审核输入的那几项「其他」记录，未输入的不在审核范围内
• 匹配方式：系统在判定时，将输入框内输入的每个名称与「货物管理记录」中该条记录的实际记录类型名称进行比对，完全一致（精确相等，不含模糊 / 包含匹配）视为匹配成功，该人员方可审核该记录

五、待处理记录确认权限控制

• 位置：抵押物详情页 → 记录管理 Tab → 待处理记录列表
• 每条待处理记录带有记录类型（入库 / 出库 / 盘点 / 巡检 / 在库移位 / 货权牌记录 / 其他）
• 系统按该记录的类型，匹配被授权「可审核该类型」的项目人员；仅这些人员在该记录的操作栏可见「确认信息」按钮
• 未被授权审核该记录类型的人员，操作栏不显示「确认信息」按钮（仅可查看，无审核动作入口）
• 修正记录同样适用本规则：待修正记录（修正记录）的审核动作亦受人员审核范围控制——仅被授权审核「修正记录」类型（或勾选「其他」且名称匹配）的人员，才能在待修正记录操作栏看到「确认信息」按钮
• 审核顺序：不影响货物数量变化的记录（巡检 / 货权牌记录 / 其他类型）无需按照业务顺序，可任意顺序进行审核

六、各页面变更说明

一、功能概述

针对抵押物详情页「货物信息维护」Tab 的「批量修改价格」按钮进行交互重构：从「必须显式勾选记录后才可操作」改造为「基于筛选条件的隐式全选」。用户先用顶部筛选栏（货物品名 / 规格等级 / 仓库 / 库位 / 影响识别因素）圈定范围，在不勾选任何行的情况下点击批量修改价格，系统默认作用于所有符合筛选条件的记录。如需小范围微调，用户可主动勾选若干行，此时仅对勾选行生效。该模式兼顾了万级记录的批量效率与单条/少量记录的精确控制。弹窗内文案随操作对象来源（筛选结果 / 已勾选行）动态切换，让用户对本次改价的影响范围始终有清晰的预期。

二、操作对象判定逻辑（隐式 vs 显式）

• 点击「批量修改价格」时，系统按以下优先级判定操作对象：
  1. 若表格内有任意勾选行（行首复选框 checked） → 操作对象 = 已勾选行（精确控制）
  2. 若表格内无勾选行 → 操作对象 = 当前筛选结果集的全部记录（隐式全选）
• 「全选」复选框（表头）勾选后等同「每行都被显式勾选」，按优先级①处理
• 取消勾选使已勾选数为 0，则回退到优先级②，按当前筛选结果集全选处理
• 排序、翻页、分页大小变化不影响判定结果（仅看当前可见的筛选结果集内的勾选状态）

三、弹窗文案与字段（与截图 1:1 对齐）

• 弹窗标题：固定为「批量修改价格」
• 说明文案（动态拼接）：
  • 隐式全选场景（无勾选）：当前筛选结果共 {X} 条，将作为本次操作对象
  • 显式勾选场景：已选中 {Y} 条，将作为本次操作对象
  • {X} / {Y} 由系统在弹窗打开瞬间实时计算并填入
• 表单字段：
  • 「单价」输入框（数字，必填，正数，> 0）
  • 「返回统计单价」下拉选择（选项与现有数据保持一致）
  • 底部「取消 / 确定」按钮（确定按钮仅在表单校验通过后高亮可点）
• 弹窗样式沿用现有「批量修改影响识别因素」弹窗的 ant-modal 结构，确保视觉一致

四、批量改价提交规则

• 点击「确定」后，系统对操作对象（隐式或显式判定后的行集合）逐行更新「单价」字段
• 更新粒度与现有「批量修改影响识别因素」一致——通过行选择器选中对应 <tr>，修改 td:nth-child(6)「单价」单元格内的 <span data-v-05403272> 文本
• 改价成功后在页面对应行「操作」列追加「变更记录」可查 —— 复用现有变更记录弹窗的 mock 数据源

五、空筛选结果与边界场景

• 筛选结果为 0 条时，「批量修改价格」禁用（置灰不可点），避免无意义的 0 条改价
• 筛选结果 1 条时，行为等同单条修改，文案「当前筛选结果共 1 条，将作为本次操作对象」
• 操作对象 > 1000 条时，弹窗确认前增加二次确认（防误操作提示「本次将批量修改 X 条货物的价格，请确认」）

六、设计目标与适用范围

• 效率：万级货权记录下，从「勾选全部 → 提交」（鼠标与键盘成本高）改为「筛条件 → 提交」（更轻量、更不易出错）
• 可控：保留行复选框，作为显式精确控制的兜底通道
• 透明：弹窗文案随来源（筛选 vs 勾选）动态变化，用户始终明确知道本次会改哪些数据
• 仅作用于「批量修改价格」入口；其他批量按钮（批量删除货物、批量修改影响识别因素）的交互改造不在本需求范围内，保持现状

七、各页面变更说明

八、UI 参考截图

图 1：批量修改价格弹窗（基础形态：单价 + 返回统计单价）

一、功能概述

在原有「包年」收费之外，新增「预存按库月费」模式。客户预充值，系统以「仓库使用权」为计费单元、以「自然月」为周期自动扣费，单价 1000 元/库/月。两种模式每客户仅可选其一。本需求覆盖：计费模型、扣费引擎、欠费与预警、退款、与包年的切换、月度账单。

二、核心计费模型

• K(c,m) = 客户 c 在月 m 已付费的仓库名额数（初值 0，每月 1 日归零）
• S(c,m) = 当月并发活跃仓库集合（同一时刻实际占用的仓库，按仓库 ID 去重）
• 计费口径：任一时点客户应付 = K×1000；当 |S| 超过 K 时即时补差，下降或切换不退款不补扣

三、扣费触发规则（事件驱动 + 幂等 + 事务）

• 创建货权：将涉及仓库并入 S；若 |S|>K 则补扣 (|S|−K)×1000 并 K:=|S|。创建前须同时满足「账户无欠费 + 余额 ≥ 本次补扣额」，否则拦截创建并提示充值。拦截文案见下方「创建货权拦截提示」
• 创建货权拦截提示（文案）：提交时后端校验不通过即阻断提交，前端以模态弹窗呈现，同时表单顶部常驻红色告警条。
  · 欠费场景——标题「无法创建货权」；正文「当前账户已欠费 ¥{欠费金额}，无法新增货权。请先充值后重试，充值到账后自动恢复。原有货权不受影响，可继续操作。」；按钮「去充值」「关闭」。
  · 余额不足场景——标题「余额不足，无法创建货权」；正文「本次创建将新增 {N} 个活跃仓库，需扣费 ¥{N×1000}.00，当前余额 ¥{当前余额} 不足以支付。请充值后重试。」；按钮「去充值」「关闭」。
  · 说明：本期不做用户端自助充值入口，「去充值」按钮置灰并提示「请联系平台运营人员线下充值」，充值由运营在后台「新增收费单 → 预存充值」录入。
  · 边界：单条货权涉及多仓库时按实际新增活跃仓库数计费；校验与扣费在同一事务内完成，避免并发下超卖名额
• 停止/结束货权（走系统已有的手动结束功能）：从该货权占用的仓库集中移除；仅当客户已无其他活跃货权占用该仓库时才从 S 移除；下降/切换不退款不补扣
• 自然月切换（每月 1 日批处理）：K 归零；S 重置为跨月仍活跃的仓库集合；对每个活跃仓库扣 1000，开新账期

四、欠费 / 低余额预警 / 退款

• 月切余额不足：记欠费 + 触发预警（不拦截已存在货权的操作）
• 欠费状态约束：欠费后原有货权可继续操作，但禁止新增货权；创建货权前校验「无欠费 + 余额充足」
• 低余额预警：预判下月应扣 |S_next|×1000，若 > 当前余额即提醒（例：9/30 活跃 3 仓、10/1 将扣 3000 而余额不足，提前告警）。该预判值仅由后端计算用于触发提醒，前端不展示「下月预计扣费」指标（客户反馈该指标易与「本月已扣费」混淆，已去）
• 提醒形态与时机：系统全局横幅（非仅账户页），登录后进入任意页面即出现；余额 > 0 但不足以覆盖下月应扣额 → 低余额提醒（黄），余额 ≤ 0 即欠费 → 欠费提醒（红）。每次登录/刷新及每次充值、扣费后按最新余额与活跃仓库数重算；可手动关闭，关闭仅对当前账户状态生效，充值回升后自动消失、再次跌破或转欠费时重新出现；欠费未结清前持续出现
• 退款：预存余额可退，走线下退款流程（系统记录退款单，不自动原路退）。规则：① 由运营在后台发起（退款流水页「新增退款」），仅预存扣费客户可退；② 退款金额 ≤ 当前账户余额，超出不允许提交；③ 提交后账户余额实时扣减并生成退款编号（TF + 时间戳），打款走线下；退款记录字段：退款编号、时间、企业名称、退款金额、收款账户、退款原因、附件（非必填）；④ 退款记录与充值/扣费一同进入客户「资金流水」，类型为「退款」（余额 −）；⑤ 退款不改变当月已扣费金额，也不影响 K/S 计费模型；⑥ 欠费状态下不允许退款（余额 ≤ 0 无可退金额）

五、与包年「二选一」及切换

• 开户时选定收费模式（包年 / 预存），写入客户档案，二者互斥
• 包年→预存切换：仅可在包年到期日或之后切换；切换前包年权益有效，切换当天严防双重计费
• 包年剩余费用是否退 / 转预存余额，按线下商务约定执行（不在系统自动处理范围）

六、月度账单（本期以邮件发送）

• 发送方式：本期以邮件发送为唯一送达渠道，系统内不做站内账单页（后续如需站内查看再补）。推送配置能力原系统已具备，本次仅在消息推送配置中新增「月度账单」模板，运营可配置是否额外短信提醒
• 生成与发送时机：每月 1 日 00:10 随月切批处理生成上月账单并立即发送；发送失败自动重试 3 次（间隔 10 分钟），仍失败则告警运营并记账待补发。账单数据以月切批处理完成后的余额与流水为准
• 收件人：客户档案中预留的财务邮箱（可多个，逗号分隔）；支持配置抄送（默认抄送该客户运营负责人）。收件人为空时告警运营，不静默丢弃
• 账单内容：账期（年/月）、月初余额、本月充值合计、本月扣费合计、本月退款合计、月末余额/欠费、仓库占用明细（仓库名称 / 占用起止 / 是否月内切出 / 是否计入扣费）、当月峰值并发仓库数、扣费与退款流水（每笔时间/金额/触发事件：创建货权 or 月切批处理）、下月预计扣费（按当前活跃仓库数测算）

七、边界与压力测试场景

• 跨月临界：9/30 23:59 建仓 → 计入 9 月账期扣 1000，10/1 月切再扣 10 月 1000（A 在 9、10 月各付一次，符合按月）；10/1 00:01 建仓 → 仅 10 月账期扣 1000。需保证月切批处理与创建事件原子归月（月切在 00:00:00 跑，创建按发生时刻所属自然月入账）
• 同月 A→B→回 A 反复切换：9/15 建 A（扣 1000，K=1）→ A 停（S 空，不退款）→ 建 B（S={B}，|S|≤K 不扣）→ B 停 → 建 A（S={A}，|S|≤K 不扣）。全程 K=1 仅扣一次，回到原仓库不重复收
• 单条货权含多仓库：创建使 |S| 一次到 N，则扣 N×1000（如 A+B 同时建扣 2000）

八、对应页面与落地建议

• 计费引擎为后端能力（事件驱动 + 幂等 + 事务），前端仅做展示与操作入口

九、运营后台页面调整方案（需求确认 2026-09-16）

改动原则：不动收费管理列表的列结构，仅扩展服务类型枚举；账户余额与收费方式放在用户管理；扣费流水独立成页。包年↔预存切换在用户详情页完成，原型不体现，需求说清即可。

• 1. 收费管理（现有页面，轻改）：服务类型筛选项 + 列表「服务类型」列新增「预存充值」；预存充值记录在列表正常展示（收费金额=充值金额），仓库额度/期限额度/生效日期/到期日期对预存充值显示「-」
• 2. 新增收费单弹窗（复用现有）：服务类型单选增加「预存充值」；选中后隐藏「仓库额度、期限额度、是否发续费邮件、续费说明、合同编号」；保留「收费金额」并语义变为充值金额。充值到账确认由线下完成（财务通知运营），系统不做待确认态，运营确认收款后在系统直接录入充值、余额即时增加
• 3. 用户管理（现有页面，加两列）：列表新增「账户余额」与「收费方式」两列。收费方式枚举 = 按条收费 / 按库收费 / 预存扣费，由运营人员在用户编辑里维护。账户余额：预存扣费客户显示具体余额；按条收费/按库收费客户显示「-」
• 4. 欠费状态标签：用户管理列表对预存扣费客户增加「欠费」标签（红色标识；欠费后原有货权可继续操作、禁止新增货权）；欠费后允许继续充值，充值使余额≥0 后自动解除欠费、恢复新增权限
• 5. 扣费流水（新增页面）：左侧菜单「收费管理」下挂两个子菜单「收费管理」「扣费流水」。扣费流水仅展示系统自动扣费记录（与收费管理列表的充值/套餐收入分开），字段：时间、企业名称、关联货权单号、仓库名称、扣费事件（创建货权 / 月切批处理）、扣费金额、扣费后余额；支持按企业名称、时间范围、事件类型筛选
• 6. 收费方式切换：在用户详情页完成（包年到期日或之后切预存；预存能否切回包年按商务规则）。原型不体现，后端需保证切换当天双重计费防护
• 7. 退款流水（新增页面）：左侧菜单「收费管理」下挂三个子菜单「收费管理」「扣费流水」「退款流水」。退款流水仅记录预存余额退款（与扣费流水分开）。列表字段：退款编号、时间、企业名称、退款金额、收款账户、退款原因、附件（非必填，有则「查看」、无则「-」）；支持按企业名称、时间范围、退款编号筛选。页面提供「新增退款」入口，弹窗字段：企业名称（必填）、退款金额（必填，≤ 当前账户余额）、收款账户（必填，开户行 / 户名 / 账号）、退款原因（必填）、附件（非必填，jpg / png / pdf，单个 ≤ 10MB）；提交后账户余额实时扣减，用户管理列表「账户余额」与用户端账户页「资金流水」同步更新

十、账户页（客户需求补充 2026-09-16）

客户（预存扣费模式）需能查看自身账户情况，否则对账全部压在运营后台、客户体验差且易客诉。账户页做在「用户端（客户 PC 端）的管理员端」——即客户企业内部管理员账号，菜单与普通用户端一致、仅多出「账户管理」一项；管理员进入后查看本企业账户余额、充值/扣费流水。与运营后台扣费流水页（需求第九节第 5 点）数据同源。

• 展示内容：当前账户余额、收费方式（按条/按库/预存）、当前活跃仓库数、本月已扣费、欠费/低余额预警提示；新增「仓库使用情况」区块（列出当前活跃仓库与本月活跃过的仓库及活跃期间，并标注当月峰值并发仓库数，解释"本月已扣费"按峰值口径、可能高于当前活跃数）
• 流水：充值 / 扣费 / 退款三类合并为一张「资金流水」记账表（按时间倒序，与运营后台扣费流水、退款流水页同源，但只展示该客户自身数据）；字段：时间 / 类型（充值=绿 +、扣费=红 −、退款=橙 −）/ 业务说明（创建货权 or 月度扣费 or 预存余额退款，充值为空）/ 仓库名称 / 关联单号 / 变动金额（±）/ 账户余额（运行）
• 入口与菜单：用户端（客户 PC 端）的「管理员端」——菜单与普通用户端一致，仅多出「账户管理」一项（仅管理员可见，普通用户不显示）；管理员进入后查看本企业账户视角，无需平台运营后台介入
• 原型已落地（account.html）：菜单在 shell.js 中新增「账户管理」项并标记 adminOnly，仅账户页渲染（其余用户端页面菜单仍为原 11 项）；页面含①账户概览（余额 / 收费方式 / 当前活跃仓库数 / 本月已扣费，不展示下月预计扣费）②仓库使用情况表（仓库名称 / 状态 / 活跃时间段（合并字段，支持同一仓库多段活跃并列展示） / 本月是否计入扣费，并标注当月峰值并发数）③资金流水表（充值与扣费合并记账，按时间倒序：时间 / 类型（充值绿、扣费红）/ 业务说明 / 仓库名称 / 关联单号 / 变动金额（±）/ 运行余额；不展示仓库 ID、到账日期、操作人）④系统全局余额不足提醒（由 shell.js 渲染在所有页面顶部，可关闭，出现时机见第四节）⑤页内「需求说明」折叠面板（面包屑右侧小按钮展开，含页面定位、计费口径、字段取舍与提醒时机说明）