Files
012-kaopeilian/docs/规划/后端开发拆分策略/子agent/00-通用基础/project_structure.md
111 998211c483 feat: 初始化考培练系统项目
- 从服务器拉取完整代码
- 按框架规范整理项目结构
- 配置 Drone CI 测试环境部署
- 包含后端(FastAPI)、前端(Vue3)、管理端

技术栈: Vue3 + TypeScript + FastAPI + MySQL
2026-01-24 19:33:28 +08:00

2.9 KiB

项目结构说明

项目根目录

/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. 提交代码