998211c483
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
72 lines
2.9 KiB
Markdown
72 lines
2.9 KiB
Markdown
# 项目结构说明
|
|
|
|
## 项目根目录
|
|
```
|
|
/Users/nongjun/Desktop/Ai公司/本地开发与测试/kaopeilian-backend/
|
|
```
|
|
|
|
## 目录结构
|
|
```
|
|
kaopeilian-backend/
|
|
├── app/ # 应用主目录
|
|
│ ├── api/ # API路由
|
|
│ │ └── v1/ # API v1版本
|
|
│ │ ├── auth.py # 认证相关API
|
|
│ │ ├── users.py # 用户管理API
|
|
│ │ ├── courses.py # 课程管理API
|
|
│ │ ├── exams.py # 考试模块API
|
|
│ │ ├── training.py # 陪练模块API
|
|
│ │ ├── analytics.py # 数据分析API
|
|
│ │ └── admin.py # 系统管理API
|
|
│ ├── config/ # 配置管理
|
|
│ │ ├── settings.py # 系统配置
|
|
│ │ └── database.py # 数据库配置
|
|
│ ├── core/ # 核心功能
|
|
│ │ ├── deps.py # 依赖注入
|
|
│ │ ├── security.py # 安全相关
|
|
│ │ ├── exceptions.py # 异常定义
|
|
│ │ ├── logger.py # 日志配置
|
|
│ │ └── middleware.py # 中间件
|
|
│ ├── models/ # 数据库模型
|
|
│ │ ├── base.py # 基础模型
|
|
│ │ ├── user.py # 用户模型
|
|
│ │ ├── course.py # 课程模型
|
|
│ │ ├── exam.py # 考试模型
|
|
│ │ └── training.py # 陪练模型
|
|
│ ├── schemas/ # Pydantic模式
|
|
│ │ ├── base.py # 基础模式
|
|
│ │ ├── user.py # 用户模式
|
|
│ │ ├── course.py # 课程模式
|
|
│ │ ├── exam.py # 考试模式
|
|
│ │ └── training.py # 陪练模式
|
|
│ ├── services/ # 业务逻辑
|
|
│ │ ├── base_service.py # 基础服务类
|
|
│ │ ├── user_service.py # 用户服务
|
|
│ │ ├── course_service.py # 课程服务
|
|
│ │ ├── exam_service.py # 考试服务
|
|
│ │ ├── training_service.py # 陪练服务
|
|
│ │ └── ai/ # AI平台集成
|
|
│ │ ├── coze/ # Coze集成
|
|
│ │ └── dify/ # Dify集成
|
|
│ └── main.py # 应用入口
|
|
├── tests/ # 测试目录
|
|
├── migrations/ # 数据库迁移
|
|
├── requirements/ # 依赖管理
|
|
├── docker/ # Docker配置
|
|
└── docs/ # 项目文档
|
|
```
|
|
|
|
## 关键配置文件
|
|
- `.env` - 环境变量配置
|
|
- `Makefile` - 开发命令集合
|
|
- `docker-compose.yml` - Docker编排配置
|
|
- `requirements/base.txt` - 基础依赖
|
|
- `requirements/dev.txt` - 开发依赖
|
|
|
|
## 开发流程
|
|
1. 在对应的目录创建模块文件
|
|
2. 继承基础类进行开发
|
|
3. 编写测试用例
|
|
4. 运行代码检查
|
|
5. 提交代码
|