feat: 初始化考培练系统项目
- 从服务器拉取完整代码 - 按框架规范整理项目结构 - 配置 Drone CI 测试环境部署 - 包含后端(FastAPI)、前端(Vue3)、管理端 技术栈: Vue3 + TypeScript + FastAPI + MySQL
This commit is contained in:
55
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/api_contract.yaml
Normal file
55
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/api_contract.yaml
Normal 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
|
||||
19
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/checklist.md
Normal file
19
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/checklist.md
Normal 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` 一致
|
||||
18
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/context.md
Normal file
18
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/context.md
Normal 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`
|
||||
@@ -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})
|
||||
```
|
||||
22
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/prompt.md
Normal file
22
docs/规划/后端开发拆分策略/子agent/06-Agent-Analytics/prompt.md
Normal 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` 一致并通过基本集成测试
|
||||
- 认证/权限依赖正常(读需登录)
|
||||
- 输入校验、统一异常、结构化日志符合通用规范
|
||||
Reference in New Issue
Block a user