使用手册
系统介绍
岩美酒库管理系统是专为酒行、酒店 F&B 部门设计的一体化库存管理平台。系统涵盖入库、出库、库存盘点、财务对账、往来单位管理以及商品防伪溯源等核心功能。
系统采用多租户架构，每个门店（shop）的数据完全隔离，支持 Web 端与桌面端（macOS / Windows）同时使用。
提示：如果是初次使用，请让管理员先创建您的账号，然后使用门店编号 + 用户名 + 密码登录。
登录与权限
登录方式
在登录页输入：
- 门店编号（由管理员提供，如
S001） - 用户名
- 密码
登录成功后，系统会保存 Token，关闭浏览器后再次打开无需重新登录（Token 有效期 7 天）。
角色说明
| 角色 | 权限范围 |
|---|---|
| 管理员 (admin) | 所有功能，包括用户管理、审批、系统设置 |
| 普通用户 (user) | 创建/编辑单据，无法审批，无系统设置权限 |
| 只读用户 (readonly) | 仅查看，不可创建或修改任何数据 |
注意：只读用户尝试任何写操作时，系统将返回 403 拒绝提示。
入库管理
创建入库单
- 点击左侧「入库管理」，然后点击「新建入库单」
- 选择仓库、供应商（往来单位），填写入库日期
- 逐行添加商品，填写数量、单价、批次号、生产日期
- 保存为「草稿」或直接「提交审核」
审批入库
状态为「待审核」的入库单，管理员可在列表中点击「审核通过」。审核通过后库存自动增加，且操作不可逆。
出库管理
出库流程与入库类似：创建出库单 → 选择仓库和商品 → 提交审核 → 管理员审批。
系统在审批出库时会自动校验库存充足性，如果库存不足，审批将失败并给出提示。
| 出库类型 | 说明 |
|---|---|
| 销售 | 对外销售，关联往来单位（客户） |
| 领用 | 内部消耗，无对外客户 |
| 损耗 | 破损/过期等非正常消耗 |
库存管理
库存列表按批次展示，每次入库产生一条库存记录。支持按商品名称、仓库、供应商筛选，并可导出 Excel。
批次追溯
每条库存记录保留了入库批次号、生产日期、供应商等信息，可完整追溯商品来源。
财务管理
财务模块记录与入库/出库单据关联的应收应付账款。支持按往来单位、日期区间、状态（已收/待收）筛选，并可导出汇总报表。
基础数据
基础数据包含：
- 商品管理：SKU 信息、规格、品牌、系列、单位，以及商品图片上传
- 仓库管理：门店下可配置多个仓库
- 往来单位：供应商与客户统一管理
- 编号规则：自定义入库单/出库单号前缀和格式
防伪溯源
为每件商品生成唯一防伪码（public_id），打印贴附于商品。消费者扫描二维码后跳转至 jiu.51yanmei.com/scan/<id>，可查看：
- 商品基本信息（名称、品牌、规格）
- 批次信息（生产日期、批次号、入库日期）
- 出售门店信息
- 岩美防伪验证标记
系统设置
系统设置仅管理员可见，包括：
- 用户管理：创建/删除用户，重置密码，调整角色
- 门店信息：更新门店名称、地址、电话等公开信息
- 数据导入：批量导入商品、历史库存数据（Excel 格式）