跳到主要内容

PDA 商品库存管理操作指南 🍺

📋 功能说明​

什么是商品库存管理？​

商品库存管理是通过 PDA 查看酒款商品及其规格的库存情况，帮助仓库管理员快速了解库存状态。

主要功能​

  • 📊 酒款列表展示：显示所有酒款及其品牌信息
  • 🔍 搜索功能：支持按酒款名称搜索，防抖搜索提升体验
  • 📈 规格库存查看：展开查看每个酒款的规格库存明细
  • 💾 库存数据：可用库存、冻结库存、总库存
  • 📝 详情查看：点击规格查看更详细的库存信息

重要说明​

⚠️ 商品库存为只读模式：

  • 不支持通过此页面直接调整库存
  • 库存变更只能通过 PDA 扫码入库/出库操作实现
  • 确保一物一码溯源的准确性

📱 详细操作步骤​

步骤 1：进入商品库存管理页面​

操作说明： 在 PDA 首页或菜单中点击"商品库存管理"功能。

页面显示：

  • 页面标题："商品库存管理"
  • 顶部搜索框
  • 搜索按钮和清空按钮
  • 统计信息："酒款: X | 规格: Y"
  • 酒款列表

步骤 2：查看酒款列表​

列表自动加载​

进入页面后，系统自动加载酒款列表数据。

加载说明：

  • 默认加载第1页
  • 每页最多100条酒款数据
  • 显示加载提示："加载中..."

列表项显示内容​

每个酒款列表项包含：

字段名称说明示例
酒款名称商品名称某某精酿啤酒
品牌名称所属品牌XX品牌
描述信息自定义风格或规格拉格/小麦啤酒
规格统计该酒款包含的规格数量共有3个规格
展开图标点击展开/折叠规格列表右侧箭头

列表状态：

  • 默认所有酒款都是折叠状态
  • 点击酒款项或展开图标可展开规格列表

步骤 3：展开查看规格库存​

操作说明： 点击酒款列表项或右侧的展开图标。

展开效果：

  • 展开图标旋转90度
  • 显示该酒款下的所有规格列表
  • 每个规格显示库存信息

规格列表显示内容​

字段名称说明数据来源
规格名称规格名称specName
可用库存可用于出库的数量availableStock 或 stockQuantity
冻结库存已预占、不可用的数量frozenStock 或 pendingStock
总库存仓库中的总数量totalStock 或 physicalStock

库存数据说明：

  • 可用库存 ≥ 0
  • 冻结库存 ≥ 0
  • 总库存 = 可用库存 + 冻结库存（一般情况）
  • 所有负数自动处理为 0

空规格处理：

  • 如果酒款没有规格数据，显示："暂无规格信息"

步骤 4：折叠规格列表​

操作说明： 再次点击已展开的酒款列表项或展开图标。

折叠效果：

  • 展开图标旋转回0度
  • 隐藏规格列表
  • 节省屏幕空间

步骤 5：搜索酒款​

系统提供两种搜索方式：

方式一：防抖搜索（推荐）​

操作说明：

  1. 在顶部搜索框中输入酒款名称关键字
  2. 系统会在您停止输入 800 毫秒后自动执行搜索
  3. 显示清空按钮（X 按钮）

优点：

  • 无需手动点击搜索按钮
  • 自动隐藏软键盘
  • 减少不必要的搜索请求

搜索过程：

  1. 显示"搜索中..."提示
  2. 调用后端接口搜索
  3. 更新列表显示搜索结果
  4. 显示匹配数量提示（如："找到 3 个匹配结果"）

方式二：手动搜索​

操作说明：

  1. 在搜索框中输入关键字
  2. 点击"搜索"按钮
  3. 或按下软键盘的"搜索"键

搜索验证：

  • 如果搜索框为空，提示："请输入搜索关键词"

清空搜索​

操作说明：

  1. 点击搜索框右侧的"清空"按钮（X 图标）
  2. 或删除搜索框中的所有文字

清空效果：

  • 搜索框内容清空
  • 恢复显示所有酒款（原始数据）
  • 清空展开状态
  • 隐藏清空按钮

搜索结果​

搜索成功：

  • 列表显示匹配的酒款
  • 更新统计信息
  • 显示匹配数量提示

搜索无结果：

  • 列表为空
  • 统计信息显示："酒款: 0 | 规格: 0"
  • 提示："未找到匹配的酒款"

搜索失败：

  • 显示错误提示："搜索失败，请重试"或"网络异常，请重试"

步骤 6：查看规格详情（可选）​

操作说明： 点击展开后的规格列表项。

跳转结果：

  • 系统跳转到"商品库存详情"页面（BeerInventoryDetailActivity）
  • 传递参数：beerId（酒款ID）、specId（规格ID）、beerName（显示名称）
  • 显示该规格的更详细库存信息

详情页面可能包含：

  • 规格基本信息
  • 批次库存明细
  • 库存历史记录
  • 其他相关信息

📊 统计信息说明​

顶部统计栏​

显示格式：

酒款: X | 规格: Y

统计逻辑：

  • 酒款数量：当前列表中的酒款总数
  • 规格数量：所有酒款包含的规格总数（累加）

更新时机：

  • 初始加载完成后
  • 搜索完成后
  • 清空搜索后

❓ 常见问题​

Q1: 页面显示"暂无商品数据"？​

可能原因：

  • 后台确实没有配置商品（酒款）数据
  • 网络连接问题导致数据加载失败
  • 接口返回数据格式异常

解决方法：

  1. 检查网络连接是否正常
  2. 在后台系统确认是否有商品数据
  3. 重新进入页面刷新数据
  4. 联系技术支持

Q2: 搜索框输入文字后没反应？​

说明：

  • 系统使用防抖搜索机制
  • 需要等待 800 毫秒（0.8秒）后才会自动搜索
  • 这是为了避免频繁请求，提升性能

解决方法：

  • 输入完成后等待片刻
  • 或直接点击"搜索"按钮立即搜索

Q3: 点击规格后无反应？​

可能原因：

  • 规格的 specId 或 beerId 为空
  • 详情页面跳转异常
  • PDA 应用卡顿

解决方法：

  1. 确认该规格是否有有效的 ID
  2. 重新点击规格项
  3. 重启 PDA 应用
  4. 联系技术支持

Q4: 为什么有些酒款显示"暂无规格信息"？​

原因：

  • 该酒款在后台系统中未配置规格信息
  • 或接口返回的 specInventories 字段为空

解决方法：

  • 这是正常现象
  • 需要在后台系统为该酒款添加规格
  • 配置后重新加载页面

Q5: 库存数据显示异常（负数、超大数值）？​

说明：

  • 系统会自动将负数处理为 0
  • 超大数值可能是数据异常

解决方法：

  1. 刷新页面重新加载数据
  2. 在后台系统检查库存数据是否正确
  3. 联系管理员核查库存数据
  4. 必要时进行库存盘点

Q6: 如何修改库存数量？​

答案：

  • ❌ 商品库存页面不支持直接修改库存
  • ✅ 需要通过以下方式变更库存：
    • PDA 扫码入库：增加库存
    • PDA 扫码出库：减少库存
  • 这是为了保证一物一码溯源的准确性

Q7: 清空搜索按钮不显示？​

原因：

  • 搜索框为空时，清空按钮会自动隐藏
  • 这是正常的交互设计

说明：

  • 只有搜索框有内容时才显示清空按钮
  • 点击清空按钮后会自动隐藏

💡 最佳实践建议​

1. 使用搜索功能​

  • ✅ 当酒款数量较多时，优先使用搜索功能
  • ✅ 输入关键字后稍等片刻，系统会自动搜索
  • ✅ 搜索完成后记得清空，恢复完整列表

2. 展开/折叠管理​

  • ✅ 只展开需要查看的酒款，节省屏幕空间
  • ✅ 查看完规格后及时折叠
  • ✅ 切换酒款时会自动清空之前的展开状态

3. 定期查看库存​

  • ✅ 每天定期查看库存情况
  • ✅ 关注可用库存是否充足
  • ✅ 冻结库存过高时及时处理订单

4. 配合出入库操作​

  • ✅ 出库前查看库存是否充足
  • ✅ 入库后确认库存数据是否更新
  • ✅ 发现异常及时上报

📊 操作流程图​

📝 数据规则说明​

库存字段映射​

显示名称优先字段备用字段默认值
可用库存availableStockstockQuantity0
冻结库存frozenStockpendingStock0
总库存totalStockphysicalStock可用库存

数据处理规则​

  • ✅ 所有库存数值 < 0 时，自动转换为 0
  • ✅ 字符串类型的数字会自动解析
  • ✅ 解析失败时使用默认值 0
  • ✅ null 或 "null" 视为无效值

展开状态管理​

  • 🔄 使用 beerId 作为唯一标识
  • 🔄 如果 beerId 为空或 0，使用列表位置作为标识
  • 🔄 搜索或清空搜索时会清空所有展开状态
  • 🔄 防止内存泄漏，页面销毁时清理数据

📚 相关文档​

最后更新: 2025-10-07
适用版本: PDA v2.0+
文档类型: 商品库存管理操作指南