# 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)。