wangjia
24123eb93c
- 新增套餐目录 license_plans.dart（标准/高级 × 月付/年付，与官网 checkout 一致） - license 模型/仓库新增 PurchaseOrder/PurchaseStatusInfo 与下单、查单接口 - 系统设置授权面板：管理员显示「在线购买 / 续费」按钮，弹窗选套餐→ 外部浏览器打开支付宝收银台→3s 轮询到账→自动刷新授权并展示新到期日 - 用户手册（docs.md + user-manual.html）同步补充在线购买入口说明 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01JJ1g8XV1YhhmHRzhwWEW7o
166 lines
9.2 KiB
Markdown
166 lines
9.2 KiB
Markdown
# 岩美酒库 · 使用手册
|
||
|
||
> 适用版本：客户端 v1.1.1 · 受众：酒行店员 / 店长
|
||
|
||
---
|
||
|
||
## 1. 快速上手
|
||
|
||
**注册新门店**：登录页点「注册新门店」，三步开通——①填门店信息（编号自动分配）②创建管理员账号（密码至少 6 位）③激活授权。新门店自带 **30 天免费试用**，有兑换券登录后在「系统设置 → 授权兑换券」输入短码续期。
|
||
|
||
**登录**：输入门店编号、登录账号、密码。「记住我」会自动填入最近登录的门店和账号；账号框带历史下拉，多人共用电脑时点箭头切换。忘记密码请找本店管理员在「用户管理」中重置。
|
||
|
||
**五端支持**：
|
||
|
||
| 平台 | 说明 |
|
||
|------|------|
|
||
| Windows / macOS | 官网下载安装包（macOS 已通过 Apple 公证） |
|
||
| Web 网页版 | 浏览器直接打开，免安装 |
|
||
| Android | 官网下载 APK |
|
||
| iOS | 通过 TestFlight 安装 |
|
||
|
||
同一账号可多端同时登录，数据实时同步。
|
||
|
||
**主题切换**：点右上角的小衣服图标，三套配色随意换——A 经典蓝（浅色·默认）、B 琥珀（深色）、C 酒窖（暖浅色），也可在「系统设置 → 偏好设置」里选。
|
||
|
||
---
|
||
|
||
## 2. 核心概念（必读）
|
||
|
||
**每瓶酒 = 一个独立编号**。系统按「件」记账：入库每录一行，就生成一个新的商品编号和专属二维码标签。字段含义：名称=品牌（茅台）、系列=型号（飞天 53°）、规格=版本（500ml）。库存里同一款酒出现多行是正常的——每行是不同批次的货，各自可追溯。
|
||
|
||
**审核流**：草稿 → 提交 → 待审核 → 审核通过（此刻才增减库存、生成账款）/ 拒绝（什么都不变）。待审核的单可「撤回」退回草稿修改；已审核的单只能走「退单」。
|
||
|
||
**四级角色**：
|
||
|
||
| 角色 | 权限要点 |
|
||
|------|---------|
|
||
| 超级管理员 | 全部操作 |
|
||
| 管理员 | 全部业务 + 用户管理；**可见成本价与利润** |
|
||
| 操作员 | 录单、审核、查询；看不到成本和利润，只能撤回自己的单 |
|
||
| 只读 | 只能查看，所有操作按钮隐藏 |
|
||
|
||
成本与利润由服务器按角色控制，操作员端不下发数字。
|
||
|
||
---
|
||
|
||
## 3. 入库管理
|
||
|
||
顶部四张统计卡：近 30 天笔数 / 金额、待审核单数、草稿单数——后两张**点击即筛选列表**。
|
||
|
||
**新建入库单**：选仓库、供应商、日期 → 明细表格逐行录（一行 = 一件独立编号商品）：名称/系列/规格可搜索、没有的直接新增；生产日期滚轮选择；**批次号必填**；**进价（单瓶）可留空 = 待定价**；**参考售价**会存入商品档案、出库时自动带出；总进价自动合计。键盘：`Enter` 跳格、`⌘D / Ctrl+D` 复制上一行、`⌘Enter / Ctrl+Enter` 提交。
|
||
|
||
**审核**：通过 → 库存增加、生成应付账款；拒绝 → 不变。审核前核对好数量和进价。
|
||
|
||
**退单**（管理员）：已审核单点红色「退单」，逐行退或全部退；库存删除、冲减应付，列表显示「部分退单 / 已退单」徽章。
|
||
|
||
**确认进价**：待定价的单在详情点「确认进价」补真实进价，成本与应付自动回填，售价/应收不受影响。
|
||
|
||
**找单**：搜索框支持单号、供应商、酒名（拼音）；「详细搜索」可按商品编码、批次号、系列、规格、录单人、审核员、状态、日期区间等组合查询。打印带预览，针式打印机版式已优化。
|
||
|
||
---
|
||
|
||
## 4. 出库管理
|
||
|
||
**新建出库单**：选仓库、客户、日期 → 「添加商品」从库存选货（按编码/名称/系列搜索，分页加载）。选中后**数量自动填可用数量、售价自动带入库时的参考售价**。管理员可见每行实时利润 =（售价 − 进价）× 数量，底栏显示合计金额与合计利润。
|
||
|
||
**待定价出库**：售价可留空先发货，事后在详情点「确认售价」补填，自动补应收。
|
||
|
||
**详情**：管理员见成本价 / 售价 / 总售价 / 利润列；操作员只见售价和小计。
|
||
|
||
**审核**：出库数量不能超过库存，不足会拦下。通过后扣减库存、生成应收账款。
|
||
|
||
**退单**：客户退货点「退单」，商品加回库存、按售价冲减应收。可打印单据（带预览）和带二维码的商品标签。
|
||
|
||
---
|
||
|
||
## 5. 库存管理
|
||
|
||
库存按**批次维度**展示，同款酒不同批次分行。搜索支持商品名（汉字/全拼/首字母）和编码；「显示字段」可自定义列且会被记住。
|
||
|
||
主要列：商品/系列/规格/批次号、库存、成本价与总价（=库存×成本，仅管理员）、生产日期、入库日期、供应商、状态（在售/预警/缺货，「缺货预警」卡点击即筛选）。
|
||
|
||
**商品编辑抽屉**：点击库存行打开——上传商品图片（双击全屏预览、可缩放翻页）、从介绍库选择商品介绍、查看成本价（单瓶）/总成本价。
|
||
|
||
**盘点**：库存盘点页选仓库（账面自动加载）→ 选全盘/循环盘点 → 填实盘数量 → 提交。
|
||
|
||
**标签与扫码分享**：每件商品唯一二维码，标签含品名、编码、批次、生产日期、店名和二维码；扫码打开商品详情公开页，链接可直接分享给顾客与同行。
|
||
|
||
---
|
||
|
||
## 6. 财务管理
|
||
|
||
页面自上而下：时间范围筛选 → KPI 四卡（本月销售、本月采购、应收、应付，带未结清笔数）→ 收支趋势图 → 应收/应付按往来单位汇总（点击行看该单位流水和近期单据）→ 收支流水表（按收款/付款/应收/应付筛选）。
|
||
|
||
账款来源：入库审核通过自动生成**应付**，出库审核通过自动生成**应收**。「登记收支」可手动记一笔收付款（类型 + 往来单位 + 金额 + 日期 + 备注）。
|
||
|
||
**结清**：流水行单笔结清，或在往来单位抽屉整体处理；入库/出库列表也有结清入口。结清不可撤销，操作前确认款项已到。
|
||
|
||
---
|
||
|
||
## 7. 往来单位
|
||
|
||
供应商和客户统一管理，录单时的供应商/客户下拉来源于此。列表含名称、类型徽章、联系人、电话、**应收、应付**，类型 chips 一键筛选，搜索支持拼音。
|
||
|
||
新建/编辑：名称必填；**期初余额**用于把老账本上的旧欠款带进系统。点击任意行打开详情抽屉：联系信息、应收应付余额、近期单据（含入库应付、出库应收、收付款），可打对账单。已关联单据的单位不可删除。
|
||
|
||
---
|
||
|
||
## 8. 基础数据
|
||
|
||
五个标签页：
|
||
|
||
| 标签 | 内容 |
|
||
|------|------|
|
||
| 商品档案 | 全店商品编号档案，由入库单自动建立（无手动新增），只查看和编辑 |
|
||
| 商品介绍 | 介绍库，供库存页商品编辑抽屉「从介绍库选择」 |
|
||
| 系列 | 型号/产品线字典 |
|
||
| 规格 | 版本/包装字典 |
|
||
| 仓库 | 仓库维护（默认仓库在「偏好设置」里选） |
|
||
|
||
字典维护直接影响录单下拉候选；录单时输入新名字选「新增」也会自动进字典，这里主要做事后整理。
|
||
|
||
---
|
||
|
||
## 9. 设备与设置
|
||
|
||
**设备管理**：登录设备（本店所有在线会话，管理员可「强制下线」）、外设登记（打印机、扫码枪存档）、打印模板。
|
||
|
||
**系统设置**五个面板：
|
||
|
||
| 面板 | 说明 |
|
||
|------|------|
|
||
| 门店信息 | 店名/地址/电话/负责人，管理员可编辑，编号不可改 |
|
||
| 用户管理 | 新增/编辑/重置密码/启停用户，仅管理员 |
|
||
| 编号规则 | 单号前缀与序号；序号切勿调小，会撞号 |
|
||
| 授权兑换券 | 输入 `JIUKU-XXXX-XXXX` 短码兑换续期，时长叠加；新店 30 天试用；管理员也可点「在线购买 / 续费」直接支付宝购买，到账自动续期 |
|
||
| 偏好设置 | 主题切换 + 默认仓库 |
|
||
|
||
授权过期：7 天内宽限照常用，7–15 天只读，满 15 天锁定；兑换新券立即恢复，数据不丢。
|
||
|
||
「关于我们」页可查版本更新、授权状态、更新日志，并提交反馈。
|
||
|
||
---
|
||
|
||
## 10. 常见问题
|
||
|
||
**忘记密码？** 找管理员在「用户管理」重置；管理员本人忘记请联系技术支持。
|
||
|
||
**单据录错了？** 待审核 → 「撤回」回草稿修改；已审核 → 「退单」退掉错的行再补单。
|
||
|
||
**库存对不上？** 记下商品编码，到入库/出库「详细搜索」按编码查所有相关单据核对，再做一次盘点调平。
|
||
|
||
**同款酒库存好多行？** 设计如此：按件记账，每行是一个独立编号/批次，各自可追溯。
|
||
|
||
**打印没反应/发糊？** 先升级到最新版；用「打印预览」确认；针打版式已做纯黑加粗优化。
|
||
|
||
**扫码打不开商品页？** 早期版本的扫码报错已修复；确认手机联网，很旧的标签可重打。
|
||
|
||
**授权到期变只读？** 「系统设置 → 授权兑换券」输入 JIUKU 兑换码，或管理员点「在线购买 / 续费」支付宝支付，到账立即恢复；过期 15 天内数据都在。
|
||
|
||
**进价/售价还没谈好？** 价格留空即「待定价」，事后在单据详情「确认进价 / 确认售价」补填，账自动补齐。
|
||
|
||
**出库提示库存不足？** 数量超过在库数，检查是否录多，或进货入库单还没审核（未审核不算库存）。
|
||
|
||
**员工离职/电脑丢失？** 「设备管理」强制下线该设备 + 「用户管理」停用账号或重置密码。
|