# dax-pay-ui
**Repository Path**: opendaxpay/dax-pay-ui
## Basic Information
- **Project Name**: dax-pay-ui
- **Description**: daxpay支付系统web端
- **Primary Language**: JavaScript
- **License**: LGPL-3.0
- **Default Branch**: 4.0
- **Homepage**: https://doc.daxpay.cn/
- **GVP Project**: No
## Statistics
- **Stars**: 95
- **Forks**: 174
- **Created**: 2023-04-18
- **Last Updated**: 2026-09-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: 支付
## README
# DaxPay Admin - 支付管理后台
## 项目简介
DaxPay UI 是 DaxPay 支付系统的 Web 管理端 monorepo，基于 Vue Vben Admin 5 二次开发，包含运营端 `daxpay-admin` 与商户端 `daxpay-merchant`，文案与菜单标题支持多语。
## 技术栈
| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.5 | 前端框架 |
| Vite | 8.x | 构建工具 |
| TypeScript | 5.9 | 开发语言 |
| antdv-next | 4.x | UI组件库（Ant Design Vue Next） |
| Vxe-Table | 最新 | 企业级表格组件 |
| Vben Admin | 5.7 | 中后台模板 |
| Pinia | 3.x | 状态管理 |
| TailwindCSS | 4.x | 原子化CSS |
| pnpm | 10.x | 包管理器 |
| Turbo | 2.x | Monorepo构建 |
| Axios | 最新 | HTTP请求 |
## 项目结构
```
dax-pay-ui/
├── apps/
│ ├── daxpay-admin/ # 运营管理后台（端口 6999）
│ │ └── src/ # 结构见下；views 约定见 apps/daxpay-admin/src/views/README.md
│ └── daxpay-merchant/ # 商户端（端口 7999；CLIENT_CODE=merchant）
│ └── src/
│ ├── api/core|iam|system # 登录/菜单/个人中心/通知等壳层 API
│ ├── constants/client.ts # CLIENT_CODE = 'merchant'
│ ├── views/_core/ # 登录 / 鉴权 / fallback
│ ├── views/dashboard/workspace/ # 静态工作台壳（阶段1）
│ ├── views/profile/ # 个人中心
│ └── views/system/notify/ # 通知中心
│
├── packages/ # Vben 内核与共享包
│ ├── @core/ # 核心（design / icons / shared / ui-kit）
│ ├── effects/ # access / layouts / request / plugins…
│ ├── constants/ · icons/ · locales/
│ ├── preferences/ · stores/ · styles/
│ ├── types/ · utils/
│
├── internal/ # lint / tsconfig / vite-config / node-utils
└── scripts/ # 构建与部署脚本
```
运营端 `daxpay-admin` 业务目录仍按域划分（`api/payment`、`views/payment/{global,channel,merchant,route,…}` 等），细则见 [`apps/daxpay-admin/src/views/README.md`](apps/daxpay-admin/src/views/README.md)。
**菜单 component 约定**：值为 `/` + `views` 内相对路径（无 `.vue` 后缀），例如 `/payment/merchant/info/MerchantList`。页面目录与命名细则见 [`apps/daxpay-admin/src/views/README.md`](apps/daxpay-admin/src/views/README.md)。
## 快速开始
### 环境要求
- Node.js 22.13+ / 24+
- pnpm 10.x
### 安装与启动
```bash
# 1. 克隆项目
git clone
cd dax-pay-ui
# 2. 安装依赖
pnpm install
# 3. 启动开发服务器
pnpm dev:admin # 运营端 http://localhost:6999
pnpm dev:merchant # 商户端 http://localhost:7999
# 4. 构建生产版本（turbo build 会扫到各 app）
pnpm build
```
> 商户端登录需运营端已创建的商户用户。
### 常用命令
| 命令 | 说明 |
|------|------|
| `pnpm dev:admin` | 启动运营端开发服务器（6999） |
| `pnpm dev:merchant` | 启动商户端开发服务器（7999） |
| `pnpm build` | 构建全部应用 |
| `pnpm lint` | 代码检查 |
| `pnpm format` | Prettier格式化 |
| `pnpm check:type` | TypeScript类型检查 |
| `pnpm test:unit` | 单元测试（Vitest） |
| `pnpm clean` | 清理构建产物 |
## 业务模块
### 支付管理 (Payment)
- **商户管理**: 商户列表/工作台、应用、门店、用户、通道商户
- **通道配置**: 支付宝、微信及多家收单通道（ISV / 直连）
- **支付主数据**: 通道、产品、能力、提供方
- **产品配置**: 产品级通道能力与详情分发
- **订单 / 设备 / 开发联调**: 订单查询、收款码设备、签名与交易调试
### IAM 权限管理
- 菜单管理、角色管理、用户管理、社交登录配置
### 系统管理 (System)
- 字典、平台配置（URL/OSS/安全/第三方平台）、日志、在线用户、通知、协议
### 工作台 (Dashboard)
- 运营工作台、数据分析
## 国际化
业务文案在各 app 的 `src/locales/langs/{locale}/`（多语对称）；菜单标题在 `locales/menu-titles/{locale}.json`。
```
apps/daxpay-admin/src/locales/ # 运营端
apps/daxpay-merchant/src/locales/ # 商户端
├── langs/{zh-CN,en-US,zh-TW,...}/ # 业务文案（按域拆分）
└── menu-titles/{locale}.json # 菜单标题（flat key）
```
## 开发规范
- Vue组件使用Composition API + `