feat: 班级管理增加分配目标功能，支持批量分配目标给班级所有学员

2026-04-24 09:24:24 +08:00
parent 8e0f6ec46d
commit 070533326a
4 changed files with 272 additions and 1 deletions
@@ -266,6 +266,45 @@ POST /api/classes/<id>/assign

 ---

+### 批量分配目标给班级学员
+
+```
+POST /api/classes/<id>/goals
+```
+
+**权限**: 登录用户
+
+**请求体**:
+```json
+{
+  "goal_id": 1,
+  "assessment_days": "30",
+  "assessment_date": null,
+  "start_date": null,
+  "start_now": true
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| goal_id | int | 是 | 目标ID |
+| assessment_days | string | 否 | 评估天数（15/30/60/90/180） |
+| assessment_date | string | 否 | 评估日期（YYYY-MM-DD），与 assessment_days 二选一 |
+| start_date | string | 否 | 开始日期（YYYY-MM-DD） |
+| start_now | bool | 否 | 是否立即开始（默认true） |
+
+**响应示例**:
+```json
+{
+  "message": "成功分配 5 个学员",
+  "assigned": 5,
+  "skipped": ["李四", "王五"],
+  "skipped_count": 2
+}
+```
+
+---
+
 ## 学员管理

 ### 获取学员列表