API-AI-011：用户学习画像保存 / 查询 API #172

New Issue

wangdl · 2026-06-10T21:03:18+08:00

wangdl commented

2026-06-10 21:03:18 +08:00

目标

提供用户学习画像的创建、更新、查询接口。

接口建议

GET  /ai/profile
PUT  /ai/profile

请求字段

learningGoal
currentLevel
dailyAvailableMinutes
qualityPreference
ageRange
occupation
examTarget
learningDeadline
learningStyle
aiAcceptanceLevel
digitalSkillLevel
preferredQuestionTypes
preferredLanguage

校验规则

dailyAvailableMinutes 必须为正数。
qualityPreference 必须为枚举值。
ageRange 可为空。
occupation 可为空。
preferredQuestionTypes 必须在允许题型范围内。

验收标准

已登录用户可查询自己的学习画像。
已登录用户可更新自己的学习画像。
不允许查询其他用户画像。
空画像时返回默认结构。
更新后 updatedAt 正确变化。
字段校验完整。
提供 controller/service/repository 测试。

## 目标提供用户学习画像的创建、更新、查询接口。 ## 接口建议 ``` GET /ai/profile PUT /ai/profile ``` ## 请求字段 - learningGoal - currentLevel - dailyAvailableMinutes - qualityPreference - ageRange - occupation - examTarget - learningDeadline - learningStyle - aiAcceptanceLevel - digitalSkillLevel - preferredQuestionTypes - preferredLanguage ## 校验规则 1. dailyAvailableMinutes 必须为正数。 2. qualityPreference 必须为枚举值。 3. ageRange 可为空。 4. occupation 可为空。 5. preferredQuestionTypes 必须在允许题型范围内。 ## 验收标准 1. 已登录用户可查询自己的学习画像。 2. 已登录用户可更新自己的学习画像。 3. 不允许查询其他用户画像。 4. 空画像时返回默认结构。 5. 更新后 updatedAt 正确变化。 6. 字段校验完整。 7. 提供 controller/service/repository 测试。

wangdl added this to the M-API-AI-RUNTIME：API AI Runtime 调度与落库 milestone 2026-06-10 21:03:18 +08:00

wangdl added the

labels 2026-06-10 21:03:18 +08:00

wangdl commented

2026-06-11 20:45:01 +08:00

完成证据

产物: src/modules/ai-runtime/user-ai.controller.ts + user-ai.service.ts + user-ai.dto.ts
提交: 4cf2aa9 feat: 用户 AI 设置与 Key 管理 API (API-AI-011~015)

接口:

GET /ai/profile — 查询学习画像
PUT /ai/profile — 保存学习画像（upsert）

DTO: SaveLearningProfileDto — learningGoal, currentLevel, dailyAvailableMinutes, qualityPreference, ageRange, occupation, examTarget, learningDeadline, learningStyle, aiAcceptanceLevel, digitalSkillLevel, preferredQuestionTypes, preferredLanguage

校验: dailyAvailableMinutes 1-480, 字段可选, 不允许查询其他用户画像

## 完成证据 **产物**: `src/modules/ai-runtime/user-ai.controller.ts` + `user-ai.service.ts` + `user-ai.dto.ts` **提交**: `4cf2aa9` feat: 用户 AI 设置与 Key 管理 API (API-AI-011~015) **接口**: - `GET /ai/profile` — 查询学习画像 - `PUT /ai/profile` — 保存学习画像（upsert） **DTO**: `SaveLearningProfileDto` — learningGoal, currentLevel, dailyAvailableMinutes, qualityPreference, ageRange, occupation, examTarget, learningDeadline, learningStyle, aiAcceptanceLevel, digitalSkillLevel, preferredQuestionTypes, preferredLanguage **校验**: dailyAvailableMinutes 1-480, 字段可选, 不允许查询其他用户画像

wangdl closed this issue

2026-06-11 20:45:02 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#172