OSPay是一个综合性支付管理平台，提供多渠道支付处理、商户管理、订单管理和资金结算等功能。该系统采用前后端分离架构，包含多个独立的组件，共同构成完整的支付生态系统。
OSPay主要功能包括：
OSPay采用微服务架构设计，各组件之间通过API进行通信。系统整体架构如下：
系统采用以下技术栈：
管理后台是系统的核心控制中心，主要负责处理管理员的请求和业务逻辑。
主要功能：
技术栈：
API后端是系统的核心服务层，提供RESTful API接口，处理来自各个前端的请求。
主要功能：
技术栈：
管理前端是系统管理员使用的Web界面，用于系统管理和监控。
主要功能：
技术栈：
商户门户是提供给商户使用的Web界面，用于商户管理自己的账户和交易。
主要功能：
技术栈：
移动应用是基于uni-app框架开发的跨平台移动应用，提供移动端支付和账户管理功能。
主要功能：
技术栈：
开发环境的硬件配置建议如下：
| 硬件 | 最低配置 | 推荐配置 |
|---|---|---|
| CPU | 双核处理器 | 四核处理器或更高 |
| 内存 | 8GB RAM | 16GB RAM或更高 |
| 存储 | 128GB SSD | 256GB SSD或更高 |
| 网络 | 10Mbps带宽 | 100Mbps带宽或更高 |
OSPay开发环境支持以下操作系统：
Git用于代码版本控制和获取项目源码。
安装步骤：
Linux (Ubuntu):
sudo apt update
sudo apt install git
macOS:
# 使用Homebrew安装
brew install git
Windows:
验证安装：
git --version
OSPay后端服务基于Python 3.8+开发。
安装步骤：
Linux (Ubuntu):
sudo apt update
sudo apt install python3 python3-pip python3-venv
macOS:
# 使用Homebrew安装
brew install python
Windows:
验证安装：
python3 --version
pip3 --version
前端应用开发需要Node.js环境。
安装步骤：
使用NVM安装（推荐，适用于所有平台）:
# 安装NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
# 或使用wget
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash
# 安装Node.js
nvm install 16
nvm use 16
直接安装:
验证安装：
node --version
npm --version
OSPay使用MySQL作为主要的关系型数据库。
安装MySQL:
Linux (Ubuntu):
sudo apt update
sudo apt install mysql-server
sudo mysql_secure_installation
macOS:
brew install mysql
brew services start mysql
Windows:
配置MySQL:
创建数据库和用户:
CREATE DATABASE ospay CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'ospay_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON ospay.* TO 'ospay_user'@'localhost';
FLUSH PRIVILEGES;
配置MySQL服务:
验证MySQL安装:
mysql -u root -p
OSPay使用Redis作为缓存和消息队列服务。
安装Redis:
Linux (Ubuntu):
sudo apt update
sudo apt install redis-server
sudo systemctl enable redis-server
macOS:
brew install redis
brew services start redis
Windows:
redis-server.exe配置Redis:
验证Redis安装:
redis-cli ping
Nginx用于反向代理和负载均衡。
安装Nginx:
Linux (Ubuntu):
sudo apt update
sudo apt install nginx
sudo systemctl enable nginx
macOS:
brew install nginx
brew services start nginx
Windows:
nginx.exe配置Nginx:
创建API服务配置文件:
# /etc/nginx/sites-available/ospay_api.conf
server {
listen 8888;
server_name localhost;
location / {
proxy_pass http://localhost:9000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
location /ws {
proxy_pass http://localhost:9000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
}
}
启用配置:
sudo ln -s /etc/nginx/sites-available/ospay_api.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
验证Nginx安装:
# 检查Nginx状态
nginx -t
# 访问默认页面
curl http://localhost:8888
首先，从Git仓库克隆ospay_api项目代码：
# 克隆项目代码
git clone https://github.com/baofeng16888/ospay_api.git
cd ospay_api
在运行服务前，需要配置相关的配置文件：
创建配置文件:
# 复制示例配置文件
cp config.example.py config.py
编辑配置文件:
根据实际环境修改config.py文件中的配置参数，主要包括：
dev = dict(
redis_host='localhost', # Redis服务器地址
mysql_host='localhost', # MySQL服务器地址
mysql_user='ospay_user', # MySQL用户名
mysql_password='your_password', # MySQL密码
mysql_database='ospay', # 数据库名称
debug=False, # 是否开启调试模式
order_timeout=5, # 订单超时时间
pay_url='http://localhost:9000/order/', # 支付URL
key_order='xxxxxx', # 订单密钥
secret_key='xxxxxxx', # 系统密钥
autoreload=True, # 是否自动重载
rollbar_server_access_token='8b2e26232f564f9ab0a486cfa7288ee8', # 日志服务token
websocket_api_allow_host=['app_servers'], # WebSocket允许的主机
usdt_api_endpoint='https://data-center-staging.rubyxgem.com:2087/api/brave_troops/usdt/remits/place_order', # USDT API端点
)
启动ospay_api服务：
创建虚拟环境:
python -m venv venv
source venv/bin/activate # Linux/macOS
# 或
venv\Scripts\activate # Windows
安装依赖:
pip install -r requirements.txt
启动服务:
python main.py --port=9000
使用Supervisor管理服务（推荐）:
安装Supervisor:
sudo apt update
sudo apt install supervisor
创建Supervisor配置:
sudo nano /etc/supervisor/conf.d/ospay_api.conf
添加以下内容：
[program:ospay_api]
command=/path/to/ospay_api/venv/bin/python /path/to/ospay_api/main.py --port=9000
directory=/path/to/ospay_api
user=your_username
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/path/to/ospay_api/logs/supervisor.log
启动服务:
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start ospay_api
首次启动服务时，需要初始化数据库：
# 激活虚拟环境
source venv/bin/activate # Linux/macOS
# 或
venv\Scripts\activate # Windows
# 执行数据库初始化脚本
python -c "from application.lakshmi_api.models import create_tables; create_tables()"
导入示例数据（可选）:
mysql -u ospay_user -p ospay < sql/mysql.sql
从Git仓库克隆ospay_admin项目代码：
# 克隆项目代码
git clone https://github.com/baofeng16888/ospay_admin.git
cd ospay_admin
ospay_admin需要配置数据库连接和其他系统参数：
创建配置文件:
# 创建配置目录
mkdir -p config
# 创建配置文件
touch config/config.py
编辑配置文件:
在config/config.py中添加以下内容：
# 数据库配置
DB_CONFIG = {
'host': 'localhost',
'port': 3306,
'user': 'ospay_user',
'password': 'your_password',
'db': 'ospay',
'charset': 'utf8mb4'
}
# Redis配置
REDIS_CONFIG = {
'host': 'localhost',
'port': 6379,
'db': 0,
'password': None
}
# 系统配置
SYSTEM_CONFIG = {
'debug': True,
'secret_key': 'your_secret_key',
'cookie_secret': 'your_cookie_secret',
'log_path': './logs',
'api_url': 'http://localhost:8888'
}
启动ospay_admin服务：
创建虚拟环境:
python -m venv venv
source venv/bin/activate # Linux/macOS
# 或
venv\Scripts\activate # Windows
安装依赖:
pip install -r requirements.txt
启动服务:
python main.py --port=8000
使用Supervisor管理服务（推荐）:
安装Supervisor:
sudo apt update
sudo apt install supervisor
创建Supervisor配置:
sudo nano /etc/supervisor/conf.d/ospay_admin.conf
添加以下内容：
[program:ospay_admin]
command=/path/to/ospay_admin/venv/bin/python /path/to/ospay_admin/main.py --port=8000
directory=/path/to/ospay_admin
user=your_username
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/path/to/ospay_admin/logs/supervisor.log
启动服务:
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start ospay_admin
从Git仓库克隆ospay_frontend项目代码：
# 克隆项目代码
git clone https://github.com/baofeng16888/ospay_frontend.git
cd ospay_frontend
安装项目依赖：
# 安装依赖
npm install
# 或使用yarn
yarn install
配置前端环境变量：
创建环境配置文件:
# 开发环境配置
cp .env.example .env.development
# 生产环境配置
cp .env.example .env.production
编辑环境配置文件:
在.env.development中设置API地址和其他配置：
# API基础URL
VUE_APP_BASE_API=http://localhost:8888
# 应用标题
VUE_APP_TITLE=OSPay管理系统
# 开发服务器端口
PORT=8080
开发环境运行:
# 启动开发服务器
npm run serve
# 或使用yarn
yarn serve
生产环境构建:
# 构建生产版本
npm run build
# 或使用yarn
yarn build
部署到Nginx:
配置Nginx:
创建Nginx配置文件/etc/nginx/sites-available/ospay_frontend.conf：
server {
listen 80;
server_name admin.ospay.local; # 开发环境域名
root /path/to/ospay_frontend/dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location /api {
proxy_pass http://localhost:8888;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
启用配置:
sudo ln -s /etc/nginx/sites-available/ospay_frontend.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
配置本地hosts:
编辑/etc/hosts文件，添加：
127.0.0.1 admin.ospay.local
从Git仓库克隆ospay_merchant项目代码：
# 克隆项目代码
git clone https://github.com/baofeng16888/ospay_merchant.git
cd ospay_merchant
安装项目依赖：
# 安装依赖
npm install
# 或使用yarn
yarn install
配置前端环境变量：
创建环境配置文件:
# 开发环境配置
cp .env.example .env.development
# 生产环境配置
cp .env.example .env.production
编辑环境配置文件:
在.env.development中设置API地址和其他配置：
# API基础URL
VUE_APP_BASE_API=http://localhost:8888
# 应用标题
VUE_APP_TITLE=OSPay商户系统
# 开发服务器端口
PORT=8081
开发环境运行:
# 启动开发服务器
npm run serve
# 或使用yarn
yarn serve
生产环境构建:
# 构建生产版本
npm run build
# 或使用yarn
yarn build
部署到Nginx:
配置Nginx:
创建Nginx配置文件/etc/nginx/sites-available/ospay_merchant.conf：
server {
listen 80;
server_name merchant.ospay.local; # 开发环境域名
root /path/to/ospay_merchant/dist;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location /api {
proxy_pass http://localhost:8888;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
启用配置:
sudo ln -s /etc/nginx/sites-available/ospay_merchant.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
配置本地hosts:
编辑/etc/hosts文件，添加：
127.0.0.1 merchant.ospay.local
从Git仓库克隆lakshmi_uniapp项目代码：
# 克隆项目代码
git clone https://github.com/baofeng16888/lakshmi_uniapp.git
cd lakshmi_uniapp
安装项目依赖：
# 安装依赖
npm install
# 或使用yarn
yarn install
配置uni-app环境：
编辑配置文件:
修改src/config/index.js文件，设置API地址：
// 开发环境配置
const development = {
baseUrl: 'http://localhost:8888',
websocketUrl: 'ws://localhost:8888/ws'
}
// 生产环境配置
const production = {
baseUrl: 'https://api.ospay.com',
websocketUrl: 'wss://api.ospay.com/ws'
}
export default {
development,
production
}
开发环境运行:
安装HBuilderX:
导入项目:
运行项目:
构建App:
配置App信息:
manifest.json云打包:
构建H5版本:
# 使用命令行构建H5版本
npm run build:h5
# 或使用yarn
yarn build:h5
部署H5版本到Nginx:
配置Nginx:
创建Nginx配置文件/etc/nginx/sites-available/lakshmi_uniapp.conf：
server {
listen 80;
server_name app.ospay.local; # 开发环境域名
root /path/to/lakshmi_uniapp/dist/build/h5;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
location /api {
proxy_pass http://localhost:8888;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
location /ws {
proxy_pass http://localhost:8888;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
启用配置:
sudo ln -s /etc/nginx/sites-available/lakshmi_uniapp.conf /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
配置本地hosts:
编辑/etc/hosts文件，添加：
127.0.0.1 app.ospay.local
验证API服务是否正常运行：
# 检查API服务状态
curl http://localhost:8888/api/health
# 测试API接口
curl http://localhost:8888/api/v1/ping
使用Postman测试API:
验证管理后台是否正常运行：
验证商户门户是否正常运行：
验证移动应用是否正常运行：
H5版本测试:
App版本测试:
问题: 无法连接到MySQL数据库
解决方案:
检查MySQL服务是否正常运行：
sudo systemctl status mysql
检查数据库配置：
检查防火墙设置：
sudo ufw status
# 如果防火墙开启，允许MySQL端口
sudo ufw allow 3306/tcp
问题: 无法连接到Redis服务
解决方案:
检查Redis服务是否正常运行：
sudo systemctl status redis
检查Redis配置：
重启Redis服务：
sudo systemctl restart redis
问题: API服务无法正常启动
解决方案:
检查日志文件：
cat /path/to/ospay_api/logs/api.log
检查配置文件：
config.py文件是否存在检查依赖项：
pip list
检查端口占用：
sudo lsof -i :9000
问题: 前端项目构建失败
解决方案:
检查Node.js版本：
node -v
# 如果版本不兼容，使用nvm切换版本
nvm use 16
清理缓存并重新安装依赖：
rm -rf node_modules
npm cache clean --force
npm install
检查构建错误信息：
npm run build -- --verbose
检查环境配置文件：
.env.development或.env.production文件是否正确