仓管端 - 资产库存列表

原型图 | React + Tailwind

9:41

场景切换

页面说明

最后更新：2026-09-13

页面定位 — PRD §5.9.1 / §5.9.10

资产库存页（高价值配件 / 滤芯两 tab）：查看一物一码明细（状态/关键字筛选；可投放态「标记故障」、故障态「发起报废」，均经二次确认）。设备不计库存、不在本页展示（设备不入库、恒「使用中」）。承接 CG11 状态桶钻取与卡片跳转。

核心内容

模块	说明	场景差异
两 Tab 栏	高价值配件 / 滤芯两 tab 切换；各 tab 状态 chips 带数量（配件：全部/可投放/故障/已报废四枚；滤芯：五枚含已借出），与 CG11 数字呼应	所有场景，跟随仓库
配件/滤芯详情面板	底部弹起（双 Tab：①详情 ②流转记录，与高价值配件/滤芯详情面板同构）：详情只读展示型号/仓库/状态/故障原因/绑定设备(或借用人)；流转记录为六字段时间线（与配件/滤芯一致）；底部操作：可投放态「标记故障」、故障态「维修完成」+「发起报废」（均经二次确认）；其余状态无操作；滤芯故障态同样支持维修完成+发起报废	所有场景
仓库下拉单选	标题栏显示当前仓库名 + 下拉箭头，点击弹出下拉单选（对齐 CG01 场景②）；切换后列表整组替换，同一时刻仅展示当前选中仓	仅多仓（场景②）

关键交互

操作	触发条件	前置校验	反馈形式	行为
切换资产 Tab	两 Tab 栏（高价值配件/滤芯）	-	切换对应 tab 列表	URL type=part/filter 参数预置对应 tab（如 cg12.html?type=part 预置高价值配件）；可叠加 status 参数预置筛选
点击状态 chip	各 tab 筛选栏任意 chip（带数量）	-	列表过滤为对应状态	全部/可投放/故障/已报废（滤芯另含已借出）；URL 携带 status 参数时预置对应筛选
点击高价值配件行	高价值配件 tab 任意卡片	-	详情面板底部弹起（双 Tab：详情 / 流转记录）	故障态显示「维修完成」+「发起报废」；可投放态显示「标记故障」；均经二次确认；其余状态无操作
点击滤芯行	滤芯 tab 任意卡片	-	详情面板底部弹起（双 Tab：详情 / 流转记录）	故障态显示「维修完成」+「发起报废」（含滤芯）；可投放态显示「标记故障」；已借出/已报废无操作；均经二次确认
标记故障（二次确认）	高价值配件/滤芯详情面板「标记故障」	仅可投放态	弹二次确认框，确认后状态→故障，列表与 status chips 数量即时刷新	原直执行已同步改为二次确认
发起报废（二次确认）	高价值配件/滤芯详情面板「发起报废」（仅故障态）	仅故障态	弹二次确认框，确认后跳转 CG10（code/type/wh）	申请报废原直执行已同步改为二次确认；CG10 按 code 预填资产（SN 编码未命中 mockAssets 时需手动选择）
切换详情 Tab	详情面板 Tab 栏	-	Tab1 详情（状态/配件/滤芯）；Tab2 流转记录时间线（类型标签/状态变更/操作人/关联单号/备注，最新在上）	切换 Tab 时滚动位置重置到顶部；流转记录空态显示「暂无流转记录」
维修完成（二次确认）	高价值配件/滤芯详情面板「维修完成」（仅故障态，非报废审批中）	仅故障态	弹二次确认框，确认后状态 → 可投放，列表与状态 chips 数量即时刷新	高价值配件/滤芯通用；mock 即时变更（故障 -1 / 可投放 +1），并追加「维修完成」流转记录（时间为当前时刻）；含滤芯
申请报废	仅库存中·故障（非报废审批中）	-	跳转 CG10 发起报废页	cg10.html?code=SN-P-xxx（按资产编码预填）
切换仓库（下拉单选）	场景② 多仓，点击标题栏仓库名	-	下拉展开，单选后标题与列表整组替换	对齐 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-P-xxx）
底部导航：首页(CG01) / 入库(CG02) / 出库(CG05) / 库存(CG11) / 我的(CG17)

页面状态

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

业务规则

· 两 tab 口径独立：高价值配件 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_PART_STATS / 滤芯 WH_FILTER_STATS，与 CG11 呼应），列表为代表性明细子集；数据为 mock 常量（WH_PARTS / WH_FILTERS）

更新记录

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

移除资产库存列表说明内残留「设备」措辞：维修完成操作去「设备/」前缀、申请报废编码前缀 SN-G → SN-P、业务规则「设备流转链」→「资产流转链」、空态「暂无设备」→「暂无资产」；业务规则移除「含使用中/运输中等历史状态事件」「库存中·可投放 → 运输中」等不实描述，状态变更文字对齐真实 mock（仅建档入库/标记故障/维修完成/借出/报废），与 Web 端「设备不入库、恒使用中、报废去除」口径对齐。

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、配件/滤芯逐行编码）。