发货订单

📌 功能概述

发货订单管理页（v8.82）：后台订单管理。自定义日期选择器修复两处：面板移到 body 层（原在隐藏的高级筛选容器内弹不出）、CSS 花括号结构修复（原误插进 .fin 内部导致面板全宽）；实测 260px 面板正常弹出/选日期/筛选。订单按来源拆分「我的赏袋 / 积分商城」两个视图，按状态浏览（待发货默认，全部在最后）；多条件筛选（订单/商品/手机号/产品ID/货号/IP系列/产品种类/日期，自定义日期选择器）；订单卡片展示；「发货处理」弹窗完成货品勾选、合并订单、包裹拆分、库存校验与发货确认全流程；mock 数据含神秘礼物订单（只显示名称，无卡位类型/库存）。v8.88 更新（2026-08-10）：积分商城**限购商品新增发货顺序**——每个品按下单时间独立自增分配发货顺序号（每品各自从 1 开始，互不干涉）；同单同品多件共用一个号；下单即锁定，取消订单**空号不补**；号终身绑定订单，**全状态显示**（含已取消）；非限购商品订单不显示。主列表「发货顺序」列（限购品显示号、非限购留空），表头可点击按号**升/降序排序**（简单按号排，不同品的号混排，无号的非限购订单固定排最后）；号仅展示参考，后台仍可自由选单发货。v8.89 更新（2026-08-10）：① 去掉订单卡片头部「积分商品」来源徽标（已切在积分商品 Tab 内，冗余）；② 积分商城**无购物车，一个订单只有一个商品**——手写 mock 与批量演示生成器（buildMockOrders）的积分商品订单全部改为单货品（同单同品多件 = qty 多件共用一号），赏袋订单保持多货品。v8.90 更新（2026-08-10）：我的赏袋发货处理弹窗新增**同货品多件拆分包裹**——同一货品待发数量 ≥2 且未分配时，操作列出现「拆分」按钮；弹窗默认均分 2 份（3→2+1）、每份数量可手调、份数可增删（≥2 份）；校验每份 ≥1、合计 = 待发总数；拆成多行后各行独立分配包裹、独立填发货数量，可分别进不同包裹出多个物流；已分配行先取消分配才能拆；已发货部分不参与拆分；弹窗 mock 赏品数量改为 1-5 件演示拆分。v8.91 更新（2026-08-10）：① 拆分按钮从操作列移到「发货/待发」列待发数字（/N）右侧，与数量挨着更直观；② 积分商城订单点「发货」不再打开发货处理弹窗，toast 提示「积分商城发货流程开发中，暂不支持」——积分商城发货流程（先拆包裹再选品）后续单独做。v8.92 更新（2026-08-10）：① 拆分按钮对齐优化——无拆分按钮的行放同宽隐藏占位，所有行「发货/待发」数字与按钮位置完全一致；② 拆分弹窗添加/删除份数时自动重新均分（总数 ÷ 份数，余数逐份 +1，如 74 拆 3 份 = 25+25+24），份数最多 = 待发总数，用户只需微调个别份。

🧱 页面结构

🔍 查询域

主列表筛选

发货处理弹窗 · 分配表格筛选

📋 功能说明（需求）

我的赏袋

将用户当前赏品和卡牌按产品抽象归类；产品信息展示：产品名称 / IP / 系列 / 货号 / 产品类型；列表展示每个产品的卡牌和赏品的发货数量及总数量；进度条下方展示未发货数量；数据展示 UI 与原型保持一致。

货品退回

将用户未发货的产品退回用户赏袋。点击货品退回弹出弹窗：查询（产品ID/产品名称文本框支持模糊、默认为空=全部；IP系列同之前；产品种类下拉单选=卡牌/赏品；卡位类型下拉复选）；列表仅显示订单内未发货的产品（同原型）；退回数量默认 disable、勾选对应产品后 enable；退回说明文本域 200 字符；上传凭证图片 200k、9 张。校验：退回数量=0 → 提示「退回货品数量不能为0」；退回数量＞实际未发货数量 → 提示「退回货品数量不能大于未发货数量」。通过 → 系统提示「货品退回成功！」并生成退回记录。

货品置换

同产品下的货品可根据库存或用户诉求进行置换。点击货品置换弹出弹窗：查询同退回；列表支持复选，未选择置换货品点【货品置换】→ 提示「请先选择需要置换的货品」；选择货品后点按钮弹出「选择置换产品」弹窗：左侧置换产品默认不勾选，未勾选点【选择置换产品】→ 提示「请先选择需要置换的货品」；勾选后只能选择同产品下的卡牌或赏品；置换数量默认 1，后面为需要置换的产品总数量；列表支持按产品ID/名称筛选、按卡牌/赏品类型筛选；数字为当前产品的售后库存；仅显示有库存的产品；已选择过的产品再次点击不再显示；点【+】提交置换后的货品并填写数量，已分配数量不能＞置换数量需校验；提交成功后货品置换产品列表更新（刨除已置换的产品）并生成置换明细；取消置换恢复置换前的产品列表；提交后生成置换记录。货品置换或退回弹窗打开时，订单无法发货和备货：点备货提示「订单货品退回或置换中，无法备货」；点发货提示「订单货品退回或置换中，无法发货」。

积分商城

列表字段增加单价和订单金额；待发货的积分商城订单支持取消订单：弹出二次弹窗，填写取消原因并上传凭证；取消后积分退回、库存、销量重置。积分商城无购物车，一个订单只有一个商品（单货品，数量可多件）。（v8.89）

发货库存联动

已发货的货品自动扣除库存，并生成售后出库记录；发货优化显示产品售后库存（实时库存）；库存=0 的货品发货时无法在下拉选中（禁止发货），提交时获取提交时的实时库存。

包裹拆分优化（打单发货）

订单信息展示不变，增加合并订单：勾选后的订单以「订单号+总货品数量」组成订单 tab，支持删除订单；删除订单弹出二次确认弹窗「确认删除订单？删除后包裹内的订单商品也将删除，是否继续」；删除后取消订单及订单内商品勾选，并删除列表页内商品及包裹归属。库存=0 商品在左侧订单及右侧商品列表不能勾选（勾选框 disable）。包裹拆分：包裹内商品发货数量≠0（为0提交不过 → 提示「【包裹1】内存在发货数为0的商品！」）；不能有空包裹（未分配商品的包裹存在则提交不过 → 提示「有空包裹【包裹2】」）；补齐发货数：点击补齐勾选商品，待发货数＞库存 → 数量=最大库存数，待发货数≤库存 → 数量=待发货数。

自行寄件发货

根据包裹填写物流公司以及物流单号。

订单备货导出表格

导出表格增加库存（未发货字段右侧增加库存，库存=导出时实时库存）。

发货明细

点击订单发货数据明细（进度条）弹出发货明细弹窗：根据产品进行 tab 划分，tab 文字=产品名称；产品ID 点击查看产品图鉴；产品名称 20 个字符超过省略；库存（实时）颜色说明——红色=库存0、橘色=库存≤未发货数量、绿色=库存＞未发货数量。

积分商品发货顺序（v8.88）

限购商品用户下单后每个品按下单时间独立自增分配发货顺序号（每品各自从 1 开始，互不干涉）；同单同品多件共用一个号；下单即锁定，取消订单空号不补、后面不前移；号终身绑定订单，所有状态（待发货/备货中/已发货/已完成/已取消）都显示；非限购商品订单不显示。主列表「发货顺序」列展示，表头点击按号升/降序排序（简单按号排），号仅作展示参考，后台仍可自由选择任意订单发货。

订单详情优化

货品信息：积分商城和我的赏袋布局优化（见原型）；积分商城已取消订单详情增加取消信息；已发货订单获取签收信息后 7 天后自动签收（待定）。

🖱️ 交互行为（页面现状）

📐 数据口径

❌ 错误提示清单

🔲 状态说明