diff --git a/DEPLOY_INSTRUCTIONS.md b/DEPLOY_INSTRUCTIONS.md new file mode 100644 index 0000000..53b6614 --- /dev/null +++ b/DEPLOY_INSTRUCTIONS.md @@ -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 +**状态**: ✅ 准备就绪 diff --git a/DEPLOY_PLAN.md b/DEPLOY_PLAN.md new file mode 100644 index 0000000..61ef489 --- /dev/null +++ b/DEPLOY_PLAN.md @@ -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