结构更新

docs/architecture/api-design.md

@@ -62,14 +62,7 @@
 - `GET /api/achievement/users/{userId}/records`
 - `GET /api/achievement/users/{userId}/progress`
 - `POST /api/achievement/events/trigger`
-
-### 3.4 推荐域（recommendation）
-- `POST /api/recommendation/tasks`
-- `GET /api/recommendation/tasks/{taskId}/items`
-- `POST /api/recommendation/items/{itemId}/feedback`
-- `GET /api/recommendation/effects/daily`
-
-### 3.5 AI 知识域（ai）
+### 3.4 AI 知识域（ai）
 - `POST /api/ai/knowledge/files`
 - `POST /api/ai/knowledge/files/{fileId}/sync`
 - `GET /api/ai/knowledge/sync-tasks/{taskId}`
@@ -78,5 +71,5 @@
 
 ## 4. API 阶段交付映射
 - M3：`auth + upms + file/message 基础扩展`
-- M5：`course + question + achievement + recommendation + ai`
+- M5：`course + question + achievement + ai`
 - M6：前后端按冻结 API 完成联调，不新增破坏性变更。

docs/architecture/er-diagram.md

@@ -3,7 +3,7 @@
 - 基础域：租户、组织、用户、角色、菜单、文件。
 - 课程域：课程、章节、学习节点、知识点、学习进度。
 - 习题与批改域：题库、试卷、作业、提交、批改、错题与复习。
-- 成就与推荐域：成就定义、用户成就、推荐任务、反馈、学习闭环。
+- 成就域：成就定义、用户成就与学习激励闭环。
 - AI 知识域：知识文件、同步任务、图谱实体/关系。
 
 ## 2. 核心关系图（基础域 + 教学主链路）
@@ -34,8 +34,6 @@ erDiagram
 
     USER_ACHIEVEMENT }o--|| ACHIEVEMENT : awarded
     USER_ACHIEVEMENT }o--|| SYS_USER : owner
-    RECOMMENDATION_TASK ||--o{ RECOMMENDATION_ITEM : produces
-    RECOMMENDATION_ITEM ||--o{ RECOMMENDATION_FEEDBACK : receives
 ```
 
 ## 3. AI 知识域关系图
@@ -72,6 +70,6 @@ erDiagram
 - `init/pg/ai/10_create_ai_tables.sql`
 
 ## 6. 设计建议
-- 保持跨域依赖单向：`course/question/achievement/recommendation` 通过 `upms` 提供的主体信息关联。
+- 保持跨域依赖单向：`course/question/achievement` 通过 `upms` 提供的主体信息关联。
 - 涉及 AI 知识检索的数据优先走异步同步表，避免在线写链路阻塞。
 - 复杂业务报表优先通过事实表/汇总表落地，避免线上实时多表大 join。

docs/architecture/logical-view.md

@@ -11,7 +11,7 @@
   - `ai-client`（Java 侧 AI 适配）
   - `python-ai`（AI 处理服务）
 - 业务域层（规划中）
-  - `course`、`question`、`achievement`、`recommendation`
+  - `course`、`question`、`achievement`
 - 数据与基础设施层
   - PostgreSQL（多 schema）
   - Redis（缓存、会话、热点）
@@ -30,21 +30,18 @@ graph TD
     GW --> COURSE[Course Service]
     GW --> QUESTION[Question Service]
     GW --> ACHIEVE[Achievement Service]
-    GW --> REC[Recommendation Service]
 
     AUTH --> PG[(PostgreSQL)]
     UPMS --> PG
     COURSE --> PG
     QUESTION --> PG
     ACHIEVE --> PG
-    REC --> PG
 
     AUTH --> REDIS[(Redis)]
     UPMS --> REDIS
     COURSE --> REDIS
     QUESTION --> REDIS
     ACHIEVE --> REDIS
-    REC --> REDIS
 
     QUESTION --> AICLIENT[AI Client]
     AICLIENT --> PYAI[Python AI]
@@ -63,7 +60,7 @@ graph TD
 - 教师发作业：题库/试卷/作业配置 -> 投放班级。
 - 学生提交：答题内容 + 文件（可选）。
 - 批改流程：自动批改 + 人工复核 -> 成绩汇总 -> 错题沉淀。
-- 复习与推荐：复习计划 -> 推荐内容 -> 用户反馈 -> 闭环效果。
+- 复习闭环：复习计划 -> 复习执行 -> 效果回写。
 - 成就激励：事件触发 -> 规则命中 -> 成就发放/进度更新。
 
 ### 3.3 AI 知识链路