65 lines
3.1 KiB
Markdown
65 lines
3.1 KiB
Markdown
# 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](supplied-service/README.md)。 |