sion/monisuo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 添加部署计划和指南

Browse Source
This commit is contained in:
sion
2026-03-23 22:01:53 +08:00
parent 9269f70cc3
commit 21c1639c88
2 changed files with 435 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

407
DEPLOY_INSTRUCTIONS.md Normal file
View File

@@ -0,0 +1,407 @@
# 🚀 生产环境部署指南
**项目**: Monisuo 虚拟货币模拟交易系统
**版本**: v1.0
**日期**: 2026-03-23
---
## 📋 部署前检查清单
- ✅ 前端构建完成（Flutter Web + Vue3）
- ✅ 后端代码已提交
- ✅ 数据库补丁已执行
- ✅ Git 已推送到远程仓库
---
## 🔧 部署步骤
### **Step 1: SSH 登录服务器**
```bash
ssh root@8.155.172.147
```
### **Step 2: 进入项目目录**
```bash
cd /path/to/monisuo
# 或者
cd /root/monisuo
```
### **Step 3: 拉取最新代码**
```bash
# 查看当前状态
git status
# 拉取最新代码
git pull origin main
# 查看最新提交
git log --oneline -5
```
**预期输出**:
```
9269f70 build: 构建前端生产版本
ca34261 docs: 添加最终测试总结报告
5c8df49 fix: 完善资金充值/提现逻辑
c294f66 fix: 添加冷钱包表支持，修复充值功能
```
---
### **Step 4: 重启后端服务**
#### **方式A: 使用 systemd**
```bash
# 重启服务
systemctl restart monisuo
# 查看状态
systemctl status monisuo
# 查看日志
journalctl -u monisuo -f
```
#### **方式B: 使用脚本**
```bash
# 停止旧服务
pkill -f monisuo-1.0.jar
# 启动新服务
nohup java -jar target/monisuo-1.0.jar --server.port=5010 > /var/log/monisuo/app.log 2>&1 &
# 查看日志
tail -f /var/log/monisuo/app.log
```
#### **方式C: 使用 Docker**
```bash
# 重新构建镜像
docker build -t monisuo:latest .
# 重启容器
docker-compose restart monisuo-backend
# 查看日志
docker-compose logs -f monisuo-backend
```
---
### **Step 5: 部署前端**
#### **Flutter Web**
```bash
# 复制构建产物到 Web 服务器目录
cp -r flutter_monisuo/build/web/* /var/www/monisuo-web/
# 设置权限
chown -R www-data:www-data /var/www/monisuo-web/
chmod -R 755 /var/www/monisuo-web/
```
#### **Vue3 管理后台**
```bash
# 复制构建产物到 Web 服务器目录
cp -r monisuo-admin/dist/* /var/www/monisuo-admin/
# 设置权限
chown -R www-data:www-data /var/www/monisuo-admin/
chmod -R 755 /var/www/monisuo-admin/
```
---
### **Step 6: 配置 Nginx**
#### **前端配置**
```nginx
# /etc/nginx/sites-available/monisuo-web
server {
listen 80;
server_name your-domain.com;
root /var/www/monisuo-web;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
# API 代理
location /api/ {
proxy_pass http://localhost:5010;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```
#### **管理后台配置**
```nginx
# /etc/nginx/sites-available/monisuo-admin
server {
listen 80;
server_name admin.your-domain.com;
root /var/www/monisuo-admin;
index index.html;
location / {
try_files $uri $uri/ /index.html;
}
# API 代理
location /admin/ {
proxy_pass http://localhost:5010;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
```
#### **重启 Nginx**
```bash
# 测试配置
nginx -t
# 重启服务
systemctl restart nginx
# 查看状态
systemctl status nginx
```
---
### **Step 7: 验证部署**
#### **1. 检查后端服务**
```bash
# 健康检查
curl http://localhost:5010/health
# 测试钱包接口
curl http://localhost:5010/api/wallet/default
# 预期返回
{
"code": "0000",
"msg": "成功",
"data": {
"id": 1,
"name": "USDT-TRC20 主钱包",
"address": "TRX1234567890abcdefghijklmnopqrstuvwxyz1234",
"network": "TRC20"
},
"success": true
}
```
#### **2. 检查前端访问**
```bash
# 用户端
curl http://localhost/
# 管理后台
curl http://localhost/admin/
```
#### **3. 运行完整测试**
```bash
# 进入项目目录
cd /root/monisuo
# 运行测试脚本
./test_fund_flow.sh
```
---
## 🧪 功能测试
### **充值流程测试**
1. **用户端操作**
- 访问用户端前端
- 登录账户
- 进入"资产"页面
- 点击"充值"按钮
- 输入充值金额（如 100 USDT）
- 确认充值
- 查看钱包地址
- 点击"已打款"
2. **管理后台操作**
- 登录管理后台
- 进入"订单管理"页面
- 查看待审批订单
- 点击"审批通过"或"审批驳回"
- 填写备注（如驳回需填写原因）
3. **验证结果**
- 用户端查看订单状态
- 查看资金账户余额变化
### **提现流程测试**
1. **用户端操作**
- 进入"资产"页面
- 点击"提现"按钮
- 输入提现金额（如 50 USDT）
- 输入提现地址
- 输入联系方式
- 确认提现
2. **管理后台操作**
- 查看待审批提现订单
- 点击"确认打款"或"驳回"
- 填写备注
3. **验证结果**
- 用户端查看订单状态
- 查看资金账户余额变化
---
## 🐛 常见问题排查
### **问题1: 后端服务无法启动**
```bash
# 检查端口占用
netstat -tunlp | grep 5010
# 检查日志
tail -f /var/log/monisuo/app.log
# 检查 Java 版本
java -version
```
### **问题2: 前端页面无法访问**
```bash
# 检查 Nginx 状态
systemctl status nginx
# 检查文件权限
ls -la /var/www/monisuo-web/
# 检查 Nginx 配置
nginx -t
```
### **问题3: 数据库连接失败**
```bash
# 检查数据库连接
mysql -u monisuo -p -h 8.155.172.147 monisuo
# 检查数据库表
SHOW TABLES;
SELECT * FROM cold_wallet;
```
### **问题4: 充值/提现功能异常**
```bash
# 检查数据库数据
SELECT * FROM cold_wallet WHERE is_default=1 AND status=1;
# 检查订单数据
SELECT * FROM order_fund ORDER BY create_time DESC LIMIT 5;
# 检查用户资金账户
SELECT * FROM account_fund WHERE user_id=1;
```
---
## 📊 监控和日志
### **后端日志**
```bash
# 实时日志
tail -f /var/log/monisuo/app.log
# 历史日志
cat /var/log/monisuo/app.log | grep ERROR
```
### **Nginx 日志**
```bash
# 访问日志
tail -f /var/log/nginx/access.log
# 错误日志
tail -f /var/log/nginx/error.log
```
### **系统监控**
```bash
# CPU 和内存
top
# 磁盘空间
df -h
# 网络连接
netstat -tunlp
```
---
## ✅ 部署完成检查
- [ ] 后端服务运行正常
- [ ] 前端页面访问正常
- [ ] 充值流程测试通过
- [ ] 提现流程测试通过
- [ ] 管理后台功能正常
- [ ] 日志记录正常
- [ ] 监控配置完成
---
## 📞 技术支持
如遇问题，请检查：
1. **日志文件**
- 后端: `/var/log/monisuo/app.log`
- Nginx: `/var/log/nginx/error.log`
2. **配置文件**
- 后端: `application-prod.yml`
- Nginx: `/etc/nginx/sites-available/monisuo-*`
3. **测试脚本**
- 充值测试: `./test_deposit_api.sh`
- 完整测试: `./test_fund_flow.sh`
---
**部署指南版本**: v1.0
**最后更新**: 2026-03-23 22:00
**状态**: ✅ 准备就绪

28
DEPLOY_PLAN.md Normal file
View File

@@ -0,0 +1,28 @@
# 部署计划
## 📋 部署步骤
### Phase 1: 服务器准备
- [ ] SSH 登录服务器
- [ ] 拉取最新代码
- [ ] 检查服务状态
### Phase 2: 后端部署
- [ ] 停止旧服务
- [ ] 启动新服务
- [ ] 验证健康检查
### Phase 3: 前端部署
- [ ] 部署 Flutter Web
- [ ] 部署 Vue3 管理后台
- [ ] 配置 Nginx
### Phase 4: 测试验证
- [ ] 测试充值流程
- [ ] 测试提现流程
- [ ] 测试管理后台
---
**开始时间**: 2026-03-23 22:00
**预计完成**: 2026-03-23 22:15