feat: 初始化考培练系统项目

- 从服务器拉取完整代码
- 按框架规范整理项目结构
- 配置 Drone CI 测试环境部署
- 包含后端(FastAPI)、前端(Vue3)、管理端

技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
111
2026-01-24 19:33:28 +08:00
commit 998211c483
1197 changed files with 228429 additions and 0 deletions

View File

@@ -0,0 +1,70 @@
# Agent理解度测试清单
使用这个清单来验证Agent是否正确理解了项目上下文。
## 基础理解测试
### 1. 项目结构
项目根目录在哪里app目录下有哪些子目录
期望:能正确说出路径和主要目录结构
### 2. 开发规范
问:导入语句应该如何排序?
期望:标准库 -> 第三方库 -> 本地模块
### 3. 基础类
问:数据库模型应该继承哪个基类?
期望BaseModel可能还需要AuditMixin或SoftDeleteMixin
## 架构理解测试
### 4. 协作机制
什么是GlobalContext它的作用是什么
期望:能解释全局上下文的作用和使用方式
### 5. 模块边界
问:你的模块可以直接访问其他模块的数据库表吗?
期望:不可以,应该通过服务接口调用
### 6. 错误处理
如何处理外部服务如Coze调用失败
期望使用ExternalServiceError包含重试机制
## 具体实现测试
### 7. API响应
API响应应该使用什么格式
期望使用ResponseModel包装包含code、message、data
### 8. 依赖注入
如何在API中获取当前用户
期望使用Depends(get_current_user)
### 9. 日志记录
问:如何记录一个用户登录事件?
期望使用logger.info(),包含结构化数据
### 10. 测试要求
问:单元测试覆盖率要求是多少?
期望80%以上
## 评分标准
- 10个全部正确Agent完全理解项目
- 8-9个正确理解良好可以开始开发
- 6-7个正确需要补充部分文档
- 5个以下需要重新引用完整文档
## 使用方法
```
请回答以下问题来验证你对项目的理解:
1. 项目根目录在哪里?
2. 导入语句应该如何排序?
3. 数据库模型应该继承哪个基类?
4. 什么是GlobalContext
5. 你的模块可以直接访问其他模块的数据库表吗?
6. 如何处理外部服务调用失败?
7. API响应应该使用什么格式
8. 如何在API中获取当前用户
9. 如何记录一个用户登录事件?
10. 单元测试覆盖率要求是多少?
```