Appearance
一、功能整体概述
1.1 功能定位
货架管理是仓储精细化库位管理的核心基础模块，归属盘点管理子系统，用于按仓库维度维护货架主档案、自动生成下级货位，完成「仓库→区域→货架→货位」四级仓储架构搭建。搭配前置「货架类别」档案使用，实现冷藏、小件、囤货、虚拟库区分类管控；支撑货架盘点、库位拣货、库存定位、原料/成品分区存放，适配烘焙多温区、多品类仓储管理需求。
强制前置规则：打开货架管理必须先选定仓库，所有货架数据按仓库隔离，不同仓库货架完全独立，不可跨仓库编辑。
1.2 整体页面构成
界面分为三大标签页：
- 货架（主标签）：维护货架顶层档案，填写货架尺寸、层数、列数、归属仓库/区域、货架类别、管理员等基础信息；
- 货位：可视化矩阵展示当前货架所有下级货位，支持批量一键生成货位、单独增删货位；
- 编码备注：存放货架全维度管控标记、操作留痕、附件等扩展字段。
顶部通用工具栏：退出、编辑、刷新、报表、选择仓库、帮助；
明细操作栏：首记录、尾记录、新增、删除、修改、保存、取消、全局搜索。
1.3 配套依赖档案
- 货架类别：提前在货架类别模块维护，货架必须绑定类别；
- 仓库档案：选择当前定义的烘焙企业仓库（例如 原料仓C0001、成品仓C0002、半成品仓C0003、熟胚半成品仓C0006、待发货仓C0007、车间仓C0004、报废仓C0005）；
- 仓库区域：货架必须归属仓库下的指定区域；
- 仓管人员：绑定负责该货架拣货、验货的管理员账号。
二、仓库选择操作说明
2.1 入口与弹窗
点击顶部【选择仓库】按钮，弹出仓库选择弹窗，仅展示总部专属仓库。
弹窗功能：
- 顶部搜索框：按仓库编号、仓库名称模糊检索；
- 表格列：仓库编号、仓库名称；
- 操作：双击仓库行快速选中；选中后点【确定】；【取消】放弃选择；
- 【定制显示效果】：自定义表格列宽、排序、隐藏字段。
2.2 仓库绑定逻辑
- 进入货架管理窗体自动弹出仓库选择，未选仓库禁止新增货架；
- 选定仓库后，页面顶部红栏显示「仓库编号-仓库名称」，整个界面仅加载当前仓库货架；
- 切换仓库会重载货架列表，清空原有货架、货位数据；
三、货架标签页
3.1 表格全部列释义
货架编号、货架名称、代码（货位前缀fCode）、货架类别、货架结构（层数、列数）、货架尺寸（长/宽/高）、货架容积、仓库、区域、备注。
其中：货架代码特别重要，他必须是在这个仓库里面唯一的字符串，长度位数可以是1或者2，这个货架代码会在之后生成货位编号的时候作为标准的前缀。
例如 我们的货架代码是A，见下图
那么然后系统生成的货位编号就都是A开头的，使用的编码规则是 —— “货位代码-行-列” ，行列都是两位数的阿拉伯数组，不足2位就补0 ，如下图：
3.3 标准操作步骤
3.3.1 新增货架
- 确认顶部已选正确仓库；
- 点击明细栏【新增】，系统自动：
- 生成唯一主键
fFrameID；默认层数=4、列数=6；自动绑定当前仓库ID；
- 依次填写：货架编号、货架名称、货位代码（A/B/C）；下拉选择货架类别、仓库区域、责任仓管；填写货架长宽高；
- 点击【保存】完成新增；系统记录创建人、创建时间；长宽高填写后自动核算容积。
3.3.2 修改货架
- 选中目标货架行，点击【修改】；
- 不建议修改已使用货架的层数、列数、货位代码，会造成货位编号错乱；
- 保存自动记录修改人、修改时间；货架已有库存（SignUsed=*）依然允许修改基础信息，仅限制删除。
3.3.3 删除货架
删除双重限制：
- 货架下存在货位：必须先清空全部货位才能删货架；
- 货架标记
SignUsed=*（存放过物料）/SignSpecial=*（系统保护）：禁止物理删除，仅可逻辑删除（SignDelete=1）；
操作：选中货架点删除，触发校验；校验通过执行删除，同步级联更新货位删除标记。
3.4 联动规则
- 选择区域：必须先选定仓库，否则弹窗提示「请先指定仓库」；区域下拉只展示当前仓库的库区；
- 选择货架类别：下拉加载货架类别全部档案，显示格式「类别编号 类别名称」；
- 选择管理员：仅筛选「仓库人员-仓管员」岗位账号，限制非仓管人员绑定货架。
四、货位标签页
该界面实现了货架下级库位的可视化管理，参见下图。
4.1 数据库底层表
货位明细表：chk_FrameCounterManage，主键fCountID；每一行对应1个独立货位，绑定上级货架ID。
| 关键字段 | 说明 |
|---|---|
| fCountID | 货位全局主键，自动生成 |
| fCountNo | 货位编号，规则：货位代码-层号-列号（示例A-04-02） |
| fFrameID | 上级货架ID，和货架主表关联绑定 |
| fFloorID | 层数序号（从上至下） |
| fListID | 列数序号（从左至右） |
| DefineMan/ChangeMan | 操作留痕，新增/修改自动记录账号时间 |
| SignUsed | 货位存放物料后标记*，不可删除 |
4.2 可视化界面说明
- 整体为矩阵网格：纵向=层数、横向=列数；左侧黄色底色列为每一层的第一列，区分层级；
- 每个格子显示完整货位编号，格式
货位代码-层号-列号；例：A-04-02 = 货架代码A、第4层、第2列； - 顶部状态栏：展示当前仓库、区域、货架、总列数；
- 左侧功能按钮：创建完善货位、删除当前货位；右侧说明区标注编号规则。
4.3 批量一键生成货位（强烈推荐）
操作步骤
- 回到货架主标签，确认货架已经填写：货位代码（A/B/C）、层数、列数，三项不能为空；层数、列数必须大于1；
- 切换到货位标签，点击【创建完善货位】；弹窗确认是否批量生成；
- 系统将自动按「层数×列数」批量生成全部货位，自动拼接货位编号；
- 生成完成自动刷新货位矩阵，全终端广播货位变更，POS、平板同步更新货位下拉列表。
约束条件
无法执行批量生成的场景：货位代码为空、层数≤1、列数≤1。
4.4 单个货位删除
- 鼠标选中需要删除的货位格子，点击【删除当前货位】；
- 系统校验：如果该货位绑定库存物料，弹窗报错「货位绑定物料，解绑后才能删除」；
- 无库存则直接删除本条货位记录，同步广播更新；支持手动单独新增零散货位。
- 其实，我们并不建议大家去手工单独新增加零散货位！
4.5 货位编号规则
标准编号：货架代码-层序号-列序号
示例：A-01-06
- A：货架主档案的货位代码；
- 01：第一层；
- 06：第六列；
系统强制货位（货架+层+列）唯一，新增重复会直接拦截报错。
五、烘焙门店标准化落地规范
- 仓库划分，一般我们建议烘焙企业按系统默认7个仓库执行：原料仓存放所有烘焙原材料；成品仓放打包面包蛋糕；半成品仓放预拌面团；熟胚仓放烘烤熟胚；车间仓放产线在制品；待发货仓放已接单待配送货品；报废仓存放过期、破损原料成品。
- 原料仓货架统一归类：高频取用小原料归属「01小件货架」；整箱面粉、糖油囤货归属「02存储货架」；冷藏奶油、冷冻面团货架归类「04特殊货架」；原料待检、在途使用「05虚拟货架」。
- 货架货位标准化配置：常规货架统一设置4层6列，货位代码用A/B/C区分；不随意修改层数列数，避免盘点货位混乱。
- 禁止跨仓库挪动货架；禁止删除有库存的货架、货位；需要停用则备注标注停用，保留档案。
- 每个货架绑定专属仓管员，实现货架责任到人，盘点差异可快速定位负责人。
六、常见故障FAQ
Q1：选完仓库，货架列表为空？
A：当前选中仓库还未创建任何货架；点击新增货架，绑定当前仓库即可。
Q2：无法批量创建完善货位？
排查4点：①货架未填写货位代码；②层数/列数填写为1；③未开启编辑模式；④当前账号无货位新增权限。
Q3：货位删除提示绑定物料无法删除？
A：该货位仍有库存商品，需要做库存调拨，把货品移到其他货位，清空库存后再删除。
Q4：货架删不掉？
三种原因：①货架下还有货位，必须先删完货位；②货架曾经存放过商品（SignUsed=），禁止物理删除；③货架被标记专用保护SignSpecial=。建议逻辑删除备注停用，不要强制删库。
Q5：选区域提示「请先指定仓库」？
A：未点击选择仓库，必须先选定仓库，仓库加载完成才能选择库区。