# 13-超市管理系统 - 功能说明
# 项目概述
覆盖超市商品、采购、销售、会员和退货业务的管理系统，设置管理员、收银员、采购员、供应商与会员五类角色。会员可通过前台选购商品、查看订单与充值记录，工作人员通过后台处理经营业务。
# 项目概览
# 创新点
- 五角色经营协作：采购员和供应商围绕采购订单协同，收银员围绕销售与退货开展工作。
- 销售与会员联动：销售记录包含会员、收银员、支付方式和获得积分。
- 退货联动处理：审核通过时可退回会员余额、恢复商品库存并回退对应积分。
# 项目亮点
- 角色分工：提供管理员、收银员、采购员、供应商、会员等业务入口。
- 业务数据组织：主初始化脚本包含 13 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 人员管理
维护管理员、会员、收银员、采购员和供应商。
# 商品管理
维护商品分类、商品信息与库存。
# 采购销售
查看采购订单、销售订单及退货记录。
# 账户记录
查询会员充值记录。
# 收银员
# 商品与收银
查询商品，在收银结算页选择商品、会员及支付方式。
# 销售退货
管理销售订单和退货记录，处理会员退货。
# 采购员
# 采购管理
维护供应商资料，创建和处理采购订单及相关信息。
# 供应商
# 采购协作
通过采购订单管理入口查看并维护采购业务记录。
# 会员
# 商品选购
通过前台商品展示和结算入口购买商品。
# 订单售后
查看个人销售订单及明细，申请退货并查看审核结果。
# 账户查询
查看余额、积分与充值记录，使用充值入口。
# 个人资料
维护账户信息与密码。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 收银员 | 采购员 | 供应商 | 会员 |
|---|---|---|---|---|---|
| 账号与分类 | 管理 | — | — | — | — |
| 商品 | 管理 | 维护查询 | — | — | 浏览选购 |
| 供应商 | 管理 | — | 维护 | 个人资料 | — |
| 采购订单 | 管理 | — | 维护 | 采购协作 | — |
| 销售订单 | 管理 | 收银处理 | — | — | 个人购买查询 |
| 退货 | 管理 | 处理 | — | — | 申请查询 |
| 充值记录 | 管理 | — | — | — | 个人查询 |
# 业务状态说明
- 采购订单：待确认、已确认、已入库、已取消。
- 销售订单：结算创建时使用已完成状态。
- 退货：待审核、已审核、已拒绝。
- 商品：上架、下架。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 收银员 | CASHIER | cashier | 123456 |
| 采购员 | PURCHASER | purchaser | 123456 |
| 供应商 | SUPPLIER | supplier | 123456 |
| 会员 | MEMBER | member | 123456 |
# 核心业务流程
# 采购记录
- 采购员维护供应商。
- 建立采购订单与明细。
- 确认订单。
- 维护采购处理状态。
# 收银结算
- 选择商品和数量。
- 选择会员及支付方式。
- 提交销售订单与明细。
- 记录销售及会员相关数据。
# 退货审核
- 会员对订单提交退货。
- 后台审核。
- 审核通过时退回余额、恢复库存并扣回积分。
- 查询退货结果。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| Vue | ^3.4.29 |
| Element Plus | ^2.8.4 |
| Pinia | ^2.2.2 |
| Axios | ^1.7.5 |
| Vite | ^5.3.1 |
| Spring Boot | 3.2.10 |
| Java | 17 |
| MyBatis 集成组件 | 3.0.4 |
| 数据库 | MySQL；具体运行版本以实际部署为准 |
| 身份认证 | JWT；通过登录接口生成令牌 |
前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
a_2026_13_supermarket_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：13 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、cashier、category、member、product、purchase_order、purchase_order_item、purchaser、recharge_record、refund_order、sales_order、sales_order_item、supplier。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 五角色经营协作
采购员和供应商围绕采购订单协同，收银员围绕销售与退货开展工作。
# 销售与会员联动
销售记录包含会员、收银员、支付方式和获得积分。
# 退货联动处理
审核通过时可退回会员余额、恢复商品库存并回退对应积分。
# 当前实现说明
- 文档编号沿用“13”，实际源码位于“20-超市管理系统”，数据库配置仍使用 a_2026_13_supermarket_system。
- 采购订单目前包含状态维护，未从采购服务确认“已入库”自动增加库存；不能把状态修改写成完整自动入库流程。
- 支付方式中的微信、支付宝等选项不代表已接入第三方收款；以本地销售记录和账户处理逻辑为准。
- 未发现独立库存盘点、积分商城和会员等级折扣模块，原文相关内容不保留。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。