# 项目上下文

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

**使用方式**:
```bash
# 常规开发（推送到 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