3.1 KiB
3.1 KiB
points-mall
积分商城供应商项目，对接 zhgh 工会平台，包含商城 H5、供应商管理后台及业务服务。
项目组成
| 目录 | 用途 | 技术栈 |
|---|---|---|
supplied-h5 |
商品浏览、购物车、下单支付、订单与售后、商家处理台 | Vue 3、Vant 3、Pinia、Vue Router 4、Vue CLI |
supplied-admin |
商品管理、订单管理、售后处理、订单对账 | Vue 3、Element Plus、Pinia、Vue Router 4、Vite |
supplied-service |
商城接口、管理端接口、工会平台对接、文件处理 | Koa、TypeScript、Prisma、MySQL、Redis、MinIO |
H5 和管理端的 Vue 版本声明均为 ^3.5.13，H5 的 Vant 版本声明为 ^3.6.16。
主要功能
- 商城 H5：商品与规格选择、购物车、地址管理、下单支付、订单查询及售后申请。
- 管理后台：账号登录、商品维护、订单筛选与分页、确认发货、重新推送拆单、售后审核与处理、订单对账。
- 平台对接：供应商授权、订单事件推送、对账及发票相关接口。
- 调试日志：查看供应商后端与 zhgh 之间的请求记录。
本地访问入口
以下为默认开发地址，实际地址以端口和环境配置为准。
| 入口 | 地址 |
|---|---|
| 管理端登录 | http://localhost:5173/login |
| 管理端订单列表 | http://localhost:5173/orders/list |
| 商城 H5 | http://localhost:3001/ |
| 商城 API | http://localhost:8888/api |
| 管理端 API | http://localhost:8888/api/admin |
商家处理与日志
- 商家处理台：
http://localhost:3001/#/joyful-selection/merchant - 供应商日志页面：
http://localhost:3001/#/joyful-selection/supplier-logs - 供应商日志接口：
GET http://localhost:8888/api/supplier-logs - 日志内容包含：当前后端接收请求、向zhgh发送请求、接收zhgh请求。
管理端登录
当前本地开发数据库已初始化以下账号；密码由初始化脚本生成并单独交付，不在文档中保存。
| 项目 | 内容 |
|---|---|
| 账号 | admin |
| 登录后进入订单列表 | http://localhost:5173/login?redirect=/orders/list |
- 登录账号存储在
supplied_user，密码使用随机盐和 scrypt 哈希保存，不保存明文密码。 - 管理端使用 Bearer Token，登录有效期为 8 小时；同一账号重新登录会替换旧 Token。
/api/admin/*除登录接口外均校验登录状态；退出登录会使当前 Token 失效。- 同一启用账号连续输错密码 5 次后锁定 15 分钟。
数据库与配置
- 管理账号表：
supplied_user。 - 购物车表：
supplied_cart_item；保留业务用户userId，不关联后台管理员账号。 - 原
user空表已移除，购物车表名统一使用supplied_cart_item。 - 后端配置位于
supplied-service/.env，字段参考.env.example。 - H5 使用
VUE_APP_SUPPLIED_API_BASE指定后端地址，使用VUE_APP_SUPPLIER_IDENTIFICATION指定供应商标识。 - 管理端使用
VITE_SUPPLIED_ADMIN_API_BASE指定管理接口地址。
后端目录、接口及初始化脚本说明见 supplied-service/README.md。