first commit

miniprogram/MINIPROGRAM_ENV_CONFIG.md

@@ -0,0 +1,141 @@
+# 小程序多环境配置说明
+
+## 📝 配置文件
+
+文件位置: `miniprogram/miniprogram/config/api.ts`
+
+## 🎯 环境说明
+
+小程序支持三种环境,会根据运行版本**自动切换**:
+
+| 小程序版本 | 环境 | 说明 |
+|-----------|------|------|
+| 开发版 (develop) | `dev` | 微信开发者工具、真机调试 |
+| 体验版 (trial) | `test` | 上传体验版后自动使用 |
+| 正式版 (release) | `prod` | 发布正式版后自动使用 |
+
+## ⚙️ 配置方法
+
+### 修改后端地址
+
+编辑 `api.ts` 文件中的 `API_CONFIG` 配置:
+
+```typescript
+const API_CONFIG: Record<EnvType, EnvConfig> = {
+  // 开发环境 - 本地开发
+  dev: {
+    baseURL: 'http://localhost:8080',           // 本地Go服务
+    pythonURL: 'http://localhost:8000',          // 本地Python服务
+    timeout: 30000
+  },
+  
+  // 测试环境 - 服务器测试
+  test: {
+    baseURL: 'http://8.149.233.36:8070',         // 测试服务器Go服务
+    pythonURL: 'http://8.149.233.36:8000',       // 测试服务器Python服务
+    timeout: 30000
+  },
+  
+  // 生产环境
+  prod: {
+    baseURL: 'https://api.yourdomain.com',       // 生产环境Go服务 (需修改)
+    pythonURL: 'https://python.yourdomain.com',  // 生产环境Python服务 (需修改)
+    timeout: 30000
+  }
+};
+```
+
+### 配置项说明
+
+- **baseURL**: 主服务地址 (Go Backend)
+- **pythonURL**: Python 服务地址 (可选,用于小红书发布等功能)
+- **timeout**: 请求超时时间 (毫秒)
+
+## 🚀 使用示例
+
+### 1. 本地开发
+- 在微信开发者工具中打开项目
+- 自动使用 `dev` 环境配置
+- 后端地址: `http://localhost:8080`
+
+### 2. 服务器测试
+- 点击"上传"按钮上传代码
+- 在微信公众平台设置为体验版
+- 自动使用 `test` 环境配置
+- 后端地址: `http://8.149.233.36:8070`
+
+### 3. 正式发布
+- 提交审核并发布
+- 自动使用 `prod` 环境配置
+- 后端地址: `https://api.yourdomain.com` (**需先修改配置**)
+
+## 🔍 调试信息
+
+启动小程序时,会在控制台输出当前环境信息:
+
+```
+[API Config] 当前环境: dev
+[API Config] 主服务: http://localhost:8080
+[API Config] Python服务: http://localhost:8000
+```
+
+可在微信开发者工具的控制台查看。
+
+## ⚠️ 注意事项
+
+1. **生产环境必须修改**: 发布前务必将 `prod` 配置中的域名修改为实际的生产服务器地址
+
+2. **域名配置**: 小程序只能访问已在微信公众平台配置的合法域名
+   - 登录 [微信公众平台](https://mp.weixin.qq.com/)
+   - 进入"开发" → "开发管理" → "开发设置"
+   - 在"服务器域名"中添加你的域名
+
+3. **HTTPS要求**: 正式版必须使用 HTTPS 协议 (开发工具可以关闭校验)
+
+4. **环境隔离**: 不同环境使用不同的数据库,避免测试数据污染生产数据
+
+## 📋 快速检查清单
+
+发布前检查:
+
+- [ ] 已修改 `prod.baseURL` 为实际生产地址
+- [ ] 已修改 `prod.pythonURL` 为实际生产地址 (如果使用)
+- [ ] 生产域名已在微信公众平台配置
+- [ ] 生产服务器使用 HTTPS 协议
+- [ ] Go 后端服务已部署并启动
+- [ ] Python 服务已部署并启动 (如果使用)
+
+## 🛠 技术说明
+
+### 环境自动检测
+
+通过微信 API 自动检测:
+
+```typescript
+function detectEnvironment(): EnvType {
+  const accountInfo = wx.getAccountInfoSync();
+  const envVersion = accountInfo.miniProgram.envVersion;
+  
+  switch (envVersion) {
+    case 'develop': return 'dev';
+    case 'trial': return 'test';
+    case 'release': return 'prod';
+    default: return 'dev';
+  }
+}
+```
+
+### 动态配置加载
+
+所有 API 调用都会动态获取当前环境的配置:
+
+```typescript
+export const API = {
+  get baseURL(): string {
+    return currentConfig().baseURL;
+  },
+  // ...
+};
+```
+
+这样可以确保始终使用正确环境的后端地址。