feat: add vocabulary review planning

docs/refactor/taro-frontend-integration.md

@@ -144,7 +144,7 @@ tenant:<tenantId>:theme
 | 练习历史/统计 | `GET /api/learning/practice-sessions/history`、`GET /api/learning/stats`、`GET /api/learning/trend` |
 | 题目视频 | `GET /api/questions/{questionId}/videos`、`POST /api/questions/videos/batch`、`POST /api/videos/play` |
 | 背单词 | `/api/catalog/vocabulary-units`、`/api/catalog/vocabulary-words` |
-| 单词进度 | `/api/learning/vocabulary/progress`、`/api/learning/vocabulary/stats` |
+| 单词进度/计划 | `/api/learning/vocabulary/progress`、`/api/learning/vocabulary/stats`、`/api/learning/vocabulary/review-plan`、`POST /api/learning/vocabulary/review` |
 | 单词收藏 | `/api/learning/vocabulary/favorites` |
 | 知识手册 | `/api/catalog/handbook-subjects`、`handbook-chapters`、`handbook-entries` |
 | 分数线 | `/api/scoreline/fields`、`schools`、`majors`、`records`、`trend`、`years` |
@@ -293,6 +293,52 @@ tenant:<tenantId>:theme
 - 收藏夹复习同理可调用 `POST /api/learning/practice-sessions`，body 为 `{ "mode": "favorite_review", "questionLimit": 20 }`。
 - 趋势图以接口返回日期桶为准，缺失日期后端会补 0，不需要前端补点。
 
+### 背单词计划与复习上报
+
+背单词页面分三类数据：单元列表、每日计划、单词进度。前端不需要计算下次复习日期，只提交“认识/不认识”，由后端统一更新 `nextReviewDate`、连续正确、掌握状态和每日复习计划。
+
+取今日计划：
+
+```http
+GET /api/learning/vocabulary/review-plan?unitId=<unitId>&reviewLimit=30&newLimit=20
+```
+
+响应关键字段：
+
+```json
+{
+  "item": {
+    "dueCount": 3,
+    "newCount": 20,
+    "totalPlanned": 23,
+    "dueWords": [{ "wordId": "...", "status": "reviewing", "dueLevel": "soon" }],
+    "newWords": [{ "wordId": "...", "status": "new", "dueLevel": "new" }],
+    "words": []
+  }
+}
+```
+
+上报单词复习结果：
+
+```json
+{
+  "wordId": "00000000-0000-0000-0000-000000000812",
+  "result": "known"
+}
+```
+
+`result` 可传：
+
+- `known`：认识/答对。
+- `unknown`：不认识/答错。
+
+前端处理规则：
+
+- `review-plan.words` 是本轮学习队列；卡片翻转、上一个、跳转、收藏状态属于前端交互。
+- 每个单词点击“认识/不认识”后调用 `POST /api/learning/vocabulary/review`。
+- 返回的 `status`、`dueLevel`、`nextReviewDate` 作为后续展示依据，不在前端重算间隔。
+- 旧的 `POST /api/learning/vocabulary/progress` 保留给兼容和后台手工修正；普通学习流优先用 `vocabulary/review`。
+
 ## 视频播放契约
 
 题目视频分为 `free`、`svip`、`video_quota` 三种访问模式。列表接口只用于展示标题、封面、时长、访问模式和试看秒数；除免费公开视频外，列表和搜索接口不会返回可播放 URL。