仓管端 - 入库确认

原型图 | React + Tailwind

9:41

入库确认

场景切换

模拟扫码结果

页面说明

最后更新：2026-09-15

页面定位 — PRD §5.9.3/§5.9.4/§5.9.5/§5.9.7/§5.9.9/§5.9.15/§6.7

仓管完成入库验收的核心页面：打开入库单后，逐条扫码（或按数量录入）确认资产，至少验收 1 项即可提交入库（差异在提交弹窗体现）。共 3 个场景：①首次入库 ②回收入库 ③归还入库；异常处理为各场景通用能力（行内标⚠ + 提交时逐条说明原因，异常可恢复正常）。所有场景均支持「添加无码资产」：到货无二维码的资产，可生成系统编码 → 打印标签 → 扫码确认，三步完成验收。

核心内容

模块	说明	场景差异
入库单信息卡片	展示入库单号、入库类型、入库仓库	①另含发起人/创建时间 ②另含回收原因/关联工单/原位置 ③另含来源出库单/借用人/借用天数
资产行状态	每行资产显示：已验收（绿✓，默认可投放）/ 异常（红⚠）/ 待验收（灰）；无码资产另有「二维码缺失 → 已生成·待贴标 → 已验收」三态；待验收行不展示资产编码，仅扫码识别到资产后才显示编码	所有场景共用
资产分组列表	按高价值配件 → 滤芯 → 配件与耗材分组，各组显示进度，可追加无码资产行	②默认可投放 + 3 标签异常（识别未匹配/功能异常/设备故障）；配件与耗材以数量行录入（摄像头/密封圈） ③纯滤芯（添加无码仅开放滤芯）默认可投放 + 3 标签异常
拍照留证 + 添加无码 + 提交	拍照留证：拍照或从相册选图，最多 5 张，缩略图展示可删除（非必填）；添加无码资产；吸底：扫码验收 + 提交入库	所有场景非必填；有异常时提交按钮显示「X 项正常 · Y 项异常」

关键交互

操作	触发条件	前置校验	反馈形式	异常处理	行为
扫码验收	点吸底「扫码验收」，选择要扫的资产	-	弹识别结果窗；确认后自动切到对应分组并高亮该行，计数+1	识别失败可重扫、报异常或转待处理区	至少验收 1 项即可提交（差异在弹窗体现）
到货数量确认	扫到 SN-LB 箱码且未扫过	数量须为正整数	弹「滤芯箱到货确认」窗（箱码/登记型号/登记根数只读 + 到货数量输入 + 箱内明细摘要）	主按钮按当前输入值动态切换（=登记根数→「确认入库」；≠→amber「进入逐根核验」+警示旁注）	一致走整箱批量入库；不一致自动标箱码异常（零录入）并进入主界面内联逐根核验
逐根核验（主界面内联）	到货数量 ≠ 登记根数后点「进入逐根核验」	有效 SN-L 码（重码提示、识别失败提示，不阻断）	不弹独立核验窗：箱码行下方展开内联核验区（登记/到货 + 已扫同规格 X/Y·散装 N + 同规格/散装双清单 + 「结束核验」），无输入框/扫码按钮；底部「扫码验收」切为核验模式（进度 + 扫下一根同规格/扫入规格不符→散装 + 手动录入分流）	实扫数与到货数不符仅提示；核验中可切分区并行扫其他资产，再开扫码面板续扫不重复	同规格根计入箱码数量即时入库；规格不符根照常入库但不计入箱码（散装）；「结束核验」收尾或提交自动收尾；SN-LB 激活带「已领用·异常」留痕，未扫登记根保持未领用
扫码不一致	实际扫到的码与单据预期不符	-	标黄提示，弹出差异填写面板	差异原因选填（仅提示不阻断）；照片建议非必填；单据编码清单不可改	所有场景通用，填完可继续
数量差异	录入数量与预期不符	-	标黄提示	差异原因选填，不阻断提交	-
提交入库	至少验收 1 项即可提交（有异常项时按钮显示 X 正常 · Y 项异常）	-	弹「确认提交并入库」窗：资产汇总 + 差异（实际/预期）+ 异常明细；有异常时含「入库备注」必填项 + 「不可撤销」警示	有异常时按钮显示「X 项正常 · Y 项异常」	确认后跳转 CG03 对应入库类型的「已完成」详情
添加无码资产	点「添加无码资产」，选类型输数量（滤芯先选型号）	-	在对应分组追加「二维码缺失」行，可多次添加	编码由系统生成，仓管不可手输	生成码 → 打印标签 → 扫码确认 → 已验收
模拟扫码结果	点右侧「模拟扫码结果」任一卡片（演示用，共 9 种结果，含「箱码·数量一致 / 箱码·数量不符」双卡，分别演示两分支）	-	整页重置为对应扫码结果（已扫项/异常/绑定状态随之变化）；当前卡高亮、不支持卡置灰	异常类结果自带具体原因，提交窗逐条展示	各场景支持哪些结果见「页面状态」；切场景自动恢复干净状态
行内异常原因	资产被标记异常或故障后	-	行内显示原因，可点「修改」弹窗改（回收/归还 3 标签点选 + 手动输入，首次入库下拉+手动输入）；已异常可「恢复正常」	手写与快捷原因均行内展示	提交弹窗逐条列出原因，无需填总原因
恢复正常	异常资产弹窗点「恢复正常」	已标记异常	弹「恢复正常」窗，提示「是否要清除异常，资产将进入已验收」，仅「确认/取消」两步	-	清除异常信息，资产回到已验收；无「重新验收」分支，不重扫
二次扫码	已验收资产再次扫码	-	提示「该资产已验收」	-	不做状态变更，要重来先「恢复正常」

页面状态

场景	展示内容
①首次入库（蓝色）	入库信息卡片（含发起人/创建时间）+ 屏幕2 + 水机板2 + 安卓板2 + 滤芯4 + 配件与耗材4；模拟卡全 9 种（全部扫码成功/部分成功/箱码·数量一致/箱码·数量不符/识别失败/配件缺失/扫码不一致/数量差异/全部成功含异常）
②回收入库（紫色）	入库信息卡片（含回收原因/关联工单/原位置）+ 屏幕1 + 水机板1 + 安卓板1 + 滤芯2 + 配件与耗材（摄像头/密封圈）；至少验收 1 项即可提交；回收件默认可投放（扫码即已验收），异常用 3 标签（识别未匹配/功能异常/设备故障）标记；模拟卡 6 种（全部扫码成功/部分成功/箱码·数量一致/箱码·数量不符/识别失败/全部成功含异常）
③归还入库（青色）	自由扫码归还：不预填资产，仓管逐件扫码（或录入编码），扫一个记一个，默认可投放（扫码即已验收），异常用 3 标签（识别未匹配/功能异常/设备故障）标记，可不关联原借用单；无设备和高价值配件（添加无码仅开放滤芯）；至少归还一项方可提交；模拟卡 6 种（全部扫码成功/部分成功/箱码·数量一致/箱码·数量不符/识别失败/全部成功含异常）

跳转关系

入库列表(CG02) → 入库详情(CG03) → 入库确认(CG04)
  ├── 确认入库完成 → CG03 对应入库类型的「已完成」详情
  │     ①首次入库 / ②回收入库 / ③归还入库
  └── 场景③：自由扫码归还，无预设借用单；由 CG02「+新建归还入库」经 ?scene=3 进入
入口参数：入库单号、入库类型、状态（CG02/CG04 双入口统一三参）
底部导航：本页按单任务设计，无底部全局导航，由顶栏「返回」退出

业务规则

•配件缺失：可标记异常后照常入库，需注明缺失配件

•现场拍照留证：可拍照或从相册选图，最多 5 张，上传后以缩略图展示、可随时删除；非必填、不参与提交校验，出现异常/差异时建议留证

•无码资产：到货无二维码的资产，系统生成编码 → 打印标签 → 扫码确认 → 验收完成；编码由系统生成，仓管不能手输

•无码资产计数：计入各组进度与底部总数；只有「已验收」算完成，其余显示「含 X 项待确认」；只要有未验收的无码资产，提交按钮禁用

•无码资产添加：屏幕/水机板/安卓板/滤芯均可添加，一次一种可多次；滤芯先选型号再填数量；已添加可「移除」；场景③仅开放滤芯

•扫码不一致：实扫码与单据不符 → 标黄提示，建议填原因（选填，不阻断）；单据编码清单不可改

•扫码顺序：滤芯、配件与耗材可任意顺序扫

•默认可投放（②③）：扫码即已验收（可投放），无需二选一；异常用 3 标签（识别未匹配/功能异常/设备故障）点选标记，或手动输入自定义原因（20 字内）；「故障」并入「设备故障」标签

•异常可见性：异常入库单在 Web 端入库单中可见，管理员可查看具体明细

•滤芯箱码到货确认（Drovio SN-LB）：扫箱码弹「到货数量」确认窗，默认 = web32 按箱生成时登记根数；输入一致 → 「确认入库」整箱批量激活；输入不一致 → 系统自动标「箱码异常（数量不符）」（仓管零录入），主按钮切「进入逐根核验」，随后在主界面箱码行下方内联逐根核验（不弹独立窗）：规格判定 = 码属性——同规格根（如 BOX-PP50→PP棉）计入箱码数量并即时入库；其他规格根照常验收入库但不计入箱码（收尾归入滤芯分组底部「散装 · 不入箱」聚合行）；内联区无输入框/扫码按钮，扫码统一走底部「扫码验收」（核验模式）；「结束核验」收尾或直接提交自动收尾，收尾行副文本「箱码异常 · 登记 X / 实扫 Y」；SN-LB 记「已领用·异常」留痕、未扫到的登记根保持未领用；核验可中断续扫、单箱展开（其他箱数量不符进入核验被拦截，一致批量不受影响）。供应商外部箱码维持人工录入直接入库，不受影响。

•提交门槛放宽：至少识别到 1 项资产即可提交（对齐场景③归还入库），未扫完不再硬阻塞；差异（实际/预期）与逐条异常原因在提交弹窗集中体现

•待确认事项提示条：提交入库不阻断；吸底栏上方琥珀色提示条列出待确认项（未扫码/异常未填原因），按资产类型聚合展示（不展示具体编码），仅提示、不禁用提交

•异常原因展示：被标记异常的资产，原因直接显示在行内，可点「修改」重新填写（回收/归还 3 标签点选 + 手动输入，首次入库下拉）；可「恢复正常」——弹窗提示「是否要清除异常，资产将进入已验收」，仅「确认 / 取消」两步，确认后清除异常状态回到已验收，无「恢复并重新验收」二选一；提交确认弹窗逐条列出异常项及原因，无需填总原因；异常原因选填，仅作提示不阻断提交；有异常时入库备注必填；「标记异常」仅扫码识别到资产后才出现（待验收行不展示编码、不可标记异常）

•已验收资产移除：所有已验收（非异常）的编码资产行均显示「移除」按钮，点击弹窗确认后从本次入库中清除该行（同步回退已扫计数，可重新扫码录入）；异常资产走「修改 / 恢复正常」流程，不提供移除

查看更新记录

2026-09-15

入库提交改为「仅提示不阻断」：取消原阻断式红横幅，改为琥珀色「待确认事项」提示条（列出未扫码/异常未填原因，按资产类型聚合不展示编码，仅提示）；提交闸门去除异常原因必填，仅保留「至少验收 1 项」；确认弹窗新增「入库备注」，异常时须填备注方可确认。页面说明同步（清除历史「强制填原因/阻塞」错误表述，补「待确认事项提示条」「入库备注」说明）。

2026-09-13（去库存说明清理）

去库存说明清理：业务规则/跳转关系去除「已去除/不再」类注记；异常上报预设「设备故障（待维修/报废）」改为「设备故障（待维修）」（设备报废去除）；回收入库 mock 卡片与详情键值列表「设备故障换新/原设备位置」改为「资产故障换新/原位置」；代码注释去除「不再弹独立窗/场景⑤已取消」残留表述，与 Web 端设备不入库·报废去除口径对齐。

2026-09-12

去库存收尾·CG04 去设备：场景①②移除设备分组与「扫码绑定配件」双状态机（BIND_PARTS / SIM_DEVICE_TEMPLATE / ScanBindModal 一并删除），提交闸门去除 bindBlockedDevices 阻塞、绑定阻断模拟卡移除；异常码重定向至屏幕码（SN-P-002 / SN-P-010）；BlockingBanner 设备未绑定阻塞项移除；场景③清理残留「设备 0 台」汇总行。页面说明同步。

恢复正常弹窗简化：标题保持「恢复正常」，文案改为「是否要清除异常，资产将进入已验收」，仅「确认 / 取消」两步（取消「恢复并重新验收」分支，三场景 dual 统一去除）；已验收（非异常）编码资产新增「移除」按钮，ConfirmRemoveModal 弹窗确认后清除该行并回退已扫计数（removedCodes 过滤 + removeCode 同步 scanned/abnormal），三场景 ①②（hv/filter/box）与 ③（scannedAssetList）通用。页面说明同步。

标记异常门槛 + 编码展示收敛：AssetRowStatus「标记异常 / 修改」按钮限定 scanned 为真才显示（待验收行不显示编码、不可标记异常，需先扫码识别到资产）；资产行编码仅在 scanned 或箱码核验中（boxVerifying）展示，待验收行不显编码；异常原因弹窗标题去除编码展示（行内已显示）。页面说明同步。

2026-09-03

核验内联化改造（v2）：数量不符后不再弹独立核验窗，改为主界面箱码行下方内联核验区（无输入框/扫码按钮，扫码走底部「扫码验收」核验模式）；规格判定 = 码属性——同规格根计入箱码数量，其他规格根照常入库但不计入箱码（收尾落滤芯分组底部「散装 · 不入箱」聚合行）；支持手动「结束核验」与提交自动收尾、中断续扫、单箱展开；收尾副文本精简为「箱码异常 · 登记 X / 实扫 Y」。页面说明同步。

2026-09-03

滤芯箱码到货确认与异常核验：扫 SN-LB 箱码弹「到货数量确认」窗（默认=登记根数），数量一致 → 确认入库整箱批量激活；数量不符 → 自动定「箱码异常（数量不符）」零录入 + 主按钮转「进入逐根核验」，逐根扫 SN-L 即时入库（以实物为准），结束核验后 SN-LB 记「已领用·异常」、未扫登记根保持未领用；核验中断可续扫；模拟卡「识别滤芯箱码」拆为「箱码·数量一致/箱码·数量不符」双卡（①10 种、②③6 种、④9 种）；提交摘要按实扫根数折算；页面说明同步。

2026-08-14

移除编辑锁提示条：被锁单据在 CG03 入库详情即拦截（"XXX 正在操作"），仓管不会进入 CG04 操作页，提示条冗余。

2026-08-13

异常恢复 + 验收模型简化：①资产行三态（待验收/已验收/异常），编码+名称同行，原因行内展示，去除独立行内原因条；②默认可投放（扫码即已验收），废除回收/归还「可投放/故障」二态按钮，「故障」并入异常标签「设备故障」；③回收/归还异常用 3 标签点选即保存（识别未匹配/功能异常/设备故障），首次/调拨保留下拉+手动输入；④异常可「恢复正常」（回收/归还二选一，首次/调拨单一），「恢复并重新验收」需重扫；⑤二次扫码已验收资产提示「该资产已验收」。

2026-08-06

跨页一致性修复（与 CG02/CG03 对齐）：四场景入库单号由 IN-20260728-00X 改为以 CG02 为基准的同号（①首次 IN-20260724-001 / ②回收 IN-20260724-003 / ③归还 IN-20260724-002 / ④调拨 IN-20260724-004）；提交跳转 CG03 由「类型+状态」改为「单据ID+类型+状态」三参；页面说明跳转关系/入口参数同步。

2026-08-06

拍照留证交互修正 + 绑定阻塞合并：① 拍照底部操作面板改为锚定手机预览框内展示（不再全屏覆盖网页）；② 点「拍照/从相册选择」不再调起系统相机/文件选择器，改为直接模拟上传占位缩略图（原型交互展示用，最多 5 张、可删除）；③ 场景①「设备配件未绑定」阻塞提示由独立红色横幅合并进「暂不可提交入库，查看原因」卡片，与未扫码项统一列出、统一计数、可点击跳转设备分区。页面说明同步。

2026-08-06

拍照留证上传样式：原空实现的「拍照留证」按钮改为真实上传交互——点击弹出底部操作面板（拍照/从相册选择/取消），调起系统相机或相册；选图后即时预览缩略图（最多 5 张，右上角 × 可删除，满 5 张后隐藏添加入口）；4 场景统一非必填（②原「异常项必填」文案同步移除）；照片不参与提交校验。页面说明同步。

2026-08-06

扫码式设备绑定 + 标记异常手动输入：设备配件绑定由勾选改为扫码——设备验收后行内提示待绑定配件，点「绑定」弹扫码窗，逐个扫配件码完成绑定，全部绑定后提示消失；绑定仅场景①（两台设备都需绑定），②回收/④调拨设备与配件不绑定（移除②④绑定按钮与④「绑定阻断」模拟卡，④ 模拟卡 9→8 种）；提交前校验绑定完成：每台设备须「配件全部绑定或已标记异常」，否则红色横幅提示并禁用提交；点「绑定阻断」模拟卡会自动弹出扫码绑定窗（可当场补齐）；标记异常弹窗改为文本框手动输入为主 + 常用原因快捷选项 + 可选补充说明；页面说明同步。

2026-08-06

行内异常原因 + 异常处理改为 4 场景共享：被标记异常的资产，原因直接显示在行内，可点「修改」弹窗重新填写；异常处理能力由原「场景⑤」下沉为各场景通用，删除场景⑤；提交确认弹窗不再填「总异常原因」，改为逐条列出异常项并须逐条填写原因；设备绑定、可投放/故障二态接入共享。模拟扫码结果重新配置：①全 9 种、②含「全部成功含异常」、③含「数量差异+全部成功含异常」、④全 9 种（后随扫码绑定收窄为 8 种）。

2026-08-05

右侧控制面板新增「模拟扫码结果」9 种状态卡（全部扫码成功/部分成功/识别滤芯箱码/识别失败/配件缺失/扫码不一致/数量差异/绑定阻断/全部成功含异常），点击即把整页重置为对应扫码结果；①全 9 种可用、②含「全部成功含异常」、③含「数量差异+全部成功含异常」、其余通用 4 种，不支持的卡置灰、当前卡高亮，切换场景自动恢复干净状态。顺带修复：扫码不一致/配件缺失的「差异原因」可被记录，提交确认弹窗逐条展示具体原因，解决「提交弹窗看不到具体异常原因」问题；扫码不一致原来不计入异常数已修正为计入。

2026-08-05

提交入库后跳转 CG03 已完成详情：4 个场景「确认入库」后，由原跳转 CG02 入库列表改为跳转 CG03 对应入库类型的「已完成」详情页（①首次/②回收/③归还/④调拨）。

2026-08-04

无码资产统计一致性修复（5场景）：① useNoCode 增加按 type 细分统计（countByType/verifiedByType/pendingByType）；② 各分组胶囊与子分组 GroupHeader 的 current/total 纳入无码资产（仅已验收计入完成，未验收计入待确认并显示「含 X 项待确认」徽标）；③ 吸底 scannedCount/totalCount 与提交按钮 submitDisabled 纳入无码资产——存在未验收无码资产时一律禁用提交；④ 修复高价值配件子分组 totals 曾将 hv 组总数重复计入每个子分组的口径错误；⑤ 修复配件与耗材胶囊原为写死占位（0/4、0/1 等）改为按填写数量动态统计（填了即完成）；⑥ 场景③归还入库移除不存在的设备/高价值配件分区，添加无码资产弹窗仅开放滤芯类型。

2026-08-04

去除底部全局导航（与 CG03/CG06 同步），本页按单任务设计，由顶栏「返回」退出。提交确认弹窗曾试行「总异常原因（必填）」——后于 2026-08-06 移除，改为逐条异常原因必填，本条为历史过程记录。

2026-07-28

初版页面说明，基于设计文档 2026-07-27-cg04-inbound-confirm-design.md。5场景完整覆盖：首次入库/回收入库/归还入库/调拨入库/异常处理。

2026-07-29

同步页面说明到最新实现：①移除「状态时间线」描述（进度卡片已从全部场景屏蔽）；②新增「添加无码资产」通用功能说明（三态流程、系统生成SN、模拟打印、移除按钮；滤芯先选型号再输数量）；③入库单信息卡片补充发起人/创建时间（场景①）；④吸底栏布局改为「拍照留证+添加无码资产」并列一排 + StickyBar（扫码验收+提交入库）贴底；⑤设备 GroupHeader 副标题「验收设备后请先扫码绑定配件」、配件与耗材 QuantityRow 改为「预计/实际」三列、水管单位「米」。

2026-08-04

参照 CG07 增加「暂不可提交入库」阻塞提示条（BlockingBanner 共享组件）：吸底提交栏上方常驻红色提示，默认收起显示「暂不可提交入库，查看原因」，点击展开卡片逐条列出未扫码资产（编码·名称）、点击跳转对应分区；应用于全部 5 个场景。卡点仅含「未扫码」一类（CG04 无异常原因文本采集，未引入「未填异常原因」）；提示条纯展示，不改变现有 submitDisabled 提交闸门。同步将页说明底部导航标注为「已移除」（入库确认为单任务页，全局 tab 冗余）。

2026-07-31

5 场景接入「确认提交并入库」二次确认弹窗（对齐 CG07 出库确认、样式与 CG08 一致，absolute 锚定手机框、遮罩 0.4、z-340）：提交按钮触发弹窗，摘要含场景抬头 + 资产分组计数（设备/高价值配件/滤芯/配件与耗材，整箱折算根数）+ 无码资产 + 异常提示 +「不可撤销」警示，确认后跳转 CG02 入库列表。同步将 7 个旧弹窗（AddNoCodeModal/ScanSimSheet/RecognitionModal/QtyDiffModal/Scene5 三异常弹窗）由 fixed 改为 absolute 锚定手机框。更正页面说明：②回收入库无摄像头核验（配件与耗材为空分区），原「摄像头toggle核验」描述与代码不符，已移除；同步删除未引用的 i18n 键 cameraCheck/hasCamera/noCamera（中泰各一处），并清理页面清单中 8 处摄像头有/无核验描述。