Sfoglia il codice sorgente

feat(articles): 加 kb_check_status/kb_check_result 字段(迁移465)

Xiaogang Liao 3 giorni fa
parent
commit
6a67b2d282

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

@@ -3491,6 +3491,9 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
 
         // 迁移464: 创建 P3 跨案例聚合承载表 attribution_case_strategies(T15 跨案例聚合,S-cfc-119 guhe.p3.lowSideAggregate)
         createAttributionCaseStrategyTable();
+
+        // 迁移465: articles 表添加 kb_check_status / kb_check_result 列(益生菌/益生元文章知识库出处自检)
+        addArticleKbCheckColumns();
     }
 
     /**
@@ -3526,6 +3529,21 @@ insertSysConfigSeed("gift_membership_pay_price", "198000", "送会员商品达
         }
     }
 
+    /**
+     * 迁移465: articles 表添加 kb_check_status / kb_check_result 列。
+     *
+     * <p>益生菌/益生元文章知识库出处自检({@code ArticleKbCheckService})结果落库:
+     * {@code kb_check_status} 取 APPROVED/REJECTED/SKIP(NULL=未校验);
+     * {@code kb_check_result} 存整句相似度明细 JSON。保存时触发、发布不硬拦,仅后台展示与排障。</p>
+     */
+    private void addArticleKbCheckColumns() {
+        ensureColumn("articles", "kb_check_status",
+                "VARCHAR(20) DEFAULT NULL COMMENT '知识库自检状态: APPROVED/REJECTED/SKIP, NULL=未校验'");
+        ensureColumn("articles", "kb_check_result",
+                "TEXT DEFAULT NULL COMMENT '知识库自检结果JSON(各句max_similarity/matched_title等)'");
+        log.info("迁移465: 已确认 articles.kb_check_status/kb_check_result 列");
+    }
+
     /**
      * 迁移458: 创建单笔订单利润池计算明细表(§7.1)。
      *

+ 4 - 0
cfc-backend/src/main/java/com/etotem/cfc/entity/Article.java

@@ -46,6 +46,10 @@ public class Article implements Serializable {
     private Long auditorId;
     /** 审核时间 */
     private Date auditedAt;
+    /** 知识库出处自检状态:APPROVED(通过) / REJECTED(未通过) / SKIP(非益生菌主题或服务不可用);NULL=未校验。保存时触发,发布不硬拦,仅提示 */
+    private String kbCheckStatus;
+    /** 知识库自检结果 JSON(含 all_passed / 各句 max_similarity / matched_title / matched_chunk)。前端展示 + 排障 */
+    private String kbCheckResult;
     private Integer isFeatured;
     /** 推荐排序值(越小越靠前) */
     private Integer sortOrder;

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

@@ -1531,7 +1531,9 @@ CREATE TABLE IF NOT EXISTS articles (
     created_at DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
     updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
     audio_url VARCHAR(500) NULL COMMENT 'AI朗读音频URL',
-    audio_text TEXT NULL COMMENT '朗读文本(纯文本,缺省从content剥离)'
+    audio_text TEXT NULL COMMENT '朗读文本(纯文本,缺省从content剥离)',
+    kb_check_status VARCHAR(20) DEFAULT NULL COMMENT '知识库自检状态: APPROVED/REJECTED/SKIP, NULL=未校验',
+    kb_check_result TEXT NULL COMMENT '知识库自检结果JSON(各句max_similarity/matched_title等)'
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='文章表';
 
 -- Article audit fields (for user-generated content)

+ 35 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/ArticleKbCheckFieldTest.java

@@ -0,0 +1,35 @@
+package com.etotem.cfc.unit;
+
+import com.etotem.cfc.entity.Article;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 文章知识库校验字段契约测试(纯 POJO,无 Spring 上下文)。
+ *
+ * 覆盖:Article 实体暴露 kbCheckStatus / kbCheckResult 两个字段(含 Lombok 生成的 getter/setter),
+ *       供 Task 3/4 的 ArticleKbCheckService 与 AdminArticleController 读写。
+ */
+class ArticleKbCheckFieldTest {
+
+    @Test
+    @DisplayName("Article 实体暴露 kbCheckStatus/kbCheckResult 字段")
+    void entityExposesKbCheckFields() {
+        Article a = new Article();
+        a.setKbCheckStatus("REJECTED");
+        a.setKbCheckResult("{\"all_passed\":false}");
+        assertEquals("REJECTED", a.getKbCheckStatus());
+        assertTrue(a.getKbCheckResult().contains("all_passed"));
+    }
+
+    @Test
+    @DisplayName("kbCheckStatus 缺省为 null(未校验/跳过)")
+    void defaultNull() {
+        Article a = new Article();
+        assertEquals(null, a.getKbCheckStatus());
+        assertEquals(null, a.getKbCheckResult());
+    }
+}