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。