# Agent-User 上下文（极简版）

## 位置
- 项目根：`/Users/nongjun/Desktop/Ai公司/本地开发与测试/kaopeilian-backend/`
- 工作目录：`app/api/v1/`、`app/services/`、`app/models/`、`app/schemas/`

## 依赖
- 输入依赖：Auth 认证与角色检查（`get_current_user`、`require_admin`）、数据库与Redis
- 输出接口：用户与团队查询/维护 API 与服务方法，供 Course/Exam/Training/Analytics 使用

## 关键约束
- 安全：认证必需；普通用户仅能操作自身；管理员可管理全量
- 性能：用户列表分页查询 ≤ 200ms（本地）；常用筛选字段建索引
- 观测：登录、变更、角色调整等关键动作记录结构化日志

## 最小运行信息
- 环境变量：复用通用 `.env`，无新增必需项
- 测试账号：与 Auth 模块一致（superadmin/admin/testuser）
- 关联模型/表：`users`、`teams`、`user_teams`

## 开发完成状态
- ✅ 用户管理模块已完成
- ✅ 数据模型：User、Team、UserTeam
- ✅ 服务层：UserService（CRUD、认证、团队管理）
- ✅ Auth模块：登录、令牌刷新、登出
- ✅ API路由：用户和认证相关端点
- ✅ 数据库表结构已创建
- ⚠️ SQLAlchemy 2.0兼容性问题需要注意