16 KiB
16 KiB
图书进销存系统 — 使用文档
系统名称：Cards（图书进销存管理后台）
适用对象：系统管理员、运营人员、仓库人员
最后更新：2026-06-03
目录
1. 系统概述
图书进销存系统是一个面向图书行业的全流程管理客户，覆盖从图书采购入库 → 库存管理 → 商品发布 → 销售出库 → 发货打单 → 盘库盘点的完整业务链条。
系统主要服务两类角色：
| 角色 | 可访问的功能 |
|---|---|
| 管理员（role=255） | 全部功能，包括代理管理、异常书目审核、核价器配置等 |
| 普通用户/代理（role=128） | 仪表盘、波次管理、仓库管理、采购销售、库存等基础业务 |
2. 登录与首页
2.1 登录
- 在浏览器中访问系统地址（开发环境：
http://localhost:5174） - 输入用户名和密码
- 选择登录身份：
- 管理员登录 — 管理员账号，拥有全部权限
- 代理登录 — 代理账号，权限受限
- 点击「登录」按钮进入系统
提示：登录信息保存在浏览器中，关闭页面后重新打开无需重复登录。如忘记密码，请联系系统管理员重置。
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 波次创建
波次创建是核心操作入口，使用相机扫描 + 手动录入结合的方式采集图书信息。
操作步骤：
- 扫描条码 — 使用摄像头扫描图书条码（ISBN），自动查询书籍信息
- OCR 识别 — 拍摄书籍封面，自动识别书名、作者、出版社（如有需要）
- 编辑信息 — 确认和修改书籍信息（书名、作者、出版社、定价、页数等）
- 支持实拍图片上传
- 支持套装书处理
- 生成条码 — 为商品生成条码图片
- 查询价格 — 从核价器获取商品的建议售价
- 提交保存 — 将商品信息保存到系统
- 创建波次 — 将一批商品归入同一波次，便于后续批量处理
6.3 波次任务列表
查看已创建的波次任务，支持按条件筛选和搜索。
7. 采购与销售
7.1 采购订单
管理图书采购全流程：
- 采购单列表 — 查看所有采购单（单号、供应商、仓库、状态、总金额）
- 筛选 — 按单号、状态、时间范围等条件筛选
- 创建采购单 — 选择供应商、仓库，添加商品明细
- 创建波次 — 采购单可创建波次进行入库操作
- 查看详情 — 查看采购单的商品明细和状态
7.2 商品管理
管理所有商品信息：
- 商品列表 — 查看所有商品（名称、条码、价格、图片、状态）
- 搜索/筛选 — 按关键字、店铺、状态搜索
- 新增/编辑/删除 — 维护商品信息
- 实拍图片 — 上传和管理商品实拍图片（支持本地路径和拼多多 URL）
- 商品发布 — 将商品发布到各个店铺（详见"发布记录"）
7.3 销售订单
管理图书销售流程：
- 销售单列表 — 查看所有销售订单（单号、客户、仓库、状态、金额）
- 筛选 — 按单号、状态、客户等条件筛选
- 创建销售单 — 选择客户、仓库，添加商品明细
- 确认订单 — 确认销售订单后可创建出库单
- 取消订单 — 可取消销售订单并填写原因
7.4 发布记录
查看商品发布到店铺的日志记录（当前为模拟数据）：
- 按店铺分组展示每个商品的发布状态
- 状态包括：发布成功、发送到店铺失败、任务已创建未发送等
- 重试发布 — 发布失败的商品可点击重试
8. 出库与发货
8.1 出库管理
- 出库单列表 — 查看所有出库单（单号、仓库、状态、日期）
- 筛选 — 按单号、状态、仓库、日期范围筛选
- 创建出库单 — 从销售订单创建或手动创建
- 审核出库 — 审核通过后库存减少
- 导出 — 导出出库单详情
8.2 发货单
- 发货单列表 — 查看所有发货单（单号、物流信息、状态）
- 筛选 — 按单号、状态、仓库、客户等条件筛选
- 生成发货单 — 从出库单生成
- 填写物流信息 — 录入物流公司和快递单号
- 打印面单 — 对接快递打印接口，批量打印快递面单
- 回填快递单号 — 将快递单号回填到外部客户
9. 库存管理
9.1 库存查询
- 按商品汇总 — 按商品维度查看各仓库库存（总量/锁定量/可用量）
- 按仓库明细 — 按仓库+库位+批次查看库存明细
- 变动记录 — 查看库存变动日志（入库/出库/调整等）
9.2 盘库管理
用于定期盘点库存，确保系统库存与实际库存一致。
操作流程：
- 创建盘库单
- 选择盘点类型：全盘（盘点仓库全部商品）或 抽盘（指定部分商品）
- 选择仓库，填写备注
- 开始盘点 — 盘库单状态变为"盘点中"
- 录入盘点数据
- 逐条录入：输入实盘数量
- 批量录入：一次性提交多条盘点结果
- 完成盘点 — 系统更新实际库存
- 调整库存 — 如果盘盈或盘亏，可手动调整库存（增加或减少）
- 取消/删除 — 待盘点状态可取消或删除盘库单
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 |
库位管理 |
如在使用过程中遇到问题，请联系系统管理员或参考技术文档获取更多信息。