455 lines
16 KiB
Markdown
455 lines
16 KiB
Markdown
# 图书进销存系统 — 使用文档
|
||
|
||
> **系统名称**：Cards（图书进销存管理后台）
|
||
> **适用对象**：系统管理员、运营人员、仓库人员
|
||
> **最后更新**：2026-06-03
|
||
|
||
---
|
||
|
||
## 目录
|
||
|
||
1. [系统概述](#1-系统概述)
|
||
2. [登录与首页](#2-登录与首页)
|
||
3. [导航与布局](#3-导航与布局)
|
||
4. [代理管理（管理员）](#4-代理管理管理员)
|
||
5. [仓库与基础数据管理](#5-仓库与基础数据管理)
|
||
6. [波次管理（核心工作流）](#6-波次管理核心工作流)
|
||
7. [采购与销售](#7-采购与销售)
|
||
8. [出库与发货](#8-出库与发货)
|
||
9. [库存管理](#9-库存管理)
|
||
10. [商品与店铺管理](#10-商品与店铺管理)
|
||
11. [系统配置](#11-系统配置)
|
||
12. [常见操作指引](#12-常见操作指引)
|
||
13. [附：菜单速查表](#13-附菜单速查表)
|
||
|
||
---
|
||
|
||
## 1. 系统概述
|
||
|
||
图书进销存系统是一个面向图书行业的全流程管理客户，覆盖从图书**采购入库 → 库存管理 → 商品发布 → 销售出库 → 发货打单 → 盘库盘点**的完整业务链条。
|
||
|
||
系统主要服务两类角色：
|
||
|
||
| 角色 | 可访问的功能 |
|
||
|------|-------------|
|
||
| **管理员**（role=255） | 全部功能，包括代理管理、异常书目审核、核价器配置等 |
|
||
| **普通用户/代理**（role=128） | 仪表盘、波次管理、仓库管理、采购销售、库存等基础业务 |
|
||
|
||
---
|
||
|
||
## 2. 登录与首页
|
||
|
||
### 2.1 登录
|
||
|
||
1. 在浏览器中访问系统地址（开发环境：`http://localhost:5174`）
|
||
2. 输入**用户名**和**密码**
|
||
3. 选择登录身份：
|
||
- **管理员登录** — 管理员账号，拥有全部权限
|
||
- **代理登录** — 代理账号，权限受限
|
||
4. 点击「登录」按钮进入系统
|
||
|
||
> **提示**：登录信息保存在浏览器中，关闭页面后重新打开无需重复登录。如忘记密码，请联系系统管理员重置。
|
||
|
||
### 2.2 首页（仪表盘）
|
||
|
||
登录后默认进入**仪表盘**页面，展示今日运营概况：
|
||
|
||
| 统计卡片 | 说明 |
|
||
|---------|------|
|
||
| **今日入库** | 今日采购入库数量（件） |
|
||
| **今日出库** | 今日出库单数量 |
|
||
| **今日销售** | 今日销售订单数量 |
|
||
|
||
页面下方两个列表：
|
||
|
||
- **今日最新商品** — 今日新录入的商品列表（名称、条码、价格、创建时间）
|
||
- **今日员工统计** — 各员工今日的入库/出库工作量统计
|
||
|
||
---
|
||
|
||
## 3. 导航与布局
|
||
|
||
### 3.1 界面结构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ 进销存系统 [折叠按钮] 用户名 ▼ 积分 │ ← 顶部栏
|
||
├──────────┬──────────────────────────────────┤
|
||
│ │ │
|
||
│ 仪表盘 │ │
|
||
│ 代理管理 │ 主内容区域 │
|
||
│ ├ 代理列表│ (router-view) │
|
||
│ ├ 添加代理│ │
|
||
│ └ 账户类型│ │
|
||
│ 供应商管理│ │
|
||
│ 仓库管理 │ │
|
||
│ ├ 仓库列表│ │
|
||
│ ├ 小车管理│ │
|
||
│ ├ 店铺管理│ │
|
||
│ ├ 打印机 │ │
|
||
│ └ PDA管理│ │
|
||
│ 波次管理 │ │
|
||
│ 采购/商品 │ │
|
||
│ 销售/出库 │ │
|
||
│ 库存/盘库 │ │
|
||
│ ... │ │
|
||
└──────────┴──────────────────────────────────┘
|
||
```
|
||
|
||
### 3.2 操作入口
|
||
|
||
- **左侧菜单** — 按功能模块分组，点击菜单项进入对应页面
|
||
- **折叠按钮** — 顶部栏左侧汉堡图标，可收起/展开左侧菜单（窄屏时有用）
|
||
- **用户菜单** — 顶部栏右侧显示当前用户名，点击可退出登录
|
||
- **积分显示** — 代理用户的当前积分显示在顶部栏右侧
|
||
|
||
### 3.3 嵌入模式
|
||
|
||
系统支持通过 URL 参数嵌入到其他系统：
|
||
|
||
```
|
||
http://host:port/path?token=xxx
|
||
```
|
||
|
||
嵌入模式下会自动隐藏左侧导航栏和顶部栏，仅显示内容区域。
|
||
|
||
---
|
||
|
||
## 4. 代理管理（管理员）
|
||
|
||
代理管理仅**管理员**（role=255）可见。
|
||
|
||
### 4.1 代理列表
|
||
|
||
- 展示所有代理账号的列表
|
||
- 支持搜索关键词（工号/姓名/账号）
|
||
- 可对代理进行**充值**（增加积分）或**扣减**（减少积分）
|
||
- 可**启用/禁用**代理账号
|
||
|
||
### 4.2 添加代理
|
||
|
||
表单字段：
|
||
- **姓名** — 代理真实姓名
|
||
- **密码** — 登录密码
|
||
- **手机号** — 联系电话
|
||
- **上级 ID** — 可选，指定上级代理
|
||
|
||
### 4.3 账户类型
|
||
|
||
管理员工账户类型配置，可设置不同类型的权限和有效期。
|
||
|
||
---
|
||
|
||
## 5. 仓库与基础数据管理
|
||
|
||
### 5.1 供应商管理
|
||
|
||
管理图书采购来源：
|
||
- **供应商列表** — 查看所有供应商（编号、名称、联系方式、状态）
|
||
- **新增/编辑/删除** — 维护供应商信息
|
||
- **搜索** — 按供应商名称或编码搜索
|
||
|
||
### 5.2 仓库管理
|
||
|
||
管理仓储资源：
|
||
- **仓库列表** — 查看所有仓库（编码、名称、类型、状态）
|
||
- **新增/编辑/删除** — 维护仓库信息
|
||
- **搜索** — 按仓库编码或名称搜索
|
||
|
||
### 5.3 库位管理
|
||
|
||
管理仓库内的存储位置：
|
||
- **库位列表** — 查看所有库位（编码、类型、容量、状态）
|
||
- **新增/编辑/删除** — 维护库位信息
|
||
- **批量生成** — 按规则一次性生成多个库位（例如 A-01-01 到 A-10-10）
|
||
- **批量更新** — 批量修改库位属性
|
||
|
||
### 5.4 小车管理
|
||
|
||
管理仓库作业用的小推车/搬运车：
|
||
- **小车列表** — 查看所有小车（编号、名称）
|
||
- **新增/编辑/删除** — 维护小车信息
|
||
- **店铺关联** — 将小车与特定店铺关联，方便拣货作业
|
||
|
||
### 5.5 店铺管理
|
||
|
||
管理销售渠道：
|
||
- **店铺列表** — 查看所有店铺（名称、类型、授权状态）
|
||
- **新增/编辑/删除** — 维护店铺信息
|
||
- **授权管理** — 更新店铺授权状态（已授权/未授权/已过期）
|
||
- **支持客户**：拼多多、孔夫子旧书网、闲鱼等
|
||
|
||
### 5.6 打印机管理
|
||
|
||
管理系统中配置的打印机设备，用于打印快递面单等。
|
||
|
||
---
|
||
|
||
## 6. 波次管理（核心工作流）
|
||
|
||
波次管理是系统的核心操作模块，用于将图书信息录入到系统中并为后续的采购/出库做准备。
|
||
|
||
### 6.1 核价器配置
|
||
|
||
在使用波次功能前，需要先配置核价器（Pricer）：
|
||
- 输入核价器的 IP 地址和端口
|
||
- **测试连接** — 验证能否连接到核价器
|
||
- 配置价格参数（新书价格、占位降价、最低运费、最低价格等）
|
||
- 管理核价器的登录 Token
|
||
- **保存价格** — 将当前配置的价格参数保存到核价器
|
||
|
||
### 6.2 波次创建
|
||
|
||
波次创建是核心操作入口，使用**相机扫描 + 手动录入**结合的方式采集图书信息。
|
||
|
||
**操作步骤：**
|
||
|
||
1. **扫描条码** — 使用摄像头扫描图书条码（ISBN），自动查询书籍信息
|
||
2. **OCR 识别** — 拍摄书籍封面，自动识别书名、作者、出版社（如有需要）
|
||
3. **编辑信息** — 确认和修改书籍信息（书名、作者、出版社、定价、页数等）
|
||
- 支持实拍图片上传
|
||
- 支持套装书处理
|
||
4. **生成条码** — 为商品生成条码图片
|
||
5. **查询价格** — 从核价器获取商品的建议售价
|
||
6. **提交保存** — 将商品信息保存到系统
|
||
7. **创建波次** — 将一批商品归入同一波次，便于后续批量处理
|
||
|
||
### 6.3 波次任务列表
|
||
|
||
查看已创建的波次任务，支持按条件筛选和搜索。
|
||
|
||
---
|
||
|
||
## 7. 采购与销售
|
||
|
||
### 7.1 采购订单
|
||
|
||
管理图书采购全流程：
|
||
- **采购单列表** — 查看所有采购单（单号、供应商、仓库、状态、总金额）
|
||
- **筛选** — 按单号、状态、时间范围等条件筛选
|
||
- **创建采购单** — 选择供应商、仓库，添加商品明细
|
||
- **创建波次** — 采购单可创建波次进行入库操作
|
||
- **查看详情** — 查看采购单的商品明细和状态
|
||
|
||
### 7.2 商品管理
|
||
|
||
管理所有商品信息：
|
||
- **商品列表** — 查看所有商品（名称、条码、价格、图片、状态）
|
||
- **搜索/筛选** — 按关键字、店铺、状态搜索
|
||
- **新增/编辑/删除** — 维护商品信息
|
||
- **实拍图片** — 上传和管理商品实拍图片（支持本地路径和拼多多 URL）
|
||
- **商品发布** — 将商品发布到各个店铺（详见"发布记录"）
|
||
|
||
### 7.3 销售订单
|
||
|
||
管理图书销售流程：
|
||
- **销售单列表** — 查看所有销售订单（单号、客户、仓库、状态、金额）
|
||
- **筛选** — 按单号、状态、客户等条件筛选
|
||
- **创建销售单** — 选择客户、仓库，添加商品明细
|
||
- **确认订单** — 确认销售订单后可创建出库单
|
||
- **取消订单** — 可取消销售订单并填写原因
|
||
|
||
### 7.4 发布记录
|
||
|
||
查看商品发布到店铺的日志记录（当前为模拟数据）：
|
||
- 按店铺分组展示每个商品的发布状态
|
||
- 状态包括：发布成功、发送到店铺失败、任务已创建未发送等
|
||
- **重试发布** — 发布失败的商品可点击重试
|
||
|
||
---
|
||
|
||
## 8. 出库与发货
|
||
|
||
### 8.1 出库管理
|
||
|
||
- **出库单列表** — 查看所有出库单（单号、仓库、状态、日期）
|
||
- **筛选** — 按单号、状态、仓库、日期范围筛选
|
||
- **创建出库单** — 从销售订单创建或手动创建
|
||
- **审核出库** — 审核通过后库存减少
|
||
- **导出** — 导出出库单详情
|
||
|
||
### 8.2 发货单
|
||
|
||
- **发货单列表** — 查看所有发货单（单号、物流信息、状态）
|
||
- **筛选** — 按单号、状态、仓库、客户等条件筛选
|
||
- **生成发货单** — 从出库单生成
|
||
- **填写物流信息** — 录入物流公司和快递单号
|
||
- **打印面单** — 对接快递打印接口，批量打印快递面单
|
||
- **回填快递单号** — 将快递单号回填到外部客户
|
||
|
||
---
|
||
|
||
## 9. 库存管理
|
||
|
||
### 9.1 库存查询
|
||
|
||
- **按商品汇总** — 按商品维度查看各仓库库存（总量/锁定量/可用量）
|
||
- **按仓库明细** — 按仓库+库位+批次查看库存明细
|
||
- **变动记录** — 查看库存变动日志（入库/出库/调整等）
|
||
|
||
### 9.2 盘库管理
|
||
|
||
用于定期盘点库存，确保系统库存与实际库存一致。
|
||
|
||
**操作流程：**
|
||
|
||
1. **创建盘库单**
|
||
- 选择盘点类型：**全盘**（盘点仓库全部商品）或 **抽盘**（指定部分商品）
|
||
- 选择仓库，填写备注
|
||
2. **开始盘点** — 盘库单状态变为"盘点中"
|
||
3. **录入盘点数据**
|
||
- 逐条录入：输入实盘数量
|
||
- 批量录入：一次性提交多条盘点结果
|
||
4. **完成盘点** — 系统更新实际库存
|
||
5. **调整库存** — 如果盘盈或盘亏，可手动调整库存（增加或减少）
|
||
6. **取消/删除** — 待盘点状态可取消或删除盘库单
|
||
|
||
---
|
||
|
||
## 10. 商品与店铺管理
|
||
|
||
### 10.1 商品管理详情
|
||
|
||
- **商品列表** 支持按商品名称、条码搜索
|
||
- 商品详情展示：名称、作者、出版社、定价（元）、条码、实拍图片等
|
||
- 支持**套装书**标识
|
||
|
||
### 10.2 异常书目审核（管理员）
|
||
|
||
当系统检测到书目信息异常（如书名/作者/价格与标准数据不一致），会在该模块展示：
|
||
|
||
- **异常记录列表** — 展示所有被标记为异常的记录
|
||
- **审核操作**：
|
||
- **通过** — 确认新数据正确，更新到数据库
|
||
- **驳回** — 拒绝异常标记，保留原数据
|
||
- 可查看新旧数据对比（书名、作者、出版社、价格、页数等）
|
||
|
||
### 10.3 ISBN 悬停浮窗
|
||
|
||
在系统中任何显示 ISBN 的地方（如商品列表），将鼠标悬停在 ISBN 上会弹出浮窗，展示该书的详细信息：
|
||
|
||
- 封面图片
|
||
- 书名、作者、出版社
|
||
- 出版时间、装帧、定价
|
||
- 页数、字数
|
||
- 套装书标记
|
||
|
||
该功能有缓存机制，同一 ISBN 只查询一次。
|
||
|
||
---
|
||
|
||
## 11. 系统配置
|
||
|
||
### 11.1 核价器配置（管理员）
|
||
|
||
路径：波次管理 → 核价器配置
|
||
|
||
| 功能 | 操作说明 |
|
||
|------|---------|
|
||
| **连接设置** | 输入核价器的 IP 和端口，点击「测试连接」验证连通性 |
|
||
| **价格配置** | 设置新书价格、占位降价金额、最低运费、最低书价 |
|
||
| **价格保存** | 将配置的价格参数提交到核价器 |
|
||
| **Token 管理** | 查看和管理核价器的登录 Token（新增/批量添加/删除） |
|
||
| **孔夫子登录** | 在核价器中登录孔夫子旧书网账号，用于自动上架 |
|
||
|
||
### 11.2 物流模板管理
|
||
|
||
- **物流模板列表** — 查看所有物流模板（名称、运费等）
|
||
- **新增/编辑/删除** — 维护物流模板
|
||
- 关联行政区划数据（省/市/区）
|
||
|
||
### 11.3 分拣设置
|
||
|
||
分拣规则配置（当前为预留功能，菜单默认隐藏）。
|
||
|
||
### 11.4 店铺设置
|
||
|
||
店铺通用配置（当前为预留功能，菜单默认隐藏）。
|
||
|
||
---
|
||
|
||
## 12. 常见操作指引
|
||
|
||
### 12.1 快速录入一本书
|
||
|
||
```
|
||
波次管理 → 进入波次页面
|
||
→ 扫描 ISBN 条码（自动查询书籍信息）
|
||
→ 确认书名、作者、出版社等信息
|
||
→ 输入定价、页数等补充信息
|
||
→ 可选：拍摄实拍图片 / OCR 识别封面
|
||
→ 点击保存 → 商品自动创建
|
||
```
|
||
|
||
### 12.2 处理一笔销售订单
|
||
|
||
```
|
||
销售订单 → 创建销售单
|
||
→ 选择客户、仓库 → 添加商品
|
||
→ 确认并提交 → 列表中确认订单
|
||
→ 进入出库管理 → 从销售单创建出库单
|
||
→ 审核出库 → 库存减少
|
||
→ 进入发货单 → 从出库单生成发货单
|
||
→ 填写物流信息 → 打印面单
|
||
```
|
||
|
||
### 12.3 进行月度盘点
|
||
|
||
```
|
||
盘库管理 → 创建盘库单
|
||
→ 选择仓库，盘点类型选"全盘"
|
||
→ 确认创建
|
||
→ 在列表中点击「开始盘点」
|
||
→ 逐条输入实盘数量
|
||
→ 全部完成后点击「完成盘点」
|
||
→ 如有差异，使用「库存调整」功能修正
|
||
```
|
||
|
||
### 12.4 查看商品库存
|
||
|
||
```
|
||
库存记录 → 库存查询
|
||
→ 选择商品 → 查看各仓库库存数量
|
||
→ 切换「明细」视图 → 查看具体库位和批次
|
||
→ 切换「变动记录」 → 查看该商品的出入库历史
|
||
```
|
||
|
||
### 12.5 退出登录
|
||
|
||
点击顶部栏右侧的用户名 → 选择「退出登录」→ 确认即可。
|
||
|
||
---
|
||
|
||
## 13. 附：菜单速查表
|
||
|
||
| 菜单 | 子菜单 | 页面路径 | 功能 |
|
||
|------|--------|---------|------|
|
||
| （首页） | — | `/dashboard` | 今日运营数据概览 |
|
||
| 代理管理 | 代理列表 | `/admin/employees` | 代理账号管理 |
|
||
| 代理管理 | 添加代理 | `/admin/employees/add` | 新增代理 |
|
||
| 代理管理 | 账户类型 | `/admin/employee-type` | 员工类型配置 |
|
||
| 供应商管理 | 供应商列表 | `/supplier` | 供应商管理 |
|
||
| 仓库管理 | 仓库列表 | `/warehouse` | 仓库管理 |
|
||
| 仓库管理 | 小车管理 | `/car` | 小车管理 |
|
||
| 仓库管理 | 店铺管理 | `/shop` | 店铺管理 |
|
||
| 仓库管理 | 打印机管理 | `/printer-manager` | 打印机管理 |
|
||
| 仓库管理 | PDA管理 | `/pdaManage` | PDA 管理 |
|
||
| 波次管理 | 核价器配置 | `/testUrl` | 核价器配置 |
|
||
| 波次管理 | 波次创建 | `/wave` | 相机扫码录书 |
|
||
| 波次管理 | 波次任务列表 | `/wave-task` | 波次任务查看 |
|
||
| 采购订单 | 采购单列表 | `/purchase-order` | 采购订单管理 |
|
||
| 商品管理 | 商品列表 | `/product` | 商品管理 |
|
||
| 商品管理 | 发布记录 | `/release-record` | 商品发布日志 |
|
||
| 销售订单 | 销售单列表 | `/sales-order` | 销售订单管理 |
|
||
| 出库管理 | 出库列表 | `/outbound` | 出库单管理 |
|
||
| 发货单 | 发货单列表 | `/shipping-order` | 发货单管理 |
|
||
| 库存记录 | 库存查询 | `/inventory` | 库存查询和变动记录 |
|
||
| 盘库管理 | 盘库单列表 | `/stock-check` | 盘库盘点管理 |
|
||
| — | 异常书目审核 | `/review-illegal-book` | 书目异常审核（管理员） |
|
||
| — | 物流模板管理 | `/logistics` | 物流模板管理 |
|
||
| — | 库位列表 | `/location` | 库位管理 |
|
||
|
||
---
|
||
|
||
*如在使用过程中遇到问题，请联系系统管理员或参考技术文档获取更多信息。*
|