0e5e6481ef
All checks were successful
continuous-integration/drone/push Build is passing
- .drone.yml: 添加 cxw-backend 到生产部署列表 - CONTEXT.md: 添加租户端口分配表，包含 cxw
165 lines
5.2 KiB
Markdown
165 lines
5.2 KiB
Markdown
# 项目上下文
|
||
|
||
> 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
|