64f5d567fa
Some checks failed
continuous-integration/drone/push Build is failing
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 格式
218 lines
4.4 KiB
Markdown
218 lines
4.4 KiB
Markdown
# 考培练系统 - 环境配置与部署指南
|
||
|
||
> 最后更新：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)
|
||
|
||
```bash
|
||
# 推送到 test 分支自动部署
|
||
git push cicd test
|
||
```
|
||
|
||
- **触发条件**：`test` 分支 push
|
||
- **部署目标**：kpl-dev 容器组
|
||
- **访问地址**：https://kpl.ireborn.com.cn
|
||
|
||
---
|
||
|
||
### 3.2 开发2环境 (主站)
|
||
|
||
```bash
|
||
# 推送到 dev2 分支自动部署
|
||
git push cicd dev2
|
||
```
|
||
|
||
- **触发条件**：`dev2` 分支 push
|
||
- **部署目标**：kaopeilian 主站容器
|
||
- **访问地址**：https://aiedu.ireborn.com.cn
|
||
|
||
---
|
||
|
||
### 3.3 生产环境 (租户)
|
||
|
||
```bash
|
||
# 推送到 main 分支，通过 commit message 控制部署范围
|
||
git push cicd main
|
||
```
|
||
|
||
#### 部署所有租户
|
||
|
||
```bash
|
||
git commit -m "feat: 新功能上线 [all]"
|
||
git push cicd main
|
||
```
|
||
|
||
#### 部署单个租户
|
||
|
||
```bash
|
||
git commit -m "fix: 修复问题 [hua]"
|
||
git push cicd main
|
||
```
|
||
|
||
#### 部署多个租户
|
||
|
||
```bash
|
||
git commit -m "feat: 功能更新 [cxw,yy,hl]"
|
||
git push cicd main
|
||
```
|
||
|
||
#### 默认行为
|
||
|
||
```bash
|
||
# 不带标签默认部署所有租户
|
||
git commit -m "feat: 常规更新"
|
||
git push cicd main
|
||
```
|
||
|
||
---
|
||
|
||
## 四、手动部署命令
|
||
|
||
### 4.1 SSH 登录服务器
|
||
|
||
```bash
|
||
ssh root@120.79.247.16
|
||
# 密码: Rxm88808
|
||
```
|
||
|
||
### 4.2 重启单个租户后端
|
||
|
||
```bash
|
||
cd /root/aiedu
|
||
docker restart cxw-backend
|
||
```
|
||
|
||
### 4.3 重建单个租户后端
|
||
|
||
```bash
|
||
cd /root/aiedu
|
||
docker-compose -f docker-compose.prod-multi.yml up -d --build --no-deps cxw-backend
|
||
```
|
||
|
||
### 4.4 查看日志
|
||
|
||
```bash
|
||
docker logs -f cxw-backend --tail 100
|
||
```
|
||
|
||
### 4.5 重新编译前端（所有租户共享）
|
||
|
||
```bash
|
||
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** |
|
||
|
||
### 查看所有容器
|
||
|
||
```bash
|
||
docker ps --format 'table {{.Names}}\t{{.Status}}'
|
||
```
|
||
|
||
---
|
||
|
||
## 七、测试账户
|
||
|
||
| 角色 | 用户名 | 密码 |
|
||
|------|--------|------|
|
||
| 系统管理员 | admin | Admin123! |
|
||
| 培训经理 | manager | Admin123! |
|
||
| 测试学员 | testuser | Admin123! |
|
||
|
||
---
|
||
|
||
## 八、注意事项
|
||
|
||
1. **前端共享**：所有生产租户共享同一套前端代码，编译一次全部更新
|
||
2. **后端独立**：每个租户有独立的后端容器和数据库
|
||
3. **域名解析**：
|
||
- `*.ireborn.com.cn` 解析到 120.79.242.43（SCRM服务器）
|
||
- `*.kpl.ireborn.com.cn` 解析到 120.79.247.16（考培练服务器）
|
||
4. **SSL证书**：使用 Let's Encrypt，自动续期
|
||
|
||
---
|
||
|
||
## 九、Git 仓库配置
|
||
|
||
```bash
|
||
# 查看远程仓库
|
||
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 # 部署生产
|
||
```
|