Просмотр исходного кода

docs(assessment.result.view): S-cfc-372 同步 API_REFERENCE 量纲标注/拒显契约说明 — latest-result 与 history DTO 新字段(scaleMin/scaleMax/八类中文标签)+ 超 0-100 量纲拒显(实现已由 6b38cc4e2 合入,补文档同步)

Sisyphus Agent 4 дней назад
Родитель
Сommit
28b567458f
1 измененных файлов с 2 добавлено и 2 удалено
  1. 2 2
      docs/superpowers/api/API_REFERENCE.md

+ 2 - 2
docs/superpowers/api/API_REFERENCE.md

@@ -2910,8 +2910,8 @@ W0.2 双配置中心合并:`product_config` 已并入 `service_config`(唯
 | `POST /api/assessment/result/{id}` | path `id` | `DanAssessmentResult` | 测评报告详情。**仅 `role=teacher` 可查看**(否则「只有指导师可以查看测评报告」);`canViewAssessment` 权限校验 |
 | `POST /api/assessment/my-results` | 无 body | `List<DanAssessmentResult>` | 指导师自己的测评报告列表(仅 teacher) |
 | `POST /api/assessment/child-results` | 无 body | `List<DanAssessmentResult>` | 下级指导师的测评报告列表(仅 teacher,`getAccessibleAssessments`) |
-| `POST /api/assessment/latest-result` | `{memberId?}`(缺省 currentMemberId) | `AssessmentResultDTO`(无则 null) | 成员最新认知测评结果(已在 4.10 登记,此处补 DTO 字段:memberId/childName/overallScore/attentionScore/focusScore/memoryScore/logicScore/perceptionScore/spatialScore/processingSpeedScore/analysisReport/growthSuggestions/assessmentDate) |
-| `POST /api/assessment/history` | `{memberId, size=5}` | `List<AssessmentHistoryItemDTO>`(assessmentDate/overallScore) | 成员测评历史(status=completed,按 assessmentDate 倒序) |
+| `POST /api/assessment/latest-result` | `{memberId?}`(缺省 currentMemberId) | `AssessmentResultDTO`(无则 null;**分数越界 0–100 拒显返回 400**) | 成员最新认知测评结果(已在 4.10 登记,此处补 DTO 字段:memberId/childName/overallScore/attentionScore/focusScore/memoryScore/logicScore/perceptionScore/spatialScore/processingSpeedScore/**scaleMin(0)/scaleMax(100)/overallLabel/attentionLabel/focusLabel/memoryLabel/logicLabel/perceptionLabel/spatialLabel/processingSpeedLabel**/analysisReport/growthSuggestions/assessmentDate;SC-P-39 边界:量纲标注 + 超量纲拒显) |
+| `POST /api/assessment/history` | `{memberId, size=5}` | `List<AssessmentHistoryItemDTO>`(assessmentDate/overallScore;**越界条目拒显过滤**) | 成员测评历史(status=completed,按 assessmentDate 倒序;历史条目携带 scaleMin/scaleMax/overallLabel 量纲标注,SC-P-39 与最新结果同口径) |
 
 #### 4.59.5.4 测评报告上传 / 指导意见 / 方案(`AssessmentReportController` `/api/dan-assessment/result`)