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

六、文件访问边界

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

七、注意事项

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

---

最后更新：2026-01-24