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,55 @@
openapi: 3.0.0
info:
title: 数据分析模块API
version: 1.0.0
description: 分析与报表最小契约(骨架)
paths:
/api/v1/analytics/overview:
get:
summary: 数据总览
tags: [分析]
security:
- bearerAuth: []
responses:
200:
description: 成功
/api/v1/analytics/users/{id}/ability:
get:
summary: 个人能力雷达
tags: [分析]
security:
- bearerAuth: []
parameters:
- in: path
name: id
required: true
schema: { type: integer }
responses:
200:
description: 成功
404:
description: 未找到
/api/v1/analytics/teams/{id}/overview:
get:
summary: 团队概况
tags: [分析]
security:
- bearerAuth: []
parameters:
- in: path
name: id
required: true
schema: { type: integer }
responses:
200:
description: 成功
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT

View File

@@ -0,0 +1,19 @@
# Agent-Analytics 开发检查清单(简版)
## 准备
- [ ] 阅读通用规范与架构文档
## 最小功能
- [ ] `GET /api/v1/analytics/overview` 总览
- [ ] `GET /api/v1/analytics/users/{id}/ability` 个人能力
- [ ] `GET /api/v1/analytics/teams/{id}/overview` 团队概况
## 安全与规范
- [ ] 登录必需;团队/全局需管理员
- [ ] 参数验证与统一异常
- [ ] 结构化日志覆盖关键操作
## 质量
- [ ] 单元测试覆盖率 ≥ 80%
- [ ] 通过 Black/isort/flake8/mypy
- [ ] API 与 `api_contract.yaml` 一致

View File

@@ -0,0 +1,18 @@
# Agent-Analytics 上下文(极简版)
## 位置
- 项目根:`/Users/nongjun/Desktop/Ai公司/本地开发与测试/kaopeilian-backend/`
- 工作目录:`app/api/v1/``app/services/``app/models/``app/schemas/`
## 依赖
- 输入依赖User组织/成员、Course课程、Exam成绩、Training陪练记录
- 输出接口:个人/团队能力概览、趋势、报表 API
## 关键约束
- 安全:登录必需;管理员可访问团队/全局数据
- 性能聚合查询缓存Redis热点数据 TTL 5-10 分钟
- 观测:耗时聚合打点记录(指标与标签)
## 最小运行信息
- 环境变量:复用通用 `.env`
- 关联模型/表:`analytics_snapshots``user_metrics``team_metrics``reports`

View File

@@ -0,0 +1,17 @@
# Agent-Analytics 示例(最小)
- 个人能力:
```python
# app/api/v1/analytics.py 片段(示例)
from fastapi import APIRouter, Depends
from app.api.deps import get_current_user
from app.schemas.base import ResponseModel
router = APIRouter()
@router.get("/users/{user_id}/ability")
async def user_ability(user_id: int):
# 省略聚合逻辑
return ResponseModel(code=200, message="success", data={"communication": 85})
```

View File

@@ -0,0 +1,22 @@
# Agent-Analytics 提示词(极简版)
## 必读引用
@子agent/00-通用基础/base_prompt.md
@子agent/00-通用基础/essential_docs.md
@考培练系统规划/后端开发拆分策略/模块分工指南.md
@考培练系统规划/后端开发拆分策略/协作机制设计.md
## 你的角色
- 本模块职责:学习与陪练数据聚合、能力评估、趋势与报表
- 依赖模块Auth、User、Course、Exam、Training
- 对外输出:个人/团队分析、趋势数据、报表生成 API
## 交付内容
- 代码:`app/api/v1/analytics.py``app/services/analytics_service.py`、相关 `app/models/``app/schemas/`
- 契约:本目录 `api_contract.yaml`OpenAPI 3.0
- 文档与测试:`checklist.md` 全通过,单元测试覆盖率 ≥ 80%
## 验收标准(最小集)
- API 与 `api_contract.yaml` 一致并通过基本集成测试
- 认证/权限依赖正常(读需登录)
- 输入校验、统一异常、结构化日志符合通用规范