docs: 更新目标和学员目标数据模型文档

This commit is contained in:
hmo
2026-04-24 00:08:40 +08:00
parent 035c599c2f
commit 977e82dbb6
2 changed files with 75 additions and 9 deletions
+20 -5
View File
@@ -307,6 +307,8 @@ SELECT * FROM users;
| id | Integer | 主键 |
| name | String(100) | 目标名称 |
| content | Text | 目标内容(Markdown |
| level | String(20) | 级别:启蒙/入门/进阶/熟练/精通 |
| category | String(20) | 分类:综合/乐理相关/演奏能力/其他 |
| created_at | DateTime | 创建时间 |
| updated_at | DateTime | 更新时间 |
@@ -330,12 +332,25 @@ SELECT * FROM users;
| id | Integer | 主键 |
| student_id | Integer | 学员ID,外键 |
| goal_id | Integer | 目标ID,外键 |
| status | String(20) | 状态:未开始/进行中/已完成 |
| mastery_level | Integer | 掌握程度 1-5 |
| deadline | DateTime | 截止日期 |
| completed_at | DateTime | 完成时间 |
| start_date | DateTime | 开始日期 |
| assessment_date | DateTime | 评估日期 |
| mastery_level | Integer | 掌握程度 1-5(评估时填写) |
| achievement_date | DateTime | 达成日期 |
| comment | Text | 评语 |
| created_at | DateTime | 创建时间 |
**状态计算逻辑**
- `status``start_date``assessment_date` 自动计算,不存储
- 早于 `start_date` → 未开始
- `start_date``assessment_date` 之间 → 进行中
- 晚于 `assessment_date` → 已结束
**排序规则**:按状态(进行中→未开始→已结束),再按评估日期倒序
**关系**
- 一个学员可以分配多个目标
- 一个目标可以分配给多个学员
- 一个目标可以分配给多个学员
**操作入口**
- "调整目标":修改开始/评估日期,移除目标
- "评估目标":填写掌握程度、达成日期、评语