feat(enum): 统一结构化枚举值传输与同步

src/main/java/com/bruce/rag/dto/request/RagDocumentParseRequest.java

@@ -12,8 +12,8 @@ public class RagDocumentParseRequest {
     @Schema(description = "文档ID列表")
     private List<Long> documentIds;
 
-    @Schema(description = "切片方式")
-    private String chunkStrategy;
+    @Schema(description = "切片方式枚举值")
+    private Integer chunkStrategy;
 
     @Schema(description = "切片长度")
     private Integer chunkSize;

src/main/java/com/bruce/rag/enums/RagChunkStrategyEnum.java

@@ -1,11 +1,14 @@
 package com.bruce.rag.enums;
 
+import com.bruce.common.enums.PersistableSysEnumDefinition;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
 
+import java.util.Arrays;
+
 @Getter
 @AllArgsConstructor
-public enum RagChunkStrategyEnum {
+public enum RagChunkStrategyEnum implements PersistableSysEnumDefinition {
 
     FIXED_LENGTH(1, "固定长度切片"),
     PARAGRAPH(2, "按段落切片"),
@@ -14,7 +17,35 @@ public enum RagChunkStrategyEnum {
     DELIMITER(5, "按分隔符切片"),
     SEMANTIC(6, "语义切片");
 
+    private static final String CATALOG = "rag";
+
+    private static final String TYPE = "chunk_strategy";
+
+    private static final String REMARK = "RAG文档切片方式";
+
     private final Integer value;
 
     private final String label;
+
+    public static RagChunkStrategyEnum fromValue(Integer value) {
+        return Arrays.stream(values())
+                .filter(item -> item.getValue().equals(value))
+                .findFirst()
+                .orElseThrow(() -> new IllegalArgumentException("不支持的切片方式: " + value));
+    }
+
+    @Override
+    public String getCatalog() {
+        return CATALOG;
+    }
+
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+
+    @Override
+    public String getRemark() {
+        return REMARK;
+    }
 }

src/main/java/com/bruce/rag/enums/RagIndexStatusEnum.java

@@ -1,18 +1,40 @@
 package com.bruce.rag.enums;
 
+import com.bruce.common.enums.PersistableSysEnumDefinition;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
 
 @Getter
 @AllArgsConstructor
-public enum RagIndexStatusEnum {
+public enum RagIndexStatusEnum implements PersistableSysEnumDefinition {
 
     PENDING(1, "待索引"),
     INDEXING(2, "索引中"),
     INDEXED(3, "已索引"),
     FAILED(4, "索引失败");
 
+    private static final String CATALOG = "rag";
+
+    private static final String TYPE = "index_status";
+
+    private static final String REMARK = "RAG文档索引状态";
+
     private final Integer value;
 
     private final String label;
+
+    @Override
+    public String getCatalog() {
+        return CATALOG;
+    }
+
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+
+    @Override
+    public String getRemark() {
+        return REMARK;
+    }
 }

src/main/java/com/bruce/rag/enums/RagParseStatusEnum.java

@@ -1,18 +1,40 @@
 package com.bruce.rag.enums;
 
+import com.bruce.common.enums.PersistableSysEnumDefinition;
 import lombok.AllArgsConstructor;
 import lombok.Getter;
 
 @Getter
 @AllArgsConstructor
-public enum RagParseStatusEnum {
+public enum RagParseStatusEnum implements PersistableSysEnumDefinition {
 
     UPLOADED(1, "已上传"),
     PARSING(2, "解析中"),
     PARSED(3, "已解析"),
     FAILED(4, "解析失败");
 
+    private static final String CATALOG = "rag";
+
+    private static final String TYPE = "parse_status";
+
+    private static final String REMARK = "RAG文档解析状态";
+
     private final Integer value;
 
     private final String label;
+
+    @Override
+    public String getCatalog() {
+        return CATALOG;
+    }
+
+    @Override
+    public String getType() {
+        return TYPE;
+    }
+
+    @Override
+    public String getRemark() {
+        return REMARK;
+    }
 }

src/main/java/com/bruce/rag/service/impl/RagDocumentParseServiceImpl.java

@@ -22,10 +22,7 @@ import org.springframework.util.StringUtils;
 
 import java.nio.file.Files;
 import java.nio.file.Path;
-import java.util.Arrays;
 import java.util.List;
-import java.util.Set;
-import java.util.stream.Collectors;
 
 @Slf4j
 @Service
@@ -95,12 +92,7 @@ public class RagDocumentParseServiceImpl implements IRagDocumentParseService {
         if (request.getDocumentIds() == null || request.getDocumentIds().isEmpty()) {
             throw new IllegalArgumentException("文档ID列表不能为空");
         }
-        Set<String> strategies = Arrays.stream(RagChunkStrategyEnum.values())
-                .map(Enum::name)
-                .collect(Collectors.toSet());
-        if (request.getChunkStrategy() == null || !strategies.contains(request.getChunkStrategy())) {
-            throw new IllegalArgumentException("不支持的切片方式: " + request.getChunkStrategy());
-        }
+        RagChunkStrategyEnum.fromValue(request.getChunkStrategy());
     }
 
     private DocumentParseContext buildParseContext(RagDocument document, SysAttachment attachment) {