Files
012-kaopeilian/docs/测试环境配置.md
yuliang_guo 64f5d567fa
Some checks failed
continuous-integration/drone/push Build is failing
feat: 实现 KPL 系统功能改进计划
1. 课程学习进度追踪
   - 新增 UserCourseProgress 和 UserMaterialProgress 模型
   - 新增 /api/v1/progress/* 进度追踪 API
   - 更新 admin.py 使用真实课程完成率数据

2. 路由权限检查完善
   - 新增前端 permissionChecker.ts 权限检查工具
   - 更新 router/guard.ts 实现团队和课程权限验证
   - 新增后端 permission_service.py

3. AI 陪练音频转文本
   - 新增 speech_recognition.py 语音识别服务
   - 新增 /api/v1/speech/* API
   - 更新 ai-practice-coze.vue 支持语音输入

4. 双人对练报告生成
   - 更新 practice_room_service.py 添加报告生成功能
   - 新增 /rooms/{room_code}/report API
   - 更新 duo-practice-report.vue 调用真实 API

5. 学习提醒推送
   - 新增 notification_service.py 通知服务
   - 新增 scheduler_service.py 定时任务服务
   - 支持钉钉、企微、站内消息推送

6. 智能学习推荐
   - 新增 recommendation_service.py 推荐服务
   - 新增 /api/v1/recommendations/* API
   - 支持错题、能力、进度、热门多维度推荐

7. 安全问题修复
   - DEBUG 默认值改为 False
   - 添加 SECRET_KEY 安全警告
   - 新增 check_security_settings() 检查函数

8. 证书 PDF 生成
   - 更新 certificate_service.py 添加 PDF 生成
   - 添加 weasyprint、Pillow、qrcode 依赖
   - 更新下载 API 支持 PDF 和 PNG 格式
2026-01-30 14:22:35 +08:00

4.4 KiB
Raw Blame History

考培练系统 - 环境配置与部署指南

最后更新2026-01-28

一、环境总览

环境 分支 域名 dist 目录 用途
测试环境 test https://kpl.ireborn.com.cn dist-test 功能开发测试
预生产 staging https://aiedu.ireborn.com.cn dist-staging 集成测试/预发布
生产环境 main 各租户域名 dist-prod 正式生产
超级管理后台 - https://admin.kpl.ireborn.com.cn - SaaS管理

二、租户列表

租户代码 名称 域名 前端端口 后端端口
hua 华尔倍丽 https://hua.ireborn.com.cn 3010 8010
yy 杨扬宠物 https://yy.ireborn.com.cn 3011 8011
hl 武汉禾丽 https://hl.ireborn.com.cn 3012 8012
xy 芯颜定制 https://xy.ireborn.com.cn 3013 8013
fw 飞沃 https://fw.ireborn.com.cn 3014 8014
ex 恩喜成都总院 https://ex.ireborn.com.cn 3015 8015
cxw 崔曦文 https://cxw.kpl.ireborn.com.cn 3016 8016

三、CI/CD 部署方式

3.1 开发1环境 (kpl-dev)

# 推送到 test 分支自动部署
git push cicd test

3.2 开发2环境 (主站)

# 推送到 dev2 分支自动部署
git push cicd dev2

3.3 生产环境 (租户)

# 推送到 main 分支,通过 commit message 控制部署范围
git push cicd main

部署所有租户

git commit -m "feat: 新功能上线 [all]"
git push cicd main

部署单个租户

git commit -m "fix: 修复问题 [hua]"
git push cicd main

部署多个租户

git commit -m "feat: 功能更新 [cxw,yy,hl]"
git push cicd main

默认行为

# 不带标签默认部署所有租户
git commit -m "feat: 常规更新"
git push cicd main

四、手动部署命令

4.1 SSH 登录服务器

ssh root@120.79.247.16
# 密码: Rxm88808

4.2 重启单个租户后端

cd /root/aiedu
docker restart cxw-backend

4.3 重建单个租户后端

cd /root/aiedu
docker-compose -f docker-compose.prod-multi.yml up -d --build --no-deps cxw-backend

4.4 查看日志

docker logs -f cxw-backend --tail 100

4.5 重新编译前端(所有租户共享)

cd /root/aiedu/kaopeilian-frontend
npm run build

五、数据库连接

5.1 生产共享 MySQL (prod-mysql)

  • 端口3309
  • 用户root
  • 密码ProdMySQL2025!@#
  • 数据库kaopeilian_hua, kaopeilian_yy, kaopeilian_hl, kaopeilian_xy, kaopeilian_fw, kaopeilian_ex, kaopeilian_cxw

5.2 开发测试 MySQL (kpl-mysql-dev)

  • 端口3308
  • 用户root
  • 密码nj861021
  • 数据库kaopeilian

5.3 主站 MySQL (kaopeilian-mysql)

  • 端口3307
  • 用户root
  • 密码nj861021
  • 数据库kaopeilian

六、容器管理

当前运行容器统计

类型 数量
前端容器 11
后端容器 11
Redis 10
MySQL 4
Nginx 1
总计 37

查看所有容器

docker ps --format 'table {{.Names}}\t{{.Status}}'

七、测试账户

角色 用户名 密码
系统管理员 admin Admin123!
培训经理 manager Admin123!
测试学员 testuser Admin123!

八、注意事项

  1. 前端共享:所有生产租户共享同一套前端代码,编译一次全部更新
  2. 后端独立:每个租户有独立的后端容器和数据库
  3. 域名解析
    • *.ireborn.com.cn 解析到 120.79.242.43SCRM服务器
    • *.kpl.ireborn.com.cn 解析到 120.79.247.16(考培练服务器)
  4. SSL证书:使用 Let's Encrypt自动续期

九、Git 仓库配置

# 查看远程仓库
git remote -v

# origin: GitHub 源代码仓库
# cicd: Gitea CI/CD 触发仓库

# 常规开发
git push origin main

# 触发部署
git push cicd test    # 部署开发1
git push cicd dev2    # 部署开发2
git push cicd main    # 部署生产