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

feat(dim): T2 统一维度常量与映射层

新增 DimensionCodeConstants(固化5根+7body+扩围子code)与 DimensionCodeMapper
(resolveToUnified/resolveLegacy,以 product_dimension_config.legacy_alias 为事实源)。
Agnes Agent 1 неделя назад
Родитель
Сommit
33b397e690

+ 86 - 0
cfc-backend/src/main/java/com/etotem/cfc/common/constant/DimensionCodeConstants.java

@@ -0,0 +1,86 @@
+package com.etotem.cfc.common.constant;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.Set;
+
+/**
+ * 统一维度体系 —— 权威 code 常量。
+ *
+ * <p>全系统引用统一维度 code 的唯一来源,禁止散落字面量。
+ * 根维度 5 个(body/mind/wisdom/action/wealth)为唯一权威;其余为 {root}.{sub} 点分全小写。</p>
+ *
+ * <p>扩围子维以代码为准(见报告):认知为「六维认知体系」非 5 维;关系实际为 12 个 action* 维非 5 维。</p>
+ */
+public final class DimensionCodeConstants {
+
+    private DimensionCodeConstants() {}
+
+    // ===================== 5 根(唯一权威) =====================
+    public static final String BODY = "body";
+    public static final String MIND = "mind";
+    public static final String WISDOM = "wisdom";
+    public static final String ACTION = "action";
+    public static final String WEALTH = "wealth";
+
+    public static final Set<String> ROOT_CODES =
+            Collections.unmodifiableSet(new HashSet<>(Arrays.asList(BODY, MIND, WISDOM, ACTION, WEALTH)));
+
+    // ===================== body 7 维(health,原 health_dimension_scores) =====================
+    public static final String BODY_GROWTH = "body.growth";
+    public static final String BODY_SLEEP = "body.sleep";
+    public static final String BODY_VISION = "body.vision";
+    public static final String BODY_IMMUNITY = "body.immunity";
+    public static final String BODY_NUTRITION = "body.nutrition";
+    public static final String BODY_GUT = "body.gut";
+    public static final String BODY_EXERCISE = "body.exercise";
+
+    public static final Set<String> BODY_CODES = Collections.unmodifiableSet(new HashSet<>(Arrays.asList(
+            BODY_GROWTH, BODY_SLEEP, BODY_VISION, BODY_IMMUNITY, BODY_NUTRITION, BODY_GUT, BODY_EXERCISE)));
+
+    // ===================== 认知 6 维(wisdom 根;DAN「六维认知体系」) =====================
+    public static final String WISDOM_PERCEPTION = "wisdom.perception";
+    public static final String WISDOM_FOCUS = "wisdom.focus";
+    public static final String WISDOM_MEMORY = "wisdom.memory";
+    public static final String WISDOM_LOGIC = "wisdom.logic";
+    public static final String WISDOM_SPATIAL = "wisdom.spatial";
+    public static final String WISDOM_PROCESSING_SPEED = "wisdom.processingSpeed";
+
+    // ===================== 心 10 维(mind 根;EMI/心理) =====================
+    public static final String MIND_BIG_FIVE_OPENNESS = "mind.bigFiveOpenness";
+    public static final String MIND_BIG_FIVE_CONSCIENTIOUSNESS = "mind.bigFiveConscientiousness";
+    public static final String MIND_BIG_FIVE_EXTRAVERSION = "mind.bigFiveExtraversion";
+    public static final String MIND_BIG_FIVE_AGREEABLENESS = "mind.bigFiveAgreeableness";
+    public static final String MIND_BIG_FIVE_NEUROTICISM = "mind.bigFiveNeuroticism";
+    public static final String MIND_EMOTION_STABILITY = "mind.emotionStability";
+    public static final String MIND_DRIVE_AUTONOMY = "mind.driveAutonomy";
+    public static final String MIND_DRIVE_COMPETENCE = "mind.driveCompetence";
+    public static final String MIND_DRIVE_RELATEDNESS = "mind.driveRelatedness";
+    public static final String MIND_SELF_CONCEPT_OVERALL = "mind.selfConceptOverall";
+
+    // ===================== 关系 12 维(action 根;关系质量,代码实际 12 个 action*) =====================
+    public static final String ACTION_CHILD_PARENT_CHILD = "action.childParentChild";
+    public static final String ACTION_SIBLING = "action.sibling";
+    public static final String ACTION_RELATIVE = "action.relative";
+    public static final String ACTION_TEACHER_STUDENT = "action.teacherStudent";
+    public static final String ACTION_CHILD_SOCIALITY = "action.childSociality";
+    public static final String ACTION_CHILD_INTERPERSONAL = "action.childInterpersonal";
+    public static final String ACTION_PARENT_CHILD = "action.parentChild";
+    public static final String ACTION_MARITAL = "action.marital";
+    public static final String ACTION_PARENTAL = "action.parental";
+    public static final String ACTION_LEADERSHIP = "action.leadership";
+    public static final String ACTION_SOCIALITY = "action.sociality";
+    public static final String ACTION_INTERPERSONAL = "action.interpersonal";
+
+    // ===================== 富 4 维(wealth 根;财富素养) =====================
+    public static final String WEALTH_SKILL = "wealth.skill";
+    public static final String WEALTH_ALTRUISM = "wealth.altruism";
+    public static final String WEALTH_INCOME = "wealth.income";
+    public static final String WEALTH_FX = "wealth.fx";
+
+    /** 判断是否为统一维度 code(根或任意子维) */
+    public static boolean isUnifiedCode(String code) {
+        return code != null && (ROOT_CODES.contains(code) || code.contains("."));
+    }
+}

+ 31 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/DimensionCodeMapper.java

@@ -0,0 +1,31 @@
+package com.etotem.cfc.service;
+
+import java.util.List;
+
+/**
+ * 统一维度体系 —— 编码映射层(legacy_alias ↔ 统一 code)。
+ *
+ * <p>双向可查:旧编码 → 统一 code(resolveToUnified);统一 code → 旧编码(resolveLegacy)。
+ * 映射数据来自 product_dimension_config.legacy_alias 列(JSON 数组)。</p>
+ */
+public interface DimensionCodeMapper {
+
+    /**
+     * 将旧体系编码解析为统一维度 code。
+     * 例:resolveToUnified("growth") == "body.growth"。
+     * 若入参本身已是统一 code(存在于 product_dimension_config.dimension_code),原样返回。
+     *
+     * @param legacy 旧体系编码(如 growth / dim.body / actionChildParentChild)
+     * @return 统一 code;无法解析返回 null
+     */
+    String resolveToUnified(String legacy);
+
+    /**
+     * 取统一 code 对应的全部历史别名(旧体系编码)。
+     * 例:resolveLegacy("body.growth") 含 "growth"。
+     *
+     * @param unified 统一维度 code
+     * @return 历史别名列表(无则空列表,不会为 null)
+     */
+    List<String> resolveLegacy(String unified);
+}

+ 70 - 0
cfc-backend/src/main/java/com/etotem/cfc/service/impl/DimensionCodeMapperImpl.java

@@ -0,0 +1,70 @@
+package com.etotem.cfc.service.impl;
+
+import com.etotem.cfc.service.DimensionCodeMapper;
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import org.springframework.stereotype.Service;
+
+import javax.annotation.Resource;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * DimensionCodeMapper 实现 —— 直接以 product_dimension_config.legacy_alias 为唯一事实源解析。
+ *
+ * <p>不引入额外缓存:每次解析走轻量 SQL,保证始终反映最新种子/配置数据,且不受组件初始化顺序影响。
+ * legacy_alias 为 JSON 数组字符串,用 Jackson 解析。</p>
+ */
+@Service
+public class DimensionCodeMapperImpl implements DimensionCodeMapper {
+
+    @Resource
+    private org.springframework.jdbc.core.JdbcTemplate jdbcTemplate;
+
+    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
+
+    @Override
+    public String resolveToUnified(String legacy) {
+        if (legacy == null || legacy.isEmpty()) {
+            return null;
+        }
+        // 1) 已是统一 code
+        Integer cnt = jdbcTemplate.queryForObject(
+                "SELECT COUNT(*) FROM product_dimension_config WHERE dimension_code = ?", Integer.class, legacy);
+        if (cnt != null && cnt > 0) {
+            return legacy;
+        }
+        // 2) 查 legacy_alias 数组包含该旧码
+        String pattern = "%\"" + legacy + "\"%";
+        try {
+            List<String> codes = jdbcTemplate.queryForList(
+                    "SELECT dimension_code FROM product_dimension_config WHERE legacy_alias LIKE ?",
+                    String.class, pattern);
+            if (codes != null && !codes.isEmpty()) {
+                return codes.get(0);
+            }
+        } catch (Exception e) {
+            // 忽略,返回 null
+        }
+        return null;
+    }
+
+    @Override
+    public List<String> resolveLegacy(String unified) {
+        if (unified == null || unified.isEmpty()) {
+            return Collections.emptyList();
+        }
+        try {
+            String json = jdbcTemplate.queryForObject(
+                    "SELECT legacy_alias FROM product_dimension_config WHERE dimension_code = ?",
+                    String.class, unified);
+            if (json == null || json.trim().isEmpty()) {
+                return Collections.emptyList();
+            }
+            List<String> list = OBJECT_MAPPER.readValue(json, new TypeReference<List<String>>() {});
+            return list != null ? list : Collections.emptyList();
+        } catch (Exception e) {
+            return Collections.emptyList();
+        }
+    }
+}