# 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`
