012-kaopeilian/CONTEXT.md

项目上下文

AI启动时必读此文件，快速了解项目全貌

一、项目信息

项目	内容
项目编号	012-考培练系统-2601
项目路径	projects/012-考培练系统-2601/
当前阶段	开发阶段
项目状态	🟢 活跃
启动日期	2026-01-24
技术栈	Vue3 + TypeScript + FastAPI + MySQL

二、AI启动指令

请依次阅读以下文件：

1. 框架层（了解规则）

   • ../../_framework/agents/00-框架总览.md
   • 检查 agents/ 是否有项目覆盖

2. 项目文档（了解当前状态）

   • docs/同步清单.md
   • docs/项目状态快照.md
   • docs/规划/系统架构.md

3. 技术文档

   • docs/README.md - 项目总览
   • backend/README.md - 后端开发指南

三、项目简介

考培练系统是一个革命性的员工能力提升平台，专为轻医美连锁品牌瑞小美打造。通过集成 Coze 和 Dify 双 AI 平台，实现智能化的培训、考核和陪练功能。

核心功能

• 智能考试系统：动态题目生成（千人千卷）、三轮考试机制
• AI陪练中心：模拟客户对话、语音交互支持
• 课程管理：知识点自动提取、分岗位内容推送
• 数据分析：能力雷达图、学习进度追踪

技术架构

层级	技术栈
前端	Vue3 + TypeScript + Element Plus + Vite
后端	Python 3.9+ + FastAPI + SQLAlchemy
数据库	MySQL 8.0 + Redis
AI平台	Dify（动态考试）+ Coze（AI陪练）
部署	Docker 容器化

四、项目结构

012-考培练系统-2601/
├── backend/              # 后端 (FastAPI)
│   ├── app/              # 应用主目录
│   │   ├── api/          # API路由
│   │   ├── models/       # 数据模型
│   │   ├── schemas/      # Pydantic schemas
│   │   └── services/     # 业务逻辑
│   └── requirements.txt
├── frontend/             # 用户端前端 (Vue3)
│   └── src/
│       ├── api/          # API调用
│       ├── views/        # 页面视图
│       └── components/   # 组件
├── admin-frontend/       # 管理端前端 (Vue3)
├── deploy/               # 部署配置
│   ├── docker/           # Docker compose 文件
│   ├── nginx/            # Nginx 配置
│   └── scripts/          # 启动/部署脚本
├── docs/                 # 文档
│   └── 规划/             # 系统规划文档
├── tests/                # 测试文件
├── 知识库/               # 开发记录、问题修复
└── .env.*                # 环境配置

五、关键配置

服务端口

服务	端口
前端	3001
后端 API	8000
MySQL	3306
Redis	6379

系统账户

角色	用户名	密码
超级管理员	superadmin	Superadmin123!
系统管理员	admin	Admin123!
测试学员	testuser	TestPass123!

数据库连接

• 服务器: 120.79.247.16
• 端口: 3306
• 数据库: kaopeilian

Git 仓库配置

Remote	地址	用途
origin	github.com/nongjun/ai-development-workspace	源代码主仓库
cicd	git.ai.ireborn.com.cn/admin/012-kaopeilian	CI/CD 触发仓库

服务器路径: /root/aiedu

使用方式:

# 常规开发（推送到 GitHub）
git push origin main

# 触发 CI/CD 部署
git push cicd main     # 生产环境（6个租户）
git push cicd test     # 测试环境（kpl.ireborn.com.cn）

CI/CD 配置

分支	环境	域名	动作
test	测试环境	https://kpl.ireborn.com.cn	重建 dev 容器
main	生产环境	6个租户域名	前端编译 + 后端重建

生产租户: hua, yy, hl, xy, fw, ex, cxw

租户端口分配

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

六、文件访问边界

区域	读取	写入
✅ 本项目目录	允许	允许
✅ _framework/	允许	⚠️ 需确认
⚠️ _private/	需许可	❌ 绝对禁止
❌ 其他项目	禁止	禁止

七、注意事项

• 多租户架构：支持多个机构独立部署（.env.fw, .env.hl 等）
• AI集成：需配置 Coze 和 Dify API 密钥
• 文件上传：使用 LibreOffice 转换 Office 文档

---

最后更新：2026-01-24