feat: 初始化考培练系统项目
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
71
docs/规划/后端开发拆分策略/子agent/00-通用基础/project_structure.md
Normal file
71
docs/规划/后端开发拆分策略/子agent/00-通用基础/project_structure.md
Normal file
@@ -0,0 +1,71 @@
|
||||
# 项目结构说明
|
||||
|
||||
## 项目根目录
|
||||
```
|
||||
/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. 提交代码
|
||||
Reference in New Issue
Block a user