204 lines
4.5 KiB
Markdown
204 lines
4.5 KiB
Markdown
# 配置指南
|
|
|
|
本文档说明如何配置海外预约小程序的各项参数。
|
|
|
|
## API 配置
|
|
|
|
### 开发环境
|
|
```javascript
|
|
Config.API_BASE_URL = 'http://localhost:3000'
|
|
```
|
|
|
|
### 生产环境
|
|
部署到生产环境时，需要修改为实际的服务器地址：
|
|
```javascript
|
|
Config.API_BASE_URL = 'https://your-domain.com'
|
|
```
|
|
|
|
## 上传配置
|
|
|
|
### 上传服务类型
|
|
|
|
项目支持多种上传方式：
|
|
|
|
1. **server** - 本地服务器上传（推荐开发环境使用）
|
|
```javascript
|
|
Config.UPLOAD_SERVICE_TYPE = 'server'
|
|
```
|
|
|
|
2. **cos** - 腾讯云 COS 对象存储
|
|
```javascript
|
|
Config.UPLOAD_SERVICE_TYPE = 'cos'
|
|
Config.UPLOAD_CONFIG.cosDomain = 'https://your-bucket.cos.region.myqcloud.com'
|
|
```
|
|
|
|
3. **aliyun** - 阿里云 OSS 对象存储
|
|
```javascript
|
|
Config.UPLOAD_SERVICE_TYPE = 'aliyun'
|
|
```
|
|
|
|
4. **qiniu** - 七牛云存储
|
|
```javascript
|
|
Config.UPLOAD_SERVICE_TYPE = 'qiniu'
|
|
```
|
|
|
|
### 上传限制配置
|
|
|
|
```javascript
|
|
Config.UPLOAD_CONFIG = {
|
|
imageQuality: 80, // 图片压缩质量 (0-100)
|
|
imageMaxSize: 5 * 1024 * 1024, // 图片最大 5MB
|
|
videoMaxSize: 50 * 1024 * 1024 // 视频最大 50MB
|
|
}
|
|
```
|
|
|
|
### 不同场景的上传预设
|
|
|
|
```javascript
|
|
Config.UPLOAD_PRESETS = {
|
|
normal: {
|
|
imageQuality: 80,
|
|
imageMaxSize: 5 * 1024 * 1024 // 普通图片 5MB
|
|
},
|
|
avatar: {
|
|
imageQuality: 90,
|
|
imageMaxSize: 2 * 1024 * 1024 // 头像 2MB
|
|
},
|
|
qrcode: {
|
|
imageQuality: 85,
|
|
imageMaxSize: 3 * 1024 * 1024 // 收款码 3MB
|
|
}
|
|
}
|
|
```
|
|
|
|
## 业务配置
|
|
|
|
### 送花时间间隔
|
|
```javascript
|
|
Config.FLOWER_SEND_INTERVAL = 60 * 60 * 1000; // 1小时
|
|
```
|
|
|
|
## 环境切换
|
|
|
|
### 方法一：手动修改
|
|
直接修改 `modules/Config.js` 文件中的配置。
|
|
|
|
### 方法二：条件编译（推荐）
|
|
使用 uni-app 的条件编译功能：
|
|
|
|
```javascript
|
|
// #ifdef MP-WEIXIN
|
|
Config.API_BASE_URL = 'https://production-api.com'
|
|
// #endif
|
|
|
|
// #ifdef H5
|
|
Config.API_BASE_URL = 'http://localhost:3000'
|
|
// #endif
|
|
```
|
|
|
|
### 方法三：环境变量
|
|
创建不同的配置文件：
|
|
|
|
**Config.dev.js** (开发环境)
|
|
```javascript
|
|
export default {
|
|
API_BASE_URL: 'http://localhost:3000',
|
|
UPLOAD_SERVICE_TYPE: 'server'
|
|
}
|
|
```
|
|
|
|
**Config.prod.js** (生产环境)
|
|
```javascript
|
|
export default {
|
|
API_BASE_URL: 'https://api.your-domain.com',
|
|
UPLOAD_SERVICE_TYPE: 'cos'
|
|
}
|
|
```
|
|
|
|
然后在 `Config.js` 中根据环境导入：
|
|
```javascript
|
|
import DevConfig from './Config.dev.js'
|
|
import ProdConfig from './Config.prod.js'
|
|
|
|
const Config = process.env.NODE_ENV === 'production' ? ProdConfig : DevConfig
|
|
```
|
|
|
|
## 后端配置
|
|
|
|
后端配置文件位于 `backend/.env`，主要配置项：
|
|
|
|
```env
|
|
# 服务器端口
|
|
PORT=3000
|
|
|
|
# 数据库配置
|
|
DB_HOST=localhost
|
|
DB_PORT=3306
|
|
DB_NAME=overseas_appointment
|
|
DB_USER=root
|
|
DB_PASSWORD=your_password
|
|
|
|
# Redis配置
|
|
REDIS_HOST=localhost
|
|
REDIS_PORT=6379
|
|
|
|
# JWT密钥
|
|
JWT_SECRET=your-secret-key
|
|
JWT_EXPIRES_IN=7d
|
|
|
|
# 微信小程序配置
|
|
WECHAT_APP_ID=your_app_id
|
|
WECHAT_APP_SECRET=your_app_secret
|
|
|
|
# 文件上传配置
|
|
UPLOAD_PATH=./uploads
|
|
MAX_FILE_SIZE=5242880
|
|
```
|
|
|
|
## 部署检查清单
|
|
|
|
部署到生产环境前，请确认以下配置：
|
|
|
|
- [ ] 修改 `Config.API_BASE_URL` 为生产环境地址
|
|
- [ ] 配置正确的上传服务类型和参数
|
|
- [ ] 后端 `.env` 文件配置正确的数据库连接
|
|
- [ ] 后端 `.env` 文件配置正确的 Redis 连接
|
|
- [ ] 后端 `.env` 文件配置正确的微信小程序 AppID 和 AppSecret
|
|
- [ ] 后端 `JWT_SECRET` 使用强密码
|
|
- [ ] 检查文件上传路径和权限
|
|
- [ ] 配置 HTTPS 证书（生产环境必须）
|
|
- [ ] 配置 CORS 允许的域名
|
|
- [ ] 设置合适的速率限制参数
|
|
|
|
## 常见问题
|
|
|
|
### Q: 为什么登录失败？
|
|
A: 检查以下几点：
|
|
1. `Config.API_BASE_URL` 是否正确
|
|
2. 后端服务是否正常运行
|
|
3. 微信小程序 AppID 和 AppSecret 是否配置正确
|
|
4. 网络是否可以访问后端服务
|
|
|
|
### Q: 图片上传失败？
|
|
A: 检查以下几点：
|
|
1. 图片大小是否超过限制
|
|
2. 上传服务类型配置是否正确
|
|
3. 如果使用云存储，检查密钥配置
|
|
4. 检查后端上传目录权限
|
|
|
|
### Q: 如何在开发环境使用真实的后端服务？
|
|
A: 修改 `Config.API_BASE_URL` 为后端服务器的实际地址，例如：
|
|
```javascript
|
|
Config.API_BASE_URL = 'http://192.168.1.100:3000'
|
|
```
|
|
|
|
### Q: 如何配置多个环境（开发、测试、生产）？
|
|
A: 建议使用环境变量或条件编译，参考上面的"环境切换"章节。
|
|
|
|
## 技术支持
|
|
|
|
如有问题，请查看：
|
|
- 后端 API 文档: http://localhost:3000/api-docs/
|
|
- API 使用指南: `modules/api/API_GUIDE.md`
|
|
- 后端 README: `backend/README.md`
|