appointment_system/CONFIG_GUIDE.md
2025-12-11 22:50:18 +08:00

4.5 KiB

配置指南

本文档说明如何配置海外预约小程序的各项参数。

API 配置

开发环境

Config.API_BASE_URL = 'http://localhost:3000'

生产环境

部署到生产环境时,需要修改为实际的服务器地址:

Config.API_BASE_URL = 'https://your-domain.com'

上传配置

上传服务类型

项目支持多种上传方式:

  1. server - 本地服务器上传(推荐开发环境使用)

    Config.UPLOAD_SERVICE_TYPE = 'server'
    
  2. cos - 腾讯云 COS 对象存储

    Config.UPLOAD_SERVICE_TYPE = 'cos'
    Config.UPLOAD_CONFIG.cosDomain = 'https://your-bucket.cos.region.myqcloud.com'
    
  3. aliyun - 阿里云 OSS 对象存储

    Config.UPLOAD_SERVICE_TYPE = 'aliyun'
    
  4. qiniu - 七牛云存储

    Config.UPLOAD_SERVICE_TYPE = 'qiniu'
    

上传限制配置

Config.UPLOAD_CONFIG = {
  imageQuality: 80,              // 图片压缩质量 (0-100)
  imageMaxSize: 5 * 1024 * 1024, // 图片最大 5MB
  videoMaxSize: 50 * 1024 * 1024 // 视频最大 50MB
}

不同场景的上传预设

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
  }
}

业务配置

送花时间间隔

Config.FLOWER_SEND_INTERVAL = 60 * 60 * 1000; // 1小时

环境切换

方法一:手动修改

直接修改 modules/Config.js 文件中的配置。

方法二:条件编译(推荐)

使用 uni-app 的条件编译功能:

// #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 (开发环境)

export default {
  API_BASE_URL: 'http://localhost:3000',
  UPLOAD_SERVICE_TYPE: 'server'
}

Config.prod.js (生产环境)

export default {
  API_BASE_URL: 'https://api.your-domain.com',
  UPLOAD_SERVICE_TYPE: 'cos'
}

然后在 Config.js 中根据环境导入:

import DevConfig from './Config.dev.js'
import ProdConfig from './Config.prod.js'

const Config = process.env.NODE_ENV === 'production' ? ProdConfig : DevConfig

后端配置

后端配置文件位于 backend/.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 为后端服务器的实际地址,例如:

Config.API_BASE_URL = 'http://192.168.1.100:3000'

Q: 如何配置多个环境(开发、测试、生产)?

A: 建议使用环境变量或条件编译,参考上面的"环境切换"章节。

技术支持

如有问题,请查看: