Explorar o código

feat(assessment): 测评类型浏览 assessment.type.browse (S-cfc-368 / SC-P-31)

后端字典枚举 DAN 8 类 + 材料类型码载体 + 类型浏览 POST 端点,使 DanAssessmentTypeBrowseContractTest 7 用例转绿。

- AssessmentService.listAssessmentTypes(): 复用 DanReportUpload.DIM_* 字典返回 8 类
- DanAssessmentController: POST /api/dan-assessment/material/types (listMaterialTypes)
- AssessmentMaterial: 新增 dimension 类型码字段(材料=类型载体)
- schema.sql + DatabaseInitializer 迁移478: assessment_materials 加 dimension 列(幂等 ensureColumn)
E2E Test Bot hai 1 día
pai
achega
337850517a

+ 14 - 0
cfc-backend/src/main/java/com/etotem/cfc/config/DatabaseInitializer.java

@@ -3552,6 +3552,9 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
 
         // 迁移478: tasks 表自定义周期/暂停扩展列 + status 增加 paused(SC-P-12 task.frequency.config)
         addTaskFrequencyConfigColumns();
+        // 迁移479: assessment_materials 加测评类型码列 dimension(能力键 assessment.type.browse,S-cfc-368 / SC-P-31):
+        // 材料作为「类型载体」,测评页从后端字典拉取 DAN 8 类(类目来自后端字典)
+        addAssessmentMaterialTypeColumn();
     }
 
     /**
@@ -16053,4 +16056,15 @@ log.info("迁移298: 已为无 openid 的 child 账号补齐 family_members 记
             log.warn("迁移474: membership_levels.cost_price 失败(忽略): {}", e.getMessage());
         }
     }
+
+    /**
+     * 迁移479: assessment_materials 加测评类型码列 dimension(能力键 {@code assessment.type.browse},S-cfc-368 / SC-P-31)。
+     * 材料作为「类型载体」,测评页列 DAN 8 类且类目来自后端字典。
+     * 幂等:ensureColumn 忽略「列已存在」。
+     */
+    private void addAssessmentMaterialTypeColumn() {
+        ensureColumn("assessment_materials", "dimension",
+                "VARCHAR(30) DEFAULT NULL COMMENT '测评类型码(类型载体:DAN 8 类 mind/wisdom/cognition/learning/behavior/career/campus/adolescent)'");
+        log.info("迁移479: assessment_materials.dimension 就绪(assessment.type.browse / SC-P-31)");
+    }
 }

+ 6 - 0
cfc-backend/src/main/java/com/etotem/cfc/controller/DanAssessmentController.java

@@ -74,6 +74,12 @@ public class DanAssessmentController {
         return Result.success(assessmentService.getMaterialList());
     }
 
+    @Operation(summary = "获取测评类型字典(DAN 8 类,类目来自后端字典)")
+    @PostMapping("/material/types")
+    public Result<List<String>> listMaterialTypes() {
+        return Result.success(assessmentService.listAssessmentTypes());
+    }
+
     // ===== 积分配置 =====
 
 @Operation(summary = "获取积分配置")

+ 3 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/AssessmentMaterial.java

@@ -21,6 +21,9 @@ public class AssessmentMaterial implements Serializable {
 
     private String coverImage;
 
+    /** 测评类型码(类型载体:DAN 8 类 mind/wisdom/cognition/learning/behavior/career/campus/adolescent,对齐 DanReportUpload.DIM_* 字典) */
+    private String dimension;
+
     private String status;
 
     private Date createdAt;

+ 21 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/AssessmentService.java

@@ -8,6 +8,7 @@ import com.etotem.cfc.entity.AssessmentMaterial;
 import com.etotem.cfc.entity.AssessmentPointsConfig;
 import com.etotem.cfc.entity.AssessmentRecord;
 import com.etotem.cfc.entity.DanAssessmentResult;
+import com.etotem.cfc.entity.DanReportUpload;
 import com.etotem.cfc.entity.FamilyAssessmentConfig;
 import com.etotem.cfc.entity.FamilyMember;
 import com.etotem.cfc.mapper.AssessmentMaterialMapper;
@@ -107,6 +108,26 @@ public class AssessmentService extends ServiceImpl<AssessmentMaterialMapper, Ass
         return this.list(wrapper);
     }
 
+    /**
+     * 能力键 {@code assessment.type.browse}(SC-P-31 / TC-P-31):枚举测评类型浏览入口。
+     *
+     * <p>返回后端类型字典的完整 DAN 8 类(mind/wisdom/cognition/learning/behavior/career/campus/adolescent),
+     * 供测评页「列 8 类、类目来自后端字典」使用。字典基线复用 {@link DanReportUpload} 的 {@code DIM_*} 常量,
+     * 避免实现与字典分叉。</p>
+     */
+    public List<String> listAssessmentTypes() {
+        return Arrays.asList(
+                DanReportUpload.DIM_MIND,
+                DanReportUpload.DIM_WISDOM,
+                DanReportUpload.DIM_COGNITION,
+                DanReportUpload.DIM_LEARNING,
+                DanReportUpload.DIM_BEHAVIOR,
+                DanReportUpload.DIM_CAREER,
+                DanReportUpload.DIM_CAMPUS,
+                DanReportUpload.DIM_ADOLESCENT
+        );
+    }
+
     public AssessmentMaterial createMaterial(String title, String content, String coverImage) {
         AssessmentMaterial material = new AssessmentMaterial();
         material.setTitle(title);

+ 1 - 0
cfc-backend/src/main/resources/schema.sql

@@ -914,6 +914,7 @@ CREATE TABLE IF NOT EXISTS assessment_materials (
     title VARCHAR(100) NOT NULL COMMENT '资料标题',
     content TEXT COMMENT '测评介绍内容',
     cover_image VARCHAR(255) COMMENT '封面图片',
+    dimension VARCHAR(30) DEFAULT NULL COMMENT '测评类型码(类型载体:DAN 8 类 mind/wisdom/cognition/learning/behavior/career/campus/adolescent)',
     status VARCHAR(20) DEFAULT 'active' COMMENT '状态:active/inactive',
     created_at DATETIME COMMENT '创建时间',
     updated_at DATETIME COMMENT '更新时间',