docs(deployment): 移除过时的配置文档并更新部署说明

- 删除了 502 错误排查指南文档 - 删除了配置文件管理说明文档 - 删除了域名配置总结文档 - 删除了 Nginx SSL 配置指南文档 - 删除了项目改进计划文档 - 删除了公网访问配置检查清单文档 - 更新了部署说明文档中的后端部署流程 - 简化了前端部署说明，移除了冗余的配置验证步骤 - 更新了配置检查清单，聚焦生产环境部署要点
docs(config): 添加配置文件管理说明并调整开发环境配置
2025-12-26 16:08:33 +08:00 · 2025-12-26 16:05:53 +08:00
14 changed files with 148 additions and 858 deletions
--- a/502_ERROR_TROUBLESHOOTING.md
+++ b/502_ERROR_TROUBLESHOOTING.md
@@ -1,220 +0,0 @@
-# 502 Bad Gateway 错误排查指南
-
-## 错误说明
-
-`502 Bad Gateway` 表示 Nginx 无法连接到后端服务。通常是因为：
-1. **后端服务未启动**
-2. **Nginx配置中的端口不正确**（最常见）
-3. **后端服务启动失败**
-4. **防火墙阻止连接**
-
-## 排查步骤
-
-### 1. 检查后端服务是否启动
-
-在服务器上执行：
-
-```bash
-# 检查18082端口是否在监听
-netstat -tlnp | grep 18082
-# 或
-ss -tlnp | grep 18082
-
-# 检查Java进程
-ps aux | grep java
-# 或
-jps -l
-```
-
-**如果端口没有监听：**
- 后端服务没有启动
- 需要启动后端服务
-
-### 2. 检查Nginx配置（最重要）
-
-在宝塔面板中：
-1. 网站 → 设置 → 配置文件
-2. 找到 `location /api/` 配置块
-3. **确认 `proxy_pass` 端口是 `18082`**
-
-**正确的配置：**
-```nginx
-location /api/ {
-    proxy_pass http://127.0.0.1:18082;  # ← 必须是18082，不是8082
-    proxy_set_header Host $host;
-    proxy_set_header X-Real-IP $remote_addr;
-    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-}
-```
-
-**错误的配置（会导致502）：**
-```nginx
-location /api/ {
-    proxy_pass http://127.0.0.1:8082;  # ← 错误：端口还是8082
-    ...
-}
-```
-
-**修改后必须：**
-1. 点击"保存"
-2. 点击"重载配置"或"重启Nginx"
-
-### 3. 测试后端服务是否正常
-
-在服务器上执行：
-
-```bash
-# 测试后端API是否可访问
-curl http://127.0.0.1:18082/api/health
-# 或
-curl http://127.0.0.1:18082/api/erp/user/login -X POST -H "Content-Type: application/json" -d '{"username":"test","password":"test"}'
-```
-
-**如果返回连接拒绝：**
- 后端服务没有启动
- 检查启动日志
-
-**如果返回正常响应：**
- 后端服务正常
- 问题在Nginx配置
-
-### 4. 检查后端启动日志
-
-查看后端启动日志，确认：
- 服务是否成功启动
- 是否监听在 `18082` 端口
- 是否有错误信息
-
-```bash
-# 如果使用nohup启动
-tail -f app.log
-
-# 或查看Spring Boot启动日志
-# 应该看到类似信息：
-# Tomcat started on port(s): 18082 (http)
-```
-
-### 5. 检查防火墙
-
-在宝塔面板中：
-1. 安全 → 防火墙
-2. 确认端口 `18082` 已开放（如果后端需要外部访问）
-3. **注意：** 如果后端只监听 `127.0.0.1`，不需要开放防火墙
-
-### 6. 检查后端监听地址
-
-确认后端配置：
-
-**application-dev.yml:**
-```yaml
-server:
-  port: 18082
-  # 如果没有配置 address，默认监听 0.0.0.0（所有网卡）
-  # 如果配置了 address: 127.0.0.1，只监听本地
-```
-
-**如果后端只监听 127.0.0.1：**
- Nginx的 `proxy_pass` 必须使用 `http://127.0.0.1:18082`
- 不能使用 `http://175.178.252.59:18082`
-
-## 快速修复步骤
-
-### 步骤1：确认后端服务已启动
-
-```bash
-# 在服务器上执行
-java -jar mt-startup-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev
-
-# 或后台运行
-nohup java -jar mt-startup-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev > app.log 2>&1 &
-```
-
-### 步骤2：修改Nginx配置
-
-在宝塔面板中修改配置文件：
-
-```nginx
-location /api/ {
-    proxy_pass http://127.0.0.1:18082;  # 确保是18082
-    proxy_set_header Host $host;
-    proxy_set_header X-Real-IP $remote_addr;
-    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    # 添加超时配置（可选）
-    proxy_connect_timeout 60s;
-    proxy_send_timeout 60s;
-    proxy_read_timeout 60s;
-}
-```
-
-### 步骤3：重载Nginx
-
-在宝塔面板中：
-1. 保存配置
-2. 重载配置
-
-### 步骤4：验证
-
-```bash
-# 在服务器上测试
-curl http://127.0.0.1/api/erp/user/login -X POST -H "Content-Type: application/json" -d '{"username":"test","password":"test"}'
-```
-
-## 常见问题
-
-### Q1: 修改了Nginx配置，但还是502？
-
-**A:** 检查是否：
- 保存了配置
- 重载了Nginx（不是只保存）
- 确认端口是 `18082`，不是 `8082`
-
-### Q2: 后端服务启动了，但Nginx还是502？
-
-**A:** 检查：
- Nginx配置中的端口是否正确
- 后端是否真的在 `18082` 端口监听
- Nginx错误日志：`/www/wwwlogs/175.178.252.59.error.log`
-
-### Q3: 如何查看Nginx错误日志？
-
-**A:** 在宝塔面板中：
- 网站 → 日志 → 错误日志
- 或直接查看：`/www/wwwlogs/175.178.252.59.error.log`
-
-查看是否有类似错误：
-```
-connect() failed (111: Connection refused) while connecting to upstream
-```
-这表示无法连接到后端。
-
-## 验证清单
-
- [ ] 后端服务已启动
- [ ] 后端监听在 `18082` 端口
- [ ] Nginx配置中 `proxy_pass` 端口是 `18082`
- [ ] Nginx配置已保存并重载
- [ ] 防火墙已开放（如果需要）
- [ ] 后端启动日志无错误
-
-## 如果还是无法解决
-
-1. **查看Nginx错误日志**
-   ```bash
-   tail -f /www/wwwlogs/175.178.252.59.error.log
-   ```
-
-2. **查看后端启动日志**
-   ```bash
-   tail -f app.log
-   ```
-
-3. **检查端口占用**
-   ```bash
-   netstat -tlnp | grep 18082
-   ```
-
-4. **测试后端直接访问**
-   ```bash
-   curl http://127.0.0.1:18082/api/health
-   ```
-
--- a/DEPLOYMENT_README.md
+++ b/DEPLOYMENT_README.md
@@ -4,26 +4,20 @@

 ### 后端部署

-1. **配置文件已更新**
-   - ✅ `app.frontend.url` 已设置为 `http://175.178.252.59`（公网地址，通过Nginx访问）
-   - ✅ `paypal.webhook-url` 已设置为 `https://175.178.252.59/api/paypal/webhook`（HTTPS，PayPal要求）
-   - ✅ 后端端口已设置为 `8082`
-   - ✅ 前端 `.env.production` 已创建，API地址为 `/api`（相对路径）
-
-2. **打包应用**
+1. **打包应用**
   ```bash
   cd E:\MTKJPAY
   mvn clean package -DskipTests
   ```

-3. **上传并启动**
+2. **上传并启动**
   ```bash
   # 上传 jar 文件到服务器
-   # 启动应用
-   java -jar mt-pay-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev
+   # 启动应用（使用生产环境配置）
+   java -jar mt-startup-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod
   
   # 或后台运行
-   nohup java -jar mt-pay-0.0.1-SNAPSHOT.jar --spring.profiles.active=dev > app.log 2>&1 &
+   nohup java -jar mt-startup-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod > app.log 2>&1 &
   ```

 ### 前端部署
@@ -34,42 +28,20 @@
   npm run build
   ```

-2. **本地测试打包结果（验证打包是否正确）**
-   ```bash
-   cd dist
-   python -m http.server 3000
-   # 或
-   npx http-server -p 3000
-   # 访问 http://localhost:3000（应该能看到页面，不是空白）
-   ```
-
-3. **API地址配置**
-   - ✅ `.env.production` 文件已创建
-   - ✅ API地址已设置为 `/api`（相对路径，通过Nginx代理）
-   - ⚠️ **重要：** 必须使用相对路径 `/api`，不要使用完整URL
-
-4. **上传到服务器**
-   ```bash
-   # 上传dist目录下的所有文件到服务器
-   scp -r dist/* root@175.178.252.59:/path/to/web/root/
-   ```
-
-5. **服务器配置**
-   - 如果服务器已有Web服务器，将dist内容放到Web根目录
+2. **上传到服务器**
+   - 上传 `dist` 目录下的所有文件到服务器Web根目录
   - 确保支持Vue Router的history模式（配置 `try_files`）

+## 配置说明
+
+- **开发环境**：使用 `application-dev.yml`（本地开发，默认）
+- **生产环境**：使用 `application-prod.yml`（服务器部署，需指定 `--spring.profiles.active=prod`）
+
 ## 配置检查清单

-部署前请检查以下配置：
-
- [x] 后端 `app.frontend.url` 已设置为 `http://175.178.252.59`（公网地址）
- [x] 后端 `paypal.webhook-url` 已设置为 `https://175.178.252.59/api/paypal/webhook`（HTTPS）
- [x] 后端端口已设置为 `8082`
- [x] 前端API地址已配置为 `/api`（相对路径，通过Nginx代理）
- [ ] 数据库连接信息正确
- [ ] 服务器防火墙已开放必要端口（8082等）
- [ ] **Nginx已配置SSL证书（PayPal Webhook必需）**
- [ ] PayPal控制台Webhook URL已更新为 `https://175.178.252.59/api/paypal/webhook`
- [ ] **Nginx配置中的proxy_pass端口已更新为8082**
-
-
+- [ ] 使用 `--spring.profiles.active=prod` 启动（生产环境配置）
+- [ ] 数据库连接信息正确（生产环境）
+- [ ] 服务器防火墙已开放必要端口（8082、443等）
+- [ ] Nginx已配置SSL证书（PayPal Webhook必需HTTPS）
+- [ ] Nginx配置中的proxy_pass端口为8082
+- [ ] PayPal控制台Webhook URL已配置为域名（HTTPS）
--- a/DOMAIN_CONFIG_SUMMARY.md
+++ b/DOMAIN_CONFIG_SUMMARY.md
@@ -1,134 +0,0 @@
-# 域名配置总结
-
-## ✅ 已完成的配置修改
-
-### 域名信息
- **域名**: `shopd.mtkj2025.com`
- **SSL证书**: 已配置（Let's Encrypt）
- **协议**: HTTPS（443端口）
-
-### 1. 后端配置文件
-
-#### application-dev.yml
- ✅ `app.frontend.url: https://shopd.mtkj2025.com`
- ✅ `paypal.webhook-url: https://shopd.mtkj2025.com/api/paypal/webhook`
-
-#### application-prod.yml
- ✅ `app.frontend.url: ${app.frontend.url:https://shopd.mtkj2025.com}`
- ✅ `paypal.webhook-url: ${paypal.webhook-url:https://shopd.mtkj2025.com/api/paypal/webhook}`
-
-#### mt-startup/application-dev.yml
- ✅ `app.frontend.url: https://shopd.mtkj2025.com`
-
-#### mt-startup/application.yml
- ✅ `app.frontend.url: https://shopd.mtkj2025.com`
-
-### 2. Java代码
-
-#### ProductServiceImpl.java
- ✅ 默认值: `https://shopd.mtkj2025.com`
- ✅ 注释示例已更新
-
-#### ProductLinkServiceImpl.java
- ✅ 默认值: `https://shopd.mtkj2025.com`
-
-#### MtPayApplication.java
- ✅ 启动日志使用域名和HTTPS协议
- ✅ 前端地址提示: `https://shopd.mtkj2025.com`
-
-#### MtkjpayApplication.java
- ✅ 启动日志使用域名和HTTPS协议
- ✅ 前端地址提示: `https://shopd.mtkj2025.com`
-
-### 3. 前端配置
-
-#### .env.production
- ✅ `VITE_API_BASE_URL=/api`（相对路径，自动使用当前域名）
-
-#### config/index.js
- ✅ 使用相对路径，自动适配HTTPS域名
-
-## 📋 配置说明
-
-### 前端URL配置
- **配置值**: `https://shopd.mtkj2025.com`
- **用途**: 生成商品详情页链接
- **格式**: `https://shopd.mtkj2025.com/product/{linkCode}`
-
-### PayPal Webhook配置
- **配置值**: `https://shopd.mtkj2025.com/api/paypal/webhook`
- **要求**: PayPal只接受HTTPS（端口443）
- **说明**: 通过Nginx SSL转发到后端8082端口
-
-### 前端API请求
- **配置**: 相对路径 `/api`
- **说明**: 自动使用当前域名和协议（HTTPS）
- **实际请求**: `https://shopd.mtkj2025.com/api/xxx`
-
-## 🔧 服务器配置要求
-
-### Nginx配置
-需要确保Nginx配置支持：
-1. **HTTPS监听**（443端口）
-2. **SSL证书**（已配置）
-3. **强制HTTPS**（建议开启）
-4. **API反向代理**（转发到后端8082）
-
-### 防火墙
- ✅ 443端口已开放（HTTPS）
- ✅ 80端口已开放（HTTP，可重定向到HTTPS）
- ✅ 8082端口已开放（后端服务，仅内网访问）
-
-## 📝 下一步操作
-
-### 1. 重新打包后端
-```bash
-cd E:\MTKJPAY
-mvn clean package -DskipTests
-```
-
-### 2. 上传并部署
- 上传新的jar包到服务器
- 重启后端服务
-
-### 3. 更新PayPal控制台
- Webhook URL: `https://shopd.mtkj2025.com/api/paypal/webhook`
- 测试Webhook连接
-
-### 4. 验证配置
- 访问前端: `https://shopd.mtkj2025.com`
- 测试API: `https://shopd.mtkj2025.com/api/health`
- 创建商品，检查生成的链接是否为: `https://shopd.mtkj2025.com/product/xxxxx`
-
-## ⚠️ 重要提示
-
-1. **强制HTTPS**
-   - 在宝塔面板中开启"强制HTTPS"开关
-   - 确保所有HTTP请求自动重定向到HTTPS
-
-2. **商品链接生成**
-   - 所有生成的商品链接将使用: `https://shopd.mtkj2025.com/product/{linkCode}`
-   - 确保链接可以通过HTTPS正常访问
-
-3. **PayPal Webhook**
-   - 必须使用HTTPS域名
-   - 确保Nginx正确转发到后端
-   - 测试Webhook连接是否正常
-
-4. **前端访问**
-   - 前端通过HTTPS访问: `https://shopd.mtkj2025.com`
-   - API请求自动使用HTTPS: `https://shopd.mtkj2025.com/api/xxx`
-
-## ✅ 配置检查清单
-
- [x] 所有配置文件中的URL已更新为域名
- [x] 所有URL使用HTTPS协议
- [x] Java代码默认值已更新
- [x] 启动日志已更新
- [x] 前端使用相对路径（自动适配域名）
- [ ] 重新打包后端
- [ ] 上传并部署新版本
- [ ] 在宝塔面板开启"强制HTTPS"
- [ ] 更新PayPal控制台Webhook URL
- [ ] 验证所有功能正常
-
--- a/NGINX_SSL_CONFIG.md
+++ b/NGINX_SSL_CONFIG.md
@@ -1,190 +0,0 @@
-# Nginx SSL配置指南（PayPal Webhook必需）
-
-## 问题说明
-
-PayPal Webhook **只接受HTTPS（端口443）**的URL，不接受HTTP或其他端口。
-
-当前配置：
- ❌ `http://175.178.252.59:8082/api/paypal/webhook` - PayPal不接受
- ✅ `https://175.178.252.59/api/paypal/webhook` - PayPal接受
-
-## 解决方案
-
-需要通过Nginx配置SSL证书，将HTTPS请求转发到后端的HTTP服务。
-
-## 配置步骤
-
-### 1. 在宝塔面板中配置SSL证书
-
-1. **进入网站设置**
-   - 宝塔面板 → 网站 → 选择你的网站（175.178.252.59）
-   - 点击"设置" → "SSL"
-
-2. **申请或配置SSL证书**
-   
-   **选项A：使用Let's Encrypt免费证书（推荐）**
-   - 点击"Let's Encrypt"
-   - 输入域名（如果有）或使用IP地址
-   - 点击"申请"
-   - 等待证书申请完成
-   
-   **选项B：使用自签名证书（仅测试用）**
-   - 点击"自签证书"
-   - 生成自签名证书
-   - ⚠️ 注意：自签名证书PayPal可能不接受，建议使用Let's Encrypt
-
-3. **启用HTTPS**
-   - 证书申请成功后，点击"强制HTTPS"
-   - 保存配置
-
-### 2. 配置Nginx反向代理（SSL）
-
-在宝塔面板中：
-1. 网站 → 设置 → 配置文件
-2. 找到 `location /api/` 配置块
-3. 确保配置如下：
-
-```nginx
-# HTTP请求重定向到HTTPS（可选，如果启用了强制HTTPS）
-# server {
-#     listen 80;
-#     server_name 175.178.252.59;
-#     return 301 https://$server_name$request_uri;
-# }
-
-# HTTPS服务器配置
-server {
-    listen 443 ssl http2;
-    listen [::]:443 ssl http2;
-    server_name 175.178.252.59;
-    
-    # SSL证书配置（宝塔会自动配置）
-    ssl_certificate /www/server/panel/vhost/cert/175.178.252.59/fullchain.pem;
-    ssl_certificate_key /www/server/panel/vhost/cert/175.178.252.59/privkey.pem;
-    
-    # SSL配置（宝塔会自动配置）
-    ssl_protocols TLSv1.2 TLSv1.3;
-    ssl_ciphers HIGH:!aNULL:!MD5;
-    ssl_prefer_server_ciphers on;
-    
-    root /www/wwwroot/175.178.252.59;
-    index index.html index.htm;
-    
-    # 前端路由配置
-    location / {
-        try_files $uri $uri/ /index.html;
-    }
-    
-    # API反向代理（关键配置）
-    location /api/ {
-        proxy_pass http://127.0.0.1:8082;  # 转发到后端HTTP服务
-        proxy_set_header Host $host;
-        proxy_set_header X-Real-IP $remote_addr;
-        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-        proxy_set_header X-Forwarded-Proto $scheme;  # 传递原始协议（HTTPS）
-        
-        # WebSocket支持（如果需要）
-        proxy_http_version 1.1;
-        proxy_set_header Upgrade $http_upgrade;
-        proxy_set_header Connection "upgrade";
-        
-        # 超时配置
-        proxy_connect_timeout 60s;
-        proxy_send_timeout 60s;
-        proxy_read_timeout 60s;
-    }
-    
-    # 静态资源缓存
-    location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
-        expires 30d;
-    }
-    
-    location ~ .*\.(js|css)?$ {
-        expires 12h;
-    }
-}
-```
-
-### 3. 修改后端配置
-
-后端配置文件已更新：
- `application-dev.yml`: `paypal.webhook-url: https://175.178.252.59/api/paypal/webhook`
-
-### 4. 更新PayPal控制台
-
-在PayPal控制台中配置Webhook URL：
- **Webhook URL**: `https://175.178.252.59/api/paypal/webhook`
- ✅ 使用HTTPS（不是HTTP）
- ✅ 不指定端口（默认443）
- ✅ 通过Nginx转发到后端
-
-### 5. 验证配置
-
-1. **测试HTTPS访问**
-   ```bash
-   curl https://175.178.252.59/api/health
-   ```
-
-2. **测试Webhook端点**
-   ```bash
-   curl -X POST https://175.178.252.59/api/paypal/webhook \
-     -H "Content-Type: application/json" \
-     -d '{"test": "data"}'
-   ```
-
-3. **检查PayPal Webhook配置**
-   - 在PayPal控制台测试Webhook
-   - 应该不再显示端口错误
-
-## 重要提示
-
-1. **SSL证书是必需的**
-   - PayPal只接受HTTPS
-   - 建议使用Let's Encrypt免费证书
-   - 自签名证书PayPal可能不接受
-
-2. **Nginx配置要点**
-   - 监听443端口（HTTPS）
-   - 将 `/api/` 请求转发到 `http://127.0.0.1:8082`
-   - 设置 `X-Forwarded-Proto` 头，让后端知道原始请求是HTTPS
-
-3. **后端不需要修改**
-   - 后端仍然监听8082端口（HTTP）
-   - Nginx负责SSL终止和转发
-
-4. **防火墙配置**
-   - 确保443端口已开放
-   - 80端口可以重定向到443
-
-## 常见问题
-
-### Q1: 没有域名，只有IP地址，能申请SSL证书吗？
-
-**A:** Let's Encrypt需要域名，不能为IP地址签发证书。解决方案：
- 使用自签名证书（PayPal可能不接受）
- 使用内网穿透服务（如ngrok、cpolar）提供HTTPS
- 申请一个域名并解析到服务器IP
-
-### Q2: 使用自签名证书PayPal会接受吗？
-
-**A:** 通常不会。PayPal会验证SSL证书的有效性，自签名证书会被拒绝。建议：
- 使用Let's Encrypt免费证书（需要域名）
- 或使用内网穿透服务
-
-### Q3: 如何测试Webhook是否正常工作？
-
-**A:** 
-1. 在PayPal控制台发送测试Webhook
-2. 查看后端日志，确认收到请求
-3. 检查Nginx访问日志和错误日志
-
-## 配置检查清单
-
- [ ] SSL证书已申请并配置
- [ ] Nginx监听443端口
- [ ] `/api/` 路径正确转发到 `http://127.0.0.1:8082`
- [ ] 后端配置中的webhook URL已改为HTTPS
- [ ] PayPal控制台Webhook URL已更新为 `https://175.178.252.59/api/paypal/webhook`
- [ ] 443端口已开放防火墙
- [ ] 测试HTTPS访问正常
-
--- a/PROJECT_IMPROVEMENT_PLAN.md
+++ b/PROJECT_IMPROVEMENT_PLAN.md
@@ -1,39 +0,0 @@
-# 项目改进计划
-
-## 已完成功能
-
- ✅ 商品管理（创建、查询、下架、分页）
- ✅ 订单管理（创建、查询、分页、状态管理）
- ✅ PayPal支付集成（创建订单、捕获支付、Webhook处理）
- ✅ 库存管理（扣减、恢复）
- ✅ 货币转换（实时汇率、多币种支持）
- ✅ ERP用户系统（注册、登录、信息管理）
- ✅ 国际化支持（6种语言）
-
-## 待实现功能（按优先级）
-
-### 高优先级
-1. **商品编辑功能** - 支持修改商品信息
-2. **订单详情页面** - 显示完整订单和支付信息
-3. **订单状态管理** - 发货、完成、取消功能
-4. **密码加密升级** - MD5升级为BCrypt
-
-### 中优先级
-5. **JWT Token实现** - 替换MD5+Base64 Token
-6. **Redis缓存集成** - PayPal token和汇率缓存
-7. **角色权限系统** - 角色和权限管理
-8. **操作日志系统** - 记录用户操作
-
-### 低优先级
-9. **单元测试** - 测试覆盖率>70%
-10. **Swagger文档** - API文档自动生成
-11. **数据统计** - 销售和订单统计
-12. **容器化部署** - Docker支持
-
-## 实施建议
-
-**第一阶段（1-2周）**：商品编辑、订单详情、订单状态管理、密码加密升级
-
-**第二阶段（2-3周）**：JWT Token、角色权限系统
-
-**第三阶段（3-4周）**：Redis缓存、操作日志、性能优化
--- a/PUBLIC_ACCESS_CHECKLIST.md
+++ b/PUBLIC_ACCESS_CHECKLIST.md
@@ -1,120 +0,0 @@
-# 公网访问配置检查清单
-
-## ✅ 已完成的配置修改
-
-### 1. 后端配置
-
-#### 端口配置
- ✅ `application-dev.yml`: `server.port: 8082`
- ✅ `application-prod.yml`: `server.port: ${server.port:8082}`
- ✅ `ProductServiceImpl.java`: 默认端口改为 `8082`
-
-#### 前端URL配置（用于生成商品链接）
- ✅ `application-dev.yml`: `app.frontend.url: http://175.178.252.59`
- ✅ `application-prod.yml`: `app.frontend.url: ${app.frontend.url:http://175.178.252.59}`
- ✅ `mt-startup/application-dev.yml`: `app.frontend.url: http://175.178.252.59`
- ✅ `mt-startup/application.yml`: `app.frontend.url: http://175.178.252.59`
- ✅ `ProductServiceImpl.java`: 默认值改为 `http://175.178.252.59`
- ✅ `ProductLinkServiceImpl.java`: 默认值改为 `http://175.178.252.59`
-
-#### PayPal Webhook配置
- ✅ `application-dev.yml`: `paypal.webhook-url: https://175.178.252.59/api/paypal/webhook`（HTTPS，PayPal要求）
-
-#### 启动类日志
- ✅ `MtPayApplication.java`: 启动日志使用公网地址
- ✅ `MtkjpayApplication.java`: 启动日志使用公网地址
-
-### 2. 前端配置
-
-#### API地址
- ✅ `.env.production`: `VITE_API_BASE_URL=/api`（相对路径，通过Nginx代理）
- ✅ `vite.config.js`: 开发环境代理（保留127.0.0.1，仅用于本地开发）
-
-### 3. 代码注释
- ✅ `ProductServiceImpl.java`: 注释中的示例URL已更新为公网地址
-
-## 📋 部署前检查清单
-
-### 后端检查
- [x] 端口配置为 `8082`
- [x] 前端URL配置为 `http://175.178.252.59`（无端口，通过Nginx访问）
- [x] PayPal Webhook URL配置为 `https://175.178.252.59/api/paypal/webhook`（HTTPS）
- [ ] 重新打包后端：`mvn clean package -DskipTests`
- [ ] 上传新的jar包到服务器
- [ ] 启动后端服务并确认监听在 `8082` 端口
-
-### 前端检查
- [x] `.env.production` 使用相对路径 `/api`
- [ ] 重新构建前端：`npm run build`
- [ ] 上传新的dist目录到服务器
-
-### Nginx配置检查
- [ ] `proxy_pass` 端口为 `8082`：
-  ```nginx
-  location /api/ {
-      proxy_pass http://127.0.0.1:8082;
-      ...
-  }
-  ```
- [ ] Nginx配置已保存并重载
-
-### PayPal配置检查
- [ ] **Nginx已配置SSL证书（PayPal Webhook必需，只接受HTTPS）**
- [ ] PayPal控制台Webhook URL已更新为：`https://175.178.252.59/api/paypal/webhook`
-
-### 防火墙检查
- [ ] 端口 `8082` 已开放（如果需要外部直接访问）
- [ ] 端口 `80` 已开放（Nginx前端访问）
-
-## 🔍 验证步骤
-
-### 1. 验证后端服务
-```bash
-# 在服务器上执行
-curl http://127.0.0.1:8082/api/health
-```
-
-### 2. 验证Nginx代理
-```bash
-# 在服务器上执行
-curl http://127.0.0.1/api/health
-```
-
-### 3. 验证商品链接生成
- 创建商品后，检查生成的链接是否为：`http://175.178.252.59/product/xxxxx`
- 不应包含 `localhost` 或端口号
-
-### 4. 验证前端访问
- 浏览器访问：`http://175.178.252.59`
- 检查浏览器控制台（F12）中的API请求
- 请求URL应为：`http://175.178.252.59/api/xxx`（通过Nginx代理）
-
-## ⚠️ 重要提示
-
-1. **前端URL不需要端口号**
-   - 配置为：`http://175.178.252.59`（不是 `http://175.178.252.59:3000`）
-   - 因为前端通过Nginx访问，默认使用80端口
-
-2. **后端API配置**
-   - PayPal Webhook通过Nginx HTTPS访问：`https://175.178.252.59/api/paypal/webhook`（Nginx转发到后端8082）
-   - 前端通过Nginx代理访问：`http://175.178.252.59/api/xxx`（Nginx转发到8082）
-   - ⚠️ **重要：** PayPal只接受HTTPS（端口443），必须配置SSL证书
-
-3. **商品链接生成**
-   - 使用 `app.frontend.url` 配置生成
-   - 格式：`{frontendUrl}/product/{linkCode}`
-   - 示例：`http://175.178.252.59/product/2563c74bd94c4a4b95abccf697a6c756`
-
-## 📝 修改总结
-
-所有 `localhost` 和硬编码地址已替换为公网地址 `175.178.252.59`：
- ✅ 配置文件中的URL
- ✅ Java代码中的默认值
- ✅ 启动日志中的提示信息
- ✅ 代码注释中的示例
-
-所有端口已统一为 `8082`：
- ✅ 后端服务端口
- ✅ PayPal Webhook URL
- ✅ 代码中的默认值
-
--- a/mt-pay/src/main/java/com/mtkj/mtpay/MtPayApplication.java
+++ b/mt-pay/src/main/java/com/mtkj/mtpay/MtPayApplication.java
@@ -32,9 +32,9 @@ public class MtPayApplication {
            String contextPath = env.getProperty("server.servlet.context-path", "");
            String activeProfiles = String.join(",", env.getActiveProfiles());
            
-            // 构建完整的访问地址（使用域名）
-            String serverHost = env.getProperty("app.server.host", "shopd.mtkj2025.com");
-            String protocol = env.getProperty("app.server.protocol", "https");
+            // 构建完整的访问地址（开发环境使用localhost，生产环境使用配置的域名）
+            String serverHost = env.getProperty("app.server.host", "localhost");
+            String protocol = env.getProperty("app.server.protocol", "http");
            String baseUrl = protocol + "://" + serverHost + ":" + serverPort + contextPath;
            String apiUrl = baseUrl + "/api";
            String druidUrl = baseUrl + "/druid";
@@ -73,7 +73,7 @@ public class MtPayApplication {
            log.info("""
                    
                    📌 提示：
-                       - 前端地址: https://shopd.mtkj2025.com
+                       - 前端代理地址: http://localhost:3000
                       - 后端API地址: {}
                       - 图片上传接口: {}/product/upload/image
                       - 商品管理接口: {}/product
--- a/mt-pay/src/main/java/com/mtkj/mtpay/service/impl/ProductLinkServiceImpl.java
+++ b/mt-pay/src/main/java/com/mtkj/mtpay/service/impl/ProductLinkServiceImpl.java
@@ -25,7 +25,7 @@ public class ProductLinkServiceImpl implements ProductLinkService {
    @Autowired
    private MtProductLinkMapper productLinkMapper;
    
-    @Value("${app.frontend.url:https://shopd.mtkj2025.com}")
+    @Value("${app.frontend.url:http://localhost:3000}")
    private String frontendUrl;
    
    private static final int DEFAULT_EXPIRE_DAYS = 90;
--- a/mt-pay/src/main/java/com/mtkj/mtpay/service/impl/ProductServiceImpl.java
+++ b/mt-pay/src/main/java/com/mtkj/mtpay/service/impl/ProductServiceImpl.java
@@ -72,7 +72,7 @@ public class ProductServiceImpl implements ProductService {
    /**
     * 前端访问地址（用于生成商品详情页URL）
     */
-    @Value("${app.frontend.url:https://shopd.mtkj2025.com}")
+    @Value("${app.frontend.url:http://localhost:3000}")
    private String frontendUrl;
    
    /**
@@ -858,7 +858,8 @@ public class ProductServiceImpl implements ProductService {
    /**
     * 从完整URL中提取链接码
     * 支持两种输入：
-     * 1. 完整URL：https://shopd.mtkj2025.com/product/2563c74bd94c4a4b95abccf697a6c756
+     * 1. 完整URL：http://localhost:3000/product/2563c74bd94c4a4b95abccf697a6c756（开发环境）
+     *             或 https://shopd.mtkj2025.com/product/2563c74bd94c4a4b95abccf697a6c756（生产环境）
     * 2. 链接码：2563c74bd94c4a4b95abccf697a6c756
     * 
     * @param input 用户输入的URL或链接码
--- a/mt-pay/src/main/resources/application-dev.yml
+++ b/mt-pay/src/main/resources/application-dev.yml
@@ -75,12 +75,11 @@ server:
      # 文件写入磁盘的阈值（超过此大小会写入临时文件）
      file-size-threshold: 2MB

-# 应用配置（所有环境通用）
+# 应用配置（开发环境）
 app:
-  # 前端访问地址（用于生成商品详情页URL等）
-  # 注意：已配置SSL证书，使用HTTPS和域名
+  # 前端访问地址（开发环境使用localhost）
  frontend:
-    url: https://shopd.mtkj2025.com
+    url: http://localhost:3000

 # 阿里云OSS相关配置（所有环境通用）
 aliyun:
@@ -112,10 +111,11 @@ paypal:
  mode: sandbox
  # 是否启用PayPal支付
  enabled: true
-  # Webhook URL（服务器公网地址，必须使用HTTPS，端口443）
+  # Webhook URL（开发环境使用内网穿透或测试地址）
  # 注意：PayPal只接受HTTPS（端口443）的Webhook URL
-  # 已配置SSL证书，使用域名访问
-  webhook-url: https://shopd.mtkj2025.com/api/paypal/webhook
+  # 开发环境可以使用内网穿透服务（如ngrok、cpolar）或留空
+  # 生产环境需要在application-prod.yml中配置
+  webhook-url: https://2646b437.r33.cpolar.top/api/paypal/webhook
  # Webhook ID（从PayPal控制台获取，用于验证Webhook签名）
  webhook-id: 0SX6117212808615P

--- a/mt-startup/src/main/java/com/mtkj/mtkjpay/MtkjpayApplication.java
+++ b/mt-startup/src/main/java/com/mtkj/mtkjpay/MtkjpayApplication.java
@@ -46,9 +46,9 @@ public class MtkjpayApplication {
            String contextPath = env.getProperty("server.servlet.context-path", "");
            String activeProfiles = String.join(",", env.getActiveProfiles());
            
-            // 构建完整的访问地址（使用域名）
-            String serverHost = env.getProperty("app.server.host", "shopd.mtkj2025.com");
-            String protocol = env.getProperty("app.server.protocol", "https");
+            // 构建完整的访问地址（开发环境使用localhost，生产环境使用配置的域名）
+            String serverHost = env.getProperty("app.server.host", "localhost");
+            String protocol = env.getProperty("app.server.protocol", "http");
            String baseUrl = protocol + "://" + serverHost + ":" + serverPort + contextPath;
            String apiUrl = baseUrl + "/api";
            String druidUrl = baseUrl + "/druid";
@@ -87,7 +87,7 @@ public class MtkjpayApplication {
            log.info("""
                    
                    📌 提示：
-                       - 前端地址: https://shopd.mtkj2025.com
+                       - 前端代理地址: http://localhost:3000
                       - 后端API地址: {}
                       - 图片上传接口: {}/product/upload/image
                       - 商品管理接口: {}/product
--- a/mt-startup/src/main/resources/application-dev.yml
+++ b/mt-startup/src/main/resources/application-dev.yml
@@ -74,11 +74,11 @@ server:
      # 文件写入磁盘的阈值（超过此大小会写入临时文件）
      file-size-threshold: 2MB

-# 应用配置（所有环境通用）
+# 应用配置（开发环境）
 app:
-  # 前端访问地址（已配置SSL证书，使用HTTPS和域名）
+  # 前端访问地址（开发环境使用localhost）
  frontend:
-    url: https://shopd.mtkj2025.com
+    url: http://localhost:3000

 # 阿里云OSS相关配置（所有环境通用）
 aliyun:
--- a/mt-startup/src/main/resources/application-prod.yml
+++ b/mt-startup/src/main/resources/application-prod.yml
@@ -0,0 +1,108 @@
+spring:
+  datasource:
+    type: com.alibaba.druid.pool.DruidDataSource
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    druid:
+      # 主库数据源（生产环境）
+      master:
+        url: ${prod.db.url}
+        username: ${prod.db.username}
+        password: ${prod.db.password}
+        # 初始连接数
+        initial-size: 5
+        # 最小连接池数量
+        min-idle: 10
+        # 最大连接池数量
+        max-active: 200
+        # 配置获取连接等待超时的时间
+        max-wait: 60000
+        # 配置连接超时时间
+        connect-timeout: 30000
+        # 配置网络超时时间
+        socket-timeout: 60000
+        # 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒
+        time-between-eviction-runs-millis: 60000
+        # 配置一个连接在池中最小生存的时间，单位是毫秒
+        min-evictable-idle-time-millis: 300000
+        # 配置一个连接在池中最大生存的时间，单位是毫秒
+        max-evictable-idle-time-millis: 900000
+        # 配置检测连接是否有效
+        validation-query: SELECT 1 FROM DUAL
+        test-while-idle: true
+        test-on-borrow: false
+        test-on-return: false
+      # 从库数据源
+      slave:
+        # 从数据源开关/默认关闭
+        enabled: false
+        url:
+        username:
+        password:
+      # Druid监控配置
+      web-stat-filter:
+        enabled: true
+      stat-view-servlet:
+        enabled: true
+        # 设置白名单，不填则允许所有访问
+        allow:
+        url-pattern: /druid/*
+        # 控制台管理用户名和密码
+        login-username: ruoyi
+        login-password: 123456
+      filter:
+        stat:
+          enabled: true
+          # 慢SQL记录
+          log-slow-sql: false
+          slow-sql-millis: 1000
+          merge-sql: true
+        wall:
+          config:
+            multi-statement-allow: true
+
+# 服务器配置
+server:
+  port: ${server.port:8082}
+  servlet:
+    context-path: /
+    multipart:
+      max-file-size: 10MB
+      max-request-size: 50MB
+      file-size-threshold: 2MB
+
+# 应用配置（生产环境）
+app:
+  # 前端访问地址（已配置SSL证书，使用HTTPS和域名）
+  # 支持通过环境变量覆盖：-Dapp.frontend.url=https://your-domain.com
+  frontend:
+    url: ${app.frontend.url:https://shopd.mtkj2025.com}
+
+# PingPong支付配置（生产环境）
+pingpong:
+  client-id: ${pingpong.client-id}
+  acc-id: ${pingpong.acc-id}
+  secret: ${pingpong.secret}
+  sign-type: MD5
+  gateway: https://acquirer-payment.pingpongx.com
+  mode: build
+  enabled: false
+
+# PayPal支付配置（生产环境）
+# 注意：当前为测试环境，使用沙箱凭证
+# 正式环境需要替换为生产环境的Client ID和Secret
+paypal:
+  # PayPal Client ID（API密钥）- 从环境变量或配置中心获取
+  client-id: ${paypal.client-id:AdGYUZpvLuHR30dybOApvM-RNB1pVKtd74SVfh-6TK52xV-1JEBddHVMCWuDdyyHri4DXd4kABBi7Icb}
+  # PayPal Client Secret（密钥）- 从环境变量或配置中心获取
+  client-secret: ${paypal.client-secret:ENblspyRmwsOU_PWFurlhEYUF5Da6aYKl0pjK4ehm7p3R5aSqvbpaF_YsIIs8v0ty1c9WJu15XP-Fe_1}
+  # 环境模式：sandbox（沙箱）或 production（生产）
+  # 当前为测试环境，使用sandbox
+  mode: ${paypal.mode:sandbox}
+  # 是否启用PayPal支付
+  enabled: ${paypal.enabled:true}
+  # Webhook URL（已配置SSL证书，使用HTTPS和域名）
+  # 支持通过环境变量覆盖：-Dpaypal.webhook-url=https://your-domain.com/api/paypal/webhook
+  webhook-url: ${paypal.webhook-url:https://shopd.mtkj2025.com/api/paypal/webhook}
+  # Webhook ID（从PayPal控制台获取）
+  webhook-id: ${paypal.webhook-id:}
+
--- a/mt-startup/src/main/resources/application.yml
+++ b/mt-startup/src/main/resources/application.yml
@@ -1,91 +1,3 @@
 spring:
-  application:
-    name: MTKJPAY
  profiles:
    active: dev
-  datasource:
-    type: com.alibaba.druid.pool.DruidDataSource
-    driver-class-name: com.mysql.cj.jdbc.Driver
-    druid:
-      # 从库数据源
-      slave:
-        # 从数据源开关/默认关闭
-        enabled: false
-        url:
-        username:
-        password:
-      # Druid监控配置
-      web-stat-filter:
-        enabled: true
-      stat-view-servlet:
-        enabled: true
-        # 设置白名单，不填则允许所有访问
-        allow:
-        url-pattern: /druid/*
-        # 控制台管理用户名和密码
-        login-username: ruoyi
-        login-password: 123456
-      filter:
-        stat:
-          enabled: true
-          # 慢SQL记录
-          log-slow-sql: false
-          slow-sql-millis: 1000
-          merge-sql: true
-        wall:
-          config:
-            multi-statement-allow: true
-  # MyBatis-Plus配置
-  mybatis-plus:
-    # 配置扫描mapper.xml文件路径
-    mapper-locations: classpath*:/mapper/**/*.xml
-    # 配置实体类包路径
-    type-aliases-package: com.mtkj.mtpay.entity
-    # 配置MyBatis-Plus全局配置
-    configuration:
-      # 开启驼峰命名转换
-      map-underscore-to-camel-case: true
-      # 开启二级缓存
-      cache-enabled: false
-      # 日志实现
-      log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
-    # 全局配置
-    global-config:
-      db-config:
-        # 主键类型：AUTO-数据库自增
-        id-type: auto
-        # 逻辑删除字段
-        logic-delete-field: deleted
-        # 逻辑删除值
-        logic-delete-value: 1
-        # 逻辑未删除值
-        logic-not-delete-value: 0
-
-# 服务器配置（所有环境通用）
-server:
-  port: 8082
-  servlet:
-    context-path: /
-    # 文件上传配置
-    multipart:
-      # 单个文件最大大小（10MB）
-      max-file-size: 10MB
-      # 请求最大大小（50MB，支持多文件上传）
-      max-request-size: 50MB
-      # 文件写入磁盘的阈值（超过此大小会写入临时文件）
-      file-size-threshold: 2MB
-
-# 应用配置（所有环境通用）
-app:
-  # 前端访问地址（已配置SSL证书，使用HTTPS和域名）
-  frontend:
-    url: https://shopd.mtkj2025.com
-
-# 阿里云OSS相关配置（所有环境通用）
-aliyun:
-  oss:
-    accessId: LTAI5tHbwvzWfANvNxju2yN1
-    accessKey: sAQR2swByBgmMOofH97hSJT638aVcJ
-    endpoint: https://oss-cn-hangzhou.aliyuncs.com
-    bucketName: mtkj2025
-