仓管端 - 设备库存列表

原型图 | React + Tailwind

← 返回总览 CG01 首页 CG02 入库列表 CG03 入库详情 CG04 入库确认 CG05 出库列表 CG06 出库详情 CG07 出库确认 CG08 借用出库创建 CG09 报废列表 CG10 发起报废 CG11 库存总览 CG12 设备库存列表 CG15 扫一扫 CG17 我的
9:41

场景切换

页面说明

最后更新:2026-08-12

页面定位 — PRD §5.9.1 / §5.9.10

资产库存页(设备 / 高价值配件 / 滤芯三 tab):设备 tab 按设备查看本仓实际库存(可投放/故障/已报废),支持状态/型号/关键字筛选与单台操作(标记故障、维修、申请报废);高价值配件 / 滤芯 tab 查看一物一码明细。承接 CG11 设备卡状态桶钻取、高价值配件卡与滤芯卡跳转。

核心内容

模块说明场景差异
三 Tab 栏设备 / 高价值配件 / 滤芯 三 tab 切换;各 tab 状态 chips 带数量(设备与配件:全部/可投放/故障/已报废四枚;滤芯:五枚含已借出),与 CG11 数字呼应所有场景,跟随仓库
筛选栏设备 tab:状态 chips 带数量(全部/可投放/故障/已报废)+ 型号下拉(S6/S8/S10,与 web 端一致)+ 关键字搜索所有场景
设备列表行 = 三行布局:首行编号 + 状态标签 / 次行名称 / 第三行已绑定配件概要(名称空格分隔,无 ✓);型号不展示在行内;报废审批中的设备在状态标签左侧额外显示蓝色「报废审批中」小标签所有场景
设备详情面板底部弹起,双 Tab:①设备详情(状态、已绑定配件/关联滤芯逐行 名称+编码)②流转记录(时间线:类型/状态变更/操作人/关联单号/备注,倒序);操作按钮固定面板底部、不随 Tab 切换;标记故障 / 维修完成 / 申请报废均经二次确认弹层所有场景
配件/滤芯详情面板底部弹起(双 Tab:①详情 ②流转记录,与设备同构):详情只读展示 型号/仓库/状态/故障原因/绑定设备(或借用人);流转记录为六字段时间线(与设备一致);底部操作:可投放态「标记故障」、故障态「维修完成」+「发起报废」(均经二次确认);其余状态无操作;滤芯故障态同样支持维修完成+发起报废所有场景
仓库下拉单选标题栏显示当前仓库名 + 下拉箭头,点击弹出下拉单选(对齐 CG01 场景②);切换后列表整组替换,同一时刻仅展示当前选中仓仅多仓(场景②)

关键交互

操作 触发条件 前置校验 反馈形式 行为
切换资产 Tab三 Tab 栏(设备/高价值配件/滤芯)-切换对应 tab 列表URL type=part/filter 参数预置对应 tab(如 cg12.html?type=part 预置高价值配件);可叠加 status 参数预置筛选
点击状态 chip各 tab 筛选栏任意 chip(带数量)-列表过滤为对应状态全部/可投放/故障/已报废(滤芯另含已借出);URL 携带 status 参数时预置对应筛选
型号/关键字筛选设备 tab:型号下拉(S6/S8/S10)/ 搜索框输入-列表按型号或编码/名称过滤型号枚举与 web 端一致(S6/S8/S10);关键字匹配编码或名称
点击设备行任意列表行-详情面板底部弹起(双 Tab:设备详情 / 流转记录)操作按钮固定面板底部,不随 Tab 切换
点击高价值配件行高价值配件 tab 任意卡片-详情面板底部弹起(双 Tab:详情 / 流转记录)故障态显示「维修完成」+「发起报废」;可投放态显示「标记故障」;均经二次确认;其余状态无操作
点击滤芯行滤芯 tab 任意卡片-详情面板底部弹起(双 Tab:详情 / 流转记录)故障态显示「维修完成」+「发起报废」(含滤芯);可投放态显示「标记故障」;已借出/已报废无操作;均经二次确认
标记故障(二次确认)设备/配件/滤芯详情面板「标记故障」仅可投放态弹二次确认框,确认后状态→故障,列表与 status chips 数量即时刷新设备 tab 原直执行已同步改为二次确认
发起报废(二次确认)设备/配件/滤芯详情面板「发起报废」(仅故障态)仅故障态弹二次确认框,确认后跳转 CG10(code/type/wh)设备 tab 申请报废原直执行已同步改为二次确认;CG10 按 code 预填资产(SN 编码未命中 mockAssets 时需手动选择,同设备 tab 现状)
切换详情 Tab详情面板 Tab 栏-Tab1 设备详情(状态/配件/滤芯);Tab2 流转记录时间线(类型标签/状态变更/操作人/关联单号/备注,最新在上)切换 Tab 时滚动位置重置到顶部;流转记录空态显示「暂无流转记录」
标记故障仅库存中·可投放-设备状态 → 库存中·故障,列表与状态 chips 数量即时刷新mock 即时变更(可投放 -1 / 故障 +1),并追加「标记故障」流转记录(橙色标签,时间为当前时刻)
维修完成(二次确认)设备/高价值配件/滤芯 详情面板「维修完成」(仅故障态,非报废审批中)仅故障态弹二次确认框,确认后状态 → 可投放,列表与状态 chips 数量即时刷新设备/配件/滤芯通用;mock 即时变更(故障 -1 / 可投放 +1),并追加「维修完成」流转记录(时间为当前时刻);含滤芯
申请报废仅库存中·故障(非报废审批中)-跳转 CG10 发起报废页cg10.html?code=SN-G-xxx(CG10 未建时为空白页,属预期)
报废审批中设备设备已发起报废申请(SN-G-002)-详情面板显示蓝色提示条,无操作按钮列表行仍显示「故障」标签;审批进度由 CG09 报废列表承载
切换仓库(下拉单选)场景② 多仓,点击标题栏仓库名-下拉展开,单选后标题与列表整组替换对齐 CG01 场景②;点击外部关闭下拉;同一时刻仅展示当前选中仓
切换场景(控制面板)控制面板场景卡-手机壳标题/仓库 Tab 联动①单仓 ②多仓

跳转关系

CG11 设备卡标题区 → CG12(不带参)
CG11 设备卡状态桶 → CG12(桶带 status 参数,如 cg12.html?status=fault,预置筛选)
CG11 高价值配件卡 → CG12(type=part,如 cg12.html?type=part,预置高价值配件 tab)
CG11 滤芯卡 → CG12(type=filter,如 cg12.html?type=filter,预置滤芯 tab)
申请报废 → CG10 发起报废(cg10.html?code=SN-G-xxx)
底部导航:首页(CG01) / 入库(CG02) / 出库(CG05) / 库存(CG11) / 我的(CG17)

页面状态

状态触发条件表现
场景① 单仓仓管控制面板场景① / 默认标题显示仓库名「曼谷1号仓」,无仓库 Tab,列表为曼谷数据
场景② 多仓仓管控制面板场景②标题栏显示当前仓库名 + 下拉单选(曼谷1号仓/清迈1号仓,对齐 CG01 场景②),列表跟随

业务规则

· 三 tab 口径独立:设备 tab 状态仅 3 项(可投放/故障/已报废,不含运输中、使用中与已借出——设备不参与借用);高价值配件 tab 状态 3 项(可投放/故障/已报废);滤芯 tab 状态 4 项(可投放/故障/已借出/已报废)
· 仅库存中·故障可申请报废(PRD §5.9.2);可投放设备须先标记故障
· 报废链路:申请 → CG10 发起(含配件处置方式)→ 待审批(管理员 Web 端审批)→ 通过后执行 → 已报废(终态);驳回保持故障可重新申请
· 待审批期间资产状态不变(仍显示故障),详情面板显示「已发起报废申请 · 待审批」提示条、隐藏「发起报废」按钮,并在底部固定「进入报废列表」按钮跳转 CG09;列表卡片额外显示蓝色「报废审批中」标签;该规则对设备 / 高价值配件 / 滤芯三类资产均适用;审批进度由 CG09 报废列表承载
· 已绑定配件 / 关联滤芯逐行展示(名称 + 编码),编码前缀 SN-P / SN-S / SN-A / SN-L
· 高价值配件一物一码:deviceCode 非空 = 已绑定设备(行内绿色展示「已绑定:SN-G-xxx」),为空 = 未绑定(灰色)
· 滤芯一物一码:borrower 非空 = 已借出(行内展示「借用人:xxx」),为空 = 未借出
· 标记故障 / 维修完成 / 申请报废为 mock 即时状态变更(设备 / 高价值配件 / 滤芯三类资产通用);维修完成与标记故障实时追加流转记录(配件 / 滤芯 mock 已补 flow 数组,终态对齐当前 status);申请报废跳转携带资产编码参数(code/type=part|filter/wh)
· 流转记录为结构化记录(时间/类型/状态变更/操作人/关联单号/备注,六字段与 web18 对齐),时间线倒序展示(最新在上),含使用中/运输中等历史状态事件;状态变更文字沿用「库存中·可投放 → 运输中」二维写法
· 每条设备流转链终态与当前状态一致(mock 静态数据);标记故障/维修完成操作实时追加流转记录,刷新页面后恢复初始 mock(不持久化)
· 状态 chips 数量反映全量口径(设备 WH_STATS / 配件 WH_PART_STATS / 滤芯 WH_FILTER_STATS,与 CG11 呼应),列表为代表性明细子集;数据为 mock 常量(WH_DEVICES / WH_PARTS / WH_FILTERS)
更新记录
2026-08-07(第六次)
终审修复:①URL status 预置三 Tab 统一透传(?type=filter&status=borrowed / ?type=part&status=fault 可达对应桶,非法值忽略,?status=borrowed 无空态);②配件/滤芯 chips 数量对齐 CG11(曼谷配件 全部150/可投放144/故障6、滤芯 全部99/可投放85/故障4/已借出10;清迈配件 全部75/可投放73/故障2、滤芯 全部49/可投放43/故障2/已借出4;各仓已报废桶 CG11 未统计取 0);③设备侧关联滤芯名称与 WH_FILTERS 一物一码自洽(SN-G-002→RO膜滤芯、SN-G-003→矿化滤芯、SN-G-102→RO膜滤芯)。
2026-08-07(第五次)
设备/高价值配件/滤芯三 Tab 合并为资产库存页:状态 chips 带数量(全量口径)替代计数行;设备列表改三行布局(编号/名称/已绑定配件概要,型号不展示行内);顶部导航移除配件/耗材库存列表独立入口(并入本页三 tab);CG11 高价值配件卡 → cg12?type=part、滤芯卡 → cg12?type=filter 预置切 tab;页面说明同步三 tab 口径。
2026-08-12
高价值配件/滤芯 tab 补点击详情:卡片可点开详情面板(只读:型号/仓库/状态/故障原因/绑定设备 或 借用人),底部操作与设备对齐——可投放态「标记故障」、故障态「发起报废」(仅故障可发起,同设备口径),均经二次确认弹层;仓库由 AssetTabsView 透传,发起报废跳 CG10(code/type=part|filter/wh)。设备 tab「标记故障」「申请报废」原直执行同步改为二次确认;配件/滤芯 mock 补 model/faultReason 字段,i18n 补中泰双语。;2026-08-12 续:设备列表卡片对 scrapStatus=pending 的设备,在状态标签左侧增加蓝色「报废审批中」小标签,与详情面板「已发起报废申请 · 待审批」提示条呼应。
2026-08-12(续2)
高价值配件/滤芯 tab 各新增一条「故障 + 报废审批中(scrapStatus=pending)」数据(SN-S-003 水机板、SN-L-025 RO膜滤芯),故障列表可见;列表卡片(设备/配件/滤芯统一)与详情面板(AssetDetailPanel 补 pending 处理:隐藏发起报废、显示「已发起报废申请·待审批」提示条)均展示「报废审批中」状态提示,与设备口径一致;i18n 复用 scrapPendingTag / scrapPending。业务规则第 3 条同步将待审批提示扩展为三类资产通用。
2026-08-12(续3)
报废审批中详情页补「进入报废列表」按钮:设备、高价值配件、滤芯三类资产在 scrapStatus=pending 时,详情面板底部固定蓝色主按钮「进入报废列表」,跳转 CG09 报废列表;i18n 补 devices.viewScrapList(中泰双语)。业务规则第 3 条同步更新。
2026-08-12(续4)
高价值配件 / 滤芯详情面板升级为双 Tab(详情 / 流转记录,与设备同构):流转记录六字段时间线(时间/类型/状态变更/操作人/关联单号/备注)倒序展示;WH_PARTS / WH_FILTERS 每条 mock 资产均补 flow 数组(终态对齐当前 status,代表类型含建档入库/标记故障/借出/报废),避免维修完成/标记故障 push 时运行时崩溃。故障态配件 / 滤芯(含滤芯)新增「维修完成」(→可投放,二次确认弹层)+「发起报废」(→CG10,二次确认);维修完成 i18n 补 devices.confirmRepairDone(中泰双语)。设备详情面板「维修完成」同步明确为二次确认。
2026-08-07(第四次)
场景②仓库切换由内容区 Tab 改为标题栏顶部下拉单选(对齐 CG01 场景②):标题栏显示当前仓库名+下拉箭头,点击弹出单选;switchScene 场景②不再注入「仓管」标题。
2026-08-07(第三次)
型号筛选对齐 web 端:型号下拉枚举改为 S6/S8/S10(原按设备名 台式净水机A/立式净水机B);8 台设备 model 字段同步分配(曼谷 SN-G-001=S10、002=S6、003=S8、004=S10、005=S6;清迈 101=S6、102=S8、103=S10),筛选逻辑按 model 匹配。
2026-08-07(第二次)
详情面板升级双 Tab:①设备详情(状态/配件/滤芯)②流转记录(结构化六字段时间线:时间/类型/状态变更/操作人/关联单号/备注,参照 web18 完整展示,最新在上);操作按钮固定面板底部不随 Tab 切换;标记故障/维修完成实时追加流转记录(刷新恢复静态 mock 不持久化);流转记录含使用中/运输中等历史事件,每条设备流转链终态=当前状态。
2026-08-07
初版页面说明,基于设计文档 docs/superpowers/specs/2026-08-07-cg12-device-inventory-list-design.md 与仓管端页面清单 §5.2(设备状态 3 项、详情操作矩阵、报废审批链路对齐 web25、配件/滤芯逐行编码)。