## 项目结构 ``` smart-question-bank/ ├── backend/ # 后端服务 │ ├── src/ # 源代码目录 │ │ ├── common/ # 公共模块 │ │ │ ├── constants.py # 常量定义 │ │ │ └── exceptions.py # 异常定义 │ │ ├── exception/ # 异常处理 │ │ │ ├── api_exception.py # API异常 │ │ │ ├── business_exception.py # 业务异常 │ │ │ └── handler.py # 异常处理器 │ │ ├── models/ # 数据模型 │ │ │ ├── base_model.py # 基础模型 │ │ │ ├── user.py # 用户模型 │ │ │ ├── question.py # 题目模型 │ │ │ ├── practice_record.py # 练习记录模型 │ │ │ ├── knowledge_point.py # 知识点模型 │ │ │ ├── exam_score.py # 考试成绩模型 │ │ │ ├── learning_path.py # 学习路径模型 │ │ │ ├── question_version.py # 题目版本模型 │ │ │ ├── question_review.py # 题目审核模型 │ │ │ ├── question_tag.py # 题目标签模型 │ │ │ ├── wrong_question.py # 错题模型 │ │ │ ├── wrong_question_reason.py # 错题原因模型 │ │ │ ├── wrong_question_tag.py # 错题标签模型 │ │ │ ├── learning_goal.py # 学习目标模型 │ │ │ ├── learning_style.py # 学习风格模型 │ │ │ ├── target_score.py # 目标分数模型 │ │ │ ├── exam.py # 考试模型 │ │ │ ├── exam_analysis.py # 考试分析模型 │ │ │ ├── learning_progress.py # 学习进度模型 │ │ │ ├── knowledge_graph.py # 知识图谱模型 │ │ │ ├── difficulty_assessment.py # 难度评估模型 │ │ │ ├── question_recommendation.py # 题目推荐模型 │ │ │ ├── adaptive_learning.py # 自适应学习模型 │ │ ├── store/ # 数据持久层 │ │ │ ├── user_store.py # 用户数据操作 │ │ │ ├── question_store.py # 题目数据操作 │ │ │ ├── practice_store.py # 练习数据操作 │ │ │ ├── knowledge_store.py # 知识点数据操作 │ │ │ ├── exam_store.py # 考试数据操作 │ │ │ ├── learning_path_store.py # 学习路径数据操作 │ │ │ ├── wrong_question_store.py # 错题数据操作 │ │ │ ├── learning_goal_store.py # 学习目标数据操作 │ │ │ ├── learning_style_store.py # 学习风格数据操作 │ │ │ ├── target_score_store.py # 目标分数数据操作 │ │ │ ├── exam_analysis_store.py # 考试分析数据操作 │ │ │ ├── learning_progress_store.py # 学习进度数据操作 │ │ │ ├── knowledge_graph_store.py # 知识图谱数据操作 │ │ │ ├── difficulty_assessment_store.py # 难度评估数据操作 │ │ │ ├── question_recommendation_store.py # 题目推荐数据操作 │ │ │ └── adaptive_learning_store.py # 自适应学习数据操作 │ │ ├── services/ # 业务逻辑 │ │ │ ├── auth_service.py # 认证服务 │ │ │ ├── question_service.py # 题目服务 │ │ │ ├── practice_service.py # 练习服务 │ │ │ ├── analysis_service.py # 分析服务 │ │ │ ├── exam_service.py # 考试服务 │ │ │ ├── learning_path_service.py # 学习路径服务 │ │ │ ├── wrong_question_service.py # 错题服务 │ │ │ ├── learning_goal_service.py # 学习目标服务 │ │ │ ├── learning_style_service.py # 学习风格服务 │ │ │ ├── target_score_service.py # 目标分数服务 │ │ │ ├── exam_analysis_service.py # 考试分析服务 │ │ │ ├── learning_progress_service.py # 学习进度服务 │ │ │ ├── knowledge_graph_service.py # 知识图谱服务 │ │ │ ├── difficulty_assessment_service.py # 难度评估服务 │ │ │ ├── question_recommendation_service.py # 题目推荐服务 │ │ │ └── adaptive_learning_service.py # 自适应学习服务 │ │ ├── controllers/ # API控制器 │ │ │ ├── auth_controller.py # 认证接口 │ │ │ ├── question_controller.py # 题目接口 │ │ │ ├── practice_controller.py # 练习接口 │ │ │ ├── analysis_controller.py # 分析接口 │ │ │ ├── exam_controller.py # 考试接口 │ │ │ ├── learning_path_controller.py # 学习路径接口 │ │ │ ├── wrong_question_controller.py # 错题接口 │ │ │ ├── learning_goal_controller.py # 学习目标接口 │ │ │ ├── learning_style_controller.py # 学习风格接口 │ │ │ ├── target_score_controller.py # 目标分数接口 │ │ │ ├── exam_analysis_controller.py # 考试分析接口 │ │ │ ├── learning_progress_controller.py # 学习进度接口 │ │ │ ├── knowledge_graph_controller.py # 知识图谱接口 │ │ │ ├── difficulty_assessment_controller.py # 难度评估接口 │ │ │ ├── question_recommendation_controller.py # 题目推荐接口 │ │ │ └── adaptive_learning_controller.py # 自适应学习接口 │ │ ├── middleware/ # 中间件 │ │ │ ├── auth_middleware.py # 认证中间件 │ │ │ ├── logging_middleware.py # 日志中间件 │ │ │ ├── error_middleware.py # 错误处理中间件 │ │ │ ├── request_handler.py # 请求处理中间件（合并请求校验、转换、过滤等功能） │ │ │ ├── response_handler.py # 响应处理中间件（合并响应格式化、压缩、加密等功能） │ │ │ ├── performance_monitor.py # 性能监控中间件（合并性能、指标、响应时间等） │ │ │ ├── security_middleware.py # 安全中间件（合并限流、权限、CORS等） │ │ │ └── tracing_middleware.py # 追踪中间件（合并请求ID、日志、追踪等） │ │ ├── config/ # 配置文件 │ │ │ ├── config_loader.py # 配置加载器。加载环境变量和配置文件，环境变量优先级高于配置文件 │ │ │ ├── application.yml # 主配置文件 │ │ │ ├── application-dev.yml # 开发环境配置 │ │ │ ├── application-prod.yml # 生产环境配置 │ │ │ └── application-test.yml # 测试环境配置 │ │ ├── database/ # 数据库相关 │ │ │ ├── connection/ # 数据库连接 │ │ │ │ └── mysql.py # MySQL连接 │ │ │ ├── migration/ # 数据库迁移 │ │ │ │ ├── alembic.ini # Alembic配置 │ │ │ │ └── versions/ # 迁移脚本 │ │ │ └── utils/ # 数据库工具 │ │ │ ├── query_builder.py # 查询构建器 │ │ │ └── pagination.py # 分页工具 │ │ ├── utils/ # 工具类 │ │ │ ├── logger.py # 日志配置 │ │ │ ├── date/ # 日期相关 │ │ │ │ ├── date_util.py # 日期工具 │ │ │ │ └── timezone.py # 时区处理 │ │ │ ├── string/ # 字符串处理 │ │ │ │ ├── string_util.py # 字符串工具 │ │ │ │ └── validator.py # 字符串验证 │ │ │ ├── file/ # 文件处理 │ │ │ │ ├── file_util.py # 文件工具 │ │ │ │ └── storage.py # 文件存储 │ │ │ └── network/ # 网络相关 │ │ │ ├── request.py # 请求工具 │ │ │ └── ip_util.py # IP工具 │ │ ├── tests/ # 测试相关 │ │ │ ├── unit/ # 单元测试 │ │ │ │ ├── models/ # 模型测试 │ │ │ │ ├── services/ # 服务测试 │ │ │ │ └── utils/ # 工具测试 │ │ │ ├── integration/ # 集成测试 │ │ │ │ ├── api/ # API测试 │ │ │ │ └── database/ # 数据库测试 │ │ │ ├── fixtures/ # 测试夹具 │ │ │ │ ├── data/ # 测试数据 │ │ │ │ └── mocks/ # Mock数据 │ │ │ └── e2e/ # 端到端测试 │ │ │ ├── api/ # API端到端测试 │ │ │ └── web/ # Web端到端测试 │ ├── requirements.txt # 依赖包列表 │ └── Dockerfile # Docker配置 ├── frontend/ # 前端应用 │ ├── public/ # 静态资源 │ │ ├── index.html # 主页面 │ │ ├── favicon.ico # 网站图标 │ │ └── robots.txt # 爬虫协议 │ ├── src/ # 源代码目录 │ │ ├── assets/ # 静态资源 │ │ │ ├── images/ # 图片资源 │ │ │ ├── fonts/ # 字体文件 │ │ │ └── styles/ # 全局样式 │ │ ├── components/ # 通用组件 │ │ │ ├── Header.vue # 头部组件 │ │ │ ├── Footer.vue # 底部组件 │ │ │ ├── QuestionCard.vue # 题目卡片 │ │ │ └── ProgressChart.vue # 进度图表 │ │ ├── views/ # 页面视图 │ │ │ ├── Home.vue # 首页 │ │ │ ├── Practice.vue # 练习页面 │ │ │ ├── Analysis.vue # 分析页面 │ │ │ └── Profile.vue # 个人中心 │ │ ├── router/ # 路由配置 │ │ │ └── index.js # 路由配置 │ │ ├── store/ # 状态管理 │ │ │ ├── modules/ # 模块 │ │ │ │ ├── auth.js # 认证模块 │ │ │ │ ├── question.js # 题目模块 │ │ │ │ └── practice.js # 练习模块 │ │ │ └── index.js # 状态管理入口 │ │ ├── api/ # API接口 │ │ │ ├── auth.js # 认证接口 │ │ │ ├── question.js # 题目接口 │ │ │ └── practice.js # 练习接口 │ │ ├── utils/ # 工具函数 │ │ │ ├── request.js # 请求封装 │ │ │ ├── date.js # 日期工具 │ │ │ └── validate.js # 验证工具 │ │ ├── styles/ # 全局样式 │ │ │ ├── variables.scss # 样式变量 │ │ │ ├── mixins.scss # 样式混合 │ │ │ └── global.scss # 全局样式 │ │ └── main.js # 程序入口 │ ├── tests/ # 测试目录 │ │ ├── unit/ # 单元测试 │ │ ├── integration/ # 集成测试 │ │ └── e2e/ # 端到端测试 │ ├── package.json # 项目配置 │ ├── vue.config.js # Vue配置 │ └── Dockerfile # Docker配置 ├── docs/ # 文档目录 │ ├── api/ # API文档 │ └── design/ # 设计文档 ├── scripts/ # 脚本目录 │ ├── deploy/ # 部署脚本 │ ├── migration/ # 数据迁移脚本 │ │ ├── migrations/ # 迁移文件目录 │ │ ├── __init__.py # 初始化文件 │ │ ├── alembic.ini # Alembic 配置文件 │ │ └── env.py # Alembic 环境配置 ├── docker-compose.yml # Docker Compose配置 ├── README.md # 项目说明 └── .gitignore # Git忽略配置 ```