Jeepay 前端项目，包括运营平台、商户系统、聚合码收银台。
三个子项目均采用 Vue 3 + Vite 构建，UI 框架使用 Ant Design Vue（管理端/商户端）。
- GitHub：https://github.com/jeequan/jeepay
- Gitee：https://gitee.com/jeequan/jeepay
- GitCode：https://gitcode.com/jeequantech/jeepay
jeepay-ui
├── jeepay-ui-cashier -- 聚合码收银台（Vue 3 + Vite）
├── jeepay-ui-manager -- 运营平台（Vue 3 + Vite + Ant Design Vue 4）
├── jeepay-ui-merchant -- 商户系统（Vue 3 + Vite + Ant Design Vue 4）
├── Dockerfile -- Docker 统一构建（通过 PLATFORM 参数区分）
├── default.conf.template -- Nginx 配置模板
└── .dockerignore
| 组件 | 版本 |
|---|---|
| Vue | 3.2+ |
| Vue Router | 4.x |
| Vite | 4.x（cashier）/ 2.x（manager/merchant） |
| Ant Design Vue | 4.2（manager/merchant） |
| Node.js | >= 16 |
- Node.js >= 18（推荐 20 LTS）
- npm >= 7
以运营平台为例（其他子项目操作相同）：
# 进入子项目目录
cd jeepay-ui-manager
# 安装依赖
npm install
# 修改开发环境后端地址
# 编辑 .env.development 中的 VITE_API_BASE_URL
# 本地开发
npm run dev
# 生产构建
npm run build
# 产物输出到 dist/ 目录| 操作 | 命令 |
|---|---|
| 本地开发 | npm run dev |
| 生产构建 | npm run build |
| 预览构建产物 | npm run serve |
| 变量名 | 说明 | 示例 |
|---|---|---|
VITE_BASE_URL |
前端资源部署根路径 | / 或 /cashier/ |
VITE_API_BASE_URL |
后端 API 地址 | http://localhost:9216 |
- 开发环境：修改
.env.development - 生产环境：修改
.env
UI 项目通过统一的 Dockerfile 构建，使用 PLATFORM 参数区分子项目。
# 构建收银台
docker build . --build-arg PLATFORM=cashier -t jeepay-ui-cashier:latest
# 构建运营平台
docker build . --build-arg PLATFORM=manager -t jeepay-ui-manager:latest
# 构建商户系统
docker build . --build-arg PLATFORM=merchant -t jeepay-ui-merchant:latestdocker run -d -p 9226:80 -e BACKEND_HOST=172.20.0.21:9216 jeepay-ui-cashier:latest
docker run -d -p 9227:80 -e BACKEND_HOST=172.20.0.22:9217 jeepay-ui-manager:latest
docker run -d -p 9228:80 -e BACKEND_HOST=172.20.0.23:9218 jeepay-ui-merchant:latest推荐在 jeepay 服务端项目中使用 docker compose up -d --build 一键启动全部服务（包含前后端 + 中间件），详见 jeepay README。
| 服务 | 端口 |
|---|---|
| 收银台 UI | 9226 |
| 运营平台 UI | 9227 |
| 商户系统 UI | 9228 |
- Docker 构建时，
.dockerignore会排除node_modules、.git、dist目录以加速构建 - Nginx 配置通过环境变量
BACKEND_HOST动态设置后端代理地址 - 如部署在非根路径下，需修改
.env中的VITE_BASE_URL