项目启动 ¶

基础环境搭建 ¶

数据库 ¶

启动或者找一台可以使用Postgresql实例，同时在后端项目中_config/sql目录下找到dax-pay.sql数据库脚本文件。

在数据库中进行新建，Postgresql选UTF8编码。
将dax-pay.sql数据库脚本文件导入进去。

Redis ¶

启动一个Redis实例，记录可进行连接的各项信息，以备后续使用。

不需要进行额外操作

项目启动（后端） ¶

各模块的启动类都在daxpay-plus-client模块下，分别有运营端、商户端、支付网关端和融合端四个模块，目前我们只需要使用融合端即可

基础环境要求 ¶

名称	介绍	参考版本
JDK	Java运行环境	21+ 推荐使用 Corretto JDK
Maven	项目构建工具	推荐版本3.8.x及以上, 并使用网易云镜像加速
IDE	集成开发工具	IntelliJ IDEA
postgresql	数据库	12+
Redis	缓存中间件	推荐使用5.0及以上版本

将项目导入到IDEA中，等待依赖下载完毕
找到项目中daxpay-plus-client下的daxpay-plus-client-union模块，打开配置文件，将其中的数据库连接地址、Redis缓存连接地址、OSS文件上传地址等配置更换为真实的地址。
打开本模块的DaxpayUnionStart类文件并运行，启动项目，当控制台打印下列内容说明启动成功。

shell

----------------------------------------------------------
	应用 'dax-pay-union' 运行成功! 
	Swagger文档: 		http://192.168.1.12:19999/doc.html
	Swagger文档: 		http://127.0.0.1:19999/doc.html 
----------------------------------------------------------

项目启动（PC前端） ¶

运营端和商户端是同一个项目，适用不同的环境变量进行启动

基础环境要求 ¶

环境	版本	备注
Node	>=18.12.0	推荐使用20.9.0+
pnpm	>=9.0.2+	低版本会导致 pnpm-lock.yaml 失效

使用Vs Code或Webstorm打开项目，然后执行以下命令启动项目：

shell

# 安装项目依赖
pnpm install
# 启动项目 (运营端)
pnpm run dev:admin
# 启动项目 (商户端)
pnpm run dev:merchant

当控制台出现下列类似内容时说明启动成功：

shell

  VITE v5.4.7  ready in 9868 ms

  ➜  Local:   http://localhost:13333/                                                                                                                                13:59:18
  ➜  Network: http://192.168.1.104:13333/                                                                                                                             13:59:18  
  ➜  Network: http://172.24.221.1:13333/                                                                                                                               13:59:18  
  ➜  Vue DevTools: Open http://localhost:13333/web/__devtools__/ as a separate window                                                                                     13:59:18  
  ➜  Vue DevTools: Press Alt(⌥)+Shift(⇧)+D in App to toggle the Vue DevTools                                                                                              13:59:18  

  ➜  press h + enter to show help                                                                                                                                         13:59:18

启动成功后，点击访问即可，默认的超级管理员账号密码为：bootx/123456

项目启动（支付网关前端） ¶

基础环境要求

环境	版本	备注
Node	>=20.9.0	推荐使用20.9.0+
pnpm	>= 9.0.2+	低版本会导致 pnpm-lock.yaml 失效

使用Vs Code或Webstorm打开项目，然后执行以下命令启动项目：

shell

# 安装项目依赖
pnpm install
# 启动项目
pnpm run dev

当控制台出现下列内容时说明启动成功：

shell

  VITE v5.4.6  ready in 2130 ms

  ➜  Local:   http://localhost:9100/h5                                                                                                                                    14:31:40  
  ➜  Network: http://192.168.11.229:9100/h5                                                                                                                               14:31:40  
  ➜  Network: http://172.24.224.1:9100/h5                                                                                                                                 14:31:40  
  ➜  press h + enter to show help                                                                                                                                         14:31:40

本地调试示例 ¶

提示

因为支付系统会涉及到一些三方支付网关的交互，以及例如微信授权域名、jsapi安全域名的限制，所以本地调试时，对一些回调和手机端上的操作，需要做一些特殊处理。假定我们拥有一个域名frp.daxpay.com，并且该域名已经备案，下面就是举一个开发时进行调试的例子。

因为开发时，需要接收各种回调请求，以及手机端开发时，需要能够从外网进行访问，通常我们需要使用内网穿透工具，比如ngrok、frp等，具体可以自行搜索相关资料。

toml

serverAddr = "8.8.8.8" # frp地址服务
serverPort = 7000 # 服务端口号
auth.method = 'token' # 客户端访问验证方式
auth.token = 'daxpay' # 客户端访问验证密码

[[proxies]]
name = "dev" # 名称
type = "tcp" # 转发类型
localIP = "127.0.0.1" # 本地IP
localPort = 11688 # 本地接收端口号
remotePort = 19100 # 远程服务端口号