# 项目结构说明

## 项目根目录
```
/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. 提交代码
