jiu/web/content/docs.md

# 岩美酒库管理系统 · 使用手册

> 适用版本：v1.x · 受众：酒行管理员及工作人员

---

## 1. 系统概述

岩美酒库管理系统专为酒行门店设计，将入库、出库、库存查询、财务往来等日常业务整合到一个平台，支持多人协同操作，数据实时同步。

**核心功能一览**

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

**支持平台**：Web 浏览器（现已上线）；Windows、macOS、iOS、Android 客户端即将推出。

---

## 2. 登录与退出

### 2.1 登录

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

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

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

### 2.2 退出登录

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

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

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

---

## 3. 界面说明

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

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

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

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

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

**更新提示**：有新版本时，内容区顶部会显示黄色提示横幅；如果是必须更新的版本，会弹出对话框要求立即更新。

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

---

## 4. 角色与权限

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

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

**权限说明**

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

---

## 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. 在库存管理页面切换到「库存盘点」标签页。
2. 选择要盘点的**仓库**，系统自动加载该仓库所有商品的账面库存数量。
3. 选择盘点类型（全盘）。
4. 逐行填写**实际盘点数量**（与账面不符时修改数量）。
5. 点击「提交盘点」完成。

盘点单编号由系统自动生成。

### 7.5 库存流水

「库存流水」标签页可查看每次库存变动记录，包括入库、出库的时间、变动数量等。

---

## 8. 财务管理

### 8.1 财务记录说明

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

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

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

### 8.2 查看财务记录

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

### 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 商品详情与二维码

每个商品都有唯一的二维码，可通过扫码访问商品公开信息页面。在商品详情页可查看或上传商品图片。

---

## 11. 系统设置

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

### 11.1 酒行信息

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

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

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

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

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

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

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

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

### 11.3 仓库管理

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

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

**编辑或删除**：点击对应按钮操作。已有库存的仓库不可删除。

### 11.4 编号规则

系统为每类单据自动生成唯一编号，格式由前缀、日期和序号组成，例如入库单编号 `RK20260523001`。

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

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

**注意**：请勿将序号调小至已使用过的范围，否则可能导致编号重复。

### 11.5 系统参数

配置系统的全局参数：

- **系统名称、货币单位、日期格式、时区**（通常无需修改）
- **入库单需要审核**：关闭后提交即视为通过，无需审批
- **出库单需要审核**：关闭后同上
- **允许超量出库**：开启后，出库数量超过库存时仍可审批通过

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

### 11.6 数据导入

通过 Excel 文件批量导入历史数据。支持以下数据类型：往来单位、商品名称、商品系列、商品规格、商品编码、库存。

各类型的 Excel 格式要求详见系统内「系统设置 → 数据导入」页面说明。

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

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

**数据清空（仅超级管理员）**：在数据导入页面下方「危险操作」区域，选择要清空的数据表，点击确认后输入「确认清空」完成操作。**此操作不可撤销，请务必提前做好数据备份。**

### 11.7 关于

- **版本信息**：显示当前系统版本。有新版本时可点击「立即更新」。
- **授权信息**：显示授权类型（试用、月付、年付、买断）、授权状态、到期时间。授权剩余不足 30 天时会显示倒计时提醒。
- **意见反馈**：点击「反馈 Bug」或「功能建议」，通过邮件向开发团队反馈。

---

## 12. 常见问题

**Q：入库单提交后发现填错了，怎么办？**

单据提交（待审核状态）后不可再修改。请联系管理员将该单据拒绝，然后重新新建一张正确的入库单。

**Q：出库审批时提示「库存不足」，怎么处理？**

出库数量超过当前仓库库存时，系统会拒绝审批。请检查出库数量，或确认对应商品的入库单是否已审批通过、库存已更新。

**Q：结清了财务记录但发现结清错了，如何撤销？**

目前系统不支持撤销结清操作。如需处理，请联系技术支持。

**Q：如何查找某批商品是从哪张入库单入库的？**

在库存管理列表中查看商品的批次号，然后在入库管理中按批次号搜索对应的入库单。

**Q：导入数据时提示「格式错误」，怎么处理？**

请检查 Excel 文件的列顺序是否与「系统设置 → 数据导入」页面说明的格式一致，且第一行为数据行（无需填写表头）。如问题持续，可将文件发送给技术支持排查。

**Q：用户无法登录，怎么处理？**

请管理员在「系统设置 → 用户管理」中检查该用户是否处于启用状态，并使用「重置密码」功能为其设置新密码。

**Q：操作时提示「无权限」，是什么原因？**

当前账号角色为「只读」，不允许执行写操作。如需操作，请联系管理员调整账号角色。

**Q：系统显示「网络连接已断开」，数据还准确吗？**

网络断开时，系统展示上次加载的缓存数据，可能不是最新状态。请恢复网络连接后刷新页面获取最新数据。

**Q：如何联系技术支持？**

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