> 本文档已迁移至 [manual/user-manual.html](manual/user-manual.html)，本文件停止更新。

# 酒库管理系统 — 用户操作手册

> 适用版本：v1.x  
> 受众：酒行管理员、操作员  
> 最后更新：2026-05-23

---

## 目录

1. [系统概述](#1-系统概述)
2. [登录与退出](#2-登录与退出)
3. [界面说明](#3-界面说明)
4. [角色与权限](#4-角色与权限)
5. [入库管理](#5-入库管理)
6. [出库管理](#6-出库管理)
7. [库存管理](#7-库存管理)
8. [财务管理](#8-财务管理)
9. [往来单位](#9-往来单位)
10. [基础数据（商品管理）](#10-基础数据商品管理)
11. [系统设置](#11-系统设置)
12. [常见问题](#12-常见问题)

---

## 1. 系统概述

酒库管理系统是专为酒行门店设计的仓库管理工具，涵盖入库、出库、库存查询、财务往来等日常业务。

**核心功能一览**

| 模块 | 主要用途 |
|------|---------|
| 入库管理 | 新建入库单、提交审核、审批通过后自动更新库存 |
| 出库管理 | 新建出库单、提交审核、审批时自动扣减库存 |
| 库存管理 | 查询实时库存、库存盘点、打印标签 |
| 财务管理 | 查看应付/应收账款、结清账款 |
| 往来单位 | 管理供应商和客户信息 |
| 基础数据 | 维护商品名称、系列、规格字典 |
| 系统设置 | 用户管理、仓库管理、编号规则、数据导入 |

**支持平台**：Windows、macOS、Web、iOS、Android

---

## 2. 登录与退出

### 2.1 登录

1. 打开系统，进入登录页面。
2. 在「门店编号」栏输入酒行的门店代号（如 `S001`）。
3. 输入「用户名」和「密码」。
4. 点击「登录」按钮。

登录成功后，系统自动跳转到「入库管理」页面。

**提示**：系统会记录最近登录过的用户名，点击输入框时可从下拉候选列表中快速选择。

### 2.2 退出登录

点击顶部右侧用户名旁的下拉箭头，选择「退出登录」。

### 2.3 查看当前登录信息

点击顶部左侧「酒库管理系统」标题或顶部右侧「门店编号」区域，弹出门店信息面板，显示门店编号、登录账号、姓名、系统版本。

---

## 3. 界面说明

系统主界面由三个区域组成：

```
┌──────────────────────────────────────────────────────────┐
│  顶部导航栏（标题、门店编号、用户名、退出）              │
├──────────┬───────────────────────────────────────────────┤
│          │                                               │
│  左侧    │           主内容区域                         │
│  侧边栏  │                                               │
│          │                                               │
├──────────┴───────────────────────────────────────────────┤
│  状态栏（门店、用户、登录时间、当前时间、连接状态）       │
└──────────────────────────────────────────────────────────┘
```

**左侧侧边栏导航项**

| 导航项 | 功能 |
|--------|------|
| 入库管理 | 入库单录入与审核 |
| 出库管理 | 出库单录入与审核 |
| 库存管理 | 库存查询与盘点 |
| 财务管理 | 应付/应收账款 |
| 往来单位 | 供应商与客户 |
| 基础数据 | 商品名称/系列/规格字典 |
| 系统设置 | 用户、仓库、编号规则等配置 |

点击侧边栏顶部的菜单图标可收起/展开侧边栏，节省屏幕空间。

**更新提示**：当有新版本时，内容区顶部会显示黄色提示横幅；如为强制更新，会弹出对话框要求立即更新。

**离线提示**：网络断开时，顶部显示红色横幅「网络连接已断开」，状态栏变红，此时展示离线缓存数据。

---

## 4. 角色与权限

系统有四个角色，权限从高到低依次为：

| 角色 | 说明 | 可执行操作 |
|------|------|------------|
| 超级管理员（superadmin） | 系统最高权限账号 | 全部操作，额外可执行数据清空 |
| 管理员（admin） | 门店管理人员 | 全部操作，含用户管理、酒行信息编辑 |
| 操作员（operator） | 日常录入审核人员 | 新建/编辑/提交/审核单据，查询数据 |
| 只读（readonly） | 仅查看数据 | 只能查看，不能新建、修改、删除任何数据 |

**权限说明**

- 只读用户点击任何写操作按钮时，系统将直接返回「无权限」提示。
- 用户管理（新增/编辑/重置密码）仅管理员可操作。
- 编辑酒行基本信息仅管理员可操作。
- 数据清空仅超级管理员可操作。

---

## 5. 入库管理

入库管理页面包含两个标签页：**入库审核**（新建和待审核）和**入库单**（已完成记录）。

### 5.1 入库单状态说明

```
新建 → 草稿 → 提交审核 → 待审核 → 审核通过 → 已审批
                                   ↓
                                 审核拒绝 → 已拒绝
```

| 状态 | 含义 |
|------|------|
| 草稿 | 已保存但未提交，可继续编辑或删除 |
| 待审核 | 已提交等待审批，不可再编辑 |
| 已审批 | 审批通过，库存已增加，同时生成应付账款记录 |
| 已拒绝 | 审批不通过，库存不变 |

### 5.2 新建入库单

1. 点击左侧「入库管理」，切换到「入库审核」标签页。
2. 点击右上角「新建入库审核单」按钮。
3. 填写入库信息：
   - **仓库**（必填）：选择货物入库的目标仓库。
   - **供应商**（必填）：选择供货的往来单位。
   - **入库日期**（必填）：默认为今天，可修改。
   - **备注**（选填）：填写本批次入库说明。
4. 在商品明细区域填写每一行商品：
   - **商品名称**（必填）：从字典中选择或输入。
   - **系列**（必填）：选择商品系列。
   - **规格**（必填）：选择商品规格（如 500ml×6）。
   - **生产日期**（必填）：点击日历图标选择。
   - **批次号**（选填）：填写批次编号，用于后续追踪。
   - **数量**（必填）：填写入库数量。
   - **单价**（必填）：填写进货单价，系统自动计算金额。
5. 点击「添加商品」可继续增加商品行，点击行末「删除」可移除该行。
6. 完成后有两种操作：
   - **保存草稿**：保存后可以继续修改。
   - **保存并提交审核**：提交后进入待审核状态，不可再编辑。

### 5.3 提交审核

草稿状态的入库单，在列表中点击「提交」按钮，确认后单据进入「待审核」状态。

### 5.4 审批入库单

具有操作员及以上权限的用户均可审批。

1. 在「入库审核」标签页中找到待审核的入库单。
2. 点击「通过」：弹窗确认，确认后系统自动将商品入库，库存增加，同时生成一笔应付账款记录。
3. 点击「拒绝」：弹窗确认，拒绝后库存不变，单据进入「已拒绝」状态。

**注意**：审批通过后操作不可撤销，请核对商品数量和单价后再确认。

### 5.5 查看入库单详情

点击入库单号（蓝色下划线链接）可弹出详情页，显示完整的商品明细、数量、金额及审核信息。详情弹窗右上角有打印按钮，可直接打印入库单。

### 5.6 打印入库单

在列表中点击对应行的「打印」按钮，直接调用打印机打印入库单据。

### 5.7 打印商品标签

1. 在列表中点击对应行的「打标签」按钮。
2. 弹出商品标签打印对话框，列出本次入库的所有商品。
3. 勾选需要打印标签的商品（默认全选）。
4. 点击「打印选中」，系统逐张打印选中商品的标签。

标签内容包括：商品名称、编码、系列、规格、批次号、生产日期、酒行名称/地址/电话及二维码。

### 5.8 结清账款

审批通过的入库单会自动生成应付账款记录。当货款结清后，在列表中点击「结清」按钮，确认后将对应财务记录标记为已结清。

### 5.9 筛选与导出

- **仓库筛选**：点击列头「仓库」的筛选图标，选择仓库进行过滤。
- **供应商筛选**：点击列头「供应商」的筛选图标，选择供应商进行过滤。
- **日期筛选**：点击「选择日期」按钮，选择日期范围。
- **状态筛选**：在入库单标签页中通过状态下拉框筛选。
- **导出**：点击「导出」按钮，将当前列表导出为 Excel 文件。

---

## 6. 出库管理

出库管理与入库管理操作流程类似，包含**出库审核**（待处理）和**出库单**（已完成）两个标签页。

### 6.1 出库单状态说明

出库单与入库单状态流转相同：草稿 → 待审核 → 已审批/已拒绝。

审批通过后：
- 系统校验库存是否充足，库存不足时审批失败并提示错误，库存不变。
- 库存充足时自动扣减库存，并生成应收账款记录。

### 6.2 新建出库单

1. 点击左侧「出库管理」，切换到「出库审核」标签页。
2. 点击右上角「新建出库审核单」按钮。
3. 填写基本信息：
   - **仓库**（必填）：选择出货仓库。
   - **客户**（必填）：选择购买方（往来单位中的客户类型）。
   - **出库日期**（必填）：默认今天，可修改。
4. 填写商品明细：商品名称、系列、规格、数量、单价（操作方式同入库单）。
5. 保存草稿或保存并提交审核。

**注意**：出库数量不能超过当前库存。审核时系统会自动校验，库存不足会提示失败。

### 6.3 审批出库单

操作步骤与入库审批相同。审批通过后库存自动扣减，同时生成应收账款记录。

### 6.4 打印出库单

在列表中点击「打印」按钮，打印出库单据。

### 6.5 结清账款

出库单审批通过后生成应收账款。收到货款后，在列表中点击「结清」按钮，将对应财务记录标记为已结清。

---

## 7. 库存管理

### 7.1 查询库存

点击左侧「库存管理」进入库存列表。

列表显示每个商品的实时库存数量、所在仓库、单价、金额、生产日期、批次等信息。

**搜索**：在搜索框输入商品名称关键字，实时过滤结果。

**仓库筛选**：点击列头「仓库」的筛选图标，按仓库查看库存。

**导出**：点击「导出」按钮，将当前库存列表导出为 Excel 文件。

### 7.2 修改备注

在库存列表中，点击「备注」列对应单元格（显示铅笔图标或现有备注内容），弹出编辑框，填写后点击「保存」即可直接修改。

### 7.3 打印商品标签

在库存列表中点击某商品行的「打印标签」按钮，可单独打印该商品的标签。

### 7.4 库存盘点

1. 在库存管理页面，切换到「库存盘点」标签页，或通过左侧导航进入 `/inventory/check`。
2. 选择要盘点的**仓库**，系统自动加载该仓库所有商品的账面库存数量。
3. 选择盘点类型（全盘）。
4. 逐行填写**实际盘点数量**（与账面不符时修改）。
5. 点击「提交盘点」完成。

盘点单编号由系统自动生成，格式为 `PD{日期}{仓库编号}`。

### 7.5 库存流水

库存列表页的「库存流水」标签页（如已开放）可查看每次库存变动记录，包括入库/出库时间、变动数量等。

---

## 8. 财务管理

### 8.1 财务记录概述

系统自动在以下情况生成财务记录：
- 入库单审批通过 → 自动生成**应付账款**（欠供应商的货款）
- 出库单审批通过 → 自动生成**应收账款**（客户欠的货款）

点击左侧「财务管理」进入财务页面，包含三个标签：

| 标签 | 内容 |
|------|------|
| 全部记录 | 所有财务流水 |
| 应付账款 | 需要向供应商付款的记录 |
| 应收账款 | 客户尚未付款的记录 |

### 8.2 查看财务记录

- 默认显示当前月份的记录。
- 可通过月份选择器切换查看历史月份。
- 支持按「类型」和「往来单位」列头筛选。
- 点击「导出」可导出当月数据。

### 8.3 结清账款

**方式一**：在入库单/出库单列表中点击「结清」按钮，直接结清该单据对应的账款。

**方式二**：在财务管理列表中，找到对应记录，点击「结清」按钮，单笔结清。

结清后该记录状态从「未结清」变为「已结清」。

### 8.4 财务汇总

财务管理页面底部（或汇总标签）显示当期应付/应收总额，便于掌握资金往来概况。

---

## 9. 往来单位

往来单位管理供应商和客户两类数据，在新建入库单/出库单时可从此处维护的名称中选择。

### 9.1 查看往来单位

点击左侧「往来单位」，通过「供应商」和「客户」标签页分别查看。

列表支持搜索（按名称关键字过滤）和导出。

### 9.2 新建往来单位

1. 在对应标签页点击右上角「新建」按钮。
2. 填写信息：
   - **名称**（必填）
   - **联系电话**（选填）
   - **地址**（选填）
   - **卡号**（选填，如有账户绑定）
   - **初始余额**（选填，导入历史数据时使用）
   - **备注**（选填）
3. 点击「保存」。

### 9.3 编辑往来单位

在列表中点击「编辑」按钮，修改信息后保存。

### 9.4 删除往来单位

在列表中点击「删除」按钮，确认后删除。

**注意**：已关联入库单/出库单的往来单位不可删除。

---

## 10. 基础数据（商品管理）

点击左侧「基础数据」，进入商品字典管理页面，包含三个标签：**商品名称**、**系列**、**规格**。

这些字典数据是新建入库/出库单时选择商品的基础，需要先在此处维护。

### 10.1 商品名称管理

**商品名称**是酒品的主名称，如「茅台飞天 53°」。

1. 在「商品名称」标签页，点击「新建」按钮。
2. 填写商品名称（必填）、编号（选填）、备注（选填）。
3. 点击「保存」。

支持按名称或编号搜索，支持分页浏览，支持编辑和删除。

### 10.2 系列管理

**系列**是商品所属的系列或品牌线，如「飞天系列」「王子系列」。

操作步骤与商品名称相同。

### 10.3 规格管理

**规格**用于描述包装规格，如「500ml×6」「1000ml×1」。

规格还可以设置「单品数量」（即一箱/件包含的单品数量），新建时填写此字段。

### 10.4 商品详情与二维码

点击「商品管理」（如有商品列表页）进入商品详情，可查看商品图片、二维码。每个商品都有唯一的二维码，可通过扫码访问商品公开信息页面。

### 10.5 商品图片上传

在商品详情页，点击「上传图片」可为商品添加图片。

---

## 11. 系统设置

点击左侧「系统设置」，包含七个标签页。

### 11.1 酒行信息

显示本门店的基本信息：门店编号、门店名称、地址、联系电话、负责人。

**编辑**（仅管理员）：点击「编辑信息」按钮，修改门店名称、地址、电话、负责人后保存。门店编号不可修改。

### 11.2 用户管理（仅管理员）

**查看用户列表**：显示本门店所有用户的姓名、用户名、角色、启用状态。

**新增用户**：
1. 点击「新增用户」按钮。
2. 填写用户名（登录账号，不可重复）、姓名、手机号、初始密码。
3. 选择角色（操作员/管理员/只读/超级管理员）。
4. 点击「保存」。

**编辑用户**：点击用户行的「编辑」按钮，可修改姓名、手机号、角色（用户名不可修改）。

**重置密码**：点击「重置密码」按钮，输入新密码后确认，下次登录时使用新密码。

**启用/停用**：在用户列表中直接拨动状态开关，停用后该用户无法登录。

### 11.3 仓库管理

**查看仓库列表**：显示所有仓库名称、位置、是否默认仓库。

**新建仓库**：
1. 点击「新建」按钮。
2. 填写仓库名称（必填）、位置（选填）。
3. 可勾选「设为默认仓库」，新建入库/出库单时将自动选择此仓库。
4. 点击「保存」。

**编辑仓库**：点击「编辑」修改仓库信息。

**删除仓库**：点击「删除」，确认后删除。已有库存的仓库不可删除。

### 11.4 编号规则

系统为每类单据自动生成唯一编号，格式为：`{前缀}{日期}{6位序号}`，例如 `RK202605230000001`。

**查看当前规则**：列表显示每种单据类型的前缀、日期格式、当前序号及下一编号示例。

**修改规则**：
1. 点击对应规则行的「编辑」按钮。
2. 可修改「前缀」和「当前序号」。
3. 点击「保存」，修改后对新建单据生效。

**注意**：修改当前序号有风险，请勿将序号调小至已使用的范围，否则可能导致单号重复。

### 11.5 系统参数

配置系统的基本参数，目前包含：

**基本设置**
- 系统名称
- 货币单位（默认：人民币 CNY）
- 日期格式（默认：YYYY-MM-DD）
- 时区（默认：Asia/Shanghai UTC+8）

**审核设置**
- 入库单需要审核（开关）
- 出库单需要审核（开关）
- 允许超量出库（开关）

修改后点击「保存设置」生效，点击「重置默认」恢复出厂值。

### 11.6 数据导入

通过 Excel 文件批量导入历史数据。支持以下数据类型：

| 数据类型 | Excel 格式说明 |
|---------|--------------|
| 往来单位 | 编号 \| 类型 \| 状态 \| 名称 \| 电话 \| 卡号 \| 初始金额 \| 单位 \| 地址 \| 备注 |
| 商品名称 | 选项编号 \| 选项名称 \| 备注 |
| 商品系列 | 选项编号 \| 选项名称 \| 备注 |
| 商品规格 | 选项编号 \| 选项名称 \| 单品数量 \| 备注 |
| 商品编码 | 商品编码：xxxx |
| 库存 | 商品编号 \| 商品名称 \| 系列 \| 规格 \| 单位 \| 库存数量 \| 单价 \| 金额 \| 生产日期 \| 批次 \| 分类 \| 所在仓库 \| 入库日期 \| 供应商 \| 上次盘点 \| 备注 |

**操作步骤**：
1. 在对应数据类型行点击「选择文件」，选择 Excel（.xls/.xlsx）文件。
2. 全部文件选择完成后，点击「全部导入」按钮。
3. 系统依次处理每个文件，显示「共 N 条，新增 N 条，重复跳过 N 条」的导入结果。
4. 如有失败，在对应行显示错误信息，请根据提示修正文件后重新导入。

**导入规则**：以名称去重，已存在的记录不重复导入，导入过程中请勿切换页面。

**数据清空（仅超级管理员）**：
1. 在数据导入页面下方「危险操作」区域，勾选需要清空的数据表（入库单、出库单、库存管理、商品详情、往来单位）。
2. 点击「清空选中数据」。
3. 在确认弹窗中输入「确认清空」后，点击确认。

**警告：数据清空操作不可撤销，请务必提前备份数据。**

### 11.7 关于

**版本信息**：显示当前系统版本，以及最新版本（若有更新可点击「立即更新」下载）。

**授权信息**：显示当前授权类型（试用/月付/年付/买断）、授权状态、到期时间。授权即将到期时（剩余 30 天内）会显示倒计时提醒。点击「续费/升级授权」查看联系方式。

**关于我们**：开发商信息、官网、技术支持联系方式。

**意见反馈**：点击「反馈 Bug」或「功能建议」，通过邮件向开发团队反馈。

---

## 12. 常见问题

**Q：入库单提交后发现填错了，怎么办？**  
A：单据提交（待审核状态）后不可修改。请联系管理员将该单据拒绝，然后重新新建一张正确的入库单。

**Q：出库审核时提示「库存不足」，怎么处理？**  
A：出库数量超过当前仓库库存时，系统会拒绝审批并提示错误。请检查出库数量，或先确认是否有对应入库单已审批通过、库存已更新。

**Q：结清了财务记录但发现结清错了，如何撤销？**  
A：目前系统不支持撤销结清操作，请联系管理员或技术支持处理。

**Q：如何知道某批商品是从哪个入库单入库的？**  
A：在库存管理列表中查看商品的批次号，然后在入库管理中按批次号搜索对应入库单。

**Q：导入数据时提示「格式错误」，怎么处理？**  
A：请检查 Excel 文件列顺序是否与「系统设置 → 数据导入」页面说明的格式一致，且第一行为数据行（无需表头行）。如问题持续，可将文件发送给技术支持排查。

**Q：用户无法登录，怎么处理？**  
A：请管理员在「系统设置 → 用户管理」中检查该用户是否处于启用状态，并使用「重置密码」为其设置新密码。

**Q：操作时提示「无权限」，是什么原因？**  
A：当前账号角色为「只读」，不允许执行写操作。如需执行操作，请联系管理员调整账号角色。

**Q：系统显示「网络连接已断开」，数据还可靠吗？**  
A：网络断开时，系统展示的是上次加载的缓存数据，可能不是最新状态。请恢复网络连接后刷新页面获取最新数据。

**Q：如何联系技术支持？**  
A：进入「系统设置 → 关于」，查看联系邮箱和技术支持时间。工作日（周一至周五）9:00 - 18:00 可获得响应。