Files

T

wangjia b856f5fec8 docs: 用户/开发手册 HTML 版、db-schema 补 license_purchases、CLAUDE.md 文档地图、pay 对接指南

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o

2026-07-03 20:40:21 +08:00

22 KiB

Raw Permalink Blame History

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

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

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

1. 系统概述

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

核心功能一览

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

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

2. 登录与退出

2.1 登录

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

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

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

2.2 退出登录

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

2.3 查看当前登录信息

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

3. 界面说明

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

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

左侧侧边栏导航项

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

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

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

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

4. 角色与权限

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

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

权限说明

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

5. 入库管理

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

5.1 入库单状态说明

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

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

5.2 新建入库单

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

5.3 提交审核

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

5.4 审批入库单

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

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

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

5.5 查看入库单详情

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

5.6 打印入库单

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

5.7 打印商品标签

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

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

5.8 结清账款

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

5.9 筛选与导出

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

6. 出库管理

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

6.1 出库单状态说明

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

审批通过后：

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

6.2 新建出库单

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

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

6.3 审批出库单

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

6.4 打印出库单

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

6.5 结清账款

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

7. 库存管理

7.1 查询库存

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

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

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

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

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

7.2 修改备注

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

7.3 打印商品标签

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

7.4 库存盘点

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

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

7.5 库存流水

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

8. 财务管理

8.1 财务记录概述

系统自动在以下情况生成财务记录：

入库单审批通过 → 自动生成应付账款（欠供应商的货款）
出库单审批通过 → 自动生成应收账款（客户欠的货款）

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

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

8.2 查看财务记录

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

8.3 结清账款

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

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

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

8.4 财务汇总

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

9. 往来单位

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

9.1 查看往来单位

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

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

9.2 新建往来单位

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

9.3 编辑往来单位

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

9.4 删除往来单位

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

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

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

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

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

10.1 商品名称管理

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

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

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

10.2 系列管理

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

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

10.3 规格管理

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

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

10.4 商品详情与二维码

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

10.5 商品图片上传

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

11. 系统设置

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

11.1 酒行信息

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

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

11.2 用户管理（仅管理员）

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

新增用户：

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

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

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

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

11.3 仓库管理

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

新建仓库：

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

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

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

11.4 编号规则

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

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

修改规则：

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

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

11.5 系统参数

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

基本设置

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

审核设置

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

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

11.6 数据导入

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

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

操作步骤：

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

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

数据清空（仅超级管理员）：

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

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

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 可获得响应。

22 KiB Raw Permalink Blame History Unescape Escape