Merge remote-tracking branch 'origin/main'

- 将JiangSu_Config1.xml和JiangSu_Config2.xml中的Value标签注释格式统一
- 在JsonToXmlConversionService中改进规则匹配统计信息显示
- 添加XML模板中Value标签数量统计功能
- 实现匹配成功和未匹配Value标签的计数统计
- 增加未匹配标签的详细描述列表输出
- 新增countXmlValueTags方法用于统计XML中Value标签总数
- 新增countMatchedValueTags方法用于统计已匹配的Value标签数
- 新增findUnmatchedValueTags方法用于查找未匹配的Value标签描述

.gitignore

@@ -5,6 +5,8 @@
 target/
 logs/
 docs/
+.codex-tmp/
+.docs/
 
 # Log file
 *.log

README.md

@@ -35,6 +35,7 @@ CN_Tool 是一个基于 Spring Boot 的多模块后端聚合工程，当前仓
 - `add-data`
 - `add-ledger`
 - `mms-mapping`
+- `parse-pqdif`
 - `wave-tool`
 
 ## 启动入口
@@ -43,7 +44,7 @@ CN_Tool 是一个基于 Spring Boot 的多模块后端聚合工程，当前仓
 
 - `entrance/src/main/java/com/njcn/gather/EntranceApplication.java`
 
-`entrance` 模块聚合了 `system`、`disk-monitor`、`dbms`、`deploy`、`user`、`detection`、`activate-tool`、`add-data`、`add-ledger`、`wave-tool`、`mms-mapping`，是当前运行时主入口。
+`entrance` 模块聚合了 `system`、`disk-monitor`、`dbms`、`deploy`、`user`、`detection`、`activate-tool`、`add-data`、`add-ledger`、`wave-tool`、`mms-mapping`、`parse-pqdif`，是当前运行时主入口。
 
 ## 技术基线
 
@@ -100,6 +101,8 @@ P0 已补齐基线文档，建议按以下顺序阅读：
   - 当前为数据台账工具预留空模块
 - `tools/mms-mapping`
   - 负责 ICD 文件解析与 MMS 映射数据生成能力
+- `tools/parse-pqdif`
+  - 当前为 PQDIF 文件解析能力预留空方法骨架
 - `tools/wave-tool`
   - 负责波形文本解析与查看数据组装能力
 

entrance/pom.xml

@@ -58,6 +58,11 @@
             <artifactId>mms-mapping</artifactId>
             <version>1.0.0</version>
         </dependency>
+        <dependency>
+            <groupId>com.njcn.gather</groupId>
+            <artifactId>parse-pqdif</artifactId>
+            <version>1.0.0</version>
+        </dependency>
         <dependency>
             <groupId>com.njcn.gather</groupId>
             <artifactId>add-data</artifactId>

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareCalculator.java

@@ -45,19 +45,6 @@ public class SteadyChecksquareCalculator {
         return result;
     }
 
-    public int maxContinuousMissingMinutes(List<SteadyChecksquareSegmentVO> segments) {
-        int result = 0;
-        if (segments == null) {
-            return result;
-        }
-        for (SteadyChecksquareSegmentVO segment : segments) {
-            if (segment != null && STATUS_MISSING.equals(segment.getStatus()) && segment.getDurationMinutes() != null) {
-                result = Math.max(result, segment.getDurationMinutes());
-            }
-        }
-        return result;
-    }
-
     private SteadyChecksquareSegmentVO buildSegment(LocalDateTime startTime, LocalDateTime endTime, String status,
                                                    int pointCount, int intervalMinutes) {
         SteadyChecksquareSegmentVO segment = new SteadyChecksquareSegmentVO();

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareHarmonicParityRuleComponent.java

@@ -0,0 +1,193 @@
+package com.njcn.gather.steady.checksquare.component;
+
+import com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityDetailVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityRuleVO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendIndicatorDefinitionBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 谐波偶次与局部奇次基线关系规则。
+ */
+@Component
+@RequiredArgsConstructor
+public class SteadyChecksquareHarmonicParityRuleComponent {
+
+    private static final DateTimeFormatter OUTPUT_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+    private static final BigDecimal THRESHOLD_MULTIPLIER = new BigDecimal("2");
+    private static final BigDecimal EVEN_HARMONIC_DEADBAND_VALUE = new BigDecimal("0.1");
+    private static final int MIN_ODD_REFERENCE_COUNT = 2;
+
+    private final SteadyChecksquareInfluxQueryComponent influxQueryComponent;
+
+    public SteadyChecksquareHarmonicParityRuleVO check(String lineId, SteadyTrendIndicatorDefinitionBO indicator,
+                                                       LocalDateTime startTime, LocalDateTime endTime,
+                                                       int intervalMinutes) {
+        SteadyChecksquareHarmonicParityRuleVO result = new SteadyChecksquareHarmonicParityRuleVO();
+        if (!supportHarmonicParityRule(indicator)) {
+            return result;
+        }
+        for (String statType : indicator.getSupportStats()) {
+            for (String phase : indicator.getPhaseCodes()) {
+                Map<Integer, Map<LocalDateTime, BigDecimal>> valueMap = queryOrderValueMap(lineId, indicator, phase,
+                        statType, startTime, endTime, intervalMinutes);
+                appendAbnormalDetails(result, phase, statType, indicator, valueMap);
+            }
+        }
+        result.setAbnormalPointCount(result.getAbnormalDetails().size());
+        result.setAbnormal(result.getAbnormalPointCount() > 0);
+        return result;
+    }
+
+    private boolean supportHarmonicParityRule(SteadyTrendIndicatorDefinitionBO indicator) {
+        return indicator != null && Boolean.TRUE.equals(indicator.getHarmonic())
+                && indicator.getHarmonicOrderStart() != null && indicator.getHarmonicOrderEnd() != null;
+    }
+
+    private Map<Integer, Map<LocalDateTime, BigDecimal>> queryOrderValueMap(String lineId,
+                                                                            SteadyTrendIndicatorDefinitionBO indicator,
+                                                                            String phase, String statType,
+                                                                            LocalDateTime startTime,
+                                                                            LocalDateTime endTime,
+                                                                            int intervalMinutes) {
+        Map<Integer, Map<LocalDateTime, BigDecimal>> result = new LinkedHashMap<Integer, Map<LocalDateTime, BigDecimal>>();
+        List<SteadyTrendResolvedFieldBO> fields = new ArrayList<SteadyTrendResolvedFieldBO>();
+        for (int order = indicator.getHarmonicOrderStart(); order <= indicator.getHarmonicOrderEnd(); order++) {
+            fields.add(buildResolvedField(lineId, indicator, order, phase, statType));
+        }
+        Map<String, List<SteadyChecksquareValuePointBO>> fieldValueMap =
+                influxQueryComponent.queryValuePointMap(fields, startTime, endTime, intervalMinutes);
+        if (fieldValueMap == null) {
+            fieldValueMap = Collections.emptyMap();
+        }
+        for (int order = indicator.getHarmonicOrderStart(); order <= indicator.getHarmonicOrderEnd(); order++) {
+            result.put(order, toValueMap(fieldValueMap.get(indicator.getHarmonicFieldPrefix() + "_" + order)));
+        }
+        return result;
+    }
+
+    private void appendAbnormalDetails(SteadyChecksquareHarmonicParityRuleVO result, String phase, String statType,
+                                       SteadyTrendIndicatorDefinitionBO indicator,
+                                       Map<Integer, Map<LocalDateTime, BigDecimal>> valueMap) {
+        for (int order = firstEvenOrder(indicator.getHarmonicOrderStart()); order <= indicator.getHarmonicOrderEnd(); order += 2) {
+            Map<LocalDateTime, BigDecimal> evenValues = valueMap.get(order);
+            if (evenValues == null || evenValues.isEmpty()) {
+                continue;
+            }
+            for (Map.Entry<LocalDateTime, BigDecimal> entry : evenValues.entrySet()) {
+                appendAbnormalDetailIfNecessary(result, phase, statType, order, entry.getKey(), entry.getValue(), valueMap);
+            }
+        }
+    }
+
+    private void appendAbnormalDetailIfNecessary(SteadyChecksquareHarmonicParityRuleVO result, String phase,
+                                                  String statType, int evenOrder, LocalDateTime time,
+                                                  BigDecimal evenValue,
+                                                  Map<Integer, Map<LocalDateTime, BigDecimal>> valueMap) {
+        if (evenValue == null || evenValue.compareTo(EVEN_HARMONIC_DEADBAND_VALUE) <= 0) {
+            return;
+        }
+        List<Integer> oddOrders = buildOddReferenceOrders(evenOrder);
+        List<BigDecimal> oddValues = new ArrayList<BigDecimal>();
+        List<Integer> effectiveOddOrders = new ArrayList<Integer>();
+        for (Integer oddOrder : oddOrders) {
+            Map<LocalDateTime, BigDecimal> values = valueMap.get(oddOrder);
+            BigDecimal oddValue = values == null ? null : values.get(time);
+            if (oddValue != null) {
+                effectiveOddOrders.add(oddOrder);
+                oddValues.add(oddValue);
+            }
+        }
+        if (oddValues.size() < MIN_ODD_REFERENCE_COUNT) {
+            return;
+        }
+        BigDecimal median = calculateMedian(oddValues);
+        if (median == null || evenValue.compareTo(median.multiply(THRESHOLD_MULTIPLIER)) <= 0) {
+            return;
+        }
+        result.getAbnormalDetails().add(buildDetail(time, phase, statType, evenOrder, evenValue,
+                effectiveOddOrders, oddValues, median));
+    }
+
+    private SteadyChecksquareHarmonicParityDetailVO buildDetail(LocalDateTime time, String phase, String statType,
+                                                                Integer evenOrder, BigDecimal evenValue,
+                                                                List<Integer> oddOrders, List<BigDecimal> oddValues,
+                                                                BigDecimal median) {
+        SteadyChecksquareHarmonicParityDetailVO detail = new SteadyChecksquareHarmonicParityDetailVO();
+        detail.setTime(OUTPUT_TIME_FORMATTER.format(time));
+        detail.setPhase(phase);
+        detail.setStatType(statType);
+        detail.setEvenHarmonicOrder(evenOrder);
+        detail.setEvenValue(evenValue);
+        detail.setOddHarmonicOrders(new ArrayList<Integer>(oddOrders));
+        detail.setOddValues(new ArrayList<BigDecimal>(oddValues));
+        detail.setOddMedianValue(median);
+        detail.setThresholdMultiplier(THRESHOLD_MULTIPLIER);
+        return detail;
+    }
+
+    private List<Integer> buildOddReferenceOrders(int evenOrder) {
+        List<Integer> result = new ArrayList<Integer>();
+        result.add(evenOrder - 3);
+        result.add(evenOrder - 1);
+        result.add(evenOrder + 1);
+        result.add(evenOrder + 3);
+        return result;
+    }
+
+    private BigDecimal calculateMedian(List<BigDecimal> values) {
+        if (values == null || values.isEmpty()) {
+            return null;
+        }
+        List<BigDecimal> sorted = new ArrayList<BigDecimal>(values);
+        Collections.sort(sorted, Comparator.naturalOrder());
+        int middleIndex = sorted.size() / 2;
+        if (sorted.size() % 2 == 1) {
+            return sorted.get(middleIndex);
+        }
+        return sorted.get(middleIndex - 1).add(sorted.get(middleIndex)).divide(new BigDecimal("2"));
+    }
+
+    private int firstEvenOrder(int startOrder) {
+        return startOrder % 2 == 0 ? startOrder : startOrder + 1;
+    }
+
+    private Map<LocalDateTime, BigDecimal> toValueMap(List<SteadyChecksquareValuePointBO> points) {
+        Map<LocalDateTime, BigDecimal> result = new LinkedHashMap<LocalDateTime, BigDecimal>();
+        if (points == null || points.isEmpty()) {
+            return result;
+        }
+        for (SteadyChecksquareValuePointBO point : points) {
+            if (point != null && point.getTime() != null && point.getValue() != null) {
+                result.put(point.getTime(), point.getValue());
+            }
+        }
+        return result;
+    }
+
+    private SteadyTrendResolvedFieldBO buildResolvedField(String lineId, SteadyTrendIndicatorDefinitionBO indicator,
+                                                          Integer harmonicOrder, String phase, String statType) {
+        SteadyTrendResolvedFieldBO field = new SteadyTrendResolvedFieldBO();
+        field.setMeasurement(indicator.getTableName());
+        field.setField(indicator.getHarmonicFieldPrefix() + "_" + harmonicOrder);
+        field.setLineId(lineId);
+        field.setIndicatorCode(indicator.getIndicatorCode());
+        field.setIndicatorName(indicator.getName());
+        field.setPhase(phase);
+        field.setStatType(statType);
+        field.setUnit(indicator.getUnit());
+        return field;
+    }
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareInfluxQueryComponent.java

@@ -4,6 +4,7 @@ import com.fasterxml.jackson.databind.JsonNode;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.njcn.common.pojo.enums.response.CommonResponseEnum;
 import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO;
 import com.njcn.gather.steady.datavie.config.SteadyInfluxDbProperties;
 import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
 import lombok.RequiredArgsConstructor;
@@ -14,6 +15,7 @@ import java.io.BufferedReader;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
+import java.math.BigDecimal;
 import java.net.HttpURLConnection;
 import java.net.URLEncoder;
 import java.net.URL;
@@ -22,7 +24,11 @@ import java.time.LocalDateTime;
 import java.time.OffsetDateTime;
 import java.time.ZoneOffset;
 import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
 import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 import java.util.Set;
 
 /**
@@ -35,28 +41,121 @@ public class SteadyChecksquareInfluxQueryComponent {
 
     private static final DateTimeFormatter INFLUX_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm:ss'Z'");
     private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();
+    private static final ThreadLocal<Map<String, List<SteadyChecksquareValuePointBO>>> REQUEST_VALUE_CACHE =
+            new ThreadLocal<Map<String, List<SteadyChecksquareValuePointBO>>>();
 
     private final SteadyInfluxDbProperties properties;
 
+    public void enableRequestCache() {
+        REQUEST_VALUE_CACHE.set(new LinkedHashMap<String, List<SteadyChecksquareValuePointBO>>());
+    }
+
+    public void clearRequestCache() {
+        REQUEST_VALUE_CACHE.remove();
+    }
+
     public Set<LocalDateTime> queryExistingSlots(SteadyTrendResolvedFieldBO field, LocalDateTime startTime,
                                                  LocalDateTime endTime, int intervalMinutes) {
+        List<SteadyChecksquareValuePointBO> points = queryValuePoints(field, startTime, endTime, intervalMinutes);
+        Set<LocalDateTime> result = new HashSet<LocalDateTime>();
+        for (SteadyChecksquareValuePointBO point : points) {
+            if (point != null && point.getTime() != null) {
+                result.add(point.getTime());
+            }
+        }
+        return result;
+    }
+
+    public List<SteadyChecksquareValuePointBO> queryValuePoints(SteadyTrendResolvedFieldBO field, LocalDateTime startTime,
+                                                                LocalDateTime endTime, int intervalMinutes) {
         validateConfig();
-        String query = buildChecksquareQuery(field, startTime, endTime);
+        String query = buildValuePointQuery(field, startTime, endTime);
+        String cacheKey = buildCacheKey(query, intervalMinutes);
+        Map<String, List<SteadyChecksquareValuePointBO>> cache = REQUEST_VALUE_CACHE.get();
+        if (cache != null && cache.containsKey(cacheKey)) {
+            return new ArrayList<SteadyChecksquareValuePointBO>(cache.get(cacheKey));
+        }
         long startMillis = System.currentTimeMillis();
-        log.info("数据校验 InfluxDB 查询开始，measurement={}，field={}，lineId={}，phase={}，statType={}，query={}",
+        log.info("数据校验指标值 InfluxDB 查询开始，measurement={}，field={}，lineId={}，phase={}，statType={}，query={}",
                 field.getMeasurement(), field.getField(), field.getLineId(), field.getPhase(), field.getStatType(), query);
         try {
             String body = executeQuery(query);
-            Set<LocalDateTime> slots = parseExistingSlots(body, intervalMinutes);
-            log.info("数据校验 InfluxDB 查询结束，slotCount={}，costMs={}", slots.size(), System.currentTimeMillis() - startMillis);
-            return slots;
+            List<SteadyChecksquareValuePointBO> points = parseValuePoints(body, intervalMinutes);
+            if (cache != null) {
+                cache.put(cacheKey, new ArrayList<SteadyChecksquareValuePointBO>(points));
+            }
+            log.info("数据校验指标值 InfluxDB 查询结束，pointCount={}，costMs={}", points.size(), System.currentTimeMillis() - startMillis);
+            return points;
         } catch (RuntimeException ex) {
-            log.warn("数据校验 InfluxDB 查询异常，costMs={}，error={}", System.currentTimeMillis() - startMillis, ex.getMessage());
+            log.warn("数据校验指标值 InfluxDB 查询异常，costMs={}，error={}", System.currentTimeMillis() - startMillis, ex.getMessage());
             throw ex;
         }
     }
 
+    public Map<String, List<SteadyChecksquareValuePointBO>> queryValuePointMap(List<SteadyTrendResolvedFieldBO> fields,
+                                                                               LocalDateTime startTime,
+                                                                               LocalDateTime endTime,
+                                                                               int intervalMinutes) {
+        Map<String, List<SteadyChecksquareValuePointBO>> result =
+                new LinkedHashMap<String, List<SteadyChecksquareValuePointBO>>();
+        if (fields == null || fields.isEmpty()) {
+            return result;
+        }
+        if (fields.size() == 1) {
+            SteadyTrendResolvedFieldBO field = fields.get(0);
+            result.put(field.getField(), queryValuePoints(field, startTime, endTime, intervalMinutes));
+            return result;
+        }
+        validateConfig();
+        Map<String, List<SteadyChecksquareValuePointBO>> cache = REQUEST_VALUE_CACHE.get();
+        List<SteadyTrendResolvedFieldBO> missingFields = new ArrayList<SteadyTrendResolvedFieldBO>();
+        for (SteadyTrendResolvedFieldBO field : fields) {
+            String cacheKey = buildCacheKey(buildValuePointQuery(field, startTime, endTime), intervalMinutes);
+            if (cache != null && cache.containsKey(cacheKey)) {
+                result.put(field.getField(), new ArrayList<SteadyChecksquareValuePointBO>(cache.get(cacheKey)));
+            } else {
+                missingFields.add(field);
+            }
+        }
+        if (!missingFields.isEmpty()) {
+            String query = buildBatchValuePointQuery(missingFields, startTime, endTime);
+            long startMillis = System.currentTimeMillis();
+            SteadyTrendResolvedFieldBO first = missingFields.get(0);
+            log.info("数据校验指标值 InfluxDB 批量查询开始，measurement={}，fieldCount={}，lineId={}，phase={}，statType={}，query={}",
+                    first.getMeasurement(), missingFields.size(), first.getLineId(), first.getPhase(), first.getStatType(), query);
+            try {
+                Map<String, List<SteadyChecksquareValuePointBO>> queried = parseBatchValuePoints(executeQuery(query), intervalMinutes);
+                for (SteadyTrendResolvedFieldBO field : missingFields) {
+                    List<SteadyChecksquareValuePointBO> points = queried.get(field.getField());
+                    if (points == null) {
+                        points = new ArrayList<SteadyChecksquareValuePointBO>();
+                    }
+                    result.put(field.getField(), points);
+                    if (cache != null) {
+                        String cacheKey = buildCacheKey(buildValuePointQuery(field, startTime, endTime), intervalMinutes);
+                        cache.put(cacheKey, new ArrayList<SteadyChecksquareValuePointBO>(points));
+                    }
+                }
+                log.info("数据校验指标值 InfluxDB 批量查询结束，fieldCount={}，costMs={}",
+                        missingFields.size(), System.currentTimeMillis() - startMillis);
+            } catch (RuntimeException ex) {
+                log.warn("数据校验指标值 InfluxDB 批量查询异常，fieldCount={}，costMs={}，error={}",
+                        missingFields.size(), System.currentTimeMillis() - startMillis, ex.getMessage());
+                throw ex;
+            }
+        }
+        return result;
+    }
+
     public String buildChecksquareQuery(SteadyTrendResolvedFieldBO field, LocalDateTime startTime, LocalDateTime endTime) {
+        return buildValuePointQuery(field, startTime, endTime);
+    }
+
+    private String buildCacheKey(String query, int intervalMinutes) {
+        return query + "|intervalMinutes=" + intervalMinutes;
+    }
+
+    public String buildValuePointQuery(SteadyTrendResolvedFieldBO field, LocalDateTime startTime, LocalDateTime endTime) {
         StringBuilder sql = new StringBuilder();
         sql.append("SELECT \"").append(field.getField()).append("\" AS \"value\"");
         sql.append(" FROM \"").append(field.getMeasurement()).append("\"");
@@ -71,11 +170,33 @@ public class SteadyChecksquareInfluxQueryComponent {
         return sql.toString();
     }
 
-    private Set<LocalDateTime> parseExistingSlots(String body, int intervalMinutes) {
+    public String buildBatchValuePointQuery(List<SteadyTrendResolvedFieldBO> fields, LocalDateTime startTime, LocalDateTime endTime) {
+        SteadyTrendResolvedFieldBO first = fields.get(0);
+        StringBuilder sql = new StringBuilder("SELECT ");
+        for (int i = 0; i < fields.size(); i++) {
+            SteadyTrendResolvedFieldBO field = fields.get(i);
+            if (i > 0) {
+                sql.append(", ");
+            }
+            sql.append("\"").append(field.getField()).append("\" AS \"").append(field.getField()).append("\"");
+        }
+        sql.append(" FROM \"").append(first.getMeasurement()).append("\"");
+        sql.append(" WHERE time >= '").append(INFLUX_TIME_FORMATTER.format(startTime)).append("'");
+        sql.append(" AND time <= '").append(INFLUX_TIME_FORMATTER.format(endTime)).append("'");
+        sql.append(" AND \"line_id\" = '").append(escapeTagValue(first.getLineId())).append("'");
+        sql.append(" AND \"phasic_type\" = '").append(escapeTagValue(first.getPhase())).append("'");
+        if (hasValueTypeTag(first.getMeasurement())) {
+            sql.append(" AND \"value_type\" = '").append(resolveValueType(first.getStatType())).append("'");
+        }
+        sql.append(" ORDER BY time ASC");
+        return sql.toString();
+    }
+
+    private List<SteadyChecksquareValuePointBO> parseValuePoints(String body, int intervalMinutes) {
         try {
             JsonNode root = OBJECT_MAPPER.readTree(body);
             JsonNode values = root.path("results").path(0).path("series").path(0).path("values");
-            Set<LocalDateTime> result = new HashSet<LocalDateTime>();
+            List<SteadyChecksquareValuePointBO> result = new ArrayList<SteadyChecksquareValuePointBO>();
             if (!values.isArray()) {
                 return result;
             }
@@ -84,13 +205,64 @@ public class SteadyChecksquareInfluxQueryComponent {
                     continue;
                 }
                 LocalDateTime time = parseInfluxTime(value.get(0).asText());
-                if (time != null) {
-                    result.add(alignToPreviousSlot(time, intervalMinutes));
+                if (time == null) {
+                    continue;
+                }
+                SteadyChecksquareValuePointBO point = new SteadyChecksquareValuePointBO();
+                point.setTime(alignToPreviousSlot(time, intervalMinutes));
+                point.setValue(new BigDecimal(value.get(1).asText()));
+                result.add(point);
+            }
+            return result;
+        } catch (IOException ex) {
+            throw fail("InfluxDB 返回结果解析失败：" + ex.getMessage());
+        } catch (NumberFormatException ex) {
+            throw fail("InfluxDB 返回指标值格式不正确：" + ex.getMessage());
+        }
+    }
+
+    private Map<String, List<SteadyChecksquareValuePointBO>> parseBatchValuePoints(String body, int intervalMinutes) {
+        try {
+            JsonNode root = OBJECT_MAPPER.readTree(body);
+            JsonNode series = root.path("results").path(0).path("series").path(0);
+            JsonNode columns = series.path("columns");
+            JsonNode values = series.path("values");
+            Map<Integer, String> columnMap = new LinkedHashMap<Integer, String>();
+            Map<String, List<SteadyChecksquareValuePointBO>> result =
+                    new LinkedHashMap<String, List<SteadyChecksquareValuePointBO>>();
+            if (!columns.isArray() || !values.isArray()) {
+                return result;
+            }
+            for (int i = 1; i < columns.size(); i++) {
+                String fieldName = columns.get(i).asText();
+                columnMap.put(i, fieldName);
+                result.put(fieldName, new ArrayList<SteadyChecksquareValuePointBO>());
+            }
+            for (JsonNode row : values) {
+                if (row.size() < 2) {
+                    continue;
+                }
+                LocalDateTime time = parseInfluxTime(row.get(0).asText());
+                if (time == null) {
+                    continue;
+                }
+                LocalDateTime slot = alignToPreviousSlot(time, intervalMinutes);
+                for (Map.Entry<Integer, String> entry : columnMap.entrySet()) {
+                    JsonNode value = row.get(entry.getKey());
+                    if (value == null || value.isNull()) {
+                        continue;
+                    }
+                    SteadyChecksquareValuePointBO point = new SteadyChecksquareValuePointBO();
+                    point.setTime(slot);
+                    point.setValue(new BigDecimal(value.asText()));
+                    result.get(entry.getValue()).add(point);
                 }
             }
             return result;
         } catch (IOException ex) {
             throw fail("InfluxDB 返回结果解析失败：" + ex.getMessage());
+        } catch (NumberFormatException ex) {
+            throw fail("InfluxDB 返回指标值格式不正确：" + ex.getMessage());
         }
     }
 

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareValueOrderRuleComponent.java

@@ -0,0 +1,145 @@
+package com.njcn.gather.steady.checksquare.component;
+
+import com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareValueOrderDetailVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareValueOrderRuleVO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendIndicatorDefinitionBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendSeriesFieldBO;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * 数据校验指标值大小关系规则。
+ */
+@Component
+@RequiredArgsConstructor
+public class SteadyChecksquareValueOrderRuleComponent {
+
+    private static final DateTimeFormatter OUTPUT_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+    private static final List<String> REQUIRED_STATS = Collections.unmodifiableList(Arrays.asList("MAX", "CP95", "AVG", "MIN"));
+    private static final int ABNORMAL_THRESHOLD = 1;
+
+    private final SteadyChecksquareInfluxQueryComponent influxQueryComponent;
+
+    public SteadyChecksquareValueOrderRuleVO check(String lineId, SteadyTrendIndicatorDefinitionBO indicator,
+                                                   Integer harmonicOrder, LocalDateTime startTime,
+                                                   LocalDateTime endTime, int intervalMinutes) {
+        SteadyChecksquareValueOrderRuleVO result = new SteadyChecksquareValueOrderRuleVO();
+        if (!supportValueOrderRule(indicator)) {
+            return result;
+        }
+        for (String phase : indicator.getPhaseCodes()) {
+            Map<String, Map<LocalDateTime, BigDecimal>> statValueMap = queryStatValueMap(lineId, indicator,
+                    harmonicOrder, phase, startTime, endTime, intervalMinutes);
+            appendAbnormalDetails(result, phase, harmonicOrder, statValueMap);
+        }
+        result.setAbnormalPointCount(result.getAbnormalDetails().size());
+        result.setAbnormal(result.getAbnormalPointCount() > ABNORMAL_THRESHOLD);
+        return result;
+    }
+
+    private boolean supportValueOrderRule(SteadyTrendIndicatorDefinitionBO indicator) {
+        return indicator != null && indicator.getSupportStats() != null && indicator.getSupportStats().containsAll(REQUIRED_STATS);
+    }
+
+    private Map<String, Map<LocalDateTime, BigDecimal>> queryStatValueMap(String lineId,
+                                                                          SteadyTrendIndicatorDefinitionBO indicator,
+                                                                          Integer harmonicOrder, String phase,
+                                                                          LocalDateTime startTime, LocalDateTime endTime,
+                                                                          int intervalMinutes) {
+        Map<String, Map<LocalDateTime, BigDecimal>> result = new LinkedHashMap<String, Map<LocalDateTime, BigDecimal>>();
+        for (String statType : REQUIRED_STATS) {
+            SteadyTrendResolvedFieldBO field = buildResolvedField(lineId, indicator, harmonicOrder, phase, statType);
+            result.put(statType, toValueMap(influxQueryComponent.queryValuePoints(field, startTime, endTime, intervalMinutes)));
+        }
+        return result;
+    }
+
+    private void appendAbnormalDetails(SteadyChecksquareValueOrderRuleVO result, String phase, Integer harmonicOrder,
+                                        Map<String, Map<LocalDateTime, BigDecimal>> statValueMap) {
+        Map<LocalDateTime, BigDecimal> maxValues = statValueMap.get("MAX");
+        Map<LocalDateTime, BigDecimal> cp95Values = statValueMap.get("CP95");
+        Map<LocalDateTime, BigDecimal> avgValues = statValueMap.get("AVG");
+        Map<LocalDateTime, BigDecimal> minValues = statValueMap.get("MIN");
+        if (maxValues == null || cp95Values == null || avgValues == null || minValues == null) {
+            return;
+        }
+        for (Map.Entry<LocalDateTime, BigDecimal> entry : maxValues.entrySet()) {
+            LocalDateTime time = entry.getKey();
+            BigDecimal maxValue = entry.getValue();
+            BigDecimal cp95Value = cp95Values.get(time);
+            BigDecimal avgValue = avgValues.get(time);
+            BigDecimal minValue = minValues.get(time);
+            // 缺少任一统计值时由缺数校验负责，不重复计入大小关系异常。
+            if (maxValue == null || cp95Value == null || avgValue == null || minValue == null) {
+                continue;
+            }
+            if (maxValue.compareTo(cp95Value) >= 0 && cp95Value.compareTo(avgValue) >= 0 && avgValue.compareTo(minValue) >= 0) {
+                continue;
+            }
+            result.getAbnormalDetails().add(buildDetail(time, phase, harmonicOrder, maxValue, minValue, avgValue, cp95Value));
+        }
+    }
+
+    private SteadyChecksquareValueOrderDetailVO buildDetail(LocalDateTime time, String phase, Integer harmonicOrder,
+                                                            BigDecimal maxValue, BigDecimal minValue,
+                                                            BigDecimal avgValue, BigDecimal cp95Value) {
+        SteadyChecksquareValueOrderDetailVO detail = new SteadyChecksquareValueOrderDetailVO();
+        detail.setTime(OUTPUT_TIME_FORMATTER.format(time));
+        detail.setPhase(phase);
+        detail.setHarmonicOrder(harmonicOrder);
+        detail.setMaxValue(maxValue);
+        detail.setMinValue(minValue);
+        detail.setAvgValue(avgValue);
+        detail.setCp95Value(cp95Value);
+        return detail;
+    }
+
+    private Map<LocalDateTime, BigDecimal> toValueMap(List<SteadyChecksquareValuePointBO> points) {
+        Map<LocalDateTime, BigDecimal> result = new LinkedHashMap<LocalDateTime, BigDecimal>();
+        if (points == null || points.isEmpty()) {
+            return result;
+        }
+        for (SteadyChecksquareValuePointBO point : points) {
+            if (point != null && point.getTime() != null && point.getValue() != null) {
+                result.put(point.getTime(), point.getValue());
+            }
+        }
+        return result;
+    }
+
+    private SteadyTrendResolvedFieldBO buildResolvedField(String lineId, SteadyTrendIndicatorDefinitionBO indicator,
+                                                          Integer harmonicOrder, String phase, String statType) {
+        SteadyTrendResolvedFieldBO field = new SteadyTrendResolvedFieldBO();
+        field.setMeasurement(indicator.getTableName());
+        field.setField(resolveField(indicator, harmonicOrder));
+        field.setLineId(lineId);
+        field.setIndicatorCode(indicator.getIndicatorCode());
+        field.setIndicatorName(indicator.getName());
+        field.setPhase(phase);
+        field.setStatType(statType);
+        field.setUnit(indicator.getUnit());
+        return field;
+    }
+
+    private String resolveField(SteadyTrendIndicatorDefinitionBO indicator, Integer harmonicOrder) {
+        if (Boolean.TRUE.equals(indicator.getHarmonic())) {
+            return indicator.getHarmonicFieldPrefix() + "_" + harmonicOrder;
+        }
+        List<SteadyTrendSeriesFieldBO> fields = indicator.getSeriesFields();
+        if (fields == null || fields.isEmpty()) {
+            return "";
+        }
+        return fields.get(0).getField();
+    }
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/controller/SteadyChecksquareController.java

@@ -1,12 +1,18 @@
 package com.njcn.gather.steady.checksquare.controller;
 
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.njcn.common.pojo.annotation.OperateInfo;
+import com.njcn.common.pojo.constant.OperateType;
 import com.njcn.common.pojo.enums.common.LogEnum;
 import com.njcn.common.pojo.enums.response.CommonResponseEnum;
 import com.njcn.common.pojo.response.HttpResult;
 import com.njcn.common.utils.LogUtil;
+import com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareHistoryQueryParam;
 import com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareQueryParam;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareCreateVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareItemDetailVO;
 import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareQueryVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareTaskVO;
 import com.njcn.gather.steady.checksquare.service.SteadyChecksquareService;
 import com.njcn.web.controller.BaseController;
 import com.njcn.web.utils.HttpResultUtil;
@@ -14,11 +20,16 @@ import io.swagger.annotations.Api;
 import io.swagger.annotations.ApiOperation;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
 import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+import java.util.List;
+
 /**
  * 数据校验接口。
  */
@@ -32,12 +43,53 @@ public class SteadyChecksquareController extends BaseController {
     private final SteadyChecksquareService checksquareService;
 
     @OperateInfo(info = LogEnum.BUSINESS_COMMON)
-    @ApiOperation("查询数据校验结果")
+    @ApiOperation("查询数据校验历史记录")
     @PostMapping("/query")
-    public HttpResult<SteadyChecksquareQueryVO> query(@RequestBody SteadyChecksquareQueryParam param) {
+    public HttpResult<Page<SteadyChecksquareTaskVO>> query(@RequestBody @Validated SteadyChecksquareHistoryQueryParam param) {
         String methodDescribe = getMethodDescribe("query");
-        LogUtil.njcnDebug(log, "{}，开始查询数据校验结果，param={}", methodDescribe, param);
-        SteadyChecksquareQueryVO result = checksquareService.query(param);
+        LogUtil.njcnDebug(log, "{}，开始查询数据校验历史记录，param={}", methodDescribe, param);
+        Page<SteadyChecksquareTaskVO> result = checksquareService.query(param);
         return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
     }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON, operateType = OperateType.ADD)
+    @ApiOperation("新增数据校验记录")
+    @PostMapping("/create")
+    public HttpResult<SteadyChecksquareCreateVO> create(@RequestBody @Validated SteadyChecksquareQueryParam param) {
+        String methodDescribe = getMethodDescribe("create");
+        LogUtil.njcnDebug(log, "{}，开始新增数据校验记录，param={}", methodDescribe, param);
+        SteadyChecksquareCreateVO result = checksquareService.create(param);
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON, operateType = OperateType.DELETE)
+    @ApiOperation("删除数据校验任务")
+    @PostMapping("/delete")
+    public HttpResult<Boolean> delete(@RequestBody List<String> taskIds) {
+        String methodDescribe = getMethodDescribe("delete");
+        LogUtil.njcnDebug(log, "{}，开始删除数据校验任务，taskIds={}", methodDescribe, taskIds);
+        boolean result = checksquareService.delete(taskIds);
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON)
+    @ApiOperation("查询数据校验任务详情")
+    @GetMapping("/detail")
+    public HttpResult<SteadyChecksquareQueryVO> detail(@RequestParam("taskId") String taskId) {
+        String methodDescribe = getMethodDescribe("detail");
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, checksquareService.detail(taskId), methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON)
+    @ApiOperation("查询数据校验检测项明细")
+    @GetMapping("/item-detail")
+    public HttpResult<SteadyChecksquareItemDetailVO> itemDetail(@RequestParam("itemId") String itemId,
+                                                               @RequestParam("detailType") String detailType,
+                                                               @RequestParam(value = "statType", required = false) String statType,
+                                                               @RequestParam(value = "pageNum", required = false) Integer pageNum,
+                                                               @RequestParam(value = "pageSize", required = false) Integer pageSize) {
+        String methodDescribe = getMethodDescribe("itemDetail");
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS,
+                checksquareService.itemDetail(itemId, detailType, statType, pageNum, pageSize), methodDescribe);
+    }
 }

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/mapper/SteadyChecksquareDetailMapper.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareDetailPO;
+
+/**
+ * 数据校验明细 Mapper。
+ */
+public interface SteadyChecksquareDetailMapper extends BaseMapper<SteadyChecksquareDetailPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/mapper/SteadyChecksquareItemMapper.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareItemPO;
+
+/**
+ * 数据校验检测项 Mapper。
+ */
+public interface SteadyChecksquareItemMapper extends BaseMapper<SteadyChecksquareItemPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/mapper/SteadyChecksquareStatSummaryMapper.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareStatSummaryPO;
+
+/**
+ * 数据校验统计摘要 Mapper。
+ */
+public interface SteadyChecksquareStatSummaryMapper extends BaseMapper<SteadyChecksquareStatSummaryPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/mapper/SteadyChecksquareTaskMapper.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareTaskPO;
+
+/**
+ * 数据校验任务 Mapper。
+ */
+public interface SteadyChecksquareTaskMapper extends BaseMapper<SteadyChecksquareTaskPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/bo/SteadyChecksquareValuePointBO.java

@@ -0,0 +1,22 @@
+package com.njcn.gather.steady.checksquare.pojo.bo;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 数据校验指标值时间点。
+ */
+@Data
+public class SteadyChecksquareValuePointBO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    /** 对齐后的统计时间。 */
+    private LocalDateTime time;
+
+    /** 指标值。 */
+    private BigDecimal value;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/constant/SteadyChecksquareConst.java

@@ -0,0 +1,18 @@
+package com.njcn.gather.steady.checksquare.pojo.constant;
+
+/**
+ * 数据校验常量。
+ */
+public final class SteadyChecksquareConst {
+
+    public static final int STATE_DELETED = 0;
+    public static final int STATE_ENABLED = 1;
+
+    public static final String TASK_STATUS_SUCCESS = "SUCCESS";
+    public static final String DETAIL_TYPE_SEGMENT = "SEGMENT";
+    public static final String DETAIL_TYPE_VALUE_ORDER = "VALUE_ORDER";
+    public static final String DETAIL_TYPE_HARMONIC_PARITY = "HARMONIC_PARITY";
+
+    private SteadyChecksquareConst() {
+    }
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/param/SteadyChecksquareHistoryQueryParam.java

@@ -0,0 +1,31 @@
+package com.njcn.gather.steady.checksquare.pojo.param;
+
+import com.njcn.web.pojo.param.BaseParam;
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * 数据校验历史查询参数。
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ApiModel("数据校验历史查询参数")
+public class SteadyChecksquareHistoryQueryParam extends BaseParam {
+
+    @ApiModelProperty("监测点 ID")
+    private String lineId;
+
+    @ApiModelProperty("指标编码")
+    private String indicatorCode;
+
+    @ApiModelProperty("检测开始时间，格式 yyyy-MM-dd HH:mm:ss")
+    private String timeStart;
+
+    @ApiModelProperty("检测结束时间，格式 yyyy-MM-dd HH:mm:ss")
+    private String timeEnd;
+
+    @ApiModelProperty("是否存在异常")
+    private Boolean hasAbnormal;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/param/SteadyChecksquareQueryParam.java

@@ -8,10 +8,10 @@ import java.io.Serializable;
 import java.util.List;
 
 /**
- * 数据校验查询参数。
+ * 数据校验新增检测参数。
  */
 @Data
-@ApiModel("数据校验查询参数")
+@ApiModel("数据校验新增检测参数")
 public class SteadyChecksquareQueryParam implements Serializable {
 
     private static final long serialVersionUID = 1L;
@@ -27,7 +27,4 @@ public class SteadyChecksquareQueryParam implements Serializable {
 
     @ApiModelProperty("结束时间，格式 yyyy-MM-dd HH:mm:ss")
     private String timeEnd;
-
-    @ApiModelProperty("谐波次数，谐波指标按请求次数查询")
-    private List<Integer> harmonicOrders;
 }

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/po/SteadyChecksquareDetailPO.java

@@ -0,0 +1,67 @@
+package com.njcn.gather.steady.checksquare.pojo.po;
+
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 数据校验明细。
+ */
+@Data
+@TableName("steady_checksquare_detail")
+public class SteadyChecksquareDetailPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId("id")
+    private String id;
+    @TableField("item_id")
+    private String itemId;
+    @TableField("detail_type")
+    private String detailType;
+    @TableField("stat_type")
+    private String statType;
+    @TableField("start_time")
+    private LocalDateTime startTime;
+    @TableField("end_time")
+    private LocalDateTime endTime;
+    @TableField("point_time")
+    private LocalDateTime pointTime;
+    @TableField("segment_status")
+    private String segmentStatus;
+    @TableField("missing_point_count")
+    private Integer missingPointCount;
+    @TableField("duration_minutes")
+    private Integer durationMinutes;
+    @TableField("phase")
+    private String phase;
+    @TableField("harmonic_order")
+    private Integer harmonicOrder;
+    @TableField("max_value")
+    private BigDecimal maxValue;
+    @TableField("min_value")
+    private BigDecimal minValue;
+    @TableField("avg_value")
+    private BigDecimal avgValue;
+    @TableField("cp95_value")
+    private BigDecimal cp95Value;
+    @TableField("even_harmonic_order")
+    private Integer evenHarmonicOrder;
+    @TableField("even_value")
+    private BigDecimal evenValue;
+    @TableField("odd_harmonic_orders_json")
+    private String oddHarmonicOrdersJson;
+    @TableField("odd_values_json")
+    private String oddValuesJson;
+    @TableField("odd_median_value")
+    private BigDecimal oddMedianValue;
+    @TableField("threshold_multiplier")
+    private BigDecimal thresholdMultiplier;
+    @TableField("create_time")
+    private LocalDateTime createTime;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/po/SteadyChecksquareItemPO.java

@@ -0,0 +1,61 @@
+package com.njcn.gather.steady.checksquare.pojo.po;
+
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 数据校验检测项。
+ */
+@Data
+@TableName("steady_checksquare_item")
+public class SteadyChecksquareItemPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId("id")
+    private String id;
+    @TableField("task_id")
+    private String taskId;
+    @TableField("item_key")
+    private String itemKey;
+    @TableField("indicator_code")
+    private String indicatorCode;
+    @TableField("indicator_name")
+    private String indicatorName;
+    @TableField("harmonic_order")
+    private Integer harmonicOrder;
+    @TableField("interval_minutes")
+    private Integer intervalMinutes;
+    @TableField("has_data")
+    private Integer hasData;
+    @TableField("expected_point_count")
+    private Integer expectedPointCount;
+    @TableField("actual_point_count")
+    private Integer actualPointCount;
+    @TableField("missing_point_count")
+    private Integer missingPointCount;
+    @TableField("data_integrity")
+    private BigDecimal dataIntegrity;
+    @TableField("data_integrity_text")
+    private String dataIntegrityText;
+    @TableField("abnormal")
+    private Integer abnormal;
+    @TableField("abnormal_point_count")
+    private Integer abnormalPointCount;
+    @TableField("harmonic_parity_abnormal")
+    private Integer harmonicParityAbnormal;
+    @TableField("harmonic_parity_abnormal_point_count")
+    private Integer harmonicParityAbnormalPointCount;
+    @TableField("state")
+    private Integer state;
+    @TableField("create_time")
+    private LocalDateTime createTime;
+    @TableField("update_time")
+    private LocalDateTime updateTime;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/po/SteadyChecksquareStatSummaryPO.java

@@ -0,0 +1,43 @@
+package com.njcn.gather.steady.checksquare.pojo.po;
+
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 数据校验统计摘要。
+ */
+@Data
+@TableName("steady_checksquare_stat_summary")
+public class SteadyChecksquareStatSummaryPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId("id")
+    private String id;
+    @TableField("item_id")
+    private String itemId;
+    @TableField("stat_type")
+    private String statType;
+    @TableField("supported")
+    private Integer supported;
+    @TableField("has_data")
+    private Integer hasData;
+    @TableField("expected_point_count")
+    private Integer expectedPointCount;
+    @TableField("actual_point_count")
+    private Integer actualPointCount;
+    @TableField("missing_point_count")
+    private Integer missingPointCount;
+    @TableField("data_integrity")
+    private BigDecimal dataIntegrity;
+    @TableField("data_integrity_text")
+    private String dataIntegrityText;
+    @TableField("create_time")
+    private LocalDateTime createTime;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/po/SteadyChecksquareTaskPO.java

@@ -0,0 +1,59 @@
+package com.njcn.gather.steady.checksquare.pojo.po;
+
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * 数据校验任务。
+ */
+@Data
+@TableName("steady_checksquare_task")
+public class SteadyChecksquareTaskPO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @TableId("id")
+    private String id;
+    @TableField("task_no")
+    private String taskNo;
+    @TableField("line_id")
+    private String lineId;
+    @TableField("line_name")
+    private String lineName;
+    @TableField("time_start")
+    private LocalDateTime timeStart;
+    @TableField("time_end")
+    private LocalDateTime timeEnd;
+    @TableField("interval_minutes")
+    private Integer intervalMinutes;
+    @TableField("indicator_codes_json")
+    private String indicatorCodesJson;
+    @TableField("indicator_codes_text")
+    private String indicatorCodesText;
+    @TableField("task_status")
+    private String taskStatus;
+    @TableField("item_count")
+    private Integer itemCount;
+    @TableField("abnormal_item_count")
+    private Integer abnormalItemCount;
+    @TableField("min_data_integrity")
+    private BigDecimal minDataIntegrity;
+    @TableField("result_message")
+    private String resultMessage;
+    @TableField("state")
+    private Integer state;
+    @TableField("create_by")
+    private String createBy;
+    @TableField("create_time")
+    private LocalDateTime createTime;
+    @TableField("update_by")
+    private String updateBy;
+    @TableField("update_time")
+    private LocalDateTime updateTime;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareCreateVO.java

@@ -0,0 +1,44 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+
+/**
+ * 新增数据校验结果。
+ */
+@Data
+@ApiModel("新增数据校验结果")
+public class SteadyChecksquareCreateVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("任务 ID")
+    private String taskId;
+
+    @ApiModelProperty("任务编号")
+    private String taskNo;
+
+    @ApiModelProperty("监测点 ID")
+    private String lineId;
+
+    @ApiModelProperty("监测点名称")
+    private String lineName;
+
+    @ApiModelProperty("开始时间")
+    private String timeStart;
+
+    @ApiModelProperty("结束时间")
+    private String timeEnd;
+
+    @ApiModelProperty("统计间隔，单位分钟")
+    private Integer intervalMinutes;
+
+    @ApiModelProperty("检测项数量")
+    private Integer itemCount;
+
+    @ApiModelProperty("异常检测项数量")
+    private Integer abnormalItemCount;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareHarmonicParityDetailVO.java

@@ -0,0 +1,47 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 谐波奇偶关系异常明细。
+ */
+@Data
+@ApiModel("谐波奇偶关系异常明细")
+public class SteadyChecksquareHarmonicParityDetailVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("时间")
+    private String time;
+
+    @ApiModelProperty("相别")
+    private String phase;
+
+    @ApiModelProperty("统计类型")
+    private String statType;
+
+    @ApiModelProperty("偶次谐波次数")
+    private Integer evenHarmonicOrder;
+
+    @ApiModelProperty("偶次谐波值")
+    private BigDecimal evenValue;
+
+    @ApiModelProperty("参与比较的奇次谐波次数")
+    private List<Integer> oddHarmonicOrders = new ArrayList<Integer>();
+
+    @ApiModelProperty("参与比较的奇次谐波值")
+    private List<BigDecimal> oddValues = new ArrayList<BigDecimal>();
+
+    @ApiModelProperty("奇次谐波中位数")
+    private BigDecimal oddMedianValue;
+
+    @ApiModelProperty("异常阈值倍数")
+    private BigDecimal thresholdMultiplier;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareHarmonicParityRuleVO.java

@@ -0,0 +1,23 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 谐波奇偶关系规则结果。
+ */
+@Data
+public class SteadyChecksquareHarmonicParityRuleVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    private Boolean abnormal = false;
+
+    private Integer abnormalPointCount = 0;
+
+    private List<SteadyChecksquareHarmonicParityDetailVO> abnormalDetails =
+            new ArrayList<SteadyChecksquareHarmonicParityDetailVO>();
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareItemDetailVO.java

@@ -0,0 +1,48 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 数据校验检测项明细。
+ */
+@Data
+@ApiModel("数据校验检测项明细")
+public class SteadyChecksquareItemDetailVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("检测项 ID")
+    private String itemId;
+
+    @ApiModelProperty("明细类型")
+    private String detailType;
+
+    @ApiModelProperty("统计类型")
+    private String statType;
+
+    @ApiModelProperty("当前页码；未分页查询时为空")
+    private Integer pageNum;
+
+    @ApiModelProperty("每页条数；未分页查询时为空")
+    private Integer pageSize;
+
+    @ApiModelProperty("总记录数；未分页查询时为空")
+    private Long total;
+
+    @ApiModelProperty("缺失区间")
+    private List<SteadyChecksquareSegmentVO> segments = new ArrayList<SteadyChecksquareSegmentVO>();
+
+    @ApiModelProperty("大小关系异常明细")
+    private List<SteadyChecksquareValueOrderDetailVO> valueOrderDetails =
+            new ArrayList<SteadyChecksquareValueOrderDetailVO>();
+
+    @ApiModelProperty("谐波奇偶关系异常明细")
+    private List<SteadyChecksquareHarmonicParityDetailVO> harmonicParityDetails =
+            new ArrayList<SteadyChecksquareHarmonicParityDetailVO>();
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareItemVO.java

@@ -18,6 +18,9 @@ public class SteadyChecksquareItemVO implements Serializable {
 
     private static final long serialVersionUID = 1L;
 
+    @ApiModelProperty("检测项 ID")
+    private String itemId;
+
     @ApiModelProperty("校验项唯一键")
     private String itemKey;
 
@@ -45,14 +48,30 @@ public class SteadyChecksquareItemVO implements Serializable {
     @ApiModelProperty("缺失点数")
     private Integer missingPointCount;
 
-    @ApiModelProperty("缺失率")
-    private BigDecimal missingRate;
+    @ApiModelProperty("数据完整性")
+    private BigDecimal dataIntegrity;
 
-    @ApiModelProperty("缺失率文本")
-    private String missingRateText;
+    @ApiModelProperty("数据完整性文本")
+    private String dataIntegrityText;
 
-    @ApiModelProperty("最大连续缺失时长，单位分钟")
-    private Integer maxContinuousMissingMinutes;
+    @ApiModelProperty("指标值大小关系是否异常")
+    private Boolean abnormal;
+
+    @ApiModelProperty("指标值大小关系异常累计值")
+    private Integer abnormalPointCount;
+
+    @ApiModelProperty("指标值大小关系异常明细")
+    private List<SteadyChecksquareValueOrderDetailVO> abnormalDetails = new ArrayList<SteadyChecksquareValueOrderDetailVO>();
+
+    @ApiModelProperty("谐波奇偶关系是否异常")
+    private Boolean harmonicParityAbnormal;
+
+    @ApiModelProperty("谐波奇偶关系异常累计值")
+    private Integer harmonicParityAbnormalPointCount;
+
+    @ApiModelProperty("谐波奇偶关系异常明细")
+    private List<SteadyChecksquareHarmonicParityDetailVO> harmonicParityAbnormalDetails =
+            new ArrayList<SteadyChecksquareHarmonicParityDetailVO>();
 
     @ApiModelProperty("统计类型摘要")
     private List<SteadyChecksquareStatSummaryVO> statSummaries = new ArrayList<SteadyChecksquareStatSummaryVO>();

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareQueryVO.java

@@ -17,6 +17,12 @@ public class SteadyChecksquareQueryVO implements Serializable {
 
     private static final long serialVersionUID = 1L;
 
+    @ApiModelProperty("任务 ID")
+    private String taskId;
+
+    @ApiModelProperty("任务编号")
+    private String taskNo;
+
     @ApiModelProperty("监测点 ID")
     private String lineId;
 

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareSegmentVO.java

@@ -24,6 +24,9 @@ public class SteadyChecksquareSegmentVO implements Serializable {
     @ApiModelProperty("状态，NORMAL/MISSING")
     private String status;
 
+    @ApiModelProperty("谐波次数")
+    private Integer harmonicOrder;
+
     @ApiModelProperty("缺失点数")
     private Integer missingPointCount;
 

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareStatSummaryVO.java

@@ -34,12 +34,9 @@ public class SteadyChecksquareStatSummaryVO implements Serializable {
     @ApiModelProperty("缺失点数")
     private Integer missingPointCount;
 
-    @ApiModelProperty("缺失率")
-    private BigDecimal missingRate;
+    @ApiModelProperty("数据完整性")
+    private BigDecimal dataIntegrity;
 
-    @ApiModelProperty("缺失率文本")
-    private String missingRateText;
-
-    @ApiModelProperty("最大连续缺失时长，单位分钟")
-    private Integer maxContinuousMissingMinutes;
+    @ApiModelProperty("数据完整性文本")
+    private String dataIntegrityText;
 }

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareTaskVO.java

@@ -0,0 +1,54 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 数据校验历史任务。
+ */
+@Data
+@ApiModel("数据校验历史任务")
+public class SteadyChecksquareTaskVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("任务 ID")
+    private String taskId;
+
+    @ApiModelProperty("任务编号")
+    private String taskNo;
+
+    @ApiModelProperty("监测点 ID")
+    private String lineId;
+
+    @ApiModelProperty("监测点名称")
+    private String lineName;
+
+    @ApiModelProperty("开始时间")
+    private String timeStart;
+
+    @ApiModelProperty("结束时间")
+    private String timeEnd;
+
+    @ApiModelProperty("统计间隔，单位分钟")
+    private Integer intervalMinutes;
+
+    @ApiModelProperty("任务状态")
+    private String taskStatus;
+
+    @ApiModelProperty("检测项数量")
+    private Integer itemCount;
+
+    @ApiModelProperty("异常检测项数量")
+    private Integer abnormalItemCount;
+
+    @ApiModelProperty("最低数据完整性")
+    private BigDecimal minDataIntegrity;
+
+    @ApiModelProperty("创建时间")
+    private String createTime;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareValueOrderDetailVO.java

@@ -0,0 +1,39 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.math.BigDecimal;
+
+/**
+ * 数据校验指标值大小关系异常明细。
+ */
+@Data
+@ApiModel("数据校验指标值大小关系异常明细")
+public class SteadyChecksquareValueOrderDetailVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    @ApiModelProperty("时间")
+    private String time;
+
+    @ApiModelProperty("相别")
+    private String phase;
+
+    @ApiModelProperty("谐波次数")
+    private Integer harmonicOrder;
+
+    @ApiModelProperty("最大值")
+    private BigDecimal maxValue;
+
+    @ApiModelProperty("最小值")
+    private BigDecimal minValue;
+
+    @ApiModelProperty("平均值")
+    private BigDecimal avgValue;
+
+    @ApiModelProperty("CP95 值")
+    private BigDecimal cp95Value;
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/pojo/vo/SteadyChecksquareValueOrderRuleVO.java

@@ -0,0 +1,22 @@
+package com.njcn.gather.steady.checksquare.pojo.vo;
+
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * 数据校验指标值大小关系规则结果。
+ */
+@Data
+public class SteadyChecksquareValueOrderRuleVO implements Serializable {
+
+    private static final long serialVersionUID = 1L;
+
+    private Boolean abnormal = false;
+
+    private Integer abnormalPointCount = 0;
+
+    private List<SteadyChecksquareValueOrderDetailVO> abnormalDetails = new ArrayList<SteadyChecksquareValueOrderDetailVO>();
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/SteadyChecksquareDetailService.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareDetailPO;
+
+/**
+ * 数据校验明细服务。
+ */
+public interface SteadyChecksquareDetailService extends IService<SteadyChecksquareDetailPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/SteadyChecksquareItemService.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareItemPO;
+
+/**
+ * 数据校验检测项服务。
+ */
+public interface SteadyChecksquareItemService extends IService<SteadyChecksquareItemPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/SteadyChecksquareService.java

@@ -1,12 +1,30 @@
 package com.njcn.gather.steady.checksquare.service;
 
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareHistoryQueryParam;
 import com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareQueryParam;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareCreateVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareItemDetailVO;
 import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareQueryVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareTaskVO;
+
+import java.util.List;
 
 /**
  * 数据校验服务。
  */
 public interface SteadyChecksquareService {
 
-    SteadyChecksquareQueryVO query(SteadyChecksquareQueryParam param);
+    Page<SteadyChecksquareTaskVO> query(SteadyChecksquareHistoryQueryParam param);
+
+    SteadyChecksquareCreateVO create(SteadyChecksquareQueryParam param);
+
+    boolean delete(List<String> taskIds);
+
+    SteadyChecksquareQueryVO detail(String taskId);
+
+    SteadyChecksquareItemDetailVO itemDetail(String itemId, String detailType, String statType);
+
+    SteadyChecksquareItemDetailVO itemDetail(String itemId, String detailType, String statType,
+                                             Integer pageNum, Integer pageSize);
 }

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/SteadyChecksquareStatSummaryService.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareStatSummaryPO;
+
+/**
+ * 数据校验统计摘要服务。
+ */
+public interface SteadyChecksquareStatSummaryService extends IService<SteadyChecksquareStatSummaryPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/SteadyChecksquareTaskService.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.steady.checksquare.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareTaskPO;
+
+/**
+ * 数据校验任务服务。
+ */
+public interface SteadyChecksquareTaskService extends IService<SteadyChecksquareTaskPO> {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/impl/SteadyChecksquareDetailServiceImpl.java

@@ -0,0 +1,15 @@
+package com.njcn.gather.steady.checksquare.service.impl;
+
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.njcn.gather.steady.checksquare.mapper.SteadyChecksquareDetailMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareDetailPO;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareDetailService;
+import org.springframework.stereotype.Service;
+
+/**
+ * 数据校验明细服务实现。
+ */
+@Service
+public class SteadyChecksquareDetailServiceImpl extends ServiceImpl<SteadyChecksquareDetailMapper, SteadyChecksquareDetailPO>
+        implements SteadyChecksquareDetailService {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/impl/SteadyChecksquareItemServiceImpl.java

@@ -0,0 +1,15 @@
+package com.njcn.gather.steady.checksquare.service.impl;
+
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.njcn.gather.steady.checksquare.mapper.SteadyChecksquareItemMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareItemPO;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareItemService;
+import org.springframework.stereotype.Service;
+
+/**
+ * 数据校验检测项服务实现。
+ */
+@Service
+public class SteadyChecksquareItemServiceImpl extends ServiceImpl<SteadyChecksquareItemMapper, SteadyChecksquareItemPO>
+        implements SteadyChecksquareItemService {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/impl/SteadyChecksquareStatSummaryServiceImpl.java

@@ -0,0 +1,16 @@
+package com.njcn.gather.steady.checksquare.service.impl;
+
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.njcn.gather.steady.checksquare.mapper.SteadyChecksquareStatSummaryMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareStatSummaryPO;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareStatSummaryService;
+import org.springframework.stereotype.Service;
+
+/**
+ * 数据校验统计摘要服务实现。
+ */
+@Service
+public class SteadyChecksquareStatSummaryServiceImpl
+        extends ServiceImpl<SteadyChecksquareStatSummaryMapper, SteadyChecksquareStatSummaryPO>
+        implements SteadyChecksquareStatSummaryService {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/service/impl/SteadyChecksquareTaskServiceImpl.java

@@ -0,0 +1,15 @@
+package com.njcn.gather.steady.checksquare.service.impl;
+
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import com.njcn.gather.steady.checksquare.mapper.SteadyChecksquareTaskMapper;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareTaskPO;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareTaskService;
+import org.springframework.stereotype.Service;
+
+/**
+ * 数据校验任务服务实现。
+ */
+@Service
+public class SteadyChecksquareTaskServiceImpl extends ServiceImpl<SteadyChecksquareTaskMapper, SteadyChecksquareTaskPO>
+        implements SteadyChecksquareTaskService {
+}

steady/steady-DataView/src/main/java/com/njcn/gather/steady/checksquare/util/SteadyChecksquareIdUtil.java

@@ -0,0 +1,24 @@
+package com.njcn.gather.steady.checksquare.util;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.UUID;
+
+/**
+ * 数据校验编号工具。
+ */
+public final class SteadyChecksquareIdUtil {
+
+    private static final DateTimeFormatter TASK_FORMATTER = DateTimeFormatter.ofPattern("yyyyMMddHHmmssSSS");
+
+    private SteadyChecksquareIdUtil() {
+    }
+
+    public static String uuid() {
+        return UUID.randomUUID().toString().replace("-", "");
+    }
+
+    public static String taskNo() {
+        return "CS" + LocalDateTime.now().format(TASK_FORMATTER);
+    }
+}

steady/steady-DataView/src/main/resources/sql/steady-DataView/steady-checksquare-result-init.sql

@@ -0,0 +1,102 @@
+CREATE TABLE IF NOT EXISTS `steady_checksquare_task` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `task_no` VARCHAR(64) NOT NULL COMMENT '检测任务编号',
+    `line_id` VARCHAR(64) NOT NULL COMMENT '监测点ID',
+    `line_name` VARCHAR(255) NULL COMMENT '监测点名称',
+    `time_start` DATETIME NOT NULL COMMENT '检测开始时间',
+    `time_end` DATETIME NOT NULL COMMENT '检测结束时间',
+    `interval_minutes` INT NULL COMMENT '默认统计间隔，单位分钟',
+    `indicator_codes_json` JSON NULL COMMENT '请求指标编码列表',
+    `indicator_codes_text` VARCHAR(2000) NULL COMMENT '请求指标编码检索文本，格式 |code1|code2|',
+    `task_status` VARCHAR(32) NOT NULL DEFAULT 'SUCCESS' COMMENT '任务状态：SUCCESS/FAIL',
+    `item_count` INT NOT NULL DEFAULT 0 COMMENT '检测项数量',
+    `abnormal_item_count` INT NOT NULL DEFAULT 0 COMMENT '异常检测项数量',
+    `min_data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '最低数据完整性',
+    `result_message` VARCHAR(2000) NULL COMMENT '执行结果说明',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_by` VARCHAR(64) NULL COMMENT '创建人',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_by` VARCHAR(64) NULL COMMENT '更新人',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_steady_checksquare_task_no` (`task_no`),
+    KEY `idx_steady_checksquare_task_line_time` (`line_id`, `time_start`, `time_end`),
+    KEY `idx_steady_checksquare_task_status` (`task_status`),
+    KEY `idx_steady_checksquare_task_indicator_text` (`indicator_codes_text`(255)),
+    KEY `idx_steady_checksquare_task_create_time` (`create_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='稳态数据校验任务表';
+
+CREATE TABLE IF NOT EXISTS `steady_checksquare_item` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `task_id` VARCHAR(64) NOT NULL COMMENT '检测任务ID',
+    `item_key` VARCHAR(255) NOT NULL COMMENT '检测项唯一键',
+    `indicator_code` VARCHAR(64) NOT NULL COMMENT '指标编码',
+    `indicator_name` VARCHAR(255) NULL COMMENT '指标名称',
+    `harmonic_order` INT NULL COMMENT '谐波次数；聚合项为空',
+    `interval_minutes` INT NULL COMMENT '当前检测项统计间隔，单位分钟',
+    `has_data` TINYINT NOT NULL DEFAULT 0 COMMENT '是否存在任意数据：0-否，1-是',
+    `expected_point_count` INT NOT NULL DEFAULT 0 COMMENT '期望点数',
+    `actual_point_count` INT NOT NULL DEFAULT 0 COMMENT '实际点数',
+    `missing_point_count` INT NOT NULL DEFAULT 0 COMMENT '缺失点数',
+    `data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '数据完整性',
+    `data_integrity_text` VARCHAR(32) NULL COMMENT '数据完整性文本',
+    `abnormal` TINYINT NOT NULL DEFAULT 0 COMMENT '指标值大小关系是否异常',
+    `abnormal_point_count` INT NOT NULL DEFAULT 0 COMMENT '大小关系异常点数',
+    `harmonic_parity_abnormal` TINYINT NOT NULL DEFAULT 0 COMMENT '谐波奇偶关系是否异常',
+    `harmonic_parity_abnormal_point_count` INT NOT NULL DEFAULT 0 COMMENT '谐波奇偶关系异常点数',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_steady_checksquare_item` (`task_id`, `item_key`),
+    KEY `idx_steady_checksquare_item_indicator` (`indicator_code`),
+    KEY `idx_steady_checksquare_item_abnormal` (`abnormal`, `harmonic_parity_abnormal`),
+    KEY `idx_steady_checksquare_item_data_integrity` (`data_integrity`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='稳态数据校验检测项表';
+
+CREATE TABLE IF NOT EXISTS `steady_checksquare_stat_summary` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `item_id` VARCHAR(64) NOT NULL COMMENT '检测项ID',
+    `stat_type` VARCHAR(16) NOT NULL COMMENT '统计类型：AVG/MAX/MIN/CP95',
+    `supported` TINYINT NOT NULL DEFAULT 1 COMMENT '是否支持',
+    `has_data` TINYINT NOT NULL DEFAULT 0 COMMENT '是否存在数据',
+    `expected_point_count` INT NOT NULL DEFAULT 0 COMMENT '期望点数',
+    `actual_point_count` INT NOT NULL DEFAULT 0 COMMENT '实际点数',
+    `missing_point_count` INT NOT NULL DEFAULT 0 COMMENT '缺失点数',
+    `data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '数据完整性',
+    `data_integrity_text` VARCHAR(32) NULL COMMENT '数据完整性文本',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_steady_checksquare_stat` (`item_id`, `stat_type`),
+    KEY `idx_steady_checksquare_stat_type` (`stat_type`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='稳态数据校验统计摘要表';
+
+CREATE TABLE IF NOT EXISTS `steady_checksquare_detail` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `item_id` VARCHAR(64) NOT NULL COMMENT '检测项ID',
+    `detail_type` VARCHAR(32) NOT NULL COMMENT '明细类型：SEGMENT/VALUE_ORDER/HARMONIC_PARITY',
+    `stat_type` VARCHAR(16) NULL COMMENT '统计类型',
+    `start_time` DATETIME NULL COMMENT '区间开始时间',
+    `end_time` DATETIME NULL COMMENT '区间结束时间',
+    `point_time` DATETIME NULL COMMENT '异常点时间',
+    `segment_status` VARCHAR(16) NULL COMMENT '区间状态：NORMAL/MISSING',
+    `missing_point_count` INT NULL COMMENT '缺失点数',
+    `duration_minutes` INT NULL COMMENT '持续时长，单位分钟',
+    `phase` VARCHAR(16) NULL COMMENT '相别',
+    `harmonic_order` INT NULL COMMENT '谐波次数',
+    `max_value` DECIMAL(24,8) NULL COMMENT '最大值',
+    `min_value` DECIMAL(24,8) NULL COMMENT '最小值',
+    `avg_value` DECIMAL(24,8) NULL COMMENT '平均值',
+    `cp95_value` DECIMAL(24,8) NULL COMMENT 'CP95值',
+    `even_harmonic_order` INT NULL COMMENT '偶次谐波次数',
+    `even_value` DECIMAL(24,8) NULL COMMENT '偶次谐波值',
+    `odd_harmonic_orders_json` JSON NULL COMMENT '参与比较的奇次谐波次数',
+    `odd_values_json` JSON NULL COMMENT '参与比较的奇次谐波值',
+    `odd_median_value` DECIMAL(24,8) NULL COMMENT '奇次谐波中位数',
+    `threshold_multiplier` DECIMAL(12,6) NULL COMMENT '异常阈值倍数',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    PRIMARY KEY (`id`),
+    KEY `idx_steady_checksquare_detail_item_type` (`item_id`, `detail_type`),
+    KEY `idx_steady_checksquare_detail_point_time` (`point_time`),
+    KEY `idx_steady_checksquare_detail_segment` (`start_time`, `end_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='稳态数据校验明细表';

steady/steady-DataView/src/main/resources/sql/steady-DataView/steady-checksquare-result-upgrade_20260611.sql

@@ -0,0 +1,14 @@
+ALTER TABLE `steady_checksquare_task`
+    CHANGE COLUMN `max_missing_rate` `min_data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '最低数据完整性';
+
+ALTER TABLE `steady_checksquare_item`
+    DROP INDEX `idx_steady_checksquare_item_missing_rate`,
+    CHANGE COLUMN `missing_rate` `data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '数据完整性',
+    CHANGE COLUMN `missing_rate_text` `data_integrity_text` VARCHAR(32) NULL COMMENT '数据完整性文本',
+    DROP COLUMN `max_continuous_missing_minutes`,
+    ADD KEY `idx_steady_checksquare_item_data_integrity` (`data_integrity`);
+
+ALTER TABLE `steady_checksquare_stat_summary`
+    CHANGE COLUMN `missing_rate` `data_integrity` DECIMAL(12,6) NOT NULL DEFAULT 0.000000 COMMENT '数据完整性',
+    CHANGE COLUMN `missing_rate_text` `data_integrity_text` VARCHAR(32) NULL COMMENT '数据完整性文本',
+    DROP COLUMN `max_continuous_missing_minutes`;

steady/steady-DataView/src/main/resources/sql/steady-DataView/steady-data-view-index.sql

@@ -0,0 +1,41 @@
+-- 稳态数据查看建议索引。
+-- 本脚本不自动执行，请按数据库现状审阅后单独执行。
+
+CREATE INDEX idx_data_v_time_line_phase
+ON data_v (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_i_time_line_phase
+ON data_i (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_flicker_time_line_phase
+ON data_flicker (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_fluc_time_line_phase
+ON data_fluc (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmphasic_i_time_line_phase
+ON data_harmphasic_i (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmphasic_v_time_line_phase
+ON data_harmphasic_v (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmpower_p_time_line_phase
+ON data_harmpower_p (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmpower_q_time_line_phase
+ON data_harmpower_q (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmpower_s_time_line_phase
+ON data_harmpower_s (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmrate_i_time_line_phase
+ON data_harmrate_i (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_harmrate_v_time_line_phase
+ON data_harmrate_v (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_inharm_i_time_line_phase
+ON data_inharm_i (TIMEID, LINEID, PHASIC_TYPE);
+
+CREATE INDEX idx_data_plt_time_line_phase
+ON data_plt (TIMEID, LINEID, PHASIC_TYPE);

steady/steady-DataView/src/main/resources/sql/steady-DataView/steady-menu-icon-update_20260525.sql

@@ -0,0 +1,42 @@
+-- 稳态模块菜单图标修正脚本。
+-- 本脚本不自动执行，请按数据库现状审阅后单独执行。
+
+UPDATE sys_function
+SET Icon = 'DataAnalysis'
+WHERE State = 1
+  AND Type = 0
+  AND (
+        Name = '稳态模块'
+        OR Code IN ('steady', 'steadyModule', 'steadyDataView')
+        OR Path IN ('/steady', '/steadyDataView', '/steady/data-view')
+      );
+
+UPDATE sys_function
+SET Icon = 'DataBoard'
+WHERE State = 1
+  AND Type = 0
+  AND (
+        Name = '稳态数据'
+        OR Code IN ('steadyData', 'steadyDataDetail')
+        OR Path IN ('/steady/data', '/steady/data-view/detail', '/steadyDataView/index')
+      );
+
+UPDATE sys_function
+SET Icon = 'TrendCharts'
+WHERE State = 1
+  AND Type = 0
+  AND (
+        Name = '稳态趋势'
+        OR Code IN ('steadyTrend', 'steadyDataTrend')
+        OR Path IN ('/steady/trend', '/steady/data-view/trend', '/steadyTrend/index')
+      );
+
+UPDATE sys_function
+SET Icon = 'CircleCheck'
+WHERE State = 1
+  AND Type = 0
+  AND (
+        Name = '数据验证'
+        OR Code IN ('dataValidation', 'steadyDataValidation')
+        OR Path IN ('/steady/data-validation', '/steady/data-view/validation', '/dataValidation/index')
+      );

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareHarmonicParityRuleComponentTest.java

@@ -0,0 +1,147 @@
+package com.njcn.gather.steady.checksquare.component;
+
+import com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityDetailVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityRuleVO;
+import com.njcn.gather.steady.datavie.component.SteadyTrendIndicatorCatalog;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendIndicatorDefinitionBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyInt;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 谐波奇偶关系规则测试。
+ */
+class SteadyChecksquareHarmonicParityRuleComponentTest {
+
+    @Test
+    void shouldRecordAbnormalWhenEvenHarmonicExceedsOddMedianThreshold() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent component = new SteadyChecksquareHarmonicParityRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePointMap(any(),
+                any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenAnswer(invocation -> {
+                    Map<String, List<SteadyChecksquareValuePointBO>> values = emptyBatchResult(invocation.getArgument(0));
+                    putPoint(values, "v_3", time, "10");
+                    putPoint(values, "v_4", time, "31");
+                    putPoint(values, "v_5", time, "12");
+                    putPoint(values, "v_7", time, "14");
+                    return values;
+                });
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorCatalog().getIndicator("V_HARMONIC");
+
+        SteadyChecksquareHarmonicParityRuleVO result = component.check("line-001", indicator,
+                time, time, 1);
+
+        Assertions.assertEquals(Boolean.TRUE, result.getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(1), result.getAbnormalPointCount());
+        SteadyChecksquareHarmonicParityDetailVO detail = result.getAbnormalDetails().get(0);
+        Assertions.assertEquals("2026-05-01 00:00:00", detail.getTime());
+        Assertions.assertEquals("A", detail.getPhase());
+        Assertions.assertEquals("AVG", detail.getStatType());
+        Assertions.assertEquals(Integer.valueOf(4), detail.getEvenHarmonicOrder());
+        Assertions.assertEquals(new BigDecimal("31"), detail.getEvenValue());
+        Assertions.assertEquals(Arrays.asList(3, 5, 7), detail.getOddHarmonicOrders());
+        Assertions.assertEquals(new BigDecimal("12"), detail.getOddMedianValue());
+        Assertions.assertEquals(new BigDecimal("2"), detail.getThresholdMultiplier());
+    }
+
+    @Test
+    void shouldSkipWhenOddReferenceCountLessThanTwo() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent component = new SteadyChecksquareHarmonicParityRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePointMap(any(),
+                any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenAnswer(invocation -> {
+                    Map<String, List<SteadyChecksquareValuePointBO>> values = emptyBatchResult(invocation.getArgument(0));
+                    putPoint(values, "v_2", time, "50");
+                    putPoint(values, "v_3", time, "10");
+                    return values;
+                });
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorCatalog().getIndicator("V_HARMONIC");
+
+        SteadyChecksquareHarmonicParityRuleVO result = component.check("line-001", indicator,
+                time, time, 1);
+
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    @Test
+    void shouldSkipEvenHarmonicWhenValueNotGreaterThanDeadband() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent component = new SteadyChecksquareHarmonicParityRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePointMap(any(),
+                any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenAnswer(invocation -> {
+                    Map<String, List<SteadyChecksquareValuePointBO>> values = emptyBatchResult(invocation.getArgument(0));
+                    putPoint(values, "v_3", time, "0.01");
+                    putPoint(values, "v_4", time, "0.10");
+                    putPoint(values, "v_5", time, "0.02");
+                    return values;
+                });
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorCatalog().getIndicator("V_HARMONIC");
+
+        SteadyChecksquareHarmonicParityRuleVO result = component.check("line-001", indicator,
+                time, time, 1);
+
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    @Test
+    void shouldSkipNonHarmonicIndicator() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent component = new SteadyChecksquareHarmonicParityRuleComponent(influxQueryComponent);
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorCatalog().getIndicator("V_RMS");
+
+        SteadyChecksquareHarmonicParityRuleVO result = component.check("line-001", indicator,
+                LocalDateTime.of(2026, 5, 1, 0, 0),
+                LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    private SteadyChecksquareValuePointBO point(LocalDateTime time, String value) {
+        SteadyChecksquareValuePointBO point = new SteadyChecksquareValuePointBO();
+        point.setTime(time);
+        point.setValue(new BigDecimal(value));
+        return point;
+    }
+
+    private Map<String, List<SteadyChecksquareValuePointBO>> emptyBatchResult(List<SteadyTrendResolvedFieldBO> fields) {
+        Map<String, List<SteadyChecksquareValuePointBO>> result =
+                new LinkedHashMap<String, List<SteadyChecksquareValuePointBO>>();
+        for (SteadyTrendResolvedFieldBO field : fields) {
+            result.put(field.getField(), Collections.<SteadyChecksquareValuePointBO>emptyList());
+        }
+        return result;
+    }
+
+    private void putPoint(Map<String, List<SteadyChecksquareValuePointBO>> values, String field,
+                          LocalDateTime time, String value) {
+        if (values.containsKey(field)) {
+            values.put(field, Collections.singletonList(point(time, value)));
+        }
+    }
+}

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareInfluxQueryComponentTest.java

@@ -2,10 +2,16 @@ package com.njcn.gather.steady.checksquare.component;
 
 import com.njcn.gather.steady.datavie.config.SteadyInfluxDbProperties;
 import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
+import com.sun.net.httpserver.HttpServer;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+import java.net.InetSocketAddress;
+import java.nio.charset.StandardCharsets;
 import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Map;
+import java.util.concurrent.atomic.AtomicInteger;
 
 /**
  * 数据校验 InfluxQL 构造契约测试。
@@ -33,4 +39,115 @@ class SteadyChecksquareInfluxQueryComponentTest {
         Assertions.assertFalse(query.contains("quality_flag"));
         Assertions.assertFalse(query.contains("GROUP BY time"));
     }
+
+    @Test
+    void shouldBuildValuePointQueryWithStatTypeFilter() {
+        SteadyChecksquareInfluxQueryComponent component = new SteadyChecksquareInfluxQueryComponent(new SteadyInfluxDbProperties());
+        SteadyTrendResolvedFieldBO field = new SteadyTrendResolvedFieldBO();
+        field.setMeasurement("data_v");
+        field.setField("rms");
+        field.setLineId("line-001");
+        field.setPhase("A");
+        field.setStatType("CP95");
+
+        String query = component.buildValuePointQuery(field,
+                LocalDateTime.of(2026, 5, 1, 0, 0, 0),
+                LocalDateTime.of(2026, 5, 1, 23, 59, 59));
+
+        Assertions.assertTrue(query.contains("SELECT \"rms\" AS \"value\""));
+        Assertions.assertTrue(query.contains("\"line_id\" = 'line-001'"));
+        Assertions.assertTrue(query.contains("\"phasic_type\" = 'A'"));
+        Assertions.assertTrue(query.contains("\"value_type\" = 'CP95'"));
+        Assertions.assertTrue(query.endsWith("ORDER BY time ASC"));
+    }
+
+    @Test
+    void shouldReuseValuePointQueryWithinRequestCache() throws Exception {
+        AtomicInteger requestCount = new AtomicInteger();
+        HttpServer server = HttpServer.create(new InetSocketAddress(0), 0);
+        server.createContext("/query", exchange -> {
+            requestCount.incrementAndGet();
+            byte[] body = ("{\"results\":[{\"series\":[{\"values\":["
+                    + "[\"2026-05-01T00:00:00Z\",1.23],"
+                    + "[\"2026-05-01T00:01:00Z\",2.34]"
+                    + "]}]}]}").getBytes(StandardCharsets.UTF_8);
+            exchange.sendResponseHeaders(200, body.length);
+            exchange.getResponseBody().write(body);
+            exchange.close();
+        });
+        server.start();
+        try {
+            SteadyInfluxDbProperties properties = new SteadyInfluxDbProperties();
+            properties.setUrl("http://127.0.0.1:" + server.getAddress().getPort());
+            properties.setDatabase("steady");
+            SteadyChecksquareInfluxQueryComponent component = new SteadyChecksquareInfluxQueryComponent(properties);
+            SteadyTrendResolvedFieldBO field = new SteadyTrendResolvedFieldBO();
+            field.setMeasurement("data_v");
+            field.setField("rms");
+            field.setLineId("line-001");
+            field.setPhase("A");
+            field.setStatType("AVG");
+
+            component.enableRequestCache();
+            component.queryExistingSlots(field,
+                    LocalDateTime.of(2026, 5, 1, 0, 0, 0),
+                    LocalDateTime.of(2026, 5, 1, 0, 1, 0), 1);
+            component.queryValuePoints(field,
+                    LocalDateTime.of(2026, 5, 1, 0, 0, 0),
+                    LocalDateTime.of(2026, 5, 1, 0, 1, 0), 1);
+            component.clearRequestCache();
+
+            Assertions.assertEquals(1, requestCount.get());
+        } finally {
+            server.stop(0);
+        }
+    }
+
+    @Test
+    void shouldQueryMultipleValueFieldsOnce() throws Exception {
+        AtomicInteger requestCount = new AtomicInteger();
+        HttpServer server = HttpServer.create(new InetSocketAddress(0), 0);
+        server.createContext("/query", exchange -> {
+            requestCount.incrementAndGet();
+            byte[] body = ("{\"results\":[{\"series\":[{\"columns\":[\"time\",\"h_2\",\"h_3\"],\"values\":["
+                    + "[\"2026-05-01T00:00:00Z\",1.23,2.34],"
+                    + "[\"2026-05-01T00:01:00Z\",3.45,null]"
+                    + "]}]}]}").getBytes(StandardCharsets.UTF_8);
+            exchange.sendResponseHeaders(200, body.length);
+            exchange.getResponseBody().write(body);
+            exchange.close();
+        });
+        server.start();
+        try {
+            SteadyInfluxDbProperties properties = new SteadyInfluxDbProperties();
+            properties.setUrl("http://127.0.0.1:" + server.getAddress().getPort());
+            properties.setDatabase("steady");
+            SteadyChecksquareInfluxQueryComponent component = new SteadyChecksquareInfluxQueryComponent(properties);
+            SteadyTrendResolvedFieldBO h2 = buildField("h_2");
+            SteadyTrendResolvedFieldBO h3 = buildField("h_3");
+
+            component.enableRequestCache();
+            Map<String, java.util.List<com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO>> result =
+                    component.queryValuePointMap(Arrays.asList(h2, h3),
+                            LocalDateTime.of(2026, 5, 1, 0, 0, 0),
+                            LocalDateTime.of(2026, 5, 1, 0, 1, 0), 1);
+            component.clearRequestCache();
+
+            Assertions.assertEquals(1, requestCount.get());
+            Assertions.assertEquals(2, result.get("h_2").size());
+            Assertions.assertEquals(1, result.get("h_3").size());
+        } finally {
+            server.stop(0);
+        }
+    }
+
+    private SteadyTrendResolvedFieldBO buildField(String fieldName) {
+        SteadyTrendResolvedFieldBO field = new SteadyTrendResolvedFieldBO();
+        field.setMeasurement("data_harmonic");
+        field.setField(fieldName);
+        field.setLineId("line-001");
+        field.setPhase("A");
+        field.setStatType("AVG");
+        return field;
+    }
 }

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/component/SteadyChecksquareValueOrderRuleComponentTest.java

@@ -0,0 +1,219 @@
+package com.njcn.gather.steady.checksquare.component;
+
+import com.njcn.gather.steady.checksquare.pojo.bo.SteadyChecksquareValuePointBO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareValueOrderRuleVO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendIndicatorDefinitionBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendSeriesFieldBO;
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
+
+/**
+ * 数据校验指标值大小关系规则测试。
+ */
+class SteadyChecksquareValueOrderRuleComponentTest {
+
+    @Test
+    void shouldMarkIndicatorAbnormalWhenInvalidPointCountGreaterThanOne() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        LocalDateTime firstTime = LocalDateTime.of(2026, 5, 1, 0, 0);
+        LocalDateTime secondTime = LocalDateTime.of(2026, 5, 1, 0, 1);
+        when(influxQueryComponent.queryValuePoints(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenAnswer(invocation -> {
+                    String statType = invocation.getArgument(0, com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO.class).getStatType();
+                    if ("MAX".equals(statType)) {
+                        return Arrays.asList(point(firstTime, "8"), point(secondTime, "9"));
+                    }
+                    if ("CP95".equals(statType)) {
+                        return Arrays.asList(point(firstTime, "9"), point(secondTime, "10"));
+                    }
+                    if ("AVG".equals(statType)) {
+                        return Arrays.asList(point(firstTime, "7"), point(secondTime, "8"));
+                    }
+                    if ("MIN".equals(statType)) {
+                        return Arrays.asList(point(firstTime, "1"), point(secondTime, "9"));
+                    }
+                    return Collections.emptyList();
+                });
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator(), null,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 2), 1);
+
+        Assertions.assertEquals(Integer.valueOf(2), result.getAbnormalPointCount());
+        Assertions.assertEquals(Boolean.TRUE, result.getAbnormal());
+        Assertions.assertEquals(2, result.getAbnormalDetails().size());
+        Assertions.assertEquals("2026-05-01 00:00:00", result.getAbnormalDetails().get(0).getTime());
+        Assertions.assertEquals("A", result.getAbnormalDetails().get(0).getPhase());
+        Assertions.assertEquals(new BigDecimal("8"), result.getAbnormalDetails().get(0).getMaxValue());
+        Assertions.assertEquals(new BigDecimal("1"), result.getAbnormalDetails().get(0).getMinValue());
+        Assertions.assertEquals(new BigDecimal("7"), result.getAbnormalDetails().get(0).getAvgValue());
+        Assertions.assertEquals(new BigDecimal("9"), result.getAbnormalDetails().get(0).getCp95Value());
+    }
+
+    @Test
+    void shouldTreatEqualAdjacentStatValuesAsNormal() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePoints(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenAnswer(invocation -> {
+                    String statType = invocation.getArgument(0, com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO.class).getStatType();
+                    if ("MAX".equals(statType)) {
+                        return Collections.singletonList(point(time, "10"));
+                    }
+                    if ("CP95".equals(statType)) {
+                        return Collections.singletonList(point(time, "10"));
+                    }
+                    if ("AVG".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    if ("MIN".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    return Collections.emptyList();
+                });
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator(), null,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    @Test
+    void shouldNotMarkIndicatorAbnormalWhenOnlyOneInvalidPointExists() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePoints(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenAnswer(invocation -> {
+                    String statType = invocation.getArgument(0, com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO.class).getStatType();
+                    if ("MAX".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    if ("CP95".equals(statType)) {
+                        return Collections.singletonList(point(time, "10"));
+                    }
+                    if ("AVG".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    if ("MIN".equals(statType)) {
+                        return Collections.singletonList(point(time, "1"));
+                    }
+                    return Collections.emptyList();
+                });
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator(), null,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(Integer.valueOf(1), result.getAbnormalPointCount());
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertEquals(1, result.getAbnormalDetails().size());
+    }
+
+    @Test
+    void shouldFillHarmonicOrderInAbnormalDetailForHarmonicIndicator() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePoints(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenAnswer(invocation -> {
+                    String statType = invocation.getArgument(0, com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO.class).getStatType();
+                    if ("MAX".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    if ("CP95".equals(statType)) {
+                        return Collections.singletonList(point(time, "10"));
+                    }
+                    if ("AVG".equals(statType)) {
+                        return Collections.singletonList(point(time, "8"));
+                    }
+                    if ("MIN".equals(statType)) {
+                        return Collections.singletonList(point(time, "1"));
+                    }
+                    return Collections.emptyList();
+                });
+        SteadyTrendIndicatorDefinitionBO indicator = indicator();
+        indicator.setHarmonic(true);
+        indicator.setHarmonicFieldPrefix("v");
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator, 5,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(1, result.getAbnormalDetails().size());
+        Assertions.assertEquals(Integer.valueOf(5), result.getAbnormalDetails().get(0).getHarmonicOrder());
+    }
+
+    @Test
+    void shouldSkipPointWhenAnyRequiredStatValueMissing() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        LocalDateTime time = LocalDateTime.of(2026, 5, 1, 0, 0);
+        when(influxQueryComponent.queryValuePoints(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenAnswer(invocation -> {
+                    String statType = invocation.getArgument(0, com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO.class).getStatType();
+                    if ("MAX".equals(statType)) {
+                        return Collections.singletonList(point(time, "10"));
+                    }
+                    if ("CP95".equals(statType)) {
+                        return Collections.singletonList(point(time, "11"));
+                    }
+                    if ("MIN".equals(statType)) {
+                        return Collections.singletonList(point(time, "1"));
+                    }
+                    return Collections.emptyList();
+                });
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator(), null,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    @Test
+    void shouldSkipIndicatorWhenNotAllFourStatsSupported() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent component = new SteadyChecksquareValueOrderRuleComponent(influxQueryComponent);
+        SteadyTrendIndicatorDefinitionBO indicator = indicator();
+        indicator.setSupportStats(Collections.singletonList("AVG"));
+
+        SteadyChecksquareValueOrderRuleVO result = component.check("line-001", indicator, null,
+                LocalDateTime.of(2026, 5, 1, 0, 0), LocalDateTime.of(2026, 5, 1, 0, 1), 1);
+
+        Assertions.assertEquals(Integer.valueOf(0), result.getAbnormalPointCount());
+        Assertions.assertEquals(Boolean.FALSE, result.getAbnormal());
+        Assertions.assertTrue(result.getAbnormalDetails().isEmpty());
+    }
+
+    private SteadyTrendIndicatorDefinitionBO indicator() {
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorDefinitionBO();
+        indicator.setIndicatorCode("V_RMS");
+        indicator.setName("相电压有效值");
+        indicator.setTableName("data_v");
+        indicator.setPhaseCodes(Collections.singletonList("A"));
+        indicator.setSeriesFields(Collections.singletonList(new SteadyTrendSeriesFieldBO("rms", "相电压有效值")));
+        indicator.setSupportStats(Arrays.asList("AVG", "MAX", "MIN", "CP95"));
+        indicator.setUnit("V");
+        return indicator;
+    }
+
+    private SteadyChecksquareValuePointBO point(LocalDateTime time, String value) {
+        SteadyChecksquareValuePointBO point = new SteadyChecksquareValuePointBO();
+        point.setTime(time);
+        point.setValue(new BigDecimal(value));
+        return point;
+    }
+}

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/controller/SteadyChecksquareControllerTest.java

@@ -2,9 +2,11 @@ package com.njcn.gather.steady.checksquare.controller;
 
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
+import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
 
+import java.util.List;
 import java.lang.reflect.Method;
 
 /**
@@ -17,8 +19,25 @@ class SteadyChecksquareControllerTest {
         RequestMapping requestMapping = SteadyChecksquareController.class.getAnnotation(RequestMapping.class);
         Assertions.assertArrayEquals(new String[]{"/steady/data-view/checksquare"}, requestMapping.value());
 
-        Method method = SteadyChecksquareController.class.getDeclaredMethod("query", com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareQueryParam.class);
-        PostMapping postMapping = method.getAnnotation(PostMapping.class);
-        Assertions.assertArrayEquals(new String[]{"/query"}, postMapping.value());
+        Method queryMethod = SteadyChecksquareController.class.getDeclaredMethod("query", com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareHistoryQueryParam.class);
+        PostMapping queryMapping = queryMethod.getAnnotation(PostMapping.class);
+        Assertions.assertArrayEquals(new String[]{"/query"}, queryMapping.value());
+
+        Method createMethod = SteadyChecksquareController.class.getDeclaredMethod("create", com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareQueryParam.class);
+        PostMapping createMapping = createMethod.getAnnotation(PostMapping.class);
+        Assertions.assertArrayEquals(new String[]{"/create"}, createMapping.value());
+
+        Method detailMethod = SteadyChecksquareController.class.getDeclaredMethod("detail", String.class);
+        GetMapping detailMapping = detailMethod.getAnnotation(GetMapping.class);
+        Assertions.assertArrayEquals(new String[]{"/detail"}, detailMapping.value());
+
+        Method itemDetailMethod = SteadyChecksquareController.class.getDeclaredMethod("itemDetail",
+                String.class, String.class, String.class, Integer.class, Integer.class);
+        GetMapping itemDetailMapping = itemDetailMethod.getAnnotation(GetMapping.class);
+        Assertions.assertArrayEquals(new String[]{"/item-detail"}, itemDetailMapping.value());
+
+        Method deleteMethod = SteadyChecksquareController.class.getDeclaredMethod("delete", List.class);
+        PostMapping deleteMapping = deleteMethod.getAnnotation(PostMapping.class);
+        Assertions.assertArrayEquals(new String[]{"/delete"}, deleteMapping.value());
     }
 }

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/pojo/param/SteadyChecksquareQueryParamTest.java

@@ -19,7 +19,7 @@ class SteadyChecksquareQueryParamTest {
         Assertions.assertNull(field("qualityFlag"));
         Assertions.assertNull(field("statTypes"));
         Assertions.assertNull(field("phases"));
-        Assertions.assertNotNull(field("harmonicOrders"));
+        Assertions.assertNull(field("harmonicOrders"));
     }
 
     private Field field(String name) {

steady/steady-DataView/src/test/java/com/njcn/gather/steady/checksquare/service/impl/SteadyChecksquareServiceImplTest.java

@@ -1,26 +1,55 @@
 package com.njcn.gather.steady.checksquare.service.impl;
 
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.baomidou.mybatisplus.extension.conditions.query.LambdaQueryChainWrapper;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import com.njcn.gather.steady.checksquare.component.SteadyChecksquareCalculator;
+import com.njcn.gather.steady.checksquare.component.SteadyChecksquareHarmonicParityRuleComponent;
 import com.njcn.gather.steady.checksquare.component.SteadyChecksquareInfluxQueryComponent;
+import com.njcn.gather.steady.checksquare.component.SteadyChecksquareValueOrderRuleComponent;
 import com.njcn.gather.steady.checksquare.pojo.param.SteadyChecksquareQueryParam;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareDetailPO;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareItemPO;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareStatSummaryPO;
+import com.njcn.gather.steady.checksquare.pojo.po.SteadyChecksquareTaskPO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityDetailVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareHarmonicParityRuleVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareItemDetailVO;
 import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareItemVO;
 import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareQueryVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareStatSummaryVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareValueOrderDetailVO;
+import com.njcn.gather.steady.checksquare.pojo.vo.SteadyChecksquareValueOrderRuleVO;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareDetailService;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareItemService;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareStatSummaryService;
+import com.njcn.gather.steady.checksquare.service.SteadyChecksquareTaskService;
 import com.njcn.gather.steady.datavie.component.SteadyTrendIndicatorCatalog;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendIndicatorDefinitionBO;
+import com.njcn.gather.steady.datavie.pojo.bo.SteadyTrendResolvedFieldBO;
 import com.njcn.gather.tool.adddata.component.AddDataTimeSlotCalculator;
 import com.njcn.gather.tool.addledger.pojo.vo.AddLedgerLinePathVO;
 import com.njcn.gather.tool.addledger.service.AddLedgerService;
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.transaction.annotation.Transactional;
 
+import java.lang.reflect.Method;
+import java.math.BigDecimal;
 import java.time.LocalDateTime;
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashSet;
 import java.util.List;
 
 import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyInt;
 import static org.mockito.ArgumentMatchers.eq;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
 import static org.mockito.Mockito.when;
 
 /**
@@ -28,12 +57,28 @@ import static org.mockito.Mockito.when;
  */
 class SteadyChecksquareServiceImplTest {
 
+    @Test
+    void shouldNotOpenTransactionAroundCreateCalculation() throws Exception {
+        Method createMethod = SteadyChecksquareServiceImpl.class.getMethod("create", SteadyChecksquareQueryParam.class);
+
+        Assertions.assertNull(createMethod.getAnnotation(Transactional.class));
+    }
+
     @Test
     void shouldUseFixedFlickerIntervalsPerIndicator() {
         SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
         AddLedgerService addLedgerService = mock(AddLedgerService.class);
         SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
-                influxQueryComponent, new SteadyChecksquareCalculator(), new AddDataTimeSlotCalculator(), addLedgerService);
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyRuleResult());
+        when(harmonicParityRuleComponent.check(any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyHarmonicParityRuleResult());
         AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
         linePath.setLineId("line-001");
         linePath.setLineName("进线一");
@@ -54,7 +99,7 @@ class SteadyChecksquareServiceImplTest {
         param.setTimeStart("2026-05-01 00:00:00");
         param.setTimeEnd("2026-05-01 02:00:00");
 
-        SteadyChecksquareQueryVO result = service.query(param);
+        SteadyChecksquareQueryVO result = calculate(service, param);
 
         Assertions.assertEquals(Integer.valueOf(1), result.getIntervalMinutes());
         Assertions.assertEquals(3, result.getItems().size());
@@ -64,11 +109,20 @@ class SteadyChecksquareServiceImplTest {
     }
 
     @Test
-    void shouldOnlyQueryRequestedHarmonicOrders() {
+    void shouldAggregateAllHarmonicOrdersIntoIndicatorItem() {
         SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
         AddLedgerService addLedgerService = mock(AddLedgerService.class);
         SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
-                influxQueryComponent, new SteadyChecksquareCalculator(), new AddDataTimeSlotCalculator(), addLedgerService);
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyRuleResult());
+        when(harmonicParityRuleComponent.check(any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyHarmonicParityRuleResult());
         AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
         linePath.setLineId("line-001");
         linePath.setLineName("进线一");
@@ -82,22 +136,32 @@ class SteadyChecksquareServiceImplTest {
         SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
         param.setLineId("line-001");
         param.setIndicatorCodes(Collections.singletonList("V_HARMONIC"));
-        param.setHarmonicOrders(Collections.singletonList(5));
         param.setTimeStart("2026-05-01 00:00:00");
         param.setTimeEnd("2026-05-01 00:01:00");
 
-        SteadyChecksquareQueryVO result = service.query(param);
+        SteadyChecksquareQueryVO result = calculate(service, param);
 
         Assertions.assertEquals(1, result.getItems().size());
-        Assertions.assertEquals(Integer.valueOf(5), result.getItems().get(0).getHarmonicOrder());
+        Assertions.assertEquals("line-001|V_HARMONIC", result.getItems().get(0).getItemKey());
+        Assertions.assertNull(result.getItems().get(0).getHarmonicOrder());
+        Assertions.assertEquals(Integer.valueOf(2), result.getItems().get(0).getStatDetails().get(0).getSegments().get(0).getHarmonicOrder());
     }
 
     @Test
-    void shouldKeepRequestedHarmonicOrdersDistinctAndOrdered() {
+    void shouldAverageHarmonicOrderResultsAndMarkAbnormalWhenAnyOrderAbnormal() {
         SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
         AddLedgerService addLedgerService = mock(AddLedgerService.class);
         SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
-                influxQueryComponent, new SteadyChecksquareCalculator(), new AddDataTimeSlotCalculator(), addLedgerService);
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyRuleResult());
+        when(harmonicParityRuleComponent.check(any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyHarmonicParityRuleResult());
         AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
         linePath.setLineId("line-001");
         linePath.setLineName("进线一");
@@ -105,21 +169,420 @@ class SteadyChecksquareServiceImplTest {
         when(addLedgerService.listLinePathByLineIds(eq(Collections.singletonList("line-001"))))
                 .thenReturn(Collections.singletonMap("line-001", linePath));
         when(influxQueryComponent.queryExistingSlots(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
-                .thenReturn(new HashSet<LocalDateTime>());
+                .thenReturn(new HashSet<LocalDateTime>(Collections.singletonList(
+                        LocalDateTime.of(2026, 5, 1, 0, 0))));
+        SteadyChecksquareValueOrderRuleVO normalRuleResult = new SteadyChecksquareValueOrderRuleVO();
+        SteadyChecksquareValueOrderRuleVO abnormalRuleResult = new SteadyChecksquareValueOrderRuleVO();
+        SteadyChecksquareValueOrderDetailVO abnormalDetail = new SteadyChecksquareValueOrderDetailVO();
+        abnormalDetail.setTime("2026-05-01 00:00:00");
+        abnormalDetail.setPhase("A");
+        abnormalDetail.setHarmonicOrder(2);
+        abnormalRuleResult.setAbnormal(true);
+        abnormalRuleResult.setAbnormalPointCount(4);
+        abnormalRuleResult.setAbnormalDetails(Collections.singletonList(abnormalDetail));
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(normalRuleResult);
+        when(valueOrderRuleComponent.check(any(), any(), eq(2), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(abnormalRuleResult);
+        when(valueOrderRuleComponent.check(any(), any(), eq(3), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(normalRuleResult);
 
         SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
         param.setLineId("line-001");
         param.setIndicatorCodes(Collections.singletonList("V_HARMONIC"));
-        param.setHarmonicOrders(Arrays.asList(7, 5, 7));
         param.setTimeStart("2026-05-01 00:00:00");
         param.setTimeEnd("2026-05-01 00:01:00");
 
-        SteadyChecksquareQueryVO result = service.query(param);
+        SteadyChecksquareQueryVO result = calculate(service, param);
 
         List<SteadyChecksquareItemVO> items = result.getItems();
-        Assertions.assertEquals(2, items.size());
-        Assertions.assertEquals(Integer.valueOf(7), items.get(0).getHarmonicOrder());
-        Assertions.assertEquals(Integer.valueOf(5), items.get(1).getHarmonicOrder());
+        Assertions.assertEquals(1, items.size());
+        Assertions.assertEquals(Boolean.TRUE, items.get(0).getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(1), items.get(0).getAbnormalPointCount());
+        Assertions.assertEquals(1, items.get(0).getAbnormalDetails().size());
+        Assertions.assertEquals(Integer.valueOf(2), items.get(0).getAbnormalDetails().get(0).getHarmonicOrder());
+        Assertions.assertEquals(Integer.valueOf(8), items.get(0).getExpectedPointCount());
+        Assertions.assertEquals(Integer.valueOf(4), items.get(0).getActualPointCount());
+    }
+
+    @Test
+    void shouldAssembleValueOrderRuleResultIntoItem() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
+        AddLedgerService addLedgerService = mock(AddLedgerService.class);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
+        linePath.setLineId("line-001");
+        linePath.setLineName("进线一");
+        linePath.setLineInterval(1);
+        when(addLedgerService.listLinePathByLineIds(eq(Collections.singletonList("line-001"))))
+                .thenReturn(Collections.singletonMap("line-001", linePath));
+        when(influxQueryComponent.queryExistingSlots(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenReturn(new HashSet<LocalDateTime>(Collections.singletonList(
+                        LocalDateTime.of(2026, 5, 1, 0, 0))));
+        SteadyChecksquareValueOrderRuleVO ruleResult = new SteadyChecksquareValueOrderRuleVO();
+        SteadyChecksquareValueOrderDetailVO detail = new SteadyChecksquareValueOrderDetailVO();
+        detail.setTime("2026-05-01 00:00:00");
+        detail.setPhase("A");
+        ruleResult.setAbnormalPointCount(2);
+        ruleResult.setAbnormal(true);
+        ruleResult.setAbnormalDetails(Collections.singletonList(detail));
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenReturn(ruleResult);
+
+        SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
+        param.setLineId("line-001");
+        param.setIndicatorCodes(Collections.singletonList("V_RMS"));
+        param.setTimeStart("2026-05-01 00:00:00");
+        param.setTimeEnd("2026-05-01 00:01:00");
+
+        SteadyChecksquareQueryVO result = calculate(service, param);
+
+        SteadyChecksquareItemVO item = result.getItems().get(0);
+        Assertions.assertEquals(Boolean.TRUE, item.getAbnormal());
+        Assertions.assertEquals(Integer.valueOf(2), item.getAbnormalPointCount());
+        Assertions.assertEquals(1, item.getAbnormalDetails().size());
+        Assertions.assertEquals("A", item.getAbnormalDetails().get(0).getPhase());
+    }
+
+    @Test
+    void shouldPrefetchNormalIndicatorFieldsByMeasurementPhaseAndStat() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
+        AddLedgerService addLedgerService = mock(AddLedgerService.class);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyRuleResult());
+        when(harmonicParityRuleComponent.check(any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyHarmonicParityRuleResult());
+        AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
+        linePath.setLineId("line-001");
+        linePath.setLineName("进线一");
+        linePath.setLineInterval(1);
+        when(addLedgerService.listLinePathByLineIds(eq(Collections.singletonList("line-001"))))
+                .thenReturn(Collections.singletonMap("line-001", linePath));
+        when(influxQueryComponent.queryExistingSlots(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenReturn(new HashSet<LocalDateTime>(Collections.singletonList(
+                        LocalDateTime.of(2026, 5, 1, 0, 0))));
+
+        SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
+        param.setLineId("line-001");
+        param.setIndicatorCodes(Arrays.asList("V_RMS", "V_LINE_RMS"));
+        param.setTimeStart("2026-05-01 00:00:00");
+        param.setTimeEnd("2026-05-01 00:01:00");
+
+        calculate(service, param);
+
+        ArgumentCaptor<List> captor = ArgumentCaptor.forClass(List.class);
+        verify(influxQueryComponent, times(12)).queryValuePointMap(captor.capture(),
+                any(LocalDateTime.class), any(LocalDateTime.class), eq(1));
+        boolean foundBatch = false;
+        for (List fields : captor.getAllValues()) {
+            if (fields.size() == 2) {
+                List<String> fieldNames = new ArrayList<String>();
+                for (Object field : fields) {
+                    fieldNames.add(((SteadyTrendResolvedFieldBO) field).getField());
+                }
+                foundBatch = fieldNames.contains("rms") && fieldNames.contains("rms_lvr");
+            }
+        }
+        Assertions.assertTrue(foundBatch);
+    }
+
+    @Test
+    void shouldAssembleHarmonicParityRuleResultIntoAggregateItem() {
+        SteadyChecksquareInfluxQueryComponent influxQueryComponent = mock(SteadyChecksquareInfluxQueryComponent.class);
+        SteadyChecksquareValueOrderRuleComponent valueOrderRuleComponent = mock(SteadyChecksquareValueOrderRuleComponent.class);
+        SteadyChecksquareHarmonicParityRuleComponent harmonicParityRuleComponent = mock(SteadyChecksquareHarmonicParityRuleComponent.class);
+        AddLedgerService addLedgerService = mock(AddLedgerService.class);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                influxQueryComponent, new SteadyChecksquareCalculator(), valueOrderRuleComponent, harmonicParityRuleComponent,
+                new AddDataTimeSlotCalculator(), addLedgerService, mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        when(valueOrderRuleComponent.check(any(), any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), anyInt()))
+                .thenReturn(emptyRuleResult());
+        AddLedgerLinePathVO linePath = new AddLedgerLinePathVO();
+        linePath.setLineId("line-001");
+        linePath.setLineName("进线一");
+        linePath.setLineInterval(1);
+        when(addLedgerService.listLinePathByLineIds(eq(Collections.singletonList("line-001"))))
+                .thenReturn(Collections.singletonMap("line-001", linePath));
+        when(influxQueryComponent.queryExistingSlots(any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenReturn(new HashSet<LocalDateTime>(Collections.singletonList(
+                        LocalDateTime.of(2026, 5, 1, 0, 0))));
+        SteadyChecksquareHarmonicParityRuleVO ruleResult = new SteadyChecksquareHarmonicParityRuleVO();
+        SteadyChecksquareHarmonicParityDetailVO detail = new SteadyChecksquareHarmonicParityDetailVO();
+        detail.setTime("2026-05-01 00:00:00");
+        detail.setPhase("A");
+        detail.setStatType("AVG");
+        detail.setEvenHarmonicOrder(4);
+        ruleResult.setAbnormal(true);
+        ruleResult.setAbnormalPointCount(1);
+        ruleResult.setAbnormalDetails(Collections.singletonList(detail));
+        when(harmonicParityRuleComponent.check(any(), any(), any(LocalDateTime.class), any(LocalDateTime.class), eq(1)))
+                .thenReturn(ruleResult);
+
+        SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
+        param.setLineId("line-001");
+        param.setIndicatorCodes(Collections.singletonList("V_HARMONIC"));
+        param.setTimeStart("2026-05-01 00:00:00");
+        param.setTimeEnd("2026-05-01 00:01:00");
+
+        SteadyChecksquareQueryVO result = calculate(service, param);
+
+        SteadyChecksquareItemVO item = result.getItems().get(0);
+        Assertions.assertNull(item.getHarmonicOrder());
+        Assertions.assertEquals(Boolean.TRUE, item.getHarmonicParityAbnormal());
+        Assertions.assertEquals(Integer.valueOf(1), item.getHarmonicParityAbnormalPointCount());
+        Assertions.assertEquals("AVG", item.getHarmonicParityAbnormalDetails().get(0).getStatType());
+    }
+
+    @Test
+    void shouldRejectUnsupportedItemDetailType() {
+        SteadyChecksquareItemService itemService = mock(SteadyChecksquareItemService.class);
+        SteadyChecksquareItemPO item = new SteadyChecksquareItemPO();
+        item.setId("item-001");
+        item.setState(1);
+        when(itemService.getById("item-001")).thenReturn(item);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), mock(SteadyChecksquareTaskService.class),
+                itemService, mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+
+        Assertions.assertThrows(RuntimeException.class, () -> service.itemDetail("item-001", "UNKNOWN", null));
+    }
+
+    @Test
+    void shouldLoadDetailSummariesInSingleBatch() {
+        SteadyChecksquareTaskService taskService = mock(SteadyChecksquareTaskService.class);
+        SteadyChecksquareItemService itemService = mock(SteadyChecksquareItemService.class);
+        SteadyChecksquareStatSummaryService statSummaryService = mock(SteadyChecksquareStatSummaryService.class);
+        LambdaQueryChainWrapper<SteadyChecksquareItemPO> itemQuery = mock(LambdaQueryChainWrapper.class);
+        LambdaQueryChainWrapper<SteadyChecksquareStatSummaryPO> summaryQuery = mock(LambdaQueryChainWrapper.class);
+        SteadyChecksquareTaskPO task = new SteadyChecksquareTaskPO();
+        task.setId("task-001");
+        task.setState(1);
+        task.setLineId("line-001");
+        task.setLineName("进线一");
+        task.setTimeStart(LocalDateTime.of(2026, 5, 1, 0, 0));
+        task.setTimeEnd(LocalDateTime.of(2026, 5, 1, 0, 1));
+        task.setIntervalMinutes(1);
+        SteadyChecksquareItemPO item1 = buildItemPO("item-001", "V_RMS");
+        SteadyChecksquareItemPO item2 = buildItemPO("item-002", "FREQ");
+        SteadyChecksquareStatSummaryPO summary1 = buildSummaryPO("item-001", "AVG");
+        SteadyChecksquareStatSummaryPO summary2 = buildSummaryPO("item-002", "AVG");
+        when(taskService.getById("task-001")).thenReturn(task);
+        when(itemService.lambdaQuery()).thenReturn(itemQuery);
+        when(itemQuery.eq(any(), any())).thenReturn(itemQuery);
+        when(itemQuery.list()).thenReturn(Arrays.asList(item1, item2));
+        when(statSummaryService.lambdaQuery()).thenReturn(summaryQuery);
+        when(summaryQuery.in(any(), any(List.class))).thenReturn(summaryQuery);
+        when(summaryQuery.list()).thenReturn(Arrays.asList(summary1, summary2));
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), taskService,
+                itemService, statSummaryService, mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+
+        SteadyChecksquareQueryVO result = service.detail("task-001");
+
+        Assertions.assertEquals(2, result.getItems().size());
+        Assertions.assertEquals(1, result.getItems().get(0).getStatSummaries().size());
+        Assertions.assertEquals(1, result.getItems().get(1).getStatSummaries().size());
+        verify(statSummaryService, times(1)).lambdaQuery();
+    }
+
+    @Test
+    void shouldPageItemDetailWhenPageArgumentsPresent() {
+        SteadyChecksquareItemService itemService = mock(SteadyChecksquareItemService.class);
+        SteadyChecksquareDetailService detailService = mock(SteadyChecksquareDetailService.class);
+        SteadyChecksquareItemPO item = new SteadyChecksquareItemPO();
+        item.setId("item-001");
+        item.setState(1);
+        SteadyChecksquareDetailPO detail = new SteadyChecksquareDetailPO();
+        detail.setItemId("item-001");
+        detail.setDetailType("VALUE_ORDER");
+        detail.setPointTime(LocalDateTime.of(2026, 5, 1, 0, 0));
+        detail.setPhase("A");
+        Page<SteadyChecksquareDetailPO> page = new Page<SteadyChecksquareDetailPO>(2, 1);
+        page.setTotal(1);
+        page.setRecords(Collections.singletonList(detail));
+        when(itemService.getById("item-001")).thenReturn(item);
+        when(detailService.page(any(Page.class), any())).thenReturn(page);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), mock(SteadyChecksquareTaskService.class),
+                itemService, mock(SteadyChecksquareStatSummaryService.class),
+                detailService, new ObjectMapper());
+
+        SteadyChecksquareItemDetailVO result = service.itemDetail("item-001", "VALUE_ORDER", null, 2, 1);
+
+        Assertions.assertEquals(Integer.valueOf(2), result.getPageNum());
+        Assertions.assertEquals(Integer.valueOf(1), result.getPageSize());
+        Assertions.assertEquals(Long.valueOf(1L), result.getTotal());
+        Assertions.assertEquals(1, result.getValueOrderDetails().size());
+        verify(detailService).page(any(Page.class), any());
+    }
+
+    @Test
+    void shouldDeleteTasksAndItemsLogically() {
+        SteadyChecksquareTaskService taskService = mock(SteadyChecksquareTaskService.class);
+        SteadyChecksquareItemService itemService = mock(SteadyChecksquareItemService.class);
+        LambdaQueryChainWrapper<SteadyChecksquareTaskPO> taskQuery = mock(LambdaQueryChainWrapper.class);
+        SteadyChecksquareTaskPO task = new SteadyChecksquareTaskPO();
+        task.setId("task-001");
+        task.setState(1);
+        when(taskService.lambdaQuery()).thenReturn(taskQuery);
+        when(taskQuery.in(any(), any(List.class))).thenReturn(taskQuery);
+        when(taskQuery.eq(any(), any())).thenReturn(taskQuery);
+        when(taskQuery.list()).thenReturn(Collections.singletonList(task));
+        when(taskService.update(any())).thenReturn(true);
+        when(itemService.update(any())).thenReturn(true);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), taskService,
+                itemService, mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+
+        boolean result = service.delete(Collections.singletonList("task-001"));
+
+        Assertions.assertTrue(result);
+        verify(taskService).update(any());
+        verify(itemService).update(any());
+    }
+
+    @Test
+    void shouldSaveChecksquareResultsInBatch() {
+        SteadyChecksquareTaskService taskService = mock(SteadyChecksquareTaskService.class);
+        SteadyChecksquareItemService itemService = mock(SteadyChecksquareItemService.class);
+        SteadyChecksquareStatSummaryService statSummaryService = mock(SteadyChecksquareStatSummaryService.class);
+        SteadyChecksquareDetailService detailService = mock(SteadyChecksquareDetailService.class);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), taskService,
+                itemService, statSummaryService, detailService, new ObjectMapper());
+        SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
+        param.setIndicatorCodes(Collections.singletonList("V_RMS"));
+        SteadyChecksquareQueryVO result = new SteadyChecksquareQueryVO();
+        result.setLineId("line-001");
+        result.setLineName("进线一");
+        result.setTimeStart("2026-05-01 00:00:00");
+        result.setTimeEnd("2026-05-01 00:01:00");
+        result.setIntervalMinutes(1);
+        SteadyChecksquareItemVO item = new SteadyChecksquareItemVO();
+        item.setItemKey("line-001|V_RMS");
+        item.setIndicatorCode("V_RMS");
+        item.setIndicatorName("相电压有效值");
+        item.setIntervalMinutes(1);
+        item.setHasData(true);
+        item.setExpectedPointCount(2);
+        item.setActualPointCount(2);
+        item.setMissingPointCount(0);
+        item.setDataIntegrity(BigDecimal.ONE.setScale(6));
+        item.setDataIntegrityText("100.00%");
+        item.setAbnormal(false);
+        item.setAbnormalPointCount(0);
+        item.setHarmonicParityAbnormal(false);
+        item.setHarmonicParityAbnormalPointCount(0);
+        SteadyChecksquareStatSummaryVO summary = new SteadyChecksquareStatSummaryVO();
+        summary.setStatType("AVG");
+        summary.setSupported(true);
+        summary.setHasData(true);
+        summary.setExpectedPointCount(2);
+        summary.setActualPointCount(2);
+        summary.setMissingPointCount(0);
+        summary.setDataIntegrity(BigDecimal.ONE.setScale(6));
+        summary.setDataIntegrityText("100.00%");
+        item.getStatSummaries().add(summary);
+        result.getItems().add(item);
+
+        saveResult(service, param, result);
+
+        verify(taskService).save(any());
+        verify(itemService).saveBatch(any());
+        verify(statSummaryService).saveBatch(any());
+    }
+
+    @Test
+    void shouldCountNoDataItemAsAbnormalWhenSavingTask() {
+        SteadyChecksquareTaskService taskService = mock(SteadyChecksquareTaskService.class);
+        SteadyChecksquareServiceImpl service = new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), taskService,
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+        SteadyChecksquareQueryParam param = new SteadyChecksquareQueryParam();
+        param.setIndicatorCodes(Collections.singletonList("V_RMS"));
+        SteadyChecksquareQueryVO result = new SteadyChecksquareQueryVO();
+        result.setLineId("line-001");
+        result.setLineName("进线一");
+        result.setTimeStart("2026-05-01 00:00:00");
+        result.setTimeEnd("2026-05-01 00:01:00");
+        result.setIntervalMinutes(1);
+        SteadyChecksquareItemVO item = new SteadyChecksquareItemVO();
+        item.setItemKey("line-001|V_RMS");
+        item.setIndicatorCode("V_RMS");
+        item.setHasData(false);
+        item.setExpectedPointCount(2);
+        item.setActualPointCount(0);
+        item.setMissingPointCount(2);
+        item.setDataIntegrity(BigDecimal.ZERO.setScale(6));
+        item.setDataIntegrityText("0.00%");
+        item.setAbnormal(false);
+        item.setHarmonicParityAbnormal(false);
+        result.getItems().add(item);
+
+        saveResult(service, param, result);
+
+        ArgumentCaptor<SteadyChecksquareTaskPO> captor = ArgumentCaptor.forClass(SteadyChecksquareTaskPO.class);
+        verify(taskService).save(captor.capture());
+        Assertions.assertEquals(Integer.valueOf(1), captor.getValue().getAbnormalItemCount());
+        Assertions.assertEquals(BigDecimal.ZERO.setScale(6), captor.getValue().getMinDataIntegrity());
+    }
+
+    @Test
+    void shouldMarkAggregateHarmonicItemNoDataWhenDataIntegrityIsZero() {
+        SteadyChecksquareServiceImpl service = newService();
+        SteadyTrendIndicatorDefinitionBO indicator = buildHarmonicIndicator();
+        SteadyChecksquareItemVO orderItem = buildOrderItem(true, BigDecimal.ZERO.setScale(6));
+        orderItem.getStatSummaries().add(buildSummaryVO(true, BigDecimal.ZERO.setScale(6)));
+
+        SteadyChecksquareItemVO result = aggregateHarmonicItems(service, indicator, Collections.singletonList(orderItem));
+
+        Assertions.assertEquals(BigDecimal.ZERO.setScale(6), result.getDataIntegrity());
+        Assertions.assertEquals(Boolean.FALSE, result.getHasData());
+        Assertions.assertEquals(Boolean.FALSE, result.getStatSummaries().get(0).getHasData());
+    }
+
+    @Test
+    void shouldMarkAggregateHarmonicItemHasDataWhenDataIntegrityIsGreaterThanZero() {
+        SteadyChecksquareServiceImpl service = newService();
+        SteadyTrendIndicatorDefinitionBO indicator = buildHarmonicIndicator();
+        SteadyChecksquareItemVO orderItem = buildOrderItem(false, new BigDecimal("0.500000"));
+        orderItem.getStatSummaries().add(buildSummaryVO(false, new BigDecimal("0.500000")));
+
+        SteadyChecksquareItemVO result = aggregateHarmonicItems(service, indicator, Collections.singletonList(orderItem));
+
+        Assertions.assertEquals(new BigDecimal("0.500000"), result.getDataIntegrity());
+        Assertions.assertEquals(Boolean.TRUE, result.getHasData());
+        Assertions.assertEquals(Boolean.TRUE, result.getStatSummaries().get(0).getHasData());
     }
 
     private void assertItemInterval(SteadyChecksquareItemVO item, String indicatorCode, int intervalMinutes, int expectedPointCount) {
@@ -127,4 +590,125 @@ class SteadyChecksquareServiceImplTest {
         Assertions.assertEquals(Integer.valueOf(intervalMinutes), item.getIntervalMinutes());
         Assertions.assertEquals(Integer.valueOf(expectedPointCount), item.getExpectedPointCount());
     }
+
+    private SteadyChecksquareServiceImpl newService() {
+        return new SteadyChecksquareServiceImpl(new SteadyTrendIndicatorCatalog(),
+                mock(SteadyChecksquareInfluxQueryComponent.class), new SteadyChecksquareCalculator(),
+                mock(SteadyChecksquareValueOrderRuleComponent.class), mock(SteadyChecksquareHarmonicParityRuleComponent.class),
+                new AddDataTimeSlotCalculator(), mock(AddLedgerService.class), mock(SteadyChecksquareTaskService.class),
+                mock(SteadyChecksquareItemService.class), mock(SteadyChecksquareStatSummaryService.class),
+                mock(SteadyChecksquareDetailService.class), new ObjectMapper());
+    }
+
+    private SteadyChecksquareQueryVO calculate(SteadyChecksquareServiceImpl service, SteadyChecksquareQueryParam param) {
+        try {
+            Method method = SteadyChecksquareServiceImpl.class.getDeclaredMethod("calculate", SteadyChecksquareQueryParam.class);
+            method.setAccessible(true);
+            return (SteadyChecksquareQueryVO) method.invoke(service, param);
+        } catch (Exception exception) {
+            throw new RuntimeException(exception);
+        }
+    }
+
+    private void saveResult(SteadyChecksquareServiceImpl service, SteadyChecksquareQueryParam param, SteadyChecksquareQueryVO result) {
+        try {
+            Method method = SteadyChecksquareServiceImpl.class.getDeclaredMethod("saveResult",
+                    SteadyChecksquareQueryParam.class, SteadyChecksquareQueryVO.class);
+            method.setAccessible(true);
+            method.invoke(service, param, result);
+        } catch (Exception exception) {
+            throw new RuntimeException(exception);
+        }
+    }
+
+    private SteadyChecksquareItemVO aggregateHarmonicItems(SteadyChecksquareServiceImpl service,
+                                                          SteadyTrendIndicatorDefinitionBO indicator,
+                                                          List<SteadyChecksquareItemVO> orderItems) {
+        try {
+            Method method = SteadyChecksquareServiceImpl.class.getDeclaredMethod("aggregateHarmonicItems",
+                    String.class, SteadyTrendIndicatorDefinitionBO.class, List.class, int.class);
+            method.setAccessible(true);
+            return (SteadyChecksquareItemVO) method.invoke(service, "line-001", indicator, orderItems, 1);
+        } catch (Exception exception) {
+            throw new RuntimeException(exception);
+        }
+    }
+
+    private SteadyTrendIndicatorDefinitionBO buildHarmonicIndicator() {
+        SteadyTrendIndicatorDefinitionBO indicator = new SteadyTrendIndicatorDefinitionBO();
+        indicator.setIndicatorCode("V_HARMONIC");
+        indicator.setName("V_HARMONIC");
+        indicator.setHarmonic(true);
+        return indicator;
+    }
+
+    private SteadyChecksquareItemVO buildOrderItem(boolean hasData, BigDecimal dataIntegrity) {
+        SteadyChecksquareItemVO item = new SteadyChecksquareItemVO();
+        item.setItemKey("line-001|V_HARMONIC|2");
+        item.setIndicatorCode("V_HARMONIC");
+        item.setIndicatorName("V_HARMONIC");
+        item.setHarmonicOrder(2);
+        item.setIntervalMinutes(1);
+        item.setHasData(hasData);
+        item.setExpectedPointCount(2);
+        item.setActualPointCount(dataIntegrity.compareTo(BigDecimal.ZERO) > 0 ? 1 : 0);
+        item.setMissingPointCount(dataIntegrity.compareTo(BigDecimal.ZERO) > 0 ? 1 : 2);
+        item.setDataIntegrity(dataIntegrity);
+        item.setAbnormal(false);
+        item.setAbnormalPointCount(0);
+        item.setHarmonicParityAbnormal(false);
+        item.setHarmonicParityAbnormalPointCount(0);
+        return item;
+    }
+
+    private SteadyChecksquareStatSummaryVO buildSummaryVO(boolean hasData, BigDecimal dataIntegrity) {
+        SteadyChecksquareStatSummaryVO summary = new SteadyChecksquareStatSummaryVO();
+        summary.setStatType("AVG");
+        summary.setSupported(true);
+        summary.setHasData(hasData);
+        summary.setExpectedPointCount(2);
+        summary.setActualPointCount(dataIntegrity.compareTo(BigDecimal.ZERO) > 0 ? 1 : 0);
+        summary.setMissingPointCount(dataIntegrity.compareTo(BigDecimal.ZERO) > 0 ? 1 : 2);
+        summary.setDataIntegrity(dataIntegrity);
+        return summary;
+    }
+
+    private SteadyChecksquareItemPO buildItemPO(String itemId, String indicatorCode) {
+        SteadyChecksquareItemPO item = new SteadyChecksquareItemPO();
+        item.setId(itemId);
+        item.setIndicatorCode(indicatorCode);
+        item.setIndicatorName(indicatorCode);
+        item.setState(1);
+        item.setHasData(1);
+        item.setExpectedPointCount(1);
+        item.setActualPointCount(1);
+        item.setMissingPointCount(0);
+        item.setDataIntegrity(BigDecimal.ONE.setScale(6));
+        item.setAbnormal(0);
+        item.setAbnormalPointCount(0);
+        item.setHarmonicParityAbnormal(0);
+        item.setHarmonicParityAbnormalPointCount(0);
+        return item;
+    }
+
+    private SteadyChecksquareStatSummaryPO buildSummaryPO(String itemId, String statType) {
+        SteadyChecksquareStatSummaryPO summary = new SteadyChecksquareStatSummaryPO();
+        summary.setItemId(itemId);
+        summary.setStatType(statType);
+        summary.setSupported(1);
+        summary.setHasData(1);
+        summary.setExpectedPointCount(1);
+        summary.setActualPointCount(1);
+        summary.setMissingPointCount(0);
+        summary.setDataIntegrity(BigDecimal.ONE.setScale(6));
+        return summary;
+    }
+
+    private SteadyChecksquareValueOrderRuleVO emptyRuleResult() {
+        return new SteadyChecksquareValueOrderRuleVO();
+    }
+
+    private SteadyChecksquareHarmonicParityRuleVO emptyHarmonicParityRuleResult() {
+        return new SteadyChecksquareHarmonicParityRuleVO();
+    }
 }

steady/steady-DataView/steady-checksquare-api-debug_20260610.md

@@ -0,0 +1,522 @@
+# 数据校验 API 调试文档
+
+## 1. 基础信息
+
+- 模块：`steady/steady-DataView`
+- 控制器：`com.njcn.gather.steady.checksquare.controller.SteadyChecksquareController`
+- 接口前缀：`/steady/data-view/checksquare`
+- 本地默认地址：`http://localhost:18192`
+- Content-Type：`application/json`
+- 认证：除登录和 Swagger 资源外，请求需要携带登录后的 `Authorization` 请求头。
+- 数据库结果表：`steady_checksquare_task`、`steady_checksquare_item`、`steady_checksquare_stat_summary`、`steady_checksquare_detail`
+
+通用请求头：
+
+```http
+Authorization: Bearer <token>
+Content-Type: application/json
+```
+
+通用返回结构：
+
+```json
+{
+  "code": 200,
+  "message": "success",
+  "data": {}
+}
+```
+
+> 实际 `code`、`message` 字段以项目公共 `HttpResult` 封装为准，下面示例重点展示 `data` 内容。
+
+## 2. 查询数据校验历史记录
+
+- 方法：`POST`
+- 路径：`/steady/data-view/checksquare/query`
+- 返回：`HttpResult<Page<SteadyChecksquareTaskVO>>`
+- 说明：分页查询已落库的数据校验任务，按创建时间倒序返回。
+
+请求示例：
+
+```json
+{
+  "pageNum": 1,
+  "pageSize": 10,
+  "lineId": "line-001",
+  "indicatorCode": "V_RMS",
+  "timeStart": "2026-05-01 00:00:00",
+  "timeEnd": "2026-05-01 23:59:59",
+  "hasAbnormal": true
+}
+```
+
+请求字段：
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| `pageNum` | 否 | 当前页码，继承自 `BaseParam` |
+| `pageSize` | 否 | 每页数量，继承自 `BaseParam` |
+| `lineId` | 否 | 监测点 ID，精确匹配 |
+| `indicatorCode` | 否 | 指标编码，按任务指标集合匹配 |
+| `timeStart` | 否 | 检测开始时间下限，格式 `yyyy-MM-dd HH:mm:ss` |
+| `timeEnd` | 否 | 检测结束时间上限，格式 `yyyy-MM-dd HH:mm:ss` |
+| `hasAbnormal` | 否 | 是否只查询存在异常项的任务；`true` 表示 `abnormalItemCount > 0` |
+
+返回示例：
+
+```json
+{
+  "records": [
+    {
+      "taskId": "8f7a4d6d1f3145a88b6f9d7a8e6c1001",
+      "taskNo": "CS202606101630001",
+      "lineId": "line-001",
+      "lineName": "进线一",
+      "timeStart": "2026-05-01 00:00:00",
+      "timeEnd": "2026-05-01 23:59:59",
+      "intervalMinutes": 1,
+      "taskStatus": "SUCCESS",
+      "itemCount": 2,
+      "abnormalItemCount": 1,
+      "minDataIntegrity": 0.999306,
+      "createTime": "2026-06-10 16:30:00"
+    }
+  ],
+  "total": 1,
+  "size": 10,
+  "current": 1,
+  "pages": 1
+}
+```
+
+cURL 示例：
+
+```bash
+curl -X POST "http://localhost:18192/steady/data-view/checksquare/query" \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/json" \
+  -d '{"pageNum":1,"pageSize":10,"lineId":"line-001","indicatorCode":"V_RMS","hasAbnormal":true}'
+```
+
+## 3. 新增数据校验记录
+
+- 方法：`POST`
+- 路径：`/steady/data-view/checksquare/create`
+- 返回：`HttpResult<SteadyChecksquareCreateVO>`
+- 说明：按监测点、指标和时间范围实时查询 InfluxDB，执行缺数校验、指标值大小关系校验、谐波奇偶关系校验，并将任务、检测项、统计摘要和明细写入 MySQL。
+
+请求示例：
+
+```json
+{
+  "lineId": "line-001",
+  "indicatorCodes": ["V_RMS", "FREQ", "V_HARMONIC"],
+  "timeStart": "2026-05-01 00:00:00",
+  "timeEnd": "2026-05-01 23:59:59"
+}
+```
+
+请求字段：
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| `lineId` | 是 | 监测点 ID，需要能在台账中找到且处于可用状态 |
+| `indicatorCodes` | 是 | 指标编码列表，来自 `/steady/data-view/indicator-tree` |
+| `timeStart` | 是 | 检测开始时间，格式 `yyyy-MM-dd HH:mm:ss` |
+| `timeEnd` | 是 | 检测结束时间，格式 `yyyy-MM-dd HH:mm:ss` |
+
+返回示例：
+
+```json
+{
+  "taskId": "8f7a4d6d1f3145a88b6f9d7a8e6c1001",
+  "taskNo": "CS202606101630001",
+  "lineId": "line-001",
+  "lineName": "进线一",
+  "timeStart": "2026-05-01 00:00:00",
+  "timeEnd": "2026-05-01 23:59:59",
+  "intervalMinutes": 1,
+  "itemCount": 3,
+  "abnormalItemCount": 1
+}
+```
+
+cURL 示例：
+
+```bash
+curl -X POST "http://localhost:18192/steady/data-view/checksquare/create" \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/json" \
+  -d '{"lineId":"line-001","indicatorCodes":["V_RMS","FREQ","V_HARMONIC"],"timeStart":"2026-05-01 00:00:00","timeEnd":"2026-05-01 23:59:59"}'
+```
+
+调试建议：
+
+- 新增接口会实际写入 MySQL，重复调用会生成新的任务记录。
+- 时间范围越大、指标越多，InfluxDB 查询和明细落库耗时越高。
+- 谐波类指标固定按 2-50 次聚合检测，不需要在请求体传 `harmonicOrders`。
+
+## 4. 查询数据校验任务详情
+
+- 方法：`GET`
+- 路径：`/steady/data-view/checksquare/detail`
+- 返回：`HttpResult<SteadyChecksquareQueryVO>`
+- 说明：按任务 ID 查询任务基础信息、检测项列表和各检测项统计摘要。检测项的明细列表通过 `/item-detail` 按需查询。
+
+请求参数：
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `taskId` | 是 | 数据校验任务 ID，即 `/query` 或 `/create` 返回的 `taskId` |
+
+请求示例：
+
+```http
+GET /steady/data-view/checksquare/detail?taskId=8f7a4d6d1f3145a88b6f9d7a8e6c1001
+```
+
+返回示例：
+
+```json
+{
+  "taskId": "8f7a4d6d1f3145a88b6f9d7a8e6c1001",
+  "taskNo": "CS202606101630001",
+  "lineId": "line-001",
+  "lineName": "进线一",
+  "timeStart": "2026-05-01 00:00:00",
+  "timeEnd": "2026-05-01 23:59:59",
+  "intervalMinutes": 1,
+  "items": [
+    {
+      "itemId": "0f4b6d6c3e9d400a902a2df101d10001",
+      "itemKey": "line-001|V_RMS",
+      "indicatorCode": "V_RMS",
+      "indicatorName": "相电压有效值",
+      "harmonicOrder": null,
+      "intervalMinutes": 1,
+      "hasData": true,
+      "expectedPointCount": 5760,
+      "actualPointCount": 5756,
+      "missingPointCount": 4,
+      "dataIntegrity": 0.999306,
+      "dataIntegrityText": "99.93%",
+      "abnormal": true,
+      "abnormalPointCount": 2,
+      "harmonicParityAbnormal": false,
+      "harmonicParityAbnormalPointCount": 0,
+      "statSummaries": [
+        {
+          "statType": "AVG",
+          "supported": true,
+          "hasData": true,
+          "expectedPointCount": 1440,
+          "actualPointCount": 1439,
+          "missingPointCount": 1,
+          "dataIntegrity": 0.999306,
+          "dataIntegrityText": "99.93%",
+        }
+      ],
+      "statDetails": []
+    }
+  ]
+}
+```
+
+cURL 示例：
+
+```bash
+curl -X GET "http://localhost:18192/steady/data-view/checksquare/detail?taskId=8f7a4d6d1f3145a88b6f9d7a8e6c1001" \
+  -H "Authorization: Bearer <token>"
+```
+
+## 5. 查询检测项明细
+
+- 方法：`GET`
+- 路径：`/steady/data-view/checksquare/item-detail`
+- 返回：`HttpResult<SteadyChecksquareItemDetailVO>`
+- 说明：按检测项 ID、明细类型查询缺数连续区间、指标值大小关系异常点或谐波奇偶关系异常点。`pageNum` 和 `pageSize` 未同时传入时保持全量返回；两者同时传入且均大于 0 时返回当前页明细，并在结果中带回分页元数据。
+
+请求参数：
+
+| 参数 | 必填 | 说明 |
+| --- | --- | --- |
+| `itemId` | 是 | 检测项 ID，即任务详情中每个 `items[].itemId` |
+| `detailType` | 是 | 明细类型：`SEGMENT`、`VALUE_ORDER`、`HARMONIC_PARITY` |
+| `statType` | 否 | 统计类型：`AVG`、`MAX`、`MIN`、`CP95`；查询缺数区间时建议传入 |
+| `pageNum` | 否 | 明细分页页码；与 `pageSize` 同时传入且大于 0 时启用分页 |
+| `pageSize` | 否 | 明细分页条数；与 `pageNum` 同时传入且大于 0 时启用分页 |
+
+### 5.1 查询缺数连续区间
+
+请求示例：
+
+```http
+GET /steady/data-view/checksquare/item-detail?itemId=0f4b6d6c3e9d400a902a2df101d10001&detailType=SEGMENT&statType=AVG
+```
+
+返回示例：
+
+```json
+{
+  "itemId": "0f4b6d6c3e9d400a902a2df101d10001",
+  "detailType": "SEGMENT",
+  "statType": "AVG",
+  "pageNum": null,
+  "pageSize": null,
+  "total": null,
+  "segments": [
+    {
+      "startTime": "2026-05-01 00:00:00",
+      "endTime": "2026-05-01 00:09:00",
+      "status": "NORMAL",
+      "harmonicOrder": null,
+      "missingPointCount": 0,
+      "durationMinutes": 10
+    },
+    {
+      "startTime": "2026-05-01 00:10:00",
+      "endTime": "2026-05-01 00:10:00",
+      "status": "MISSING",
+      "harmonicOrder": null,
+      "missingPointCount": 1,
+      "durationMinutes": 1
+    }
+  ],
+  "valueOrderDetails": [],
+  "harmonicParityDetails": []
+}
+```
+
+### 5.2 查询指标值大小关系异常明细
+
+请求示例：
+
+```http
+GET /steady/data-view/checksquare/item-detail?itemId=0f4b6d6c3e9d400a902a2df101d10001&detailType=VALUE_ORDER&pageNum=1&pageSize=20
+```
+
+返回示例：
+
+```json
+{
+  "itemId": "0f4b6d6c3e9d400a902a2df101d10001",
+  "detailType": "VALUE_ORDER",
+  "statType": null,
+  "pageNum": 1,
+  "pageSize": 20,
+  "total": 1,
+  "segments": [],
+  "valueOrderDetails": [
+    {
+      "time": "2026-05-01 00:10:00",
+      "phase": "A",
+      "harmonicOrder": null,
+      "maxValue": 219.8,
+      "minValue": 218.1,
+      "avgValue": 219.0,
+      "cp95Value": 219.8
+    }
+  ],
+  "harmonicParityDetails": []
+}
+```
+
+### 5.3 查询谐波奇偶关系异常明细
+
+请求示例：
+
+```http
+GET /steady/data-view/checksquare/item-detail?itemId=0f4b6d6c3e9d400a902a2df101d10002&detailType=HARMONIC_PARITY&pageNum=1&pageSize=20
+```
+
+返回示例：
+
+```json
+{
+  "itemId": "0f4b6d6c3e9d400a902a2df101d10002",
+  "detailType": "HARMONIC_PARITY",
+  "statType": null,
+  "pageNum": 1,
+  "pageSize": 20,
+  "total": 1,
+  "segments": [],
+  "valueOrderDetails": [],
+  "harmonicParityDetails": [
+    {
+      "time": "2026-05-01 00:10:00",
+      "phase": "A",
+      "statType": "AVG",
+      "evenHarmonicOrder": 4,
+      "evenValue": 0.32,
+      "oddHarmonicOrders": [3, 5],
+      "oddValues": [0.08, 0.09],
+      "oddMedianValue": 0.085,
+      "thresholdMultiplier": 3.0
+    }
+  ]
+}
+```
+
+cURL 示例：
+
+```bash
+curl -X GET "http://localhost:18192/steady/data-view/checksquare/item-detail?itemId=0f4b6d6c3e9d400a902a2df101d10001&detailType=VALUE_ORDER" \
+  -H "Authorization: Bearer <token>"
+```
+
+分页 cURL 示例：
+
+```bash
+curl -X GET "http://localhost:18192/steady/data-view/checksquare/item-detail?itemId=0f4b6d6c3e9d400a902a2df101d10001&detailType=VALUE_ORDER&pageNum=1&pageSize=20" \
+  -H "Authorization: Bearer <token>"
+```
+
+## 6. 删除数据校验任务
+
+- 方法：`POST`
+- 路径：`/steady/data-view/checksquare/delete`
+- 返回：`HttpResult<Boolean>`
+- 说明：按任务 ID 批量逻辑删除数据校验任务，并同步将任务下检测项置为删除态。删除后历史查询不再返回该任务，详情和检测项明细会按不存在处理。
+
+请求示例：
+
+```json
+[
+  "8f7a4d6d1f3145a88b6f9d7a8e6c1001"
+]
+```
+
+请求字段：
+
+| 字段 | 必填 | 说明 |
+| --- | --- | --- |
+| 请求体 | 是 | 数据校验任务 ID 数组 |
+
+返回示例：
+
+```json
+true
+```
+
+cURL 示例：
+
+```bash
+curl -X POST "http://localhost:18192/steady/data-view/checksquare/delete" \
+  -H "Authorization: Bearer <token>" \
+  -H "Content-Type: application/json" \
+  -d '["8f7a4d6d1f3145a88b6f9d7a8e6c1001"]'
+```
+
+## 7. 校验规则说明
+
+### 7.1 缺数校验
+
+- 按检测项支持的统计类型分别查询实际存在的时间点。
+- 返回期望点数、实际点数、缺失点数、数据完整性和最大连续缺失时长。
+- `SEGMENT` 明细按连续区间返回，`status` 可取 `NORMAL`、`MISSING`。
+- `FLUC`、`PST` 固定按 10 分钟间隔校验，`PLT` 固定按 120 分钟间隔校验，其余指标按监测点统计间隔校验。
+
+### 7.2 指标值大小关系校验
+
+- 同一时间点、同一指标、同一相别需要满足 `MAX >= CP95 >= AVG >= MIN`。
+- 缺少 `MAX`、`CP95`、`AVG`、`MIN` 任一值的时间点不计入大小关系异常，由缺数校验体现。
+- 异常点写入 `VALUE_ORDER` 明细，前端可通过 `item-detail` 拉取后弹窗展示。
+
+### 7.3 谐波奇偶关系校验
+
+- 谐波指标固定聚合 2-50 次检测。
+- 偶次谐波值需要大于 `0.1` 才继续参与奇偶关系检测。
+- 异常点写入 `HARMONIC_PARITY` 明细，包含偶次谐波值、参与比较的奇次谐波值、中位数和阈值倍数。
+
+## 8. 字段说明
+
+### 8.1 任务字段
+
+| 字段 | 说明 |
+| --- | --- |
+| `taskId` | 数据校验任务 ID |
+| `taskNo` | 数据校验任务编号 |
+| `lineId` | 监测点 ID |
+| `lineName` | 监测点名称 |
+| `timeStart` | 检测开始时间 |
+| `timeEnd` | 检测结束时间 |
+| `intervalMinutes` | 监测点统计间隔，单位分钟 |
+| `taskStatus` | 任务状态，当前成功任务为 `SUCCESS` |
+| `itemCount` | 检测项数量 |
+| `abnormalItemCount` | 存在异常的检测项数量 |
+| `minDataIntegrity` | 检测项中的最低数据完整性 |
+| `createTime` | 任务创建时间 |
+
+### 8.2 检测项字段
+
+| 字段 | 说明 |
+| --- | --- |
+| `itemId` | 检测项 ID |
+| `itemKey` | 检测项唯一键 |
+| `indicatorCode` | 指标编码 |
+| `indicatorName` | 指标名称 |
+| `harmonicOrder` | 谐波次数；聚合检测项为空 |
+| `hasData` | 当前检测项是否存在任意数据 |
+| `expectedPointCount` | 期望点数 |
+| `actualPointCount` | 实际点数 |
+| `missingPointCount` | 缺失点数 |
+| `dataIntegrity` | 数据完整性数值 |
+| `dataIntegrityText` | 数据完整性文本 |
+| `abnormal` | 指标值大小关系是否异常 |
+| `abnormalPointCount` | 指标值大小关系异常点数 |
+| `harmonicParityAbnormal` | 谐波奇偶关系是否异常 |
+| `harmonicParityAbnormalPointCount` | 谐波奇偶关系异常点数 |
+| `statSummaries` | 各统计类型缺数摘要 |
+| `statDetails` | 兼容字段；明细建议通过 `/item-detail` 按需查询 |
+
+### 8.3 检测项明细字段
+
+| 字段 | 说明 |
+| --- | --- |
+| `itemId` | 检测项 ID |
+| `detailType` | 明细类型：`SEGMENT`、`VALUE_ORDER`、`HARMONIC_PARITY` |
+| `statType` | 统计类型；未传入或当前明细类型不按统计类型过滤时为空 |
+| `pageNum` | 当前页码；未启用分页时为空 |
+| `pageSize` | 每页条数；未启用分页时为空 |
+| `total` | 当前查询条件下的总明细数；未启用分页时为空 |
+| `segments` | 缺数连续区间，仅 `SEGMENT` 查询返回数据 |
+| `valueOrderDetails` | 指标值大小关系异常点，仅 `VALUE_ORDER` 查询返回数据 |
+| `harmonicParityDetails` | 谐波奇偶关系异常点，仅 `HARMONIC_PARITY` 查询返回数据 |
+
+## 9. 常见错误场景
+
+| 场景 | 后端提示 |
+| --- | --- |
+| 新增时 `lineId` 为空 | `监测点 ID 不能为空` |
+| 新增时 `indicatorCodes` 为空 | `指标不能为空` |
+| 新增时开始时间为空 | `开始时间不能为空` |
+| 新增时结束时间为空 | `结束时间不能为空` |
+| 开始时间大于结束时间 | `开始时间不能大于结束时间` |
+| 时间格式不正确 | `时间格式不正确，仅支持 yyyy-MM-dd HH:mm:ss` |
+| 监测点不存在或不可用 | `监测点不存在或不可用` |
+| 指标编码不支持 | `稳态指标不支持：xxx` |
+| 任务不存在或已删除 | `数据校验任务不存在` |
+| 检测项不存在或已删除 | `数据校验检测项不存在` |
+| 删除时任务 ID 为空 | `数据校验任务 ID 不能为空` |
+| 删除时任务不存在或已删除 | `数据校验任务不存在或已删除` |
+| 明细类型为空 | `明细类型不能为空` |
+| 明细类型不支持 | `明细类型不支持：xxx` |
+
+## 10. 调试流程建议
+
+1. 调用 `/steady/data-view/ledger-tree` 获取可用监测点，取叶子节点 `lineId`。
+2. 调用 `/steady/data-view/indicator-tree` 获取可用指标编码。
+3. 调用 `/steady/data-view/checksquare/create` 新增校验任务。
+4. 使用返回的 `taskId` 调用 `/steady/data-view/checksquare/detail` 查看任务详情和检测项列表。
+5. 使用 `items[].itemId` 调用 `/steady/data-view/checksquare/item-detail` 查看缺数区间或异常点明细。
+6. 调用 `/steady/data-view/checksquare/query` 验证任务已落库，并按监测点、指标、时间和异常状态筛选历史记录。
+7. 调用 `/steady/data-view/checksquare/delete` 删除任务后，再调用 `/query`、`/detail` 验证任务已不可见。
+
+## 11. 环境依赖
+
+- MySQL：需要已初始化 4 张 `steady_checksquare_*` 结果表。
+- InfluxDB：新增校验任务时需要可访问 `steady.influxdb` 配置的时序库。
+- 台账：新增校验任务时需要 `lineId` 能在台账中解析到监测点路径和统计间隔。
+- 指标目录：`indicatorCodes` 必须来自后端趋势指标目录。
+
+

system-ops/dbms/README.md

@@ -2,7 +2,7 @@
 
 ## 模块定位
 
-`dbms` 是 `system-ops` 下的数据库运维模块，当前面向 Oracle 数据库提供连接配置、连接测试、表列表查询、备份、恢复、任务状态查询和删除接口。
+`dbms` 是 `system-ops` 下的数据库运维模块，当前支持 Oracle、MySQL 两类数据库运维能力，其中 Oracle 支持 `DATA_PUMP`、`JDBC_EXPORT`，MySQL 当前支持 `JDBC_EXPORT`。
 
 ## 当前接口
 
@@ -53,6 +53,7 @@ dbms:
   backup:
     storage-path: D:/dbms-backup
     default-max-file-size-mb: 512
+    mysql-fetch-size: 1000
   tools:
     expdp-path:
     impdp-path:
@@ -62,20 +63,31 @@ dbms:
 
 - `backup.storage-path`
   - `JDBC_EXPORT` 生成的 CSV 和元数据 JSON 的受管根目录。
+- `backup.default-max-file-size-mb`
+  - MySQL `JDBC_EXPORT` 默认分片大小，前端可通过 `maxFileSizeMb` 覆盖，默认 512MB。
+- `backup.mysql-fetch-size`
+  - MySQL `JDBC_EXPORT` 流式读取批量大小，默认 1000。
 - `tools.expdp-path`、`tools.impdp-path`
   - Oracle Data Pump 工具路径；为空时尝试走系统 `PATH`。
 
 ## 当前行为
 
-- 一期仅支持 `ORACLE`。
-- 连接密码支持两种运行方式：
-  - 前端每次传 `temporaryPassword`。
-  - 连接已保存密文，且公共 `Sm4Utils` 提供 `decryptData_ECB` 时由后端自动解密复用。
-- 新增连接前的测试接口允许只传 `temporaryPassword`，不强制把密码写进 `connection.password`。
+- 当前能力矩阵如下：
+
+| 数据库类型 | 连接测试 | 表列表 | JDBC_EXPORT | DATA_PUMP |
+| --- | --- | --- | --- | --- |
+| ORACLE | 支持 | 支持 | 支持 | 支持 |
+| MYSQL | 支持 | 支持 | 支持 | 不支持 |
+- 备份和恢复只允许基于已保存且连接可用的连接配置发起。
+- 新增连接前的测试接口仍可传 `temporaryPassword` 做临时连通性测试。
 - 备份任务异步执行，只有实际文件生成成功后才会写入 `dbms_backup_file` 记录。
 - `JDBC_EXPORT` 当前会生成两类文件：
-  - 主数据文件：`*.csv`
-  - 元数据文件：`*_metadata_yyyyMMdd_<taskNo>.json`
+- MySQL `JDBC_EXPORT` 会按任务号创建独立备份目录，每张表独立 CSV，默认按 512MB 分片：
+  - 数据分片文件：`<table>_part001_yyyyMMdd_<taskNo>.csv`
+  - 元数据文件：`mysql_jdbc_export_metadata_yyyyMMdd_<taskNo>.json`
+- 备份任务支持停止和重新开始：
+  - `POST /database/backups/tasks/stop`
+  - `POST /database/backups/tasks/restart`
 - `JDBC_EXPORT` 恢复依赖元数据文件，不再允许缺少元数据直接发起恢复。
 - 删除备份文件时，会校验目标路径必须位于受管备份目录下，避免误删非备份文件。
 
@@ -83,7 +95,7 @@ dbms:
 
 - `DATA_PUMP` 仍依赖部署机器可执行 `expdp`、`impdp`，并且 Oracle 侧已准备好 `directory` 对象和权限。
 - 当前代码要求 `DATA_PUMP` 连接配置里补齐可管理的 `directoryPath`，否则虽然 Oracle 端可能已导出成功，后端无法安全管理文件记录与删除。
-- `JDBC_EXPORT` 恢复当前仅覆盖表数据，不承诺恢复索引、约束、触发器、序列、存储过程、权限等 Oracle 对象。
+- `JDBC_EXPORT` 恢复当前仅覆盖表数据，不承诺恢复索引、约束、触发器、序列、存储过程、权限等数据库对象。
 - `TIME_RANGE` 模式当前只在 `JDBC_EXPORT` 场景真正参与查询过滤；`DATA_PUMP` 尚未接入 Oracle `QUERY` 参数。
-- `SIZE_SPLIT` 参数目前已做入参校验，但尚未实现真正的导出分片。
+- MySQL `JDBC_EXPORT` 已实现按大小分片；Oracle `JDBC_EXPORT` 仍沿用原单文件导出路径。
 - 本轮仅完成代码路径和文档收口，未执行 `mvn` 编译、测试或真实库联调。

system-ops/dbms/pom.xml

@@ -35,5 +35,10 @@
             <groupId>org.springframework</groupId>
             <artifactId>spring-tx</artifactId>
         </dependency>
+        <dependency>
+            <groupId>com.oracle</groupId>
+            <artifactId>ojdbc6</artifactId>
+            <version>11.2.0.3</version>
+        </dependency>
     </dependencies>
 </project>

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/component/DatabasePasswordComponent.java

@@ -1,11 +1,8 @@
 package com.njcn.gather.systemops.database.component;
 
 import cn.hutool.core.util.StrUtil;
-import com.njcn.common.utils.sm.Sm4Utils;
 import org.springframework.stereotype.Component;
 
-import java.lang.reflect.Method;
-
 /**
  * 数据库连接密码处理组件。
  */
@@ -16,29 +13,16 @@ public class DatabasePasswordComponent {
         if (StrUtil.isBlank(plainText)) {
             return null;
         }
-        return new Sm4Utils(Sm4Utils.globalSecretKey).encryptData_ECB(plainText);
+        return plainText;
     }
 
     /**
-     * 优先使用本次请求传入的临时密码；如果公共 SM4 工具存在解密能力，则复用已保存密文。
+     * 优先使用本次请求传入的临时密码；否则复用已保存的数据库密码。
      */
     public String resolveRuntimePassword(String passwordCipher, String temporaryPassword) {
         if (StrUtil.isNotBlank(temporaryPassword)) {
             return temporaryPassword;
         }
-        if (StrUtil.isBlank(passwordCipher)) {
-            return null;
-        }
-        try {
-            Sm4Utils sm4Utils = new Sm4Utils(Sm4Utils.globalSecretKey);
-            Method decryptMethod = Sm4Utils.class.getMethod("decryptData_ECB", String.class);
-            Object plainText = decryptMethod.invoke(sm4Utils, passwordCipher);
-            if (plainText instanceof String && StrUtil.isNotBlank((String) plainText)) {
-                return (String) plainText;
-            }
-        } catch (Exception ignored) {
-            // 兼容公共工具不同版本，未找到解密方法时继续走统一失败提示。
-        }
-        throw new IllegalArgumentException("当前环境未确认密码解密方法，请传入临时密码执行本次操作");
+        return StrUtil.isBlank(passwordCipher) ? null : passwordCipher;
     }
 }

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/component/JdbcExportComponent.java

@@ -0,0 +1,541 @@
+package com.njcn.gather.systemops.database.component;
+
+import cn.hutool.core.util.StrUtil;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
+import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import lombok.Data;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.sql.Connection;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.ResultSetMetaData;
+import java.sql.Statement;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.regex.Pattern;
+import java.util.function.BooleanSupplier;
+
+/**
+ * JDBC 表数据导出与恢复组件。
+ */
+@Component
+@RequiredArgsConstructor
+public class JdbcExportComponent {
+
+    private static final Pattern IDENTIFIER_PATTERN = Pattern.compile("^[A-Za-z][A-Za-z0-9_#$]*$");
+    private static final DateTimeFormatter DATE_TIME_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
+
+    private final ObjectMapper objectMapper;
+
+    public void exportCsv(Connection jdbcConnection, String ownerName, DatabaseBackupParam.CreateParam param,
+                          Path dataFilePath, Path metadataFilePath) throws Exception {
+        Files.createDirectories(dataFilePath.getParent());
+        if (metadataFilePath.getParent() != null) {
+            Files.createDirectories(metadataFilePath.getParent());
+        }
+        List<TableMetadata> metadataList = new ArrayList<>();
+        try (BufferedWriter writer = Files.newBufferedWriter(dataFilePath, StandardCharsets.UTF_8)) {
+            for (String tableName : param.getTargetNames()) {
+                metadataList.add(exportTable(jdbcConnection, ownerName, tableName, param, writer));
+            }
+        }
+        try (BufferedWriter metadataWriter = Files.newBufferedWriter(metadataFilePath, StandardCharsets.UTF_8)) {
+            objectMapper.writeValue(metadataWriter, metadataList);
+        }
+    }
+
+    public void importCsv(Connection jdbcConnection, Path dataFilePath, Path metadataFilePath, String dbType,
+                          String restoreMode, String targetOwnerName) throws Exception {
+        String metadataText = new String(Files.readAllBytes(metadataFilePath), StandardCharsets.UTF_8);
+        if (metadataText.trim().startsWith("{")) {
+            importCsvV2(jdbcConnection, metadataFilePath, dbType, restoreMode, targetOwnerName);
+            return;
+        }
+        List<TableMetadata> metadataList = Arrays.asList(objectMapper.readValue(metadataFilePath.toFile(), TableMetadata[].class));
+        Map<String, TableMetadata> metadataMap = new LinkedHashMap<>();
+        for (TableMetadata metadata : metadataList) {
+            metadataMap.put(metadata.getFullTableName(), metadata);
+        }
+        jdbcConnection.setAutoCommit(false);
+        try (BufferedReader reader = Files.newBufferedReader(dataFilePath, StandardCharsets.UTF_8)) {
+            try {
+                String line;
+                TableMetadata currentMetadata = null;
+                List<String> currentColumns = null;
+                while ((line = reader.readLine()) != null) {
+                    if (line.startsWith("-- TABLE ")) {
+                        currentMetadata = metadataMap.get(line.substring("-- TABLE ".length()).trim());
+                        if (currentMetadata == null) {
+                            throw new IllegalArgumentException("未找到表元数据：" + line);
+                        }
+                        currentColumns = null;
+                        prepareTargetTable(jdbcConnection, currentMetadata, dbType, restoreMode, targetOwnerName);
+                        continue;
+                    }
+                    if (currentMetadata == null) {
+                        continue;
+                    }
+                    if (currentColumns == null) {
+                        currentColumns = parseCsvLine(line);
+                        continue;
+                    }
+                    List<String> values = parseCsvLine(line);
+                    insertRow(jdbcConnection, currentMetadata, currentColumns, values, dbType, restoreMode, targetOwnerName);
+                }
+                jdbcConnection.commit();
+            } catch (Exception exception) {
+                jdbcConnection.rollback();
+                throw exception;
+            }
+        }
+    }
+
+    public ExportManifest exportMysqlCsvV2(Connection jdbcConnection, String databaseName, String taskNo,
+                                           DatabaseBackupParam.CreateParam param, Path backupDirectory,
+                                           Path metadataFilePath, int fetchSize, long maxPartBytes,
+                                           BooleanSupplier cancelled) throws Exception {
+        Files.createDirectories(backupDirectory);
+        ExportManifest manifest = new ExportManifest();
+        manifest.setVersion(2);
+        manifest.setDbType("MYSQL");
+        manifest.setBackupStrategy("JDBC_EXPORT");
+        manifest.setTaskNo(taskNo);
+        manifest.setDatabaseName(databaseName);
+        List<TableExportMetadata> tableMetadataList = new ArrayList<>();
+        manifest.setTables(tableMetadataList);
+        for (String tableName : param.getTargetNames()) {
+            checkCancelled(cancelled, backupDirectory);
+            tableMetadataList.add(exportMysqlTableV2(jdbcConnection, tableName, param, backupDirectory, taskNo,
+                    fetchSize, maxPartBytes, cancelled));
+        }
+        try (BufferedWriter metadataWriter = Files.newBufferedWriter(metadataFilePath, StandardCharsets.UTF_8)) {
+            objectMapper.writeValue(metadataWriter, manifest);
+        }
+        return manifest;
+    }
+
+    private TableMetadata exportTable(Connection connection, String ownerName, String tableName,
+                                      DatabaseBackupParam.CreateParam param, BufferedWriter writer) throws Exception {
+        String normalizedOwner = normalizeOwner(ownerName);
+        String normalizedTable = normalizeMysqlIdentifier(tableName);
+        String fullTableName = buildFullTableName(normalizedOwner, normalizedTable);
+        String querySql = buildQuerySql(fullTableName, param);
+        TableMetadata metadata = new TableMetadata();
+        metadata.setOwnerName(normalizedOwner);
+        metadata.setTableName(normalizedTable);
+        metadata.setFullTableName(fullTableName);
+        metadata.setTimeColumn(StrUtil.isBlank(param.getTimeColumn()) ? null : normalizeMysqlIdentifier(param.getTimeColumn()));
+        metadata.setStartTime(param.getStartTime() == null ? null : param.getStartTime().format(DATE_TIME_FORMATTER));
+        metadata.setEndTime(param.getEndTime() == null ? null : param.getEndTime().format(DATE_TIME_FORMATTER));
+        writer.write("-- TABLE " + fullTableName);
+        writer.newLine();
+        try (PreparedStatement statement = connection.prepareStatement(querySql)) {
+            fillQueryParams(statement, param);
+            try (ResultSet resultSet = statement.executeQuery()) {
+                ResultSetMetaData resultSetMetaData = resultSet.getMetaData();
+                int columnCount = resultSetMetaData.getColumnCount();
+                List<String> columnNames = new ArrayList<>();
+                List<String> columnTypes = new ArrayList<>();
+                for (int i = 1; i <= columnCount; i++) {
+                    String columnName = resultSetMetaData.getColumnName(i);
+                    columnNames.add(normalizeMysqlIdentifier(columnName));
+                    columnTypes.add(resultSetMetaData.getColumnTypeName(i));
+                    if (i > 1) {
+                        writer.write(",");
+                    }
+                    writer.write(escape(columnName));
+                }
+                writer.newLine();
+                long rowCount = 0L;
+                while (resultSet.next()) {
+                    for (int i = 1; i <= columnCount; i++) {
+                        if (i > 1) {
+                            writer.write(",");
+                        }
+                        writer.write(escape(resultSet.getString(i)));
+                    }
+                    writer.newLine();
+                    rowCount++;
+                }
+                metadata.setColumnNames(columnNames);
+                metadata.setColumnTypes(columnTypes);
+                metadata.setRowCount(rowCount);
+                return metadata;
+            }
+        }
+    }
+
+    private TableExportMetadata exportMysqlTableV2(Connection connection, String tableName,
+                                                   DatabaseBackupParam.CreateParam param, Path backupDirectory,
+                                                   String taskNo, int fetchSize, long maxPartBytes,
+                                                   BooleanSupplier cancelled) throws Exception {
+        String normalizedTable = normalizeIdentifier(tableName);
+        String querySql = buildQuerySql(normalizedTable, param);
+        TableExportMetadata metadata = new TableExportMetadata();
+        metadata.setTableName(normalizedTable);
+        metadata.setFullTableName(normalizedTable);
+        metadata.setTimeColumn(StrUtil.isBlank(param.getTimeColumn()) ? null : normalizeIdentifier(param.getTimeColumn()));
+        metadata.setStartTime(param.getStartTime() == null ? null : param.getStartTime().format(DATE_TIME_FORMATTER));
+        metadata.setEndTime(param.getEndTime() == null ? null : param.getEndTime().format(DATE_TIME_FORMATTER));
+        metadata.setColumns(new ArrayList<>());
+        metadata.setParts(new ArrayList<>());
+        try (PreparedStatement statement = connection.prepareStatement(querySql, ResultSet.TYPE_FORWARD_ONLY, ResultSet.CONCUR_READ_ONLY)) {
+            statement.setFetchSize(fetchSize);
+            fillQueryParams(statement, param);
+            try (ResultSet resultSet = statement.executeQuery()) {
+                ResultSetMetaData resultSetMetaData = resultSet.getMetaData();
+                int columnCount = resultSetMetaData.getColumnCount();
+                List<String> columnNames = new ArrayList<>();
+                for (int i = 1; i <= columnCount; i++) {
+                    String columnName = resultSetMetaData.getColumnName(i);
+                    columnNames.add(columnName);
+                    ColumnMetadata columnMetadata = new ColumnMetadata();
+                    columnMetadata.setName(columnName);
+                    columnMetadata.setType(resultSetMetaData.getColumnTypeName(i));
+                    metadata.getColumns().add(columnMetadata);
+                }
+                PartWriter partWriter = openPartWriter(backupDirectory, normalizedTable, taskNo,
+                        metadata.getParts().size() + 1, columnNames);
+                metadata.getParts().add(partWriter.getPart());
+                long totalRows = 0L;
+                try {
+                    while (resultSet.next()) {
+                        checkCancelled(cancelled, backupDirectory);
+                        if (partWriter.shouldRotate(maxPartBytes)) {
+                            partWriter.close();
+                            partWriter = openPartWriter(backupDirectory, normalizedTable, taskNo,
+                                    metadata.getParts().size() + 1, columnNames);
+                            metadata.getParts().add(partWriter.getPart());
+                        }
+                        partWriter.writeRow(resultSet, columnCount);
+                        totalRows++;
+                    }
+                } finally {
+                    partWriter.close();
+                }
+                metadata.setRowCount(totalRows);
+                return metadata;
+            }
+        }
+    }
+
+    private String buildQuerySql(String fullTableName, DatabaseBackupParam.CreateParam param) {
+        StringBuilder sql = new StringBuilder("SELECT * FROM ").append(fullTableName);
+        if (param.getStartTime() != null && param.getEndTime() != null && StrUtil.isNotBlank(param.getTimeColumn())) {
+            sql.append(" WHERE ").append(normalizeIdentifier(param.getTimeColumn())).append(" BETWEEN ? AND ?");
+        }
+        return sql.toString();
+    }
+
+    private void fillQueryParams(PreparedStatement statement, DatabaseBackupParam.CreateParam param) throws Exception {
+        if (param.getStartTime() != null && param.getEndTime() != null && StrUtil.isNotBlank(param.getTimeColumn())) {
+            statement.setString(1, param.getStartTime().format(DATE_TIME_FORMATTER));
+            statement.setString(2, param.getEndTime().format(DATE_TIME_FORMATTER));
+        }
+    }
+
+    private void prepareTargetTable(Connection connection, TableMetadata metadata, String dbType, String restoreMode,
+                                    String targetOwnerName) throws Exception {
+        if (!"TRUNCATE".equalsIgnoreCase(restoreMode)
+                && !("REPLACE".equalsIgnoreCase(restoreMode) && !isMysql(dbType))) {
+            return;
+        }
+        String fullTargetName = buildTargetTableName(metadata, targetOwnerName);
+        try (Statement statement = connection.createStatement()) {
+            statement.execute("TRUNCATE TABLE " + fullTargetName);
+        }
+    }
+
+    private void insertRow(Connection connection, TableMetadata metadata, List<String> columns,
+                           List<String> values, String dbType, String restoreMode, String targetOwnerName) throws Exception {
+        String fullTargetName = buildTargetTableName(metadata, targetOwnerName);
+        StringBuilder placeholders = new StringBuilder();
+        for (int i = 0; i < columns.size(); i++) {
+            if (i > 0) {
+                placeholders.append(",");
+            }
+            placeholders.append("?");
+        }
+        String sql = buildInsertSql(dbType, restoreMode, fullTargetName, columns, placeholders.toString());
+        try (PreparedStatement statement = connection.prepareStatement(sql)) {
+            for (int i = 0; i < columns.size(); i++) {
+                statement.setString(i + 1, i < values.size() ? values.get(i) : null);
+            }
+            statement.executeUpdate();
+        }
+    }
+
+    private String buildInsertSql(String dbType, String restoreMode, String fullTargetName, List<String> columns,
+                                  String placeholders) {
+        String command = "INSERT INTO";
+        if (isMysql(dbType) && "SKIP".equalsIgnoreCase(restoreMode)) {
+            // MySQL 跳过重复主键行，避免普通恢复因历史数据重复而整体失败。
+            command = "INSERT IGNORE INTO";
+        } else if (isMysql(dbType) && "REPLACE".equalsIgnoreCase(restoreMode)) {
+            command = "REPLACE INTO";
+        }
+        return command + " " + fullTargetName + " (" + String.join(",", columns) + ") VALUES (" + placeholders + ")";
+    }
+
+    private void importCsvV2(Connection jdbcConnection, Path metadataFilePath, String dbType, String restoreMode,
+                             String targetOwnerName) throws Exception {
+        ExportManifest manifest = objectMapper.readValue(metadataFilePath.toFile(), ExportManifest.class);
+        jdbcConnection.setAutoCommit(false);
+        try {
+            for (TableExportMetadata tableMetadata : manifest.getTables()) {
+                prepareTargetTable(jdbcConnection, toLegacyMetadata(tableMetadata), dbType, restoreMode, targetOwnerName);
+                for (FilePartMetadata part : tableMetadata.getParts()) {
+                    importPart(jdbcConnection, metadataFilePath.getParent(), tableMetadata, part, dbType, restoreMode, targetOwnerName);
+                }
+            }
+            jdbcConnection.commit();
+        } catch (Exception exception) {
+            jdbcConnection.rollback();
+            throw exception;
+        }
+    }
+
+    private void importPart(Connection jdbcConnection, Path backupDirectory, TableExportMetadata tableMetadata,
+                            FilePartMetadata part, String dbType, String restoreMode, String targetOwnerName) throws Exception {
+        Path partPath = backupDirectory.resolve(part.getFileName()).normalize();
+        if (!partPath.startsWith(backupDirectory.normalize())) {
+            throw new IllegalArgumentException("备份分片路径不在元数据目录内：" + part.getFileName());
+        }
+        try (BufferedReader reader = Files.newBufferedReader(partPath, StandardCharsets.UTF_8)) {
+            List<String> columns = null;
+            String line;
+            while ((line = reader.readLine()) != null) {
+                if (line.startsWith("-- TABLE ")) {
+                    continue;
+                }
+                if (columns == null) {
+                    columns = parseCsvLine(line);
+                    continue;
+                }
+                List<String> values = parseCsvLine(line);
+                insertRow(jdbcConnection, toLegacyMetadata(tableMetadata), columns, values, dbType, restoreMode, targetOwnerName);
+            }
+        }
+    }
+
+    private boolean isMysql(String dbType) {
+        return DatabaseOpsConst.DB_TYPE_MYSQL.equalsIgnoreCase(dbType);
+    }
+
+    private PartWriter openPartWriter(Path backupDirectory, String tableName, String taskNo, int partIndex,
+                                      List<String> columnNames) throws IOException {
+        String rawName = tableName.toLowerCase(Locale.ROOT) + "_part" + String.format("%03d", partIndex) + ".csv";
+        String fileName = DatabaseFileNameUtil.appendTodayWithTask(rawName, taskNo);
+        Path filePath = backupDirectory.resolve(fileName).normalize();
+        BufferedWriter writer = Files.newBufferedWriter(filePath, StandardCharsets.UTF_8);
+        writer.write("-- TABLE " + tableName);
+        writer.newLine();
+        for (int i = 0; i < columnNames.size(); i++) {
+            if (i > 0) {
+                writer.write(",");
+            }
+            writer.write(escape(columnNames.get(i)));
+        }
+        writer.newLine();
+        FilePartMetadata part = new FilePartMetadata();
+        part.setFileName(fileName);
+        part.setFilePath(filePath.toString());
+        part.setRowCount(0L);
+        part.setFileSize(0L);
+        return new PartWriter(writer, filePath, part);
+    }
+
+    private TableMetadata toLegacyMetadata(TableExportMetadata metadata) {
+        TableMetadata legacy = new TableMetadata();
+        legacy.setOwnerName(null);
+        legacy.setTableName(metadata.getTableName());
+        legacy.setFullTableName(metadata.getFullTableName());
+        legacy.setTimeColumn(metadata.getTimeColumn());
+        legacy.setStartTime(metadata.getStartTime());
+        legacy.setEndTime(metadata.getEndTime());
+        legacy.setRowCount(metadata.getRowCount());
+        List<String> columnNames = new ArrayList<>();
+        List<String> columnTypes = new ArrayList<>();
+        for (ColumnMetadata column : metadata.getColumns()) {
+            columnNames.add(column.getName());
+            columnTypes.add(column.getType());
+        }
+        legacy.setColumnNames(columnNames);
+        legacy.setColumnTypes(columnTypes);
+        return legacy;
+    }
+
+    private void checkCancelled(BooleanSupplier cancelled, Path backupDirectory) {
+        if (cancelled != null && cancelled.getAsBoolean()) {
+            throw new IllegalStateException("备份任务已停止，已生成文件保留在：" + backupDirectory);
+        }
+    }
+
+    private String buildTargetTableName(TableMetadata metadata, String targetOwnerName) {
+        String owner = normalizeOwner(StrUtil.blankToDefault(targetOwnerName, metadata.getOwnerName()));
+        return buildFullTableName(owner, metadata.getTableName());
+    }
+
+    private String buildFullTableName(String ownerName, String tableName) {
+        if (StrUtil.isBlank(ownerName)) {
+            return tableName;
+        }
+        return ownerName + "." + tableName;
+    }
+
+    private String normalizeOwner(String ownerName) {
+        if (StrUtil.isBlank(ownerName)) {
+            return null;
+        }
+        return normalizeIdentifier(ownerName);
+    }
+
+    private List<String> parseCsvLine(String line) {
+        List<String> result = new ArrayList<>();
+        StringBuilder current = new StringBuilder();
+        boolean quoted = false;
+        for (int i = 0; i < line.length(); i++) {
+            char currentChar = line.charAt(i);
+            if (currentChar == '"') {
+                if (quoted && i + 1 < line.length() && line.charAt(i + 1) == '"') {
+                    current.append('"');
+                    i++;
+                } else {
+                    quoted = !quoted;
+                }
+                continue;
+            }
+            if (currentChar == ',' && !quoted) {
+                result.add(current.toString());
+                current.setLength(0);
+                continue;
+            }
+            current.append(currentChar);
+        }
+        result.add(current.toString());
+        return result;
+    }
+
+    private String escape(String value) {
+        if (value == null) {
+            return "";
+        }
+        return "\"" + value.replace("\"", "\"\"") + "\"";
+    }
+
+    private String normalizeIdentifier(String value) {
+        if (value == null || !IDENTIFIER_PATTERN.matcher(value).matches()) {
+            throw new IllegalArgumentException("数据库对象名称格式不正确：" + value);
+        }
+        return value.trim().toUpperCase(Locale.ROOT);
+    }
+
+    private String normalizeMysqlIdentifier(String value) {
+        if (value == null || !IDENTIFIER_PATTERN.matcher(value).matches()) {
+            throw new IllegalArgumentException("数据库对象名称格式不正确：" + value);
+        }
+        return value.trim();
+    }
+
+    @Data
+    public static class TableMetadata {
+        private String ownerName;
+        private String tableName;
+        private String fullTableName;
+        private List<String> columnNames;
+        private List<String> columnTypes;
+        private String timeColumn;
+        private String startTime;
+        private String endTime;
+        private Long rowCount;
+    }
+
+    @Data
+    public static class ExportManifest {
+        private Integer version;
+        private String dbType;
+        private String backupStrategy;
+        private String taskNo;
+        private String databaseName;
+        private List<TableExportMetadata> tables;
+    }
+
+    @Data
+    public static class TableExportMetadata {
+        private String tableName;
+        private String fullTableName;
+        private String timeColumn;
+        private String startTime;
+        private String endTime;
+        private List<ColumnMetadata> columns;
+        private Long rowCount;
+        private List<FilePartMetadata> parts;
+    }
+
+    @Data
+    public static class ColumnMetadata {
+        private String name;
+        private String type;
+    }
+
+    @Data
+    public static class FilePartMetadata {
+        private String fileName;
+        private String filePath;
+        private Long rowCount;
+        private Long fileSize;
+    }
+
+    private class PartWriter {
+        private final BufferedWriter writer;
+        private final Path filePath;
+        private final FilePartMetadata part;
+
+        private PartWriter(BufferedWriter writer, Path filePath, FilePartMetadata part) {
+            this.writer = writer;
+            this.filePath = filePath;
+            this.part = part;
+        }
+
+        private FilePartMetadata getPart() {
+            return part;
+        }
+
+        private boolean shouldRotate(long maxPartBytes) throws IOException {
+            writer.flush();
+            return part.getRowCount() > 0 && Files.size(filePath) >= maxPartBytes;
+        }
+
+        private void writeRow(ResultSet resultSet, int columnCount) throws Exception {
+            for (int i = 1; i <= columnCount; i++) {
+                if (i > 1) {
+                    writer.write(",");
+                }
+                writer.write(escape(resultSet.getString(i)));
+            }
+            writer.newLine();
+            part.setRowCount(part.getRowCount() + 1);
+        }
+
+        private void close() throws IOException {
+            writer.close();
+            part.setFileSize(Files.exists(filePath) ? Files.size(filePath) : 0L);
+        }
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/component/OracleJdbcComponent.java

@@ -0,0 +1,89 @@
+package com.njcn.gather.systemops.database.component;
+
+import cn.hutool.core.util.StrUtil;
+import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTableVO;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTestResultVO;
+import org.springframework.stereotype.Component;
+
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.Timestamp;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+/**
+ * Oracle JDBC 连接与元数据探测组件。
+ */
+@Component
+public class OracleJdbcComponent {
+
+    public DatabaseTestResultVO test(DatabaseConnection connection, String password) {
+        DatabaseTestResultVO result = new DatabaseTestResultVO();
+        try (Connection ignored = openConnection(connection, password)) {
+            result.setSuccess(true);
+            result.setMessage("连接成功");
+        } catch (Exception exception) {
+            result.setSuccess(false);
+            result.setMessage(exception.getMessage());
+        }
+        return result;
+    }
+
+    public List<DatabaseTableVO> listTables(DatabaseConnection connection, String password, String schemaName) throws Exception {
+        String owner = StrUtil.blankToDefault(schemaName, connection.getSchemaName());
+        if (StrUtil.isBlank(owner)) {
+            owner = connection.getUsername();
+        }
+        owner = owner.trim().toUpperCase(Locale.ROOT);
+        String sql = "SELECT t.owner, t.table_name, t.num_rows, o.last_ddl_time, c.comments "
+                + "FROM all_tables t "
+                + "LEFT JOIN all_tab_comments c "
+                + "ON t.owner = c.owner AND t.table_name = c.table_name "
+                + "LEFT JOIN all_objects o "
+                + "ON t.owner = o.owner AND t.table_name = o.object_name AND o.object_type = 'TABLE' "
+                + "WHERE t.owner = ? ORDER BY t.table_name";
+        try (Connection jdbcConnection = openConnection(connection, password);
+             PreparedStatement statement = jdbcConnection.prepareStatement(sql)) {
+            statement.setString(1, owner);
+            try (ResultSet resultSet = statement.executeQuery()) {
+                List<DatabaseTableVO> result = new ArrayList<>();
+                while (resultSet.next()) {
+                    DatabaseTableVO table = new DatabaseTableVO();
+                    table.setOwner(resultSet.getString("owner"));
+                    table.setTableName(resultSet.getString("table_name"));
+                    table.setEngine(DatabaseOpsConst.DB_TYPE_ORACLE);
+                    table.setTableRows(getLongValue(resultSet, "num_rows"));
+                    Timestamp updateTime = resultSet.getTimestamp("last_ddl_time");
+                    table.setUpdateTime(updateTime == null ? null : updateTime.toLocalDateTime());
+                    table.setComments(resultSet.getString("comments"));
+                    result.add(table);
+                }
+                return result;
+            }
+        }
+    }
+
+    private Long getLongValue(ResultSet resultSet, String columnName) throws Exception {
+        long value = resultSet.getLong(columnName);
+        return resultSet.wasNull() ? null : value;
+    }
+
+    public Connection openConnection(DatabaseConnection connection, String password) throws Exception {
+        if (StrUtil.isBlank(password)) {
+            throw new IllegalArgumentException("数据库密码不能为空");
+        }
+        return DriverManager.getConnection(buildJdbcUrl(connection), connection.getUsername(), password);
+    }
+
+    public String buildJdbcUrl(DatabaseConnection connection) {
+        if (DatabaseOpsConst.CONNECT_TYPE_SID.equalsIgnoreCase(connection.getConnectType())) {
+            return "jdbc:oracle:thin:@" + connection.getHost() + ":" + connection.getPort() + ":" + connection.getSid();
+        }
+        return "jdbc:oracle:thin:@//" + connection.getHost() + ":" + connection.getPort() + "/" + connection.getServiceName();
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/config/DbmsProperties.java

@@ -19,6 +19,7 @@ public class DbmsProperties {
     public static class Backup {
         private String storagePath = "D:/dbms-backup";
         private Integer defaultMaxFileSizeMb = 512;
+        private Integer mysqlFetchSize = 1000;
     }
 
     @Data

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/constant/DatabaseOpsConst.java

@@ -6,6 +6,7 @@ package com.njcn.gather.systemops.database.constant;
 public final class DatabaseOpsConst {
 
     public static final String DB_TYPE_ORACLE = "ORACLE";
+    public static final String DB_TYPE_MYSQL = "MYSQL";
     public static final String CONNECT_TYPE_SERVICE_NAME = "SERVICE_NAME";
     public static final String CONNECT_TYPE_SID = "SID";
     public static final String CONFIRM_DELETE = "确认删除";

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/controller/DatabaseBackupController.java

@@ -61,6 +61,22 @@ public class DatabaseBackupController extends BaseController {
         return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, databaseOperationTaskService.getStatus(taskId), methodDescribe);
     }
 
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON, operateType = OperateType.UPDATE)
+    @ApiOperation("停止备份任务")
+    @PostMapping("/tasks/stop")
+    public HttpResult<Boolean> stop(@RequestBody @Validated DatabaseBackupParam.StopParam param) {
+        String methodDescribe = getMethodDescribe("stop");
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, databaseOperationTaskService.stopBackupTask(param), methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON, operateType = OperateType.ADD)
+    @ApiOperation("重新开始备份任务")
+    @PostMapping("/tasks/restart")
+    public HttpResult<DatabaseTaskCreateVO> restart(@RequestBody @Validated DatabaseBackupParam.RestartParam param) {
+        String methodDescribe = getMethodDescribe("restart");
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, databaseOperationTaskService.restartBackupTask(param), methodDescribe);
+    }
+
     @OperateInfo(info = LogEnum.BUSINESS_COMMON)
     @ApiOperation("查询备份文件")
     @PostMapping("/files/list")

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/enums/OperationTypeEnum.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.systemops.database.pojo.enums;
+
+/**
+ * 数据库运维操作类型。
+ */
+public enum OperationTypeEnum {
+    BACKUP,
+    RESTORE,
+    DELETE
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/enums/RestoreModeEnum.java

@@ -0,0 +1,11 @@
+package com.njcn.gather.systemops.database.pojo.enums;
+
+/**
+ * 恢复模式。
+ */
+public enum RestoreModeEnum {
+    SKIP,
+    APPEND,
+    TRUNCATE,
+    REPLACE
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/param/DatabaseBackupParam.java

@@ -64,4 +64,22 @@ public class DatabaseBackupParam {
         @ApiModelProperty("备份策略")
         private String backupStrategy;
     }
+
+    @Data
+    @ApiModel("停止备份任务参数")
+    public static class StopParam {
+        @ApiModelProperty("备份任务 ID")
+        @NotBlank(message = "备份任务 ID 不能为空")
+        private String taskId;
+    }
+
+    @Data
+    @ApiModel("重新开始备份任务参数")
+    public static class RestartParam {
+        @ApiModelProperty("备份任务 ID")
+        @NotBlank(message = "备份任务 ID 不能为空")
+        private String taskId;
+        @ApiModelProperty("临时密码，原连接未保存密码时传入")
+        private String temporaryPassword;
+    }
 }

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/param/DatabaseConnectionParam.java

@@ -1,5 +1,6 @@
 package com.njcn.gather.systemops.database.pojo.param;
 
+import com.fasterxml.jackson.annotation.JsonAlias;
 import com.njcn.web.pojo.param.BaseParam;
 import io.swagger.annotations.ApiModel;
 import io.swagger.annotations.ApiModelProperty;
@@ -20,7 +21,7 @@ public class DatabaseConnectionParam {
     @NotBlank(message = "连接名称不能为空")
     private String connectionName;
 
-    @ApiModelProperty("数据库类型，一期固定 ORACLE")
+    @ApiModelProperty("数据库类型：ORACLE、MYSQL")
     private String dbType;
 
     @ApiModelProperty("数据库主机地址")
@@ -40,6 +41,9 @@ public class DatabaseConnectionParam {
     @ApiModelProperty("SID")
     private String sid;
 
+    @ApiModelProperty("数据库名，MySQL 使用")
+    private String databaseName;
+
     @ApiModelProperty("Schema")
     private String schemaName;
 
@@ -113,7 +117,14 @@ public class DatabaseConnectionParam {
         private String connectionId;
         @ApiModelProperty("临时密码，不保存密码时传入")
         private String temporaryPassword;
-        @ApiModelProperty("Schema，不传则使用连接默认 Schema")
+        @ApiModelProperty("兼容前端传入的运行时密码；为空时复用数据库 password_cipher")
+        private String password;
+        @JsonAlias("password_cipher")
+        @ApiModelProperty("兼容前端传入的已保存密码")
+        private String passwordCipher;
+        @ApiModelProperty("兼容前端传入的临时连接参数")
+        private DatabaseConnectionParam connection;
+        @ApiModelProperty("Schema 或数据库名，不传则使用连接默认值")
         private String schemaName;
     }
 }

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/vo/DatabaseConnectionVO.java

@@ -17,6 +17,7 @@ public class DatabaseConnectionVO {
     private String connectType;
     private String serviceName;
     private String sid;
+    private String databaseName;
     private String schemaName;
     private String username;
     private Integer savePassword;

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/pojo/vo/DatabaseTableVO.java

@@ -2,6 +2,8 @@ package com.njcn.gather.systemops.database.pojo.vo;
 
 import lombok.Data;
 
+import java.time.LocalDateTime;
+
 /**
  * 数据库表信息。
  */
@@ -9,5 +11,11 @@ import lombok.Data;
 public class DatabaseTableVO {
     private String owner;
     private String tableName;
+    private Long autoIncrementValue = 0L;
+    private Long autoIncrement = 0L;
+    private LocalDateTime updateTime;
+    private Long dataLength;
+    private String engine;
+    private Long tableRows;
     private String comments;
 }

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/service/DatabaseOperationTaskService.java

@@ -18,6 +18,10 @@ public interface DatabaseOperationTaskService extends IService<DatabaseOperation
 
     DatabaseTaskVO getStatus(String taskId);
 
+    boolean stopBackupTask(DatabaseBackupParam.StopParam param);
+
+    DatabaseTaskCreateVO restartBackupTask(DatabaseBackupParam.RestartParam param);
+
     boolean deleteTask(String taskId, String confirmText);
 
     boolean existsRunningTask(String connectionId);

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/service/impl/DatabaseBackupFileServiceImpl.java

@@ -24,7 +24,9 @@ import org.springframework.transaction.annotation.Transactional;
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.time.LocalDateTime;
+import java.util.Comparator;
 import java.util.stream.Collectors;
+import java.util.stream.Stream;
 
 /**
  * 数据库备份文件服务实现。
@@ -63,9 +65,9 @@ public class DatabaseBackupFileServiceImpl extends ServiceImpl<DatabaseBackupFil
         if (file == null) {
             throw new BusinessException(CommonResponseEnum.FAIL, "备份文件不存在或已删除");
         }
-        deletePhysicalFile(file, file.getFilePath());
-        deletePhysicalFile(file, file.getLogFilePath());
-        deletePhysicalFile(file, file.getMetadataFilePath());
+        deletePhysicalPath(file, file.getFilePath());
+        deletePhysicalPath(file, file.getLogFilePath());
+        deletePhysicalPath(file, file.getMetadataFilePath());
         file.setState(DatabaseOpsConst.STATE_DELETED);
         file.setUpdateTime(LocalDateTime.now());
         return this.updateById(file);
@@ -73,14 +75,14 @@ public class DatabaseBackupFileServiceImpl extends ServiceImpl<DatabaseBackupFil
 
     @Override
     public void validateBackupFileReadable(DatabaseBackupFile backupFile) {
-        validateReadablePath(backupFile, backupFile.getFilePath(), "备份文件", false);
+        validateReadablePath(backupFile, backupFile.getFilePath(), "备份文件", false, true);
         validateReadablePath(backupFile, backupFile.getMetadataFilePath(), "备份元数据文件",
-                StrUtil.isBlank(backupFile.getMetadataFilePath()));
+                StrUtil.isBlank(backupFile.getMetadataFilePath()), false);
         if (StrUtil.isBlank(backupFile.getChecksum())) {
             throw new BusinessException(CommonResponseEnum.FAIL, "备份文件缺少校验值");
         }
-        Path filePath = resolveManagedPath(backupFile, backupFile.getFilePath());
-        String actualChecksum = DatabaseChecksumUtil.sha256(filePath);
+        Path checksumPath = resolveChecksumPath(backupFile);
+        String actualChecksum = DatabaseChecksumUtil.sha256(checksumPath);
         if (!backupFile.getChecksum().equalsIgnoreCase(actualChecksum)) {
             throw new BusinessException(CommonResponseEnum.FAIL, "备份文件校验失败");
         }
@@ -100,20 +102,41 @@ public class DatabaseBackupFileServiceImpl extends ServiceImpl<DatabaseBackupFil
             return path;
         }
         Path primaryFilePath = DatabasePathUtil.normalize(backupFile.getFilePath());
-        if (primaryFilePath != null && primaryFilePath.getParent() != null
-                && DatabasePathUtil.isUnder(path, primaryFilePath.getParent())) {
-            return path;
+        if (primaryFilePath != null) {
+            Path allowedRoot = Files.isDirectory(primaryFilePath) ? primaryFilePath : primaryFilePath.getParent();
+            if (allowedRoot != null && DatabasePathUtil.isUnder(path, allowedRoot)) {
+                return path;
+            }
         }
         throw new BusinessException(CommonResponseEnum.FAIL, "文件路径不在允许的备份目录内");
     }
 
-    private void deletePhysicalFile(DatabaseBackupFile backupFile, String filePath) {
+    private Path resolveChecksumPath(DatabaseBackupFile backupFile) {
+        Path metadataPath = resolveManagedPath(backupFile, backupFile.getMetadataFilePath());
+        if (metadataPath != null && Files.exists(metadataPath) && !Files.isDirectory(metadataPath)) {
+            return metadataPath;
+        }
+        Path filePath = resolveManagedPath(backupFile, backupFile.getFilePath());
+        if (filePath == null || !Files.exists(filePath) || Files.isDirectory(filePath)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份校验文件不存在");
+        }
+        return filePath;
+    }
+
+    private void deletePhysicalPath(DatabaseBackupFile backupFile, String filePath) {
         if (StrUtil.isBlank(filePath)) {
             return;
         }
         try {
             Path path = resolveManagedPath(backupFile, filePath);
-            if (path != null && Files.exists(path) && !Files.isDirectory(path)) {
+            if (path == null || !Files.exists(path)) {
+                return;
+            }
+            if (Files.isDirectory(path)) {
+                try (Stream<Path> paths = Files.walk(path)) {
+                    paths.sorted(Comparator.reverseOrder()).forEach(this::deleteSinglePath);
+                }
+            } else {
                 Files.delete(path);
             }
         } catch (BusinessException exception) {
@@ -123,7 +146,16 @@ public class DatabaseBackupFileServiceImpl extends ServiceImpl<DatabaseBackupFil
         }
     }
 
-    private void validateReadablePath(DatabaseBackupFile backupFile, String filePath, String fileType, boolean allowBlank) {
+    private void deleteSinglePath(Path path) {
+        try {
+            Files.deleteIfExists(path);
+        } catch (Exception exception) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "删除物理文件失败：" + exception.getMessage());
+        }
+    }
+
+    private void validateReadablePath(DatabaseBackupFile backupFile, String filePath, String fileType,
+                                      boolean allowBlank, boolean allowDirectory) {
         if (StrUtil.isBlank(filePath)) {
             if (allowBlank) {
                 return;
@@ -131,9 +163,12 @@ public class DatabaseBackupFileServiceImpl extends ServiceImpl<DatabaseBackupFil
             throw new BusinessException(CommonResponseEnum.FAIL, fileType + "路径不能为空");
         }
         Path path = resolveManagedPath(backupFile, filePath);
-        if (path == null || !Files.exists(path) || Files.isDirectory(path)) {
+        if (path == null || !Files.exists(path)) {
             throw new BusinessException(CommonResponseEnum.FAIL, fileType + "不存在");
         }
+        if (Files.isDirectory(path) && !allowDirectory) {
+            throw new BusinessException(CommonResponseEnum.FAIL, fileType + "不能是目录");
+        }
     }
 
     private DatabaseBackupFileVO toVO(DatabaseBackupFile file) {

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/service/impl/DatabaseConnectionServiceImpl.java

@@ -8,7 +8,6 @@ import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import com.njcn.common.pojo.enums.response.CommonResponseEnum;
 import com.njcn.common.pojo.exception.BusinessException;
 import com.njcn.gather.systemops.database.component.DatabasePasswordComponent;
-import com.njcn.gather.systemops.database.component.OracleJdbcComponent;
 import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
 import com.njcn.gather.systemops.database.mapper.DatabaseConnectionMapper;
 import com.njcn.gather.systemops.database.pojo.param.DatabaseConnectionParam;
@@ -18,6 +17,8 @@ import com.njcn.gather.systemops.database.pojo.vo.DatabaseTableVO;
 import com.njcn.gather.systemops.database.pojo.vo.DatabaseTestResultVO;
 import com.njcn.gather.systemops.database.service.DatabaseConnectionService;
 import com.njcn.gather.systemops.database.service.DatabaseOperationTaskService;
+import com.njcn.gather.systemops.database.support.spi.DatabaseConnectionOperator;
+import com.njcn.gather.systemops.database.support.spi.DatabaseOperatorRegistry;
 import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
 import com.njcn.web.factory.PageFactory;
 import lombok.RequiredArgsConstructor;
@@ -38,7 +39,7 @@ import java.util.stream.Collectors;
 public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectionMapper, DatabaseConnection> implements DatabaseConnectionService {
 
     private final DatabasePasswordComponent databasePasswordComponent;
-    private final OracleJdbcComponent oracleJdbcComponent;
+    private final DatabaseOperatorRegistry databaseOperatorRegistry;
     private final ObjectProvider<DatabaseOperationTaskService> databaseOperationTaskServiceProvider;
 
     @Override
@@ -61,6 +62,7 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
     public boolean addConnection(DatabaseConnectionParam param) {
         DatabaseConnection connection = new DatabaseConnection();
         fillConnection(connection, param, true);
+        checkConnectionNameUnique(connection.getConnectionName());
         connection.setId(DatabaseOpsIdUtil.uuid());
         connection.setState(DatabaseOpsConst.STATE_ENABLED);
         connection.setCreateTime(LocalDateTime.now());
@@ -95,12 +97,10 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
     @Transactional(rollbackFor = Exception.class)
     public DatabaseTestResultVO testConnection(DatabaseConnectionParam.TestParam param) {
         DatabaseConnection connection = resolveTestConnection(param);
-        DatabaseTestResultVO result = oracleJdbcComponent.test(connection, resolvePassword(connection, param.getTemporaryPassword()));
+        DatabaseConnectionOperator operator = databaseOperatorRegistry.getConnectionOperator(connection.getDbType());
+        DatabaseTestResultVO result = operator.test(connection, resolvePassword(connection, param.getTemporaryPassword()));
         if (StrUtil.isNotBlank(connection.getId())) {
-            connection.setLastTestStatus(Boolean.TRUE.equals(result.getSuccess()) ? "SUCCESS" : "FAIL");
-            connection.setLastTestMessage(result.getMessage());
-            connection.setLastTestTime(LocalDateTime.now());
-            this.updateById(connection);
+            updateLastTestResult(connection.getId(), result);
         }
         return result;
     }
@@ -109,7 +109,10 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
     public List<DatabaseTableVO> listTables(DatabaseConnectionParam.TablesParam param) {
         DatabaseConnection connection = requireEnabled(param.getConnectionId());
         try {
-            return oracleJdbcComponent.listTables(connection, resolvePassword(connection, param.getTemporaryPassword()), param.getSchemaName());
+            DatabaseConnectionOperator operator = databaseOperatorRegistry.getConnectionOperator(connection.getDbType());
+            String password = resolveTablesPassword(connection, param);
+            return operator.listTables(connection, password,
+                    resolveSchemaOrDatabase(param, connection));
         } catch (Exception exception) {
             throw new BusinessException(CommonResponseEnum.FAIL, exception.getMessage());
         }
@@ -141,7 +144,18 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
 
     private DatabaseConnection resolveTestConnection(DatabaseConnectionParam.TestParam param) {
         if (StrUtil.isNotBlank(param.getConnectionId())) {
-            return requireEnabled(param.getConnectionId());
+            DatabaseConnection savedConnection = requireEnabled(param.getConnectionId());
+            if (param.getConnection() == null) {
+                return savedConnection;
+            }
+            DatabaseConnection connection = new DatabaseConnection();
+            fillConnection(connection, param.getConnection(), true, true);
+            connection.setId(savedConnection.getId());
+            if (StrUtil.isBlank(param.getConnection().getPassword())) {
+                // 已有连接测试编辑后参数时，未传密码则复用库里保存的密码。
+                connection.setPasswordCipher(savedConnection.getPasswordCipher());
+            }
+            return connection;
         }
         if (param.getConnection() == null) {
             throw new BusinessException(CommonResponseEnum.FAIL, "连接测试参数不能为空");
@@ -151,20 +165,47 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
         return connection;
     }
 
+    private void updateLastTestResult(String connectionId, DatabaseTestResultVO result) {
+        this.lambdaUpdate()
+                .set(DatabaseConnection::getLastTestStatus, Boolean.TRUE.equals(result.getSuccess()) ? "SUCCESS" : "FAIL")
+                .set(DatabaseConnection::getLastTestMessage, result.getMessage())
+                .set(DatabaseConnection::getLastTestTime, LocalDateTime.now())
+                .eq(DatabaseConnection::getId, connectionId)
+                .update();
+    }
+
+    private String resolveTablesPassword(DatabaseConnection connection, DatabaseConnectionParam.TablesParam param) {
+        if (StrUtil.isNotBlank(param.getTemporaryPassword())) {
+            return param.getTemporaryPassword();
+        }
+        if (StrUtil.isNotBlank(param.getPassword())) {
+            return param.getPassword();
+        }
+        if (param.getConnection() != null && StrUtil.isNotBlank(param.getConnection().getPassword())) {
+            return param.getConnection().getPassword();
+        }
+        if (StrUtil.isNotBlank(param.getPasswordCipher())) {
+            return databasePasswordComponent.resolveRuntimePassword(param.getPasswordCipher(), null);
+        }
+        return resolvePassword(connection, null);
+    }
+
     private void fillConnection(DatabaseConnection connection, DatabaseConnectionParam param, boolean create) {
         fillConnection(connection, param, create, false);
     }
 
     private void fillConnection(DatabaseConnection connection, DatabaseConnectionParam param, boolean create,
                                 boolean allowTemporaryPasswordOnly) {
-        validateConnectionParam(param);
+        String dbType = resolveDbType(param.getDbType());
+        validateConnectionParam(param, dbType);
         connection.setConnectionName(param.getConnectionName().trim());
-        connection.setDbType(DatabaseOpsConst.DB_TYPE_ORACLE);
+        connection.setDbType(dbType);
         connection.setHost(param.getHost().trim());
         connection.setPort(param.getPort());
-        connection.setConnectType(resolveConnectType(param.getConnectType()));
-        connection.setServiceName(trimToNull(param.getServiceName()));
-        connection.setSid(trimToNull(param.getSid()));
+        connection.setConnectType(DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? resolveConnectType(param.getConnectType()) : null);
+        connection.setServiceName(DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? trimToNull(param.getServiceName()) : null);
+        connection.setSid(DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? trimToNull(param.getSid()) : null);
+        connection.setDatabaseName(DatabaseOpsConst.DB_TYPE_MYSQL.equals(dbType) ? trimToNull(param.getDatabaseName()) : null);
         connection.setSchemaName(trimToNull(param.getSchemaName()));
         connection.setUsername(param.getUsername().trim());
         connection.setSavePassword(param.getSavePassword() == null ? DatabaseOpsConst.SAVE_PASSWORD_YES : param.getSavePassword());
@@ -180,19 +221,38 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
         } else if (create && StrUtil.isBlank(param.getPassword()) && !allowTemporaryPasswordOnly) {
             throw new BusinessException(CommonResponseEnum.FAIL, "保存密码时密码不能为空");
         }
-        connection.setDirectoryName(trimToNull(param.getDirectoryName()));
-        connection.setDirectoryPath(trimToNull(param.getDirectoryPath()));
+        connection.setDirectoryName(DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? trimToNull(param.getDirectoryName()) : null);
+        connection.setDirectoryPath(DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? trimToNull(param.getDirectoryPath()) : null);
         connection.setExtraConfigJson(trimToNull(param.getExtraConfigJson()));
         connection.setRemark(param.getRemark());
     }
 
-    private void validateConnectionParam(DatabaseConnectionParam param) {
-        String connectType = resolveConnectType(param.getConnectType());
-        if (DatabaseOpsConst.CONNECT_TYPE_SERVICE_NAME.equals(connectType) && StrUtil.isBlank(param.getServiceName())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "SERVICE_NAME 连接方式下服务名不能为空");
+    private void validateConnectionParam(DatabaseConnectionParam param, String dbType) {
+        if (DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType)) {
+            String connectType = resolveConnectType(param.getConnectType());
+            if (DatabaseOpsConst.CONNECT_TYPE_SERVICE_NAME.equals(connectType) && StrUtil.isBlank(param.getServiceName())) {
+                throw new BusinessException(CommonResponseEnum.FAIL, "SERVICE_NAME 连接方式下服务名不能为空");
+            }
+            if (DatabaseOpsConst.CONNECT_TYPE_SID.equals(connectType) && StrUtil.isBlank(param.getSid())) {
+                throw new BusinessException(CommonResponseEnum.FAIL, "SID 连接方式下 SID 不能为空");
+            }
+            return;
         }
-        if (DatabaseOpsConst.CONNECT_TYPE_SID.equals(connectType) && StrUtil.isBlank(param.getSid())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "SID 连接方式下 SID 不能为空");
+        if (StrUtil.isBlank(param.getDatabaseName())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "MYSQL 数据库名不能为空");
+        }
+    }
+
+    /**
+     * 新增连接时，连接名称在有效记录中必须唯一。
+     */
+    private void checkConnectionNameUnique(String connectionName) {
+        long count = this.lambdaQuery()
+                .eq(DatabaseConnection::getConnectionName, connectionName)
+                .eq(DatabaseConnection::getState, DatabaseOpsConst.STATE_ENABLED)
+                .count();
+        if (count > 0) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "连接名称已存在");
         }
     }
 
@@ -200,6 +260,21 @@ public class DatabaseConnectionServiceImpl extends ServiceImpl<DatabaseConnectio
         return StrUtil.blankToDefault(connectType, DatabaseOpsConst.CONNECT_TYPE_SERVICE_NAME).trim().toUpperCase(Locale.ROOT);
     }
 
+    private String resolveDbType(String dbType) {
+        String resolved = StrUtil.blankToDefault(dbType, DatabaseOpsConst.DB_TYPE_ORACLE).trim().toUpperCase(Locale.ROOT);
+        if (!DatabaseOpsConst.DB_TYPE_ORACLE.equals(resolved) && !DatabaseOpsConst.DB_TYPE_MYSQL.equals(resolved)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "不支持的数据库类型：" + dbType);
+        }
+        return resolved;
+    }
+
+    private String resolveSchemaOrDatabase(DatabaseConnectionParam.TablesParam param, DatabaseConnection connection) {
+        if (DatabaseOpsConst.DB_TYPE_MYSQL.equals(connection.getDbType())) {
+            return StrUtil.blankToDefault(param.getSchemaName(), connection.getDatabaseName());
+        }
+        return param.getSchemaName();
+    }
+
     private String trimToNull(String value) {
         return StrUtil.isBlank(value) ? null : value.trim();
     }

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/service/impl/DatabaseOperationTaskServiceImpl.java

@@ -8,14 +8,10 @@ import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.njcn.common.pojo.enums.response.CommonResponseEnum;
 import com.njcn.common.pojo.exception.BusinessException;
-import com.njcn.gather.systemops.database.component.DataPumpCommandExecutor;
-import com.njcn.gather.systemops.database.component.JdbcExportComponent;
-import com.njcn.gather.systemops.database.config.DbmsProperties;
 import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
 import com.njcn.gather.systemops.database.mapper.DatabaseOperationTaskMapper;
 import com.njcn.gather.systemops.database.pojo.enums.BackupModeEnum;
 import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
-import com.njcn.gather.systemops.database.pojo.enums.FileFormatEnum;
 import com.njcn.gather.systemops.database.pojo.enums.OperationTypeEnum;
 import com.njcn.gather.systemops.database.pojo.enums.TaskStatusEnum;
 import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
@@ -27,10 +23,9 @@ import com.njcn.gather.systemops.database.pojo.vo.DatabaseTaskVO;
 import com.njcn.gather.systemops.database.service.DatabaseBackupFileService;
 import com.njcn.gather.systemops.database.service.DatabaseConnectionService;
 import com.njcn.gather.systemops.database.service.DatabaseOperationTaskService;
-import com.njcn.gather.systemops.database.util.DatabaseChecksumUtil;
-import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import com.njcn.gather.systemops.database.support.spi.DatabaseBackupOperator;
+import com.njcn.gather.systemops.database.support.spi.DatabaseOperatorRegistry;
 import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
-import com.njcn.gather.systemops.database.util.DatabasePathUtil;
 import com.njcn.web.factory.PageFactory;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -39,8 +34,6 @@ import org.springframework.transaction.annotation.Transactional;
 
 import javax.annotation.Resource;
 import java.math.BigDecimal;
-import java.nio.file.Files;
-import java.nio.file.Path;
 import java.time.LocalDateTime;
 import java.util.Arrays;
 import java.util.Locale;
@@ -57,9 +50,7 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
 
     private final DatabaseConnectionService databaseConnectionService;
     private final DatabaseBackupFileService databaseBackupFileService;
-    private final DataPumpCommandExecutor dataPumpCommandExecutor;
-    private final JdbcExportComponent jdbcExportComponent;
-    private final DbmsProperties dbmsProperties;
+    private final DatabaseOperatorRegistry databaseOperatorRegistry;
     private final ObjectMapper objectMapper;
     @Resource(name = "dbmsTaskExecutorService")
     private ExecutorService dbmsTaskExecutorService;
@@ -95,11 +86,41 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
 
     @Override
     public DatabaseTaskVO getStatus(String taskId) {
-        DatabaseOperationTask task = this.getById(taskId);
-        if (task == null || !Integer.valueOf(DatabaseOpsConst.STATE_ENABLED).equals(task.getState())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "任务不存在或已删除");
+        return toVO(requireEnabledTask(taskId));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public boolean stopBackupTask(DatabaseBackupParam.StopParam param) {
+        DatabaseOperationTask task = requireEnabledTask(param.getTaskId());
+        if (!OperationTypeEnum.BACKUP.name().equals(task.getOperationType())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "仅支持停止备份任务");
         }
-        return toVO(task);
+        if (!TaskStatusEnum.WAITING.name().equals(task.getTaskStatus())
+                && !TaskStatusEnum.RUNNING.name().equals(task.getTaskStatus())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "仅等待中或运行中的任务允许停止");
+        }
+        task.setTaskStatus(TaskStatusEnum.CANCELLED.name());
+        task.setResultMessage("用户请求停止备份任务");
+        task.setFinishedAt(LocalDateTime.now());
+        task.setUpdateTime(LocalDateTime.now());
+        return this.updateById(task);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public DatabaseTaskCreateVO restartBackupTask(DatabaseBackupParam.RestartParam param) {
+        DatabaseOperationTask sourceTask = requireEnabledTask(param.getTaskId());
+        if (!OperationTypeEnum.BACKUP.name().equals(sourceTask.getOperationType())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "仅支持重新开始备份任务");
+        }
+        if (!TaskStatusEnum.FAIL.name().equals(sourceTask.getTaskStatus())
+                && !TaskStatusEnum.CANCELLED.name().equals(sourceTask.getTaskStatus())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "仅失败或已取消的任务允许重新开始");
+        }
+        DatabaseBackupParam.CreateParam createParam = readCreateParam(sourceTask.getRequestParamJson());
+        createParam.setTemporaryPassword(param.getTemporaryPassword());
+        return createBackupTask(createParam);
     }
 
     @Override
@@ -108,10 +129,7 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
         if (!DatabaseOpsConst.CONFIRM_DELETE.equals(confirmText)) {
             throw new BusinessException(CommonResponseEnum.FAIL, "确认文案不正确");
         }
-        DatabaseOperationTask task = this.getById(taskId);
-        if (task == null || !Integer.valueOf(DatabaseOpsConst.STATE_ENABLED).equals(task.getState())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "任务不存在或已删除");
-        }
+        DatabaseOperationTask task = requireEnabledTask(taskId);
         if (TaskStatusEnum.RUNNING.name().equals(task.getTaskStatus()) || TaskStatusEnum.WAITING.name().equals(task.getTaskStatus())) {
             throw new BusinessException(CommonResponseEnum.FAIL, "运行中的任务不能删除");
         }
@@ -132,113 +150,32 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
     private void executeBackupTask(String taskId, DatabaseBackupParam.CreateParam param) {
         DatabaseOperationTask task = this.getById(taskId);
         try {
+            if (task == null || TaskStatusEnum.CANCELLED.name().equals(task.getTaskStatus())) {
+                return;
+            }
             markRunning(task);
             DatabaseConnection connection = databaseConnectionService.requireEnabled(task.getConnectionId());
             connection.setSchemaName(task.getSchemaName());
             String password = databaseConnectionService.resolvePassword(connection, param.getTemporaryPassword());
-            DatabaseBackupFile backupFile;
-            if (BackupStrategyEnum.DATA_PUMP.name().equals(task.getBackupStrategy())) {
-                backupFile = executeDataPumpBackup(task, connection, password, param);
-            } else {
-                backupFile = executeJdbcExportBackup(task, connection, password, param);
+            DatabaseBackupOperator operator = databaseOperatorRegistry.getBackupOperator(connection.getDbType(), task.getBackupStrategy());
+            DatabaseBackupFile backupFile = operator.executeBackup(task, connection, password, param);
+            task = this.getById(taskId);
+            if (task == null || TaskStatusEnum.CANCELLED.name().equals(task.getTaskStatus())) {
+                return;
             }
             databaseBackupFileService.save(backupFile);
             markSuccess(task, "备份任务执行成功");
         } catch (Exception exception) {
             log.error("数据库备份任务失败，taskId={}", taskId, exception);
+            task = this.getById(taskId);
+            if (task != null && TaskStatusEnum.CANCELLED.name().equals(task.getTaskStatus())) {
+                markCancelled(task, exception.getMessage());
+                return;
+            }
             markFail(task, exception.getMessage());
         }
     }
 
-    private DatabaseBackupFile executeDataPumpBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
-                                                     DatabaseBackupParam.CreateParam param) {
-        String directoryName = StrUtil.blankToDefault(param.getDirectoryName(), connection.getDirectoryName());
-        if (StrUtil.isBlank(directoryName)) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "DATA_PUMP 备份需要 Oracle Directory 名称");
-        }
-        String baseName = buildBaseFileName(connection, task);
-        String dumpFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".dmp", task.getTaskNo());
-        String logFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".log", task.getTaskNo());
-        DataPumpCommandExecutor.CommandResult commandResult = dataPumpCommandExecutor.expdp(connection, password, directoryName, dumpFileName, logFileName, param.getTargetNames());
-        if (!Boolean.TRUE.equals(commandResult.getSuccess())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 执行失败：" + commandResult.getOutput());
-        }
-        if (StrUtil.isBlank(connection.getDirectoryPath())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 备份需要配置可管理的 directoryPath");
-        }
-        Path dumpPath = buildManagedPath(connection.getDirectoryPath(), dumpFileName);
-        Path logPath = buildManagedPath(connection.getDirectoryPath(), logFileName);
-        return buildBackupFile(task, connection, param, FileFormatEnum.DMP.name(), dumpFileName, dumpPath, logFileName, logPath, null);
-    }
-
-    private DatabaseBackupFile executeJdbcExportBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
-                                                       DatabaseBackupParam.CreateParam param) throws Exception {
-        String baseName = buildBaseFileName(connection, task);
-        String fileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".csv", task.getTaskNo());
-        String metadataFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + "_metadata.json", task.getTaskNo());
-        Path dataFilePath = buildManagedPath(dbmsProperties.getBackup().getStoragePath(), fileName);
-        Path metadataFilePath = buildManagedPath(dbmsProperties.getBackup().getStoragePath(), metadataFileName);
-        jdbcExportComponent.exportCsv(connection, password, param, dataFilePath, metadataFilePath);
-        return buildBackupFile(task, connection, param, FileFormatEnum.CSV.name(), fileName, dataFilePath, null, null, metadataFilePath);
-    }
-
-    private DatabaseBackupFile buildBackupFile(DatabaseOperationTask task, DatabaseConnection connection, DatabaseBackupParam.CreateParam param,
-                                               String fileFormat, String fileName, Path filePath, String logFileName, Path logFilePath,
-                                               Path metadataFilePath) {
-        if (filePath == null || !Files.exists(filePath)) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "备份文件未生成");
-        }
-        DatabaseBackupFile file = new DatabaseBackupFile();
-        file.setId(DatabaseOpsIdUtil.uuid());
-        file.setTaskId(task.getId());
-        file.setConnectionId(connection.getId());
-        file.setDbType(connection.getDbType());
-        file.setBackupStrategy(task.getBackupStrategy());
-        file.setFileFormat(fileFormat);
-        file.setSchemaName(task.getSchemaName());
-        file.setTargetNamesJson(task.getTargetNamesJson());
-        file.setBackupMode(StrUtil.blankToDefault(param.getBackupMode(), BackupModeEnum.FULL_TABLE.name()).toUpperCase(Locale.ROOT));
-        file.setBackupStartTime(param.getStartTime());
-        file.setBackupEndTime(param.getEndTime());
-        file.setTimeColumn(param.getTimeColumn());
-        file.setDirectoryName(StrUtil.blankToDefault(param.getDirectoryName(), connection.getDirectoryName()));
-        file.setDumpFileName(FileFormatEnum.DMP.name().equals(fileFormat) ? fileName : null);
-        file.setLogFileName(logFileName);
-        file.setFileName(fileName);
-        file.setFilePath(filePath.toString());
-        file.setLogFilePath(logFilePath == null ? null : logFilePath.toString());
-        file.setMetadataFilePath(metadataFilePath == null ? null : metadataFilePath.toString());
-        file.setFileSize(readFileSize(filePath));
-        file.setChecksum(DatabaseChecksumUtil.sha256(filePath));
-        file.setState(DatabaseOpsConst.STATE_ENABLED);
-        file.setCreateTime(LocalDateTime.now());
-        file.setUpdateTime(LocalDateTime.now());
-        return file;
-    }
-
-    private Long readFileSize(Path filePath) {
-        try {
-            if (filePath != null && Files.exists(filePath) && !Files.isDirectory(filePath)) {
-                return Files.size(filePath);
-            }
-        } catch (Exception ignored) {
-            return null;
-        }
-        return null;
-    }
-
-    private Path buildManagedPath(String rootPath, String fileName) {
-        Path root = DatabasePathUtil.normalize(rootPath);
-        if (root == null) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "备份目录未配置");
-        }
-        return root.resolve(fileName).normalize();
-    }
-
-    private String buildBaseFileName(DatabaseConnection connection, DatabaseOperationTask task) {
-        return connection.getSchemaName() + "_" + task.getBackupStrategy().toLowerCase(Locale.ROOT);
-    }
-
     private DatabaseOperationTask buildBackupTask(DatabaseBackupParam.CreateParam param, DatabaseConnection connection) {
         DatabaseOperationTask task = new DatabaseOperationTask();
         task.setId(DatabaseOpsIdUtil.uuid());
@@ -246,9 +183,9 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
         task.setConnectionId(connection.getId());
         task.setDbType(connection.getDbType());
         task.setOperationType(OperationTypeEnum.BACKUP.name());
-        task.setBackupStrategy(resolveBackupStrategy(param.getBackupStrategy()));
+        task.setBackupStrategy(resolveBackupStrategy(param.getBackupStrategy(), connection.getDbType()));
         task.setTaskStatus(TaskStatusEnum.WAITING.name());
-        task.setSchemaName(StrUtil.blankToDefault(param.getSchemaName(), connection.getSchemaName()));
+        task.setSchemaName(resolveSchemaName(param, connection));
         task.setTargetNamesJson(writeJson(param.getTargetNames()));
         task.setRequestParamJson(writeJsonWithoutPassword(param));
         task.setProgressPercent(BigDecimal.ZERO);
@@ -259,15 +196,16 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
     }
 
     private void validateBackupParam(DatabaseBackupParam.CreateParam param, DatabaseConnection connection) {
-        if (!DatabaseOpsConst.DB_TYPE_ORACLE.equals(connection.getDbType())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "一期仅支持 ORACLE");
-        }
         if (param.getTargetNames() == null || param.getTargetNames().isEmpty()) {
             throw new BusinessException(CommonResponseEnum.FAIL, "备份表不能为空");
         }
-        if (StrUtil.isBlank(StrUtil.blankToDefault(param.getSchemaName(), connection.getSchemaName()))) {
+        if (DatabaseOpsConst.DB_TYPE_ORACLE.equals(connection.getDbType())
+                && StrUtil.isBlank(StrUtil.blankToDefault(param.getSchemaName(), connection.getSchemaName()))) {
             throw new BusinessException(CommonResponseEnum.FAIL, "备份 Schema 不能为空");
         }
+        if (DatabaseOpsConst.DB_TYPE_MYSQL.equals(connection.getDbType()) && StrUtil.isBlank(connection.getDatabaseName())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "MYSQL 数据库名不能为空");
+        }
         String backupMode = StrUtil.blankToDefault(param.getBackupMode(), BackupModeEnum.FULL_TABLE.name()).toUpperCase(Locale.ROOT);
         if (BackupModeEnum.TIME_RANGE.name().equals(backupMode)
                 && (param.getStartTime() == null || param.getEndTime() == null)) {
@@ -282,22 +220,37 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
                 && (param.getMaxFileSizeMb() == null || param.getMaxFileSizeMb() <= 0)) {
             throw new BusinessException(CommonResponseEnum.FAIL, "按大小分片必须传入大于 0 的文件大小");
         }
-        if (BackupStrategyEnum.JDBC_EXPORT.name().equals(resolveBackupStrategy(param.getBackupStrategy()))
-                && BackupModeEnum.TIME_RANGE.name().equals(backupMode)
-                && StrUtil.isBlank(param.getTimeColumn())) {
-            throw new BusinessException(CommonResponseEnum.FAIL, "JDBC 按时间备份必须传入时间字段");
+        if (BackupModeEnum.TIME_RANGE.name().equals(backupMode) && StrUtil.isBlank(param.getTimeColumn())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "按时间备份必须传入时间字段");
         }
+        resolveBackupStrategy(param.getBackupStrategy(), connection.getDbType());
     }
 
-    private String resolveBackupStrategy(String backupStrategy) {
-        String value = StrUtil.blankToDefault(backupStrategy, BackupStrategyEnum.DATA_PUMP.name()).trim().toUpperCase(Locale.ROOT);
+    private String resolveBackupStrategy(String backupStrategy, String dbType) {
+        String value = StrUtil.blankToDefault(backupStrategy,
+                        DatabaseOpsConst.DB_TYPE_ORACLE.equals(dbType) ? BackupStrategyEnum.DATA_PUMP.name() : BackupStrategyEnum.JDBC_EXPORT.name())
+                .trim()
+                .toUpperCase(Locale.ROOT);
         try {
-            return BackupStrategyEnum.valueOf(value).name();
+            BackupStrategyEnum strategyEnum = BackupStrategyEnum.valueOf(value);
+            if (DatabaseOpsConst.DB_TYPE_MYSQL.equals(dbType) && BackupStrategyEnum.DATA_PUMP == strategyEnum) {
+                throw new BusinessException(CommonResponseEnum.FAIL, "MYSQL 不支持 DATA_PUMP");
+            }
+            return strategyEnum.name();
+        } catch (BusinessException exception) {
+            throw exception;
         } catch (Exception exception) {
             throw new BusinessException(CommonResponseEnum.FAIL, "不支持的备份策略：" + backupStrategy);
         }
     }
 
+    private String resolveSchemaName(DatabaseBackupParam.CreateParam param, DatabaseConnection connection) {
+        if (DatabaseOpsConst.DB_TYPE_MYSQL.equals(connection.getDbType())) {
+            return StrUtil.blankToDefault(param.getSchemaName(), connection.getDatabaseName());
+        }
+        return StrUtil.blankToDefault(param.getSchemaName(), connection.getSchemaName());
+    }
+
     private void markRunning(DatabaseOperationTask task) {
         task.setTaskStatus(TaskStatusEnum.RUNNING.name());
         task.setStartedAt(LocalDateTime.now());
@@ -315,6 +268,9 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
     }
 
     private void markFail(DatabaseOperationTask task, String message) {
+        if (task == null) {
+            return;
+        }
         task.setTaskStatus(TaskStatusEnum.FAIL.name());
         task.setResultMessage(message);
         task.setFinishedAt(LocalDateTime.now());
@@ -322,6 +278,22 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
         this.updateById(task);
     }
 
+    private void markCancelled(DatabaseOperationTask task, String message) {
+        task.setTaskStatus(TaskStatusEnum.CANCELLED.name());
+        task.setResultMessage(StrUtil.blankToDefault(message, "备份任务已停止"));
+        task.setFinishedAt(LocalDateTime.now());
+        task.setUpdateTime(LocalDateTime.now());
+        this.updateById(task);
+    }
+
+    private DatabaseOperationTask requireEnabledTask(String taskId) {
+        DatabaseOperationTask task = this.getById(taskId);
+        if (task == null || !Integer.valueOf(DatabaseOpsConst.STATE_ENABLED).equals(task.getState())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "任务不存在或已删除");
+        }
+        return task;
+    }
+
     private String writeJson(Object value) {
         try {
             return objectMapper.writeValueAsString(value);
@@ -337,6 +309,14 @@ public class DatabaseOperationTaskServiceImpl extends ServiceImpl<DatabaseOperat
         return writeJson(copy);
     }
 
+    private DatabaseBackupParam.CreateParam readCreateParam(String requestParamJson) {
+        try {
+            return objectMapper.readValue(requestParamJson, DatabaseBackupParam.CreateParam.class);
+        } catch (Exception exception) {
+            throw new BusinessException(CommonResponseEnum.JSON_CONVERT_EXCEPTION, exception.getMessage());
+        }
+    }
+
     private DatabaseTaskCreateVO toCreateVO(DatabaseOperationTask task) {
         DatabaseTaskCreateVO vo = new DatabaseTaskCreateVO();
         vo.setTaskId(task.getId());

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/service/impl/DatabaseRestoreServiceImpl.java

@@ -5,13 +5,9 @@ import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.njcn.common.pojo.enums.response.CommonResponseEnum;
 import com.njcn.common.pojo.exception.BusinessException;
-import com.njcn.gather.systemops.database.component.DataPumpCommandExecutor;
-import com.njcn.gather.systemops.database.component.JdbcExportComponent;
-import com.njcn.gather.systemops.database.component.OracleJdbcComponent;
 import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
 import com.njcn.gather.systemops.database.mapper.DatabaseRestoreRecordMapper;
 import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
-import com.njcn.gather.systemops.database.pojo.enums.FileFormatEnum;
 import com.njcn.gather.systemops.database.pojo.enums.OperationTypeEnum;
 import com.njcn.gather.systemops.database.pojo.enums.RestoreModeEnum;
 import com.njcn.gather.systemops.database.pojo.enums.TaskStatusEnum;
@@ -25,7 +21,9 @@ import com.njcn.gather.systemops.database.service.DatabaseBackupFileService;
 import com.njcn.gather.systemops.database.service.DatabaseConnectionService;
 import com.njcn.gather.systemops.database.service.DatabaseOperationTaskService;
 import com.njcn.gather.systemops.database.service.DatabaseRestoreService;
-import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import com.njcn.gather.systemops.database.support.spi.DatabaseConnectionOperator;
+import com.njcn.gather.systemops.database.support.spi.DatabaseOperatorRegistry;
+import com.njcn.gather.systemops.database.support.spi.DatabaseRestoreOperator;
 import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
@@ -34,7 +32,6 @@ import org.springframework.transaction.annotation.Transactional;
 
 import javax.annotation.Resource;
 import java.math.BigDecimal;
-import java.nio.file.Path;
 import java.time.LocalDateTime;
 import java.util.Locale;
 import java.util.concurrent.ExecutorService;
@@ -50,9 +47,7 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
     private final DatabaseConnectionService databaseConnectionService;
     private final DatabaseOperationTaskService databaseOperationTaskService;
     private final DatabaseBackupFileService databaseBackupFileService;
-    private final DataPumpCommandExecutor dataPumpCommandExecutor;
-    private final JdbcExportComponent jdbcExportComponent;
-    private final OracleJdbcComponent oracleJdbcComponent;
+    private final DatabaseOperatorRegistry databaseOperatorRegistry;
     private final ObjectMapper objectMapper;
     @Resource(name = "dbmsTaskExecutorService")
     private ExecutorService dbmsTaskExecutorService;
@@ -87,20 +82,8 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
             DatabaseBackupFile backupFile = requireBackupFile(record.getBackupFileId());
             databaseBackupFileService.validateBackupFileReadable(backupFile);
             String password = databaseConnectionService.resolvePassword(connection, param.getTemporaryPassword());
-            if (BackupStrategyEnum.DATA_PUMP.name().equals(backupFile.getBackupStrategy())) {
-                DataPumpCommandExecutor.CommandResult result = dataPumpCommandExecutor.impdp(connection, password,
-                        backupFile.getDirectoryName(), backupFile.getDumpFileName(), buildRestoreLogName(task),
-                        record.getTableExistsAction());
-                if (!Boolean.TRUE.equals(result.getSuccess())) {
-                    throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 恢复失败：" + result.getOutput());
-                }
-            } else if (FileFormatEnum.CSV.name().equalsIgnoreCase(backupFile.getFileFormat())) {
-                Path dataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getFilePath());
-                Path metadataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getMetadataFilePath());
-                jdbcExportComponent.importCsv(connection, password, dataFilePath, metadataFilePath, record.getRestoreMode(), record.getTargetSchemaName());
-            } else {
-                throw new BusinessException(CommonResponseEnum.FAIL, "暂不支持的恢复文件格式：" + backupFile.getFileFormat());
-            }
+            DatabaseRestoreOperator operator = databaseOperatorRegistry.getRestoreOperator(connection.getDbType(), backupFile.getBackupStrategy());
+            operator.executeRestore(task, record, backupFile, connection, password, param);
             record.setResultMessage("恢复任务执行成功");
             record.setUpdateTime(LocalDateTime.now());
             this.updateById(record);
@@ -125,7 +108,8 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
         }
         databaseBackupFileService.validateBackupFileReadable(backupFile);
         String password = databaseConnectionService.resolvePassword(connection, param.getTemporaryPassword());
-        if (!Boolean.TRUE.equals(oracleJdbcComponent.test(connection, password).getSuccess())) {
+        DatabaseConnectionOperator operator = databaseOperatorRegistry.getConnectionOperator(connection.getDbType());
+        if (!Boolean.TRUE.equals(operator.test(connection, password).getSuccess())) {
             throw new BusinessException(CommonResponseEnum.FAIL, "目标连接测试失败，不能创建恢复任务");
         }
         if (BackupStrategyEnum.DATA_PUMP.name().equals(backupFile.getBackupStrategy())) {
@@ -148,7 +132,7 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
         task.setOperationType(OperationTypeEnum.RESTORE.name());
         task.setBackupStrategy(backupFile.getBackupStrategy());
         task.setTaskStatus(TaskStatusEnum.WAITING.name());
-        task.setSchemaName(StrUtil.blankToDefault(param.getTargetSchemaName(), connection.getSchemaName()));
+        task.setSchemaName(resolveTargetSchemaName(param, connection));
         task.setTargetNamesJson(backupFile.getTargetNamesJson());
         task.setRequestParamJson(writeJsonWithoutPassword(param));
         task.setProgressPercent(BigDecimal.ZERO);
@@ -168,7 +152,7 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
         record.setConnectionId(connection.getId());
         record.setDbType(connection.getDbType());
         record.setRestoreMode(restoreMode);
-        record.setTargetSchemaName(StrUtil.blankToDefault(param.getTargetSchemaName(), connection.getSchemaName()));
+        record.setTargetSchemaName(resolveTargetSchemaName(param, connection));
         record.setTargetNamesJson(backupFile.getTargetNamesJson());
         record.setTableExistsAction(restoreMode);
         record.setOverwriteConfirmed(DatabaseOpsConst.CONFIRM_OVERWRITE.equals(param.getOverwriteConfirmText()) ? 1 : 0);
@@ -178,6 +162,13 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
         return record;
     }
 
+    private String resolveTargetSchemaName(DatabaseRestoreParam.CreateParam param, DatabaseConnection connection) {
+        if (DatabaseOpsConst.DB_TYPE_MYSQL.equals(connection.getDbType())) {
+            return StrUtil.blankToDefault(param.getTargetSchemaName(), connection.getDatabaseName());
+        }
+        return StrUtil.blankToDefault(param.getTargetSchemaName(), connection.getSchemaName());
+    }
+
     private DatabaseBackupFile requireBackupFile(String backupFileId) {
         DatabaseBackupFile backupFile = databaseBackupFileService.getById(backupFileId);
         if (backupFile == null || !Integer.valueOf(DatabaseOpsConst.STATE_ENABLED).equals(backupFile.getState())) {
@@ -195,10 +186,6 @@ public class DatabaseRestoreServiceImpl extends ServiceImpl<DatabaseRestoreRecor
         }
     }
 
-    private String buildRestoreLogName(DatabaseOperationTask task) {
-        return DatabaseFileNameUtil.appendTodayWithTask(task.getTaskNo() + "_restore.log", task.getTaskNo());
-    }
-
     private void markRunning(DatabaseOperationTask task) {
         task.setTaskStatus(TaskStatusEnum.RUNNING.name());
         task.setStartedAt(LocalDateTime.now());

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/mysql/MysqlConnectionOperator.java

@@ -0,0 +1,102 @@
+package com.njcn.gather.systemops.database.support.mysql;
+
+import cn.hutool.core.util.StrUtil;
+import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTableVO;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTestResultVO;
+import com.njcn.gather.systemops.database.support.spi.DatabaseConnectionOperator;
+import org.springframework.stereotype.Component;
+
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.PreparedStatement;
+import java.sql.ResultSet;
+import java.sql.Timestamp;
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+
+/**
+ * MySQL 连接能力实现。
+ */
+@Component
+public class MysqlConnectionOperator implements DatabaseConnectionOperator {
+
+    @Override
+    public boolean support(String dbType) {
+        return DatabaseOpsConst.DB_TYPE_MYSQL.equalsIgnoreCase(dbType);
+    }
+
+    @Override
+    public DatabaseTestResultVO test(DatabaseConnection connection, String password) {
+        DatabaseTestResultVO result = new DatabaseTestResultVO();
+        try (Connection ignored = openConnection(connection, password)) {
+            result.setSuccess(true);
+            result.setMessage("连接成功");
+        } catch (Exception exception) {
+            result.setSuccess(false);
+            result.setMessage(exception.getMessage());
+        }
+        return result;
+    }
+
+    @Override
+    public List<DatabaseTableVO> listTables(DatabaseConnection connection, String password, String schemaOrDatabaseName) throws Exception {
+        String databaseName = StrUtil.blankToDefault(schemaOrDatabaseName, connection.getDatabaseName());
+        String sql = "SELECT t.table_schema, t.table_name, t.auto_increment, t.update_time, "
+                + "t.data_length, t.engine, t.table_rows, t.table_comment, "
+                + "MAX(CASE WHEN c.extra LIKE '%auto_increment%' THEN 1 ELSE 0 END) AS has_auto_increment "
+                + "FROM information_schema.tables t "
+                + "LEFT JOIN information_schema.columns c "
+                + "ON t.table_schema = c.table_schema AND t.table_name = c.table_name "
+                + "WHERE t.table_schema = ? AND t.table_type = 'BASE TABLE' "
+                + "GROUP BY t.table_schema, t.table_name, t.auto_increment, t.update_time, "
+                + "t.data_length, t.engine, t.table_rows, t.table_comment "
+                + "ORDER BY t.table_name";
+        try (Connection jdbcConnection = openConnection(connection, password);
+             PreparedStatement statement = jdbcConnection.prepareStatement(sql)) {
+            statement.setString(1, databaseName);
+            try (ResultSet resultSet = statement.executeQuery()) {
+                List<DatabaseTableVO> result = new ArrayList<>();
+                while (resultSet.next()) {
+                    DatabaseTableVO table = new DatabaseTableVO();
+                    table.setOwner(resultSet.getString("table_schema").toUpperCase(Locale.ROOT));
+                    table.setTableName(resultSet.getString("table_name"));
+                    if (resultSet.getInt("has_auto_increment") == 1) {
+                        fillAutoIncrement(table, defaultZero(getLongValue(resultSet, "auto_increment")));
+                    }
+                    Timestamp updateTime = resultSet.getTimestamp("update_time");
+                    table.setUpdateTime(updateTime == null ? null : updateTime.toLocalDateTime());
+                    table.setDataLength(getLongValue(resultSet, "data_length"));
+                    table.setEngine(resultSet.getString("engine"));
+                    table.setTableRows(getLongValue(resultSet, "table_rows"));
+                    table.setComments(resultSet.getString("table_comment"));
+                    result.add(table);
+                }
+                return result;
+            }
+        }
+    }
+
+    private Long getLongValue(ResultSet resultSet, String columnName) throws Exception {
+        long value = resultSet.getLong(columnName);
+        return resultSet.wasNull() ? null : value;
+    }
+
+    private Long defaultZero(Long value) {
+        return value == null ? 0L : value;
+    }
+
+    private void fillAutoIncrement(DatabaseTableVO table, Long autoIncrement) {
+        table.setAutoIncrementValue(autoIncrement);
+        table.setAutoIncrement(autoIncrement);
+    }
+
+    private Connection openConnection(DatabaseConnection connection, String password) throws Exception {
+        if (StrUtil.isBlank(password)) {
+            throw new IllegalArgumentException("数据库密码不能为空");
+        }
+        return DriverManager.getConnection(MysqlJdbcUrlUtil.build(connection), connection.getUsername(), password);
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/mysql/MysqlJdbcExportBackupOperator.java

@@ -0,0 +1,146 @@
+package com.njcn.gather.systemops.database.support.mysql;
+
+import cn.hutool.core.util.StrUtil;
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.gather.systemops.database.component.JdbcExportComponent;
+import com.njcn.gather.systemops.database.config.DbmsProperties;
+import com.njcn.gather.systemops.database.mapper.DatabaseOperationTaskMapper;
+import com.njcn.gather.systemops.database.pojo.enums.BackupModeEnum;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.enums.FileFormatEnum;
+import com.njcn.gather.systemops.database.pojo.enums.TaskStatusEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.support.spi.DatabaseBackupOperator;
+import com.njcn.gather.systemops.database.util.DatabaseChecksumUtil;
+import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
+import com.njcn.gather.systemops.database.util.DatabasePathUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.time.LocalDateTime;
+import java.util.Locale;
+import java.util.stream.Stream;
+
+/**
+ * MySQL JDBC_EXPORT 大数据量备份实现。
+ */
+@Component
+@RequiredArgsConstructor
+public class MysqlJdbcExportBackupOperator implements DatabaseBackupOperator {
+
+    private final JdbcExportComponent jdbcExportComponent;
+    private final DbmsProperties dbmsProperties;
+    private final DatabaseOperationTaskMapper databaseOperationTaskMapper;
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "MYSQL".equalsIgnoreCase(dbType) && BackupStrategyEnum.JDBC_EXPORT.name().equals(backupStrategy);
+    }
+
+    @Override
+    public DatabaseBackupFile executeBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
+                                            DatabaseBackupParam.CreateParam param) throws Exception {
+        Path backupDirectory = buildManagedPath(dbmsProperties.getBackup().getStoragePath(), task.getTaskNo());
+        String metadataFileName = DatabaseFileNameUtil.appendTodayWithTask("mysql_jdbc_export_metadata.json", task.getTaskNo());
+        Path metadataFilePath = backupDirectory.resolve(metadataFileName).normalize();
+        int fetchSize = positiveOrDefault(dbmsProperties.getBackup().getMysqlFetchSize(), 1000);
+        long maxPartBytes = resolveMaxPartBytes(param);
+        try (Connection jdbcConnection = DriverManager.getConnection(MysqlJdbcUrlUtil.build(connection), connection.getUsername(), password)) {
+            jdbcExportComponent.exportMysqlCsvV2(jdbcConnection, connection.getDatabaseName(), task.getTaskNo(), param,
+                    backupDirectory, metadataFilePath, fetchSize, maxPartBytes, () -> isTaskCancelled(task.getId()));
+        } catch (Exception exception) {
+            throw new BusinessException(CommonResponseEnum.FAIL, exception.getMessage() + "，导出目录：" + backupDirectory);
+        }
+        return buildBackupFile(task, connection, param, backupDirectory, metadataFilePath);
+    }
+
+    private boolean isTaskCancelled(String taskId) {
+        DatabaseOperationTask task = databaseOperationTaskMapper.selectById(taskId);
+        return task != null && TaskStatusEnum.CANCELLED.name().equals(task.getTaskStatus());
+    }
+
+    private DatabaseBackupFile buildBackupFile(DatabaseOperationTask task, DatabaseConnection connection,
+                                               DatabaseBackupParam.CreateParam param, Path backupDirectory,
+                                               Path metadataFilePath) throws Exception {
+        if (!Files.exists(metadataFilePath)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份元数据文件未生成");
+        }
+        DatabaseBackupFile file = new DatabaseBackupFile();
+        file.setId(DatabaseOpsIdUtil.uuid());
+        file.setTaskId(task.getId());
+        file.setConnectionId(connection.getId());
+        file.setDbType(connection.getDbType());
+        file.setBackupStrategy(task.getBackupStrategy());
+        file.setFileFormat(FileFormatEnum.CSV.name());
+        file.setSchemaName(task.getSchemaName());
+        file.setTargetNamesJson(task.getTargetNamesJson());
+        file.setBackupMode(StrUtil.blankToDefault(param.getBackupMode(), BackupModeEnum.FULL_TABLE.name()).toUpperCase(Locale.ROOT));
+        file.setBackupStartTime(param.getStartTime());
+        file.setBackupEndTime(param.getEndTime());
+        file.setTimeColumn(param.getTimeColumn());
+        file.setDirectoryName(null);
+        file.setDumpFileName(null);
+        file.setLogFileName(null);
+        file.setFileName(backupDirectory.getFileName().toString());
+        file.setFilePath(backupDirectory.toString());
+        file.setLogFilePath(null);
+        file.setMetadataFilePath(metadataFilePath.toString());
+        file.setFileSize(readDirectoryFileSize(backupDirectory));
+        file.setChecksum(DatabaseChecksumUtil.sha256(metadataFilePath));
+        file.setState(1);
+        file.setCreateTime(LocalDateTime.now());
+        file.setUpdateTime(LocalDateTime.now());
+        return file;
+    }
+
+    private long resolveMaxPartBytes(DatabaseBackupParam.CreateParam param) {
+        Integer maxFileSizeMb = param.getMaxFileSizeMb();
+        if (maxFileSizeMb == null || maxFileSizeMb <= 0) {
+            maxFileSizeMb = positiveOrDefault(dbmsProperties.getBackup().getDefaultMaxFileSizeMb(), 512);
+        }
+        return maxFileSizeMb.longValue() * 1024L * 1024L;
+    }
+
+    private int positiveOrDefault(Integer value, int defaultValue) {
+        return value == null || value <= 0 ? defaultValue : value;
+    }
+
+    private Long readDirectoryFileSize(Path directory) {
+        try {
+            if (directory != null && Files.exists(directory) && Files.isDirectory(directory)) {
+                final long[] total = new long[]{0L};
+                try (Stream<Path> paths = Files.walk(directory)) {
+                    paths.filter(path -> Files.exists(path) && !Files.isDirectory(path))
+                            .forEach(path -> {
+                                try {
+                                    total[0] += Files.size(path);
+                                } catch (Exception ignored) {
+                                    // 忽略单个文件大小读取失败，避免影响备份记录生成。
+                                }
+                            });
+                }
+                return total[0];
+            }
+        } catch (Exception ignored) {
+            return null;
+        }
+        return null;
+    }
+
+    private Path buildManagedPath(String rootPath, String directoryName) {
+        Path root = DatabasePathUtil.normalize(rootPath);
+        if (root == null) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份目录未配置");
+        }
+        return root.resolve(directoryName).normalize();
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/mysql/MysqlJdbcExportRestoreOperator.java

@@ -0,0 +1,48 @@
+package com.njcn.gather.systemops.database.support.mysql;
+
+import com.njcn.gather.systemops.database.component.JdbcExportComponent;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseRestoreParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseRestoreRecord;
+import com.njcn.gather.systemops.database.service.DatabaseBackupFileService;
+import com.njcn.gather.systemops.database.support.spi.DatabaseRestoreOperator;
+import org.springframework.stereotype.Component;
+
+import java.nio.file.Path;
+import java.sql.Connection;
+import java.sql.DriverManager;
+
+/**
+ * MySQL JDBC_EXPORT 恢复实现。
+ */
+@Component
+public class MysqlJdbcExportRestoreOperator implements DatabaseRestoreOperator {
+
+    private final JdbcExportComponent jdbcExportComponent;
+    private final DatabaseBackupFileService databaseBackupFileService;
+
+    public MysqlJdbcExportRestoreOperator(JdbcExportComponent jdbcExportComponent,
+                                          DatabaseBackupFileService databaseBackupFileService) {
+        this.jdbcExportComponent = jdbcExportComponent;
+        this.databaseBackupFileService = databaseBackupFileService;
+    }
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "MYSQL".equalsIgnoreCase(dbType) && BackupStrategyEnum.JDBC_EXPORT.name().equals(backupStrategy);
+    }
+
+    @Override
+    public void executeRestore(DatabaseOperationTask task, DatabaseRestoreRecord record, DatabaseBackupFile backupFile,
+                               DatabaseConnection connection, String password, DatabaseRestoreParam.CreateParam param) throws Exception {
+        Path dataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getFilePath());
+        Path metadataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getMetadataFilePath());
+        try (Connection jdbcConnection = DriverManager.getConnection(MysqlJdbcUrlUtil.build(connection), connection.getUsername(), password)) {
+            jdbcExportComponent.importCsv(jdbcConnection, dataFilePath, metadataFilePath,
+                    connection.getDbType(), record.getRestoreMode(), null);
+        }
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/mysql/MysqlJdbcUrlUtil.java

@@ -0,0 +1,18 @@
+package com.njcn.gather.systemops.database.support.mysql;
+
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+
+/**
+ * MySQL JDBC URL 构造工具。
+ */
+public final class MysqlJdbcUrlUtil {
+
+    private MysqlJdbcUrlUtil() {
+    }
+
+    public static String build(DatabaseConnection connection) {
+        return "jdbc:mysql://" + connection.getHost() + ":" + connection.getPort() + "/" + connection.getDatabaseName()
+                + "?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai"
+                + "&useCursorFetch=true&connectTimeout=5000&socketTimeout=30000";
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/oracle/OracleConnectionOperator.java

@@ -0,0 +1,37 @@
+package com.njcn.gather.systemops.database.support.oracle;
+
+import com.njcn.gather.systemops.database.component.OracleJdbcComponent;
+import com.njcn.gather.systemops.database.constant.DatabaseOpsConst;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTableVO;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTestResultVO;
+import com.njcn.gather.systemops.database.support.spi.DatabaseConnectionOperator;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+/**
+ * Oracle 连接能力实现。
+ */
+@Component
+@RequiredArgsConstructor
+public class OracleConnectionOperator implements DatabaseConnectionOperator {
+
+    private final OracleJdbcComponent oracleJdbcComponent;
+
+    @Override
+    public boolean support(String dbType) {
+        return DatabaseOpsConst.DB_TYPE_ORACLE.equalsIgnoreCase(dbType);
+    }
+
+    @Override
+    public DatabaseTestResultVO test(DatabaseConnection connection, String password) {
+        return oracleJdbcComponent.test(connection, password);
+    }
+
+    @Override
+    public List<DatabaseTableVO> listTables(DatabaseConnection connection, String password, String schemaOrDatabaseName) throws Exception {
+        return oracleJdbcComponent.listTables(connection, password, schemaOrDatabaseName);
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/oracle/OracleDataPumpBackupOperator.java

@@ -0,0 +1,122 @@
+package com.njcn.gather.systemops.database.support.oracle;
+
+import cn.hutool.core.util.StrUtil;
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.gather.systemops.database.component.DataPumpCommandExecutor;
+import com.njcn.gather.systemops.database.pojo.enums.BackupModeEnum;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.enums.FileFormatEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.service.DatabaseBackupFileService;
+import com.njcn.gather.systemops.database.support.spi.DatabaseBackupOperator;
+import com.njcn.gather.systemops.database.util.DatabaseChecksumUtil;
+import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
+import com.njcn.gather.systemops.database.util.DatabasePathUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.time.LocalDateTime;
+import java.util.Locale;
+
+/**
+ * Oracle DATA_PUMP 备份实现。
+ */
+@Component
+@RequiredArgsConstructor
+public class OracleDataPumpBackupOperator implements DatabaseBackupOperator {
+
+    private final DataPumpCommandExecutor dataPumpCommandExecutor;
+    private final DatabaseBackupFileService databaseBackupFileService;
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "ORACLE".equalsIgnoreCase(dbType) && BackupStrategyEnum.DATA_PUMP.name().equals(backupStrategy);
+    }
+
+    @Override
+    public DatabaseBackupFile executeBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
+                                            DatabaseBackupParam.CreateParam param) {
+        String directoryName = StrUtil.blankToDefault(param.getDirectoryName(), connection.getDirectoryName());
+        if (StrUtil.isBlank(directoryName)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "DATA_PUMP 备份需要 Oracle Directory 名称");
+        }
+        String baseName = buildBaseFileName(connection, task);
+        String dumpFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".dmp", task.getTaskNo());
+        String logFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".log", task.getTaskNo());
+        DataPumpCommandExecutor.CommandResult commandResult = dataPumpCommandExecutor.expdp(connection, password,
+                directoryName, dumpFileName, logFileName, param.getTargetNames());
+        if (!Boolean.TRUE.equals(commandResult.getSuccess())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 执行失败：" + commandResult.getOutput());
+        }
+        if (StrUtil.isBlank(connection.getDirectoryPath())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 备份需要配置可管理的 directoryPath");
+        }
+        Path dumpPath = buildManagedPath(connection.getDirectoryPath(), dumpFileName);
+        Path logPath = buildManagedPath(connection.getDirectoryPath(), logFileName);
+        return buildBackupFile(task, connection, param, FileFormatEnum.DMP.name(), dumpFileName, dumpPath, logFileName, logPath, null);
+    }
+
+    private DatabaseBackupFile buildBackupFile(DatabaseOperationTask task, DatabaseConnection connection,
+                                               DatabaseBackupParam.CreateParam param, String fileFormat, String fileName,
+                                               Path filePath, String logFileName, Path logFilePath, Path metadataFilePath) {
+        if (filePath == null || !Files.exists(filePath)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份文件未生成");
+        }
+        DatabaseBackupFile file = new DatabaseBackupFile();
+        file.setId(DatabaseOpsIdUtil.uuid());
+        file.setTaskId(task.getId());
+        file.setConnectionId(connection.getId());
+        file.setDbType(connection.getDbType());
+        file.setBackupStrategy(task.getBackupStrategy());
+        file.setFileFormat(fileFormat);
+        file.setSchemaName(task.getSchemaName());
+        file.setTargetNamesJson(task.getTargetNamesJson());
+        file.setBackupMode(StrUtil.blankToDefault(param.getBackupMode(), BackupModeEnum.FULL_TABLE.name()).toUpperCase(Locale.ROOT));
+        file.setBackupStartTime(param.getStartTime());
+        file.setBackupEndTime(param.getEndTime());
+        file.setTimeColumn(param.getTimeColumn());
+        file.setDirectoryName(StrUtil.blankToDefault(param.getDirectoryName(), connection.getDirectoryName()));
+        file.setDumpFileName(FileFormatEnum.DMP.name().equals(fileFormat) ? fileName : null);
+        file.setLogFileName(logFileName);
+        file.setFileName(fileName);
+        file.setFilePath(filePath.toString());
+        file.setLogFilePath(logFilePath == null ? null : logFilePath.toString());
+        file.setMetadataFilePath(metadataFilePath == null ? null : metadataFilePath.toString());
+        file.setFileSize(readFileSize(filePath));
+        file.setChecksum(DatabaseChecksumUtil.sha256(filePath));
+        file.setState(1);
+        file.setCreateTime(LocalDateTime.now());
+        file.setUpdateTime(LocalDateTime.now());
+        return file;
+    }
+
+    private Long readFileSize(Path filePath) {
+        try {
+            if (filePath != null && Files.exists(filePath) && !Files.isDirectory(filePath)) {
+                return Files.size(filePath);
+            }
+        } catch (Exception ignored) {
+            return null;
+        }
+        return null;
+    }
+
+    private Path buildManagedPath(String rootPath, String fileName) {
+        Path root = DatabasePathUtil.normalize(rootPath);
+        if (root == null) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份目录未配置");
+        }
+        return root.resolve(fileName).normalize();
+    }
+
+    private String buildBaseFileName(DatabaseConnection connection, DatabaseOperationTask task) {
+        return connection.getSchemaName() + "_" + task.getBackupStrategy().toLowerCase(Locale.ROOT);
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/oracle/OracleDataPumpRestoreOperator.java

@@ -0,0 +1,47 @@
+package com.njcn.gather.systemops.database.support.oracle;
+
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.gather.systemops.database.component.DataPumpCommandExecutor;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseRestoreParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseRestoreRecord;
+import com.njcn.gather.systemops.database.support.spi.DatabaseRestoreOperator;
+import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import org.springframework.stereotype.Component;
+
+/**
+ * Oracle DATA_PUMP 恢复实现。
+ */
+@Component
+public class OracleDataPumpRestoreOperator implements DatabaseRestoreOperator {
+
+    private final DataPumpCommandExecutor dataPumpCommandExecutor;
+
+    public OracleDataPumpRestoreOperator(DataPumpCommandExecutor dataPumpCommandExecutor) {
+        this.dataPumpCommandExecutor = dataPumpCommandExecutor;
+    }
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "ORACLE".equalsIgnoreCase(dbType) && BackupStrategyEnum.DATA_PUMP.name().equals(backupStrategy);
+    }
+
+    @Override
+    public void executeRestore(DatabaseOperationTask task, DatabaseRestoreRecord record, DatabaseBackupFile backupFile,
+                               DatabaseConnection connection, String password, DatabaseRestoreParam.CreateParam param) {
+        DataPumpCommandExecutor.CommandResult result = dataPumpCommandExecutor.impdp(connection, password,
+                backupFile.getDirectoryName(), backupFile.getDumpFileName(), buildRestoreLogName(task),
+                record.getTableExistsAction());
+        if (!Boolean.TRUE.equals(result.getSuccess())) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "Data Pump 恢复失败：" + result.getOutput());
+        }
+    }
+
+    private String buildRestoreLogName(DatabaseOperationTask task) {
+        return DatabaseFileNameUtil.appendTodayWithTask(task.getTaskNo() + "_restore.log", task.getTaskNo());
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/oracle/OracleJdbcExportBackupOperator.java

@@ -0,0 +1,116 @@
+package com.njcn.gather.systemops.database.support.oracle;
+
+import cn.hutool.core.util.StrUtil;
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import com.njcn.gather.systemops.database.component.JdbcExportComponent;
+import com.njcn.gather.systemops.database.component.OracleJdbcComponent;
+import com.njcn.gather.systemops.database.config.DbmsProperties;
+import com.njcn.gather.systemops.database.pojo.enums.BackupModeEnum;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.enums.FileFormatEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.support.spi.DatabaseBackupOperator;
+import com.njcn.gather.systemops.database.util.DatabaseChecksumUtil;
+import com.njcn.gather.systemops.database.util.DatabaseFileNameUtil;
+import com.njcn.gather.systemops.database.util.DatabaseOpsIdUtil;
+import com.njcn.gather.systemops.database.util.DatabasePathUtil;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.sql.Connection;
+import java.time.LocalDateTime;
+import java.util.Locale;
+
+/**
+ * Oracle JDBC_EXPORT 备份实现。
+ */
+@Component
+@RequiredArgsConstructor
+public class OracleJdbcExportBackupOperator implements DatabaseBackupOperator {
+
+    private final JdbcExportComponent jdbcExportComponent;
+    private final OracleJdbcComponent oracleJdbcComponent;
+    private final DbmsProperties dbmsProperties;
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "ORACLE".equalsIgnoreCase(dbType) && BackupStrategyEnum.JDBC_EXPORT.name().equals(backupStrategy);
+    }
+
+    @Override
+    public DatabaseBackupFile executeBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
+                                            DatabaseBackupParam.CreateParam param) throws Exception {
+        String baseName = buildBaseFileName(connection, task);
+        String fileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + ".csv", task.getTaskNo());
+        String metadataFileName = DatabaseFileNameUtil.appendTodayWithTask(baseName + "_metadata.json", task.getTaskNo());
+        Path dataFilePath = buildManagedPath(dbmsProperties.getBackup().getStoragePath(), fileName);
+        Path metadataFilePath = buildManagedPath(dbmsProperties.getBackup().getStoragePath(), metadataFileName);
+        try (Connection jdbcConnection = oracleJdbcComponent.openConnection(connection, password)) {
+            jdbcExportComponent.exportCsv(jdbcConnection, connection.getSchemaName(), param, dataFilePath, metadataFilePath);
+        }
+        return buildBackupFile(task, connection, param, fileName, dataFilePath, metadataFilePath);
+    }
+
+    private DatabaseBackupFile buildBackupFile(DatabaseOperationTask task, DatabaseConnection connection,
+                                               DatabaseBackupParam.CreateParam param, String fileName, Path filePath,
+                                               Path metadataFilePath) {
+        if (filePath == null || !Files.exists(filePath)) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份文件未生成");
+        }
+        DatabaseBackupFile file = new DatabaseBackupFile();
+        file.setId(DatabaseOpsIdUtil.uuid());
+        file.setTaskId(task.getId());
+        file.setConnectionId(connection.getId());
+        file.setDbType(connection.getDbType());
+        file.setBackupStrategy(task.getBackupStrategy());
+        file.setFileFormat(FileFormatEnum.CSV.name());
+        file.setSchemaName(task.getSchemaName());
+        file.setTargetNamesJson(task.getTargetNamesJson());
+        file.setBackupMode(StrUtil.blankToDefault(param.getBackupMode(), BackupModeEnum.FULL_TABLE.name()).toUpperCase(Locale.ROOT));
+        file.setBackupStartTime(param.getStartTime());
+        file.setBackupEndTime(param.getEndTime());
+        file.setTimeColumn(param.getTimeColumn());
+        file.setDirectoryName(null);
+        file.setDumpFileName(null);
+        file.setLogFileName(null);
+        file.setFileName(fileName);
+        file.setFilePath(filePath.toString());
+        file.setLogFilePath(null);
+        file.setMetadataFilePath(metadataFilePath.toString());
+        file.setFileSize(readFileSize(filePath));
+        file.setChecksum(DatabaseChecksumUtil.sha256(filePath));
+        file.setState(1);
+        file.setCreateTime(LocalDateTime.now());
+        file.setUpdateTime(LocalDateTime.now());
+        return file;
+    }
+
+    private Long readFileSize(Path filePath) {
+        try {
+            if (filePath != null && Files.exists(filePath) && !Files.isDirectory(filePath)) {
+                return Files.size(filePath);
+            }
+        } catch (Exception ignored) {
+            return null;
+        }
+        return null;
+    }
+
+    private Path buildManagedPath(String rootPath, String fileName) {
+        Path root = DatabasePathUtil.normalize(rootPath);
+        if (root == null) {
+            throw new BusinessException(CommonResponseEnum.FAIL, "备份目录未配置");
+        }
+        return root.resolve(fileName).normalize();
+    }
+
+    private String buildBaseFileName(DatabaseConnection connection, DatabaseOperationTask task) {
+        return connection.getSchemaName() + "_" + task.getBackupStrategy().toLowerCase(Locale.ROOT);
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/oracle/OracleJdbcExportRestoreOperator.java

@@ -0,0 +1,51 @@
+package com.njcn.gather.systemops.database.support.oracle;
+
+import com.njcn.gather.systemops.database.component.JdbcExportComponent;
+import com.njcn.gather.systemops.database.component.OracleJdbcComponent;
+import com.njcn.gather.systemops.database.pojo.enums.BackupStrategyEnum;
+import com.njcn.gather.systemops.database.pojo.param.DatabaseRestoreParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseRestoreRecord;
+import com.njcn.gather.systemops.database.service.DatabaseBackupFileService;
+import com.njcn.gather.systemops.database.support.spi.DatabaseRestoreOperator;
+import org.springframework.stereotype.Component;
+
+import java.nio.file.Path;
+import java.sql.Connection;
+
+/**
+ * Oracle JDBC_EXPORT 恢复实现。
+ */
+@Component
+public class OracleJdbcExportRestoreOperator implements DatabaseRestoreOperator {
+
+    private final JdbcExportComponent jdbcExportComponent;
+    private final OracleJdbcComponent oracleJdbcComponent;
+    private final DatabaseBackupFileService databaseBackupFileService;
+
+    public OracleJdbcExportRestoreOperator(JdbcExportComponent jdbcExportComponent,
+                                           OracleJdbcComponent oracleJdbcComponent,
+                                           DatabaseBackupFileService databaseBackupFileService) {
+        this.jdbcExportComponent = jdbcExportComponent;
+        this.oracleJdbcComponent = oracleJdbcComponent;
+        this.databaseBackupFileService = databaseBackupFileService;
+    }
+
+    @Override
+    public boolean support(String dbType, String backupStrategy) {
+        return "ORACLE".equalsIgnoreCase(dbType) && BackupStrategyEnum.JDBC_EXPORT.name().equals(backupStrategy);
+    }
+
+    @Override
+    public void executeRestore(DatabaseOperationTask task, DatabaseRestoreRecord record, DatabaseBackupFile backupFile,
+                               DatabaseConnection connection, String password, DatabaseRestoreParam.CreateParam param) throws Exception {
+        Path dataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getFilePath());
+        Path metadataFilePath = databaseBackupFileService.resolveManagedPath(backupFile, backupFile.getMetadataFilePath());
+        try (Connection jdbcConnection = oracleJdbcComponent.openConnection(connection, password)) {
+            jdbcExportComponent.importCsv(jdbcConnection, dataFilePath, metadataFilePath,
+                    connection.getDbType(), record.getRestoreMode(), record.getTargetSchemaName());
+        }
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/spi/DatabaseBackupOperator.java

@@ -0,0 +1,17 @@
+package com.njcn.gather.systemops.database.support.spi;
+
+import com.njcn.gather.systemops.database.pojo.param.DatabaseBackupParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+
+/**
+ * 按数据库类型与备份策略隔离备份执行能力。
+ */
+public interface DatabaseBackupOperator {
+
+    boolean support(String dbType, String backupStrategy);
+
+    DatabaseBackupFile executeBackup(DatabaseOperationTask task, DatabaseConnection connection, String password,
+                                     DatabaseBackupParam.CreateParam param) throws Exception;
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/spi/DatabaseConnectionOperator.java

@@ -0,0 +1,19 @@
+package com.njcn.gather.systemops.database.support.spi;
+
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTableVO;
+import com.njcn.gather.systemops.database.pojo.vo.DatabaseTestResultVO;
+
+import java.util.List;
+
+/**
+ * 按数据库类型隔离连接测试与表查询能力。
+ */
+public interface DatabaseConnectionOperator {
+
+    boolean support(String dbType);
+
+    DatabaseTestResultVO test(DatabaseConnection connection, String password);
+
+    List<DatabaseTableVO> listTables(DatabaseConnection connection, String password, String schemaOrDatabaseName) throws Exception;
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/spi/DatabaseOperatorRegistry.java

@@ -0,0 +1,43 @@
+package com.njcn.gather.systemops.database.support.spi;
+
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.exception.BusinessException;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+
+/**
+ * 数据库能力路由注册器。
+ */
+@Component
+@RequiredArgsConstructor
+public class DatabaseOperatorRegistry {
+
+    private final List<DatabaseConnectionOperator> connectionOperators;
+    private final List<DatabaseBackupOperator> backupOperators;
+    private final List<DatabaseRestoreOperator> restoreOperators;
+
+    public DatabaseConnectionOperator getConnectionOperator(String dbType) {
+        return connectionOperators.stream()
+                .filter(operator -> operator.support(dbType))
+                .findFirst()
+                .orElseThrow(() -> new BusinessException(CommonResponseEnum.FAIL, "暂不支持的数据库类型：" + dbType));
+    }
+
+    public DatabaseBackupOperator getBackupOperator(String dbType, String backupStrategy) {
+        return backupOperators.stream()
+                .filter(operator -> operator.support(dbType, backupStrategy))
+                .findFirst()
+                .orElseThrow(() -> new BusinessException(CommonResponseEnum.FAIL,
+                        "暂不支持的备份能力：" + dbType + "/" + backupStrategy));
+    }
+
+    public DatabaseRestoreOperator getRestoreOperator(String dbType, String backupStrategy) {
+        return restoreOperators.stream()
+                .filter(operator -> operator.support(dbType, backupStrategy))
+                .findFirst()
+                .orElseThrow(() -> new BusinessException(CommonResponseEnum.FAIL,
+                        "暂不支持的恢复能力：" + dbType + "/" + backupStrategy));
+    }
+}

system-ops/dbms/src/main/java/com/njcn/gather/systemops/database/support/spi/DatabaseRestoreOperator.java

@@ -0,0 +1,18 @@
+package com.njcn.gather.systemops.database.support.spi;
+
+import com.njcn.gather.systemops.database.pojo.param.DatabaseRestoreParam;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseBackupFile;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseConnection;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseOperationTask;
+import com.njcn.gather.systemops.database.pojo.po.DatabaseRestoreRecord;
+
+/**
+ * 按数据库类型与备份策略隔离恢复执行能力。
+ */
+public interface DatabaseRestoreOperator {
+
+    boolean support(String dbType, String backupStrategy);
+
+    void executeRestore(DatabaseOperationTask task, DatabaseRestoreRecord record, DatabaseBackupFile backupFile,
+                        DatabaseConnection connection, String password, DatabaseRestoreParam.CreateParam param) throws Exception;
+}

system-ops/dbms/src/main/resources/sql/system-ops/dbms-database-ops-init.sql

@@ -0,0 +1,119 @@
+CREATE TABLE IF NOT EXISTS `dbms_connection` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `connection_name` VARCHAR(100) NOT NULL COMMENT '连接名称',
+    `db_type` VARCHAR(32) NOT NULL DEFAULT 'ORACLE' COMMENT '数据库类型：ORACLE，后续可扩展 MYSQL、INFLUXDB',
+    `host` VARCHAR(255) NOT NULL COMMENT '数据库主机地址',
+    `port` INT NOT NULL COMMENT '数据库端口',
+    `connect_type` VARCHAR(32) NULL COMMENT '连接类型：SERVICE_NAME、SID，Oracle 使用',
+    `service_name` VARCHAR(128) NULL COMMENT '服务名，Oracle SERVICE_NAME 模式使用',
+    `sid` VARCHAR(128) NULL COMMENT 'SID，Oracle SID 模式使用',
+    `database_name` VARCHAR(128) NULL COMMENT '数据库名或实例名，预留给 MySQL 等数据库使用',
+    `schema_name` VARCHAR(128) NULL COMMENT '默认 Schema，Oracle 使用',
+    `username` VARCHAR(128) NOT NULL COMMENT '用户名',
+    `password_cipher` VARCHAR(1000) NULL COMMENT '保存的数据库密码；为空表示不保存密码，执行时临时输入',
+    `save_password` TINYINT NOT NULL DEFAULT 1 COMMENT '是否保存密码：0-否，1-是',
+    `directory_name` VARCHAR(128) NULL COMMENT '默认数据库目录对象名称，Oracle Data Pump 使用',
+    `directory_path` VARCHAR(500) NULL COMMENT '目录对象对应物理路径，仅用于展示和校验',
+    `extra_config_json` JSON NULL COMMENT '扩展配置 JSON，用于保存不同数据库的差异配置',
+    `remark` VARCHAR(500) NULL COMMENT '备注',
+    `last_test_status` VARCHAR(32) NULL COMMENT '最近连接测试状态：SUCCESS、FAIL',
+    `last_test_message` VARCHAR(1000) NULL COMMENT '最近连接测试结果说明',
+    `last_test_time` DATETIME NULL COMMENT '最近连接测试时间',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_by` VARCHAR(64) NULL COMMENT '创建人',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_by` VARCHAR(64) NULL COMMENT '更新人',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    KEY `idx_dbms_connection_state` (`state`),
+    KEY `idx_dbms_connection_db_type` (`db_type`),
+    KEY `idx_dbms_connection_name` (`connection_name`),
+    KEY `idx_dbms_connection_schema` (`schema_name`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='数据库连接配置表';
+
+CREATE TABLE IF NOT EXISTS `dbms_operation_task` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `task_no` VARCHAR(64) NOT NULL COMMENT '任务编号',
+    `connection_id` VARCHAR(64) NOT NULL COMMENT '数据库连接配置 ID',
+    `db_type` VARCHAR(32) NOT NULL COMMENT '数据库类型：ORACLE，后续可扩展 MYSQL、INFLUXDB',
+    `operation_type` VARCHAR(32) NOT NULL COMMENT '操作类型：BACKUP、RESTORE、DELETE',
+    `backup_strategy` VARCHAR(32) NULL COMMENT '备份策略：DATA_PUMP、JDBC_EXPORT',
+    `task_status` VARCHAR(32) NOT NULL DEFAULT 'WAITING' COMMENT '任务状态：WAITING、RUNNING、SUCCESS、FAIL、CANCELLED',
+    `schema_name` VARCHAR(128) NULL COMMENT '操作 Schema',
+    `target_names_json` JSON NULL COMMENT '操作对象名称列表 JSON，例如表名列表',
+    `request_param_json` JSON NULL COMMENT '请求参数快照 JSON，不保存运行时密码',
+    `result_message` VARCHAR(2000) NULL COMMENT '执行结果或失败原因',
+    `progress_percent` DECIMAL(5,2) NOT NULL DEFAULT 0.00 COMMENT '任务进度百分比',
+    `started_at` DATETIME NULL COMMENT '任务开始时间',
+    `finished_at` DATETIME NULL COMMENT '任务结束时间',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_by` VARCHAR(64) NULL COMMENT '创建人',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_by` VARCHAR(64) NULL COMMENT '更新人',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    UNIQUE KEY `uk_dbms_operation_task_no` (`task_no`),
+    KEY `idx_dbms_operation_connection` (`connection_id`),
+    KEY `idx_dbms_operation_db_type` (`db_type`),
+    KEY `idx_dbms_operation_type_status` (`operation_type`, `task_status`),
+    KEY `idx_dbms_operation_create_time` (`create_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='数据库运维任务表';
+
+CREATE TABLE IF NOT EXISTS `dbms_backup_file` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `task_id` VARCHAR(64) NOT NULL COMMENT '备份任务 ID',
+    `connection_id` VARCHAR(64) NOT NULL COMMENT '数据库连接配置 ID',
+    `db_type` VARCHAR(32) NOT NULL COMMENT '数据库类型：ORACLE，后续可扩展 MYSQL、INFLUXDB',
+    `backup_strategy` VARCHAR(32) NOT NULL COMMENT '备份策略：DATA_PUMP、JDBC_EXPORT',
+    `file_format` VARCHAR(32) NOT NULL COMMENT '文件格式：DMP、SQL、CSV',
+    `schema_name` VARCHAR(128) NULL COMMENT '备份 Schema',
+    `target_names_json` JSON NULL COMMENT '备份对象名称列表 JSON，例如表名列表',
+    `backup_mode` VARCHAR(32) NOT NULL DEFAULT 'FULL_TABLE' COMMENT '备份模式：FULL_TABLE、TIME_RANGE、SIZE_SPLIT',
+    `backup_start_time` DATETIME NULL COMMENT '按时间备份开始时间',
+    `backup_end_time` DATETIME NULL COMMENT '按时间备份结束时间',
+    `time_column` VARCHAR(128) NULL COMMENT '按时间备份使用的时间字段',
+    `directory_name` VARCHAR(128) NULL COMMENT '数据库目录对象名称，Oracle Data Pump 使用',
+    `dump_file_name` VARCHAR(255) NULL COMMENT 'Data Pump dump 文件名',
+    `log_file_name` VARCHAR(255) NULL COMMENT 'Data Pump log 文件名',
+    `file_name` VARCHAR(255) NOT NULL COMMENT '主备份文件名，需包含 _yyyyMMdd',
+    `file_path` VARCHAR(1000) NOT NULL COMMENT '服务端记录的备份文件路径或目录对象映射路径',
+    `log_file_path` VARCHAR(1000) NULL COMMENT '备份日志文件路径',
+    `metadata_file_path` VARCHAR(1000) NULL COMMENT 'JDBC_EXPORT 元数据文件路径',
+    `file_size` BIGINT NULL COMMENT '文件大小，单位字节',
+    `checksum` VARCHAR(128) NULL COMMENT '文件校验值',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_by` VARCHAR(64) NULL COMMENT '创建人',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_by` VARCHAR(64) NULL COMMENT '更新人',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    KEY `idx_dbms_backup_task` (`task_id`),
+    KEY `idx_dbms_backup_connection` (`connection_id`),
+    KEY `idx_dbms_backup_db_type` (`db_type`),
+    KEY `idx_dbms_backup_strategy` (`backup_strategy`),
+    KEY `idx_dbms_backup_create_time` (`create_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='数据库备份文件记录表';
+
+CREATE TABLE IF NOT EXISTS `dbms_restore_record` (
+    `id` VARCHAR(64) NOT NULL COMMENT '主键',
+    `task_id` VARCHAR(64) NOT NULL COMMENT '恢复任务 ID',
+    `backup_file_id` VARCHAR(64) NOT NULL COMMENT '备份文件 ID',
+    `connection_id` VARCHAR(64) NOT NULL COMMENT '目标数据库连接配置 ID',
+    `db_type` VARCHAR(32) NOT NULL COMMENT '数据库类型：ORACLE，后续可扩展 MYSQL、INFLUXDB',
+    `restore_mode` VARCHAR(32) NOT NULL DEFAULT 'SKIP' COMMENT '恢复模式：SKIP、APPEND、TRUNCATE、REPLACE',
+    `target_schema_name` VARCHAR(128) NULL COMMENT '目标 Schema',
+    `target_names_json` JSON NULL COMMENT '恢复对象名称列表 JSON，例如表名列表',
+    `table_exists_action` VARCHAR(32) NULL COMMENT 'Data Pump TABLE_EXISTS_ACTION：SKIP、APPEND、TRUNCATE、REPLACE',
+    `overwrite_confirmed` TINYINT NOT NULL DEFAULT 0 COMMENT '是否已确认覆盖类操作：0-否，1-是',
+    `result_message` VARCHAR(2000) NULL COMMENT '恢复结果说明',
+    `state` TINYINT NOT NULL DEFAULT 1 COMMENT '状态：0-删除，1-正常',
+    `create_by` VARCHAR(64) NULL COMMENT '创建人',
+    `create_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+    `update_by` VARCHAR(64) NULL COMMENT '更新人',
+    `update_time` DATETIME NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+    PRIMARY KEY (`id`),
+    KEY `idx_dbms_restore_task` (`task_id`),
+    KEY `idx_dbms_restore_backup_file` (`backup_file_id`),
+    KEY `idx_dbms_restore_connection` (`connection_id`),
+    KEY `idx_dbms_restore_db_type` (`db_type`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='数据库恢复记录表';

system-ops/dbms/src/main/resources/sql/system-ops/system-ops-init.sql

@@ -0,0 +1,14 @@
+INSERT INTO `cn_tool`.`sys_function`
+(`Id`, `Pid`, `Pids`, `Name`, `Code`, `Path`, `Component`, `Icon`, `Sort`, `Type`, `Remark`, `State`, `Create_By`, `Create_Time`, `Update_By`, `Update_Time`)
+VALUES
+('9f3b2c7a6e8d4b91a5c0f2d7e6a3b841', '0', '0', '系统运维', 'systemOps', '/systemOps', '/systemOps/index', 'Aim', 50, 0, '系统运维', 1, 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:00:00', 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:00:00');
+
+INSERT INTO `cn_tool`.`sys_function`
+(`Id`, `Pid`, `Pids`, `Name`, `Code`, `Path`, `Component`, `Icon`, `Sort`, `Type`, `Remark`, `State`, `Create_By`, `Create_Time`, `Update_By`, `Update_Time`)
+VALUES
+('2a7e5d9c1f4b4386b0c9e6f3a8d21754', '9f3b2c7a6e8d4b91a5c0f2d7e6a3b841', '0,9f3b2c7a6e8d4b91a5c0f2d7e6a3b841', '数据库监控', 'database', '/systemOps/database', '/systemOps/database/index', 'Monitor', 100, 0, '数据库监控', 1, 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:10:00', 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:10:00');
+
+INSERT INTO `cn_tool`.`sys_function`
+(`Id`, `Pid`, `Pids`, `Name`, `Code`, `Path`, `Component`, `Icon`, `Sort`, `Type`, `Remark`, `State`, `Create_By`, `Create_Time`, `Update_By`, `Update_Time`)
+VALUES
+('7c6d4a1e9b2f43c8a5e0d3f6b9c21875', '9f3b2c7a6e8d4b91a5c0f2d7e6a3b841', '0,9f3b2c7a6e8d4b91a5c0f2d7e6a3b841', '系统部署', 'deploy', '/systemOps/deploy', '/systemOps/deploy/index', 'Upload', 110, 0, '系统部署', 1, 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:20:00', 'f8516cc81d964cd8b4b771a3b3985cd4', '2026-05-20 10:20:00');

tools/README.md

@@ -10,9 +10,10 @@
 - `add-data`
 - `add-ledger`
 - `mms-mapping`
+- `parse-pqdif`
 - `wave-tool`
 
-因此，`tools` 现阶段仍然是聚合模块，但当前已实际承载激活工具、电能质量数据补录工具、数据台账工具空模块、ICD/MMS 映射工具和波形查看工具五个子模块。
+因此，`tools` 现阶段仍然是聚合模块，但当前已实际承载激活工具、电能质量数据补录工具、数据台账工具空模块、ICD/MMS 映射工具、PQDIF 解析预留工具和波形查看工具六个子模块。
 
 ## 当前结构
 
@@ -22,6 +23,7 @@ tools/
 ├── add-data/
 ├── add-ledger/
 ├── mms-mapping/
+├── parse-pqdif/
 └── wave-tool/
 ```
 
@@ -78,6 +80,16 @@ tools/
 
 从接口层看，当前主要围绕 `/api/mms-mapping` 路径提供能力。
 
+## parse-pqdif 的职责
+
+`parse-pqdif` 当前仅作为 PQDIF 文件解析工具的预留骨架，参照 `mms-mapping` 的 Controller、Service、ServiceImpl 和 VO 分层组织。
+
+- 预留 PQDIF 文件上传解析入口
+- 预留解析服务接口与实现
+- 当前不包含真实 PQDIF 解析、持久化或数据转换逻辑
+
+从接口层看，当前预留路径为 `/api/parse-pqdif/parse`。
+
 ## mms-mapping 配置
 
 `mms-mapping` 当前支持以下配置项：
@@ -98,7 +110,7 @@ tools/
 
 ## 依赖关系
 
-`tools/activate-tool`、`tools/add-data`、`tools/add-ledger`、`tools/mms-mapping` 与 `tools/wave-tool` 当前主要依赖：
+`tools/activate-tool`、`tools/add-data`、`tools/add-ledger`、`tools/mms-mapping`、`tools/parse-pqdif` 与 `tools/wave-tool` 当前主要依赖：
 
 - `com.njcn:njcn-common`
 - `com.njcn:spingboot2.3.12`

tools/add-data/src/main/java/com/njcn/gather/tool/adddata/component/AddDataValueGenerator.java

@@ -223,7 +223,8 @@ public class AddDataValueGenerator {
         if (baseValue == null) {
             throw new IllegalStateException("派生字段缺少主值：" + column);
         }
-        double factor = noise(state.sharedSeed + column.hashCode(), 0.01D, 0.05D);
+        String baseColumn = resolveDerivedBaseColumn(column, metricType);
+        double factor = noise(state.sharedSeed + baseColumn.hashCode(), 0.01D, 0.05D);
         double delta = Math.max(Math.abs(baseValue) * factor, 0.005D);
         double value;
         if (MetricType.MAX.equals(metricType)) {
@@ -239,6 +240,16 @@ public class AddDataValueGenerator {
         return round(value, 4);
     }
 
+    private String resolveDerivedBaseColumn(String column, MetricType metricType) {
+        if (MetricType.MAX.equals(metricType)) {
+            return removeSuffix(column, SUFFIX_MAX);
+        }
+        if (MetricType.MIN.equals(metricType)) {
+            return removeSuffix(column, SUFFIX_MIN);
+        }
+        return removeSuffix(column, SUFFIX_CP95);
+    }
+
     /**
      * 构建同源基础状态。
      *

tools/add-data/src/test/java/com/njcn/gather/tool/adddata/component/AddDataValueGeneratorTest.java

@@ -25,4 +25,24 @@ class AddDataValueGeneratorTest {
 
         Assertions.assertEquals(0, row.get(3));
     }
+
+    @Test
+    void shouldKeepStatValuesOrderedForSameTimeAndMetric() {
+        AddDataValueGenerator generator = new AddDataValueGenerator();
+        AddDataTableDefinition definition = new AddDataTableDefinition("data_v",
+                Arrays.asList("TIMEID", "LINEID", "PHASIC_TYPE", "QUALITYFLAG",
+                        "RMS", "RMS_MAX", "RMS_CP95", "RMS_MIN"),
+                Arrays.asList("A"), 100, AddDataTableDefinition.TimeAxisType.REQUEST_INTERVAL);
+
+        List<Object> row = generator.generateRow(definition, "line-001",
+                LocalDateTime.of(2026, 5, 18, 10, 0, 0), "A");
+
+        double avg = ((Number) row.get(4)).doubleValue();
+        double max = ((Number) row.get(5)).doubleValue();
+        double cp95 = ((Number) row.get(6)).doubleValue();
+        double min = ((Number) row.get(7)).doubleValue();
+        Assertions.assertTrue(max >= cp95, "MAX should be greater than or equal to CP95");
+        Assertions.assertTrue(cp95 >= avg, "CP95 should be greater than or equal to AVG");
+        Assertions.assertTrue(avg >= min, "AVG should be greater than or equal to MIN");
+    }
 }

tools/mms-mapping/pom.xml

@@ -20,6 +20,12 @@
             <version>0.0.1</version>
         </dependency>
 
+        <dependency>
+            <groupId>com.njcn</groupId>
+            <artifactId>mybatis-plus</artifactId>
+            <version>0.0.1</version>
+        </dependency>
+
         <dependency>
             <groupId>com.njcn</groupId>
             <artifactId>spingboot2.3.12</artifactId>

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/component/JsonToXmlConversionService.java

@@ -93,7 +93,7 @@ public class JsonToXmlConversionService {
         MappingDocument mappingDocument = objectMapper.readValue(mappingJson, MappingDocument.class);
         return buildXmlFromMapping(mappingDocument, templateStream, ruleStreams, indexMapping, methodDescribeList);
     }
-    
+
     /**
      * 从MappingDocument构建XML内容
      */
@@ -102,13 +102,13 @@ public class JsonToXmlConversionService {
                                        List<InputStream> ruleStreams,
                                        IcdToXmlMappingService.IndexMappingConfig indexMapping,
                                        List<String> methodDescribeList) throws Exception {
-        
+        // 读取模板
         String templateContent = readInputStreamToString(templateStream);
-        
+        //填充IED信息
         String xmlContent = fillIedInfo(templateContent, mappingDocument);
-        
+        //填充ReportControls信息
         xmlContent = fillReportControlsFromMapping(xmlContent, mappingDocument);
-        
+        //填充do da信息
         xmlContent = applyRulesFromMapping(xmlContent, mappingDocument, ruleStreams, indexMapping, methodDescribeList);
         
         return xmlContent;
@@ -192,6 +192,68 @@ public class JsonToXmlConversionService {
             reportStatBuilder.toString().replace("$", "\\$").replace("[", "\\[").replace("]", "\\]")
         );
 
+        reportStatBuilder = new StringBuilder();
+        reportStatBuilder.append("\t\t<ReportReal>\n");
+
+        for (var reportItem : mappingDocument.getReportMap()) {
+            if (reportItem.getName() != null && !reportItem.getName().isEmpty()) {
+                String name = reportItem.getName();
+
+                if (name.contains("urcbFluc") ||
+                        name.contains("urcbStHarm") ||
+                        name.contains("urcbStIHarm") ||
+                        name.contains("urcbStMMXU") ||
+                        name.contains("urcbStMSQI") ||
+                        name.contains("urcbPLT") ||
+                        name.contains("urcbPST") ||
+                        name.contains("urcbFlicker") ||
+                        name.contains("urcbStatistic")||
+                        name.contains("urcbRealData")) {
+
+                    String reportControlStr = buildReportControlString(reportItem);
+                    reportStatBuilder.append("\t\t\t<Report ReportControl=\"")
+                            .append(escapeXml(reportControlStr))
+                            .append("\" />\n");
+                }
+            }
+        }
+
+        reportStatBuilder.append("\t\t</ReportReal>");
+
+        xmlContent = xmlContent.replaceAll(
+                "<ReportReal>[\\s\\S]*?</ReportReal>",
+                reportStatBuilder.toString().replace("$", "\\$").replace("[", "\\[").replace("]", "\\]")
+        );
+
+        reportStatBuilder = new StringBuilder();
+        reportStatBuilder.append("\t\t<ReportEvent>\n");
+
+        for (var reportItem : mappingDocument.getReportMap()) {
+            if (reportItem.getName() != null && !reportItem.getName().isEmpty()) {
+                String name = reportItem.getName();
+
+                if (name.contains("QVVR") ||
+                        name.contains("RDRE") ||
+                        name.contains("GGIO")) {
+
+                    String reportControlStr = buildEventReportControlString(reportItem);
+                    reportStatBuilder.append("\t\t\t<Report ReportControl=\"")
+                            .append(escapeXml(reportControlStr))
+                            .append("\" />\n");
+                }
+            }
+        }
+
+        reportStatBuilder.append("\t\t</ReportEvent>");
+
+        xmlContent = xmlContent.replaceAll(
+                "<ReportEvent>[\\s\\S]*?</ReportEvent>",
+                reportStatBuilder.toString().replace("$", "\\$").replace("[", "\\[").replace("]", "\\]")
+        );
+
+
+
+
         return xmlContent;
     }
     
@@ -202,8 +264,10 @@ public class JsonToXmlConversionService {
         StringBuilder sb = new StringBuilder();
 
         sb.append("LLN0$").append(rc.getBuffered() != null && rc.getBuffered().equals("BR") ? "BR$" : "RP$").append(rc.getName());
-        
-        if(rc.getName().contains("PLT") || rc.getName().contains("Flicker") || rc.getName().contains("PST") || rc.getName().contains("Fluc")){
+        if(rc.getName().contains("urcb")){
+            sb.append(",3");
+        }
+        else if(rc.getName().contains("PLT") || rc.getName().contains("Flicker") || rc.getName().contains("PST") || rc.getName().contains("Fluc")){
             sb.append(",600");
         }else{
             sb.append(",60");
@@ -227,15 +291,53 @@ public class JsonToXmlConversionService {
         
         if(rc.getName().contains("PLT") || rc.getName().contains("Flicker")){
             sb.append(",1");
-        }else if(rc.getName().contains("PST") || rc.getName().contains("Fluc")){
+        }else if(rc.getName().contains("PST") || rc.getName().contains("Fluc")|| rc.getName().contains("RealData")){
             sb.append(",2");
-        } else {
+        }else {
             sb.append(",0");
         }
 
         return sb.toString();
     }
-    
+
+
+    /**
+     * 构建EventReportControl字符串
+     */
+    private String buildEventReportControlString(ReportMapItem rc) {
+        StringBuilder sb = new StringBuilder();
+
+        sb.append("LLN0$").append(rc.getBuffered() != null && rc.getBuffered().equals("BR") ? "BR$" : "RP$").append(rc.getName());
+        if(rc.getName().contains("urcb")){
+            sb.append(",3");
+        }
+        else if(rc.getName().contains("PLT") || rc.getName().contains("Flicker") || rc.getName().contains("PST") || rc.getName().contains("Fluc")){
+            sb.append(",600");
+        }else{
+            sb.append(",60");
+        }
+        sb.append(",1");
+        sb.append(",0");
+        sb.append(",0");
+        sb.append(",0");
+        sb.append(",0");
+        sb.append(",yes");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",0");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",1");
+        sb.append(",8");
+        sb.append(",1");
+        sb.append(",0");
+
+        return sb.toString();
+    }
+
     /**
      * 从MappingDocument应用规则
      */
@@ -244,19 +346,34 @@ public class JsonToXmlConversionService {
                                          List<InputStream> ruleStreams,
                                          IcdToXmlMappingService.IndexMappingConfig indexMapping,
                                          List<String> methodDescribeList) throws Exception {
-        
+        //合并所有规则文件
         var mergedRules = mergeAllRulesDesc(ruleStreams, indexMapping);
-        
+        //读取mappingDocument
         var mappingMetrics = extractMetricsFromMapping(mappingDocument);
         
         addMethodDescribe(methodDescribeList, "========== 开始从JSON匹配规则 ==========");
-        addMethodDescribe(methodDescribeList, "规则总数: " + mergedRules.size());
+        addMethodDescribe(methodDescribeList, "规则文件中定义规则总数: " + mergedRules.size());
         addMethodDescribe(methodDescribeList, "JSON中指标总数: " + mappingMetrics.size());
         
         var applicableRules = findApplicableRulesDesc(mergedRules, mappingMetrics, methodDescribeList);
         
-        addMethodDescribe(methodDescribeList, "匹配成功: " + applicableRules.size() + " 条规则");
-        addMethodDescribe(methodDescribeList, "匹配失败: " + (mergedRules.size() - applicableRules.size()) + " 条规则");
+        int xmlValueTagCount = countXmlValueTags(xmlContent);
+        int matchedValueTagCount = countMatchedValueTags(xmlContent, applicableRules);
+        int unmatchedValueTagCount = xmlValueTagCount - matchedValueTagCount;
+        
+        addMethodDescribe(methodDescribeList, "========== XML模板配置统计 ==========");
+        addMethodDescribe(methodDescribeList, "XML模板中需要配置的<Value>标签总数: " + xmlValueTagCount);
+        addMethodDescribe(methodDescribeList, "成功匹配的<Value>标签数: " + matchedValueTagCount);
+        addMethodDescribe(methodDescribeList, "未匹配的<Value>标签数: " + unmatchedValueTagCount);
+        
+        if (unmatchedValueTagCount > 0) {
+            List<String> unmatchedDescList = findUnmatchedValueTags(xmlContent, applicableRules);
+            addMethodDescribe(methodDescribeList, "未匹配的标签desc列表:");
+            for (String desc : unmatchedDescList) {
+                addMethodDescribe(methodDescribeList, "  - " + desc);
+            }
+        }
+        
         addMethodDescribe(methodDescribeList, "========== JSON规则匹配结束 ==========");
         
         return applyRulesToXml(xmlContent, applicableRules);
@@ -401,18 +518,14 @@ public class JsonToXmlConversionService {
         String line;
         String currentGroup = "";
 
-        java.util.regex.Pattern valueRulePattern = java.util.regex.Pattern.compile(
-                "<Value\\s+" +
-                        "name=\"([^\"]+)\"\\s+" +
-                        "desc=\"([^\"]+)\"\\s+" +
-                        "type=\"([^\"]+)\"\\s+" +
-                        "(?:DO=\"([^\"]*)\")?\\s*" +
-                        "(?:DA=\"([^\"]*)\")?\\s*" +
-                        "(?:BaseFlag=\"([^\"]*)\")?\\s*" +
-                        "(?:LimitUp=\"([^\"]*)\")?\\s*" +
-                        "(?:LimitDown=\"([^\"]*)\")?\\s*" +
-                        "(?:Coefficient=\"([^\"]*)\")?\\s*" +
-                        "/>", java.util.regex.Pattern.CASE_INSENSITIVE
+        java.util.regex.Pattern valueTagPattern = java.util.regex.Pattern.compile(
+                "<Value\\s+([^>]+)/>", 
+                java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Pattern attributePattern = java.util.regex.Pattern.compile(
+                "(name|desc|type|DO|DA|BaseFlag|LimitUp|LimitDown|Coefficient|Offset|PltFlag)=\"([^\"]*)\"",
+                java.util.regex.Pattern.CASE_INSENSITIVE
         );
 
         while ((line = reader.readLine()) != null) {
@@ -441,14 +554,23 @@ public class JsonToXmlConversionService {
                 continue;
             }
 
-            java.util.regex.Matcher matcher = valueRulePattern.matcher(line);
-            if (matcher.find()) {
+            java.util.regex.Matcher tagMatcher = valueTagPattern.matcher(line);
+            if (tagMatcher.find()) {
+                String attributesStr = tagMatcher.group(1);
+                
+                java.util.Map<String, String> attrMap = new java.util.HashMap<>();
+                java.util.regex.Matcher attrMatcher = attributePattern.matcher(attributesStr);
+                while (attrMatcher.find()) {
+                    attrMap.put(attrMatcher.group(1).toLowerCase(), attrMatcher.group(2));
+                }
+                
                 RuleBasedXmlMappingService.ValueRule rule = new RuleBasedXmlMappingService.ValueRule();
-                rule.setName(matcher.group(1));
-                rule.setDesc(matcher.group(2));
-                rule.setType(matcher.group(3));
-                String doPath = matcher.group(4) != null ? matcher.group(4) : "";
-                String daPath = matcher.group(5) != null ? matcher.group(5) : "";
+                rule.setName(attrMap.getOrDefault("name", ""));
+                rule.setDesc(attrMap.getOrDefault("desc", ""));
+                rule.setType(attrMap.getOrDefault("type", ""));
+                
+                String doPath = attrMap.getOrDefault("do", "");
+                String daPath = attrMap.getOrDefault("da", "");
 
                 if (indexMapping != null && !doPath.isEmpty()) {
                     doPath = applyIndexMapping(doPath, currentGroup, indexMapping, rule.getName(), rule.getDesc());
@@ -456,13 +578,16 @@ public class JsonToXmlConversionService {
 
                 rule.setDoPath(doPath);
                 rule.setDaPath(daPath);
-                rule.setBaseFlag(matcher.group(6));
-                rule.setLimitUp(matcher.group(7));
-                rule.setLimitDown(matcher.group(8));
-                rule.setCoefficient(matcher.group(9));
+                rule.setBaseFlag(attrMap.getOrDefault("baseflag", null));
+                rule.setLimitUp(attrMap.getOrDefault("limitup", null));
+                rule.setLimitDown(attrMap.getOrDefault("limitdown", null));
+                rule.setCoefficient(attrMap.getOrDefault("coefficient", null));
+                rule.setOffset(attrMap.getOrDefault("offset", null));
+                rule.setPltFlag(attrMap.getOrDefault("pltflag", null));
 
                 String key =  rule.getDesc();
-                if (!key.isEmpty() && hasValidDoOrDa(rule)) {
+
+                if (!key.isEmpty()) {//!key.isEmpty() && hasValidDoOrDa(rule)
                     rules.computeIfAbsent(key.toLowerCase(), k -> new ArrayList<>()).add(rule);
                 }
             }
@@ -710,6 +835,8 @@ public class JsonToXmlConversionService {
                 } else {
                     sb.append("[").append(start).append("]");
                 }
+            }else{
+                sb.append("$cVal");
             }
         }
         if (typeName != null && !typeName.isEmpty()) {
@@ -770,9 +897,9 @@ public class JsonToXmlConversionService {
             boolean matched = false;
 
             for (RuleBasedXmlMappingService.ValueRule rule : ruleVariants) {
-                if (rule.getName() == null || rule.getDoPath().isEmpty()) {
-                    continue;
-                }
+//                if (rule.getName() == null || rule.getDoPath().isEmpty()) {
+//                    continue;
+//                }
 
                 if(mappingMetrics.containsKey(rule.getName())){
                     MetricInfo metric = mappingMetrics.get(rule.getName());
@@ -909,30 +1036,32 @@ public class JsonToXmlConversionService {
     private String applyRulesToXml(String xmlContent,
                                    java.util.Map<String, RuleBasedXmlMappingService.ValueRule> applicableRules) {
         
-        java.util.regex.Pattern xmlValuePattern = java.util.regex.Pattern.compile(
-            "<Value\\s+" +
-            "name=\"([^\"]+)\"\\s+" +
-            "desc=\"([^\"]+)\"\\s+" +
-            "type=\"([^\"]+)\"\\s+" +
-            "(?:DO=\"([^\"]*)\")?\\s*" +
-            "(?:DA=\"([^\"]*)\")?\\s*" +
-            "(?:BaseFlag=\"([^\"]*)\")?\\s*" +
-            "(?:LimitUp=\"([^\"]*)\")?\\s*" +
-            "(?:LimitDown=\"([^\"]*)\")?\\s*" +
-            "(?:Coefficient=\"([^\"]*)\")?\\s*" +
-            "/>", java.util.regex.Pattern.CASE_INSENSITIVE
+        java.util.regex.Pattern valueTagPattern = java.util.regex.Pattern.compile(
+            "<Value\\s+([^>]+)/>", 
+            java.util.regex.Pattern.CASE_INSENSITIVE
         );
         
-        java.util.regex.Matcher matcher = xmlValuePattern.matcher(xmlContent);
+        java.util.regex.Pattern attributePattern = java.util.regex.Pattern.compile(
+            "(name|desc|type|DO|DA|BaseFlag|LimitUp|LimitDown|Coefficient|Offset|PltFlag)=\"([^\"]*)\"",
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Matcher matcher = valueTagPattern.matcher(xmlContent);
         StringBuffer result = new StringBuffer();
         
         while (matcher.find()) {
-            String name = matcher.group(1);
-            String desc = matcher.group(2);
-            String type = matcher.group(3);
+            String attributesStr = matcher.group(1);
+            
+            java.util.Map<String, String> attrMap = new java.util.HashMap<>();
+            java.util.regex.Matcher attrMatcher = attributePattern.matcher(attributesStr);
+            while (attrMatcher.find()) {
+                attrMap.put(attrMatcher.group(1).toLowerCase(), attrMatcher.group(2));
+            }
+            
+            String name = attrMap.getOrDefault("name", "");
+            String desc = attrMap.getOrDefault("desc", "");
+            String type = attrMap.getOrDefault("type", "6");
 
-            // String key = buildRuleKey(name, desc);
-            //RuleBasedXmlMappingService.ValueRule matchedRule = applicableRules.get(key.toLowerCase());
             RuleBasedXmlMappingService.ValueRule matchedRule = applicableRules.get(desc);
             if (matchedRule != null) {
                 StringBuilder valueNode = new StringBuilder("<Value ");
@@ -958,6 +1087,12 @@ public class JsonToXmlConversionService {
                 if (matchedRule.getCoefficient() != null && !matchedRule.getCoefficient().isEmpty()) {
                     valueNode.append("Coefficient=\"").append(escapeXml(matchedRule.getCoefficient())).append("\" ");
                 }
+                if (matchedRule.getOffset() != null && !matchedRule.getOffset().isEmpty()) {
+                    valueNode.append("Offset=\"").append(escapeXml(matchedRule.getOffset())).append("\" ");
+                }
+                if (matchedRule.getPltFlag() != null && !matchedRule.getPltFlag().isEmpty()) {
+                    valueNode.append("PltFlag=\"").append(escapeXml(matchedRule.getPltFlag())).append("\" ");
+                }
                 
                 valueNode.append("/>");
                 matcher.appendReplacement(result, java.util.regex.Matcher.quoteReplacement(valueNode.toString()));
@@ -986,7 +1121,102 @@ public class JsonToXmlConversionService {
         }
         methodDescribeList.add(message);
     }
-    
+
+    /**
+     * 统计 XML 模板中 <Value> 标签的总数
+     */
+    private int countXmlValueTags(String xmlContent) {
+        if (xmlContent == null || xmlContent.isEmpty()) {
+            return 0;
+        }
+        
+        java.util.regex.Pattern valueTagPattern = java.util.regex.Pattern.compile(
+            "<Value\\s+[^>]+/>", 
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Matcher matcher = valueTagPattern.matcher(xmlContent);
+        int count = 0;
+        while (matcher.find()) {
+            count++;
+        }
+        
+        return count;
+    }
+
+    /**
+     * 统计 XML 模板中成功匹配的 <Value> 标签数
+     */
+    private int countMatchedValueTags(String xmlContent,
+                                      java.util.Map<String, RuleBasedXmlMappingService.ValueRule> applicableRules) {
+        if (xmlContent == null || xmlContent.isEmpty() || applicableRules == null) {
+            return 0;
+        }
+        
+        java.util.regex.Pattern valueTagPattern = java.util.regex.Pattern.compile(
+            "<Value\\s+([^>]+)/>", 
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Pattern attributePattern = java.util.regex.Pattern.compile(
+            "desc=\"([^\"]*)\"",
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Matcher matcher = valueTagPattern.matcher(xmlContent);
+        int matchedCount = 0;
+        
+        while (matcher.find()) {
+            String attributesStr = matcher.group(1);
+            java.util.regex.Matcher attrMatcher = attributePattern.matcher(attributesStr);
+            if (attrMatcher.find()) {
+                String desc = attrMatcher.group(1);
+                if (applicableRules.containsKey(desc)) {
+                    matchedCount++;
+                }
+            }
+        }
+        
+        return matchedCount;
+    }
+
+    /**
+     * 查找 XML 模板中未匹配的 <Value> 标签的 desc 属性列表
+     */
+    private List<String> findUnmatchedValueTags(String xmlContent,
+                                                 java.util.Map<String, RuleBasedXmlMappingService.ValueRule> applicableRules) {
+        List<String> unmatchedList = new ArrayList<>();
+        
+        if (xmlContent == null || xmlContent.isEmpty() || applicableRules == null) {
+            return unmatchedList;
+        }
+        
+        java.util.regex.Pattern valueTagPattern = java.util.regex.Pattern.compile(
+            "<Value\\s+([^>]+)/>", 
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Pattern attributePattern = java.util.regex.Pattern.compile(
+            "desc=\"([^\"]*)\"",
+            java.util.regex.Pattern.CASE_INSENSITIVE
+        );
+        
+        java.util.regex.Matcher matcher = valueTagPattern.matcher(xmlContent);
+        
+        while (matcher.find()) {
+            String attributesStr = matcher.group(1);
+            java.util.regex.Matcher attrMatcher = attributePattern.matcher(attributesStr);
+            if (attrMatcher.find()) {
+                String desc = attrMatcher.group(1);
+                if (!applicableRules.containsKey(desc) && !desc.isEmpty()) {
+                    unmatchedList.add(desc);
+                }
+            }
+        }
+        
+        return unmatchedList;
+    }
+
     /**
      * 指标信息内部类
      */

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/component/RuleBasedXmlMappingService.java

@@ -60,14 +60,24 @@ public class RuleBasedXmlMappingService {
     private static final Pattern DO_INDEX_PATTERN = Pattern.compile("(MMXU|MHAI|MSQI|MFLK|QVVR)(\\d+)");
     private static final Pattern DO_NO_INDEX_PATTERN = Pattern.compile("(MMXU|MHAI|MSQI|MFLK|QVVR)\\$");
 
-    public InputStream loadDefaultXmlFile( ) throws Exception {
-        ClassPathResource templateResource = new ClassPathResource("template/JiangSu_Config2.xml");
+    public InputStream loadDefaultXmlFile() throws Exception {
+        return loadDefaultXmlFile(1);
+    }
+
+    public InputStream loadDefaultXmlFile(Integer configType) throws Exception {
+        String fileName;
+        if (configType != null && configType == 2) {
+            fileName = "template/JiangSu_Config1.xml";
+        } else {
+            fileName = "template/JiangSu_Config2.xml";
+        }
+
+        ClassPathResource templateResource = new ClassPathResource(fileName);
 
         if (!templateResource.exists()) {
             return null;
         }
 
-
         return templateResource.getInputStream();
     }
 
@@ -808,6 +818,8 @@ public class RuleBasedXmlMappingService {
         private String limitUp;
         private String limitDown;
         private String coefficient;
+        private String offset;
+        private String pltFlag;
 
         public String getName() { return name; }
         public void setName(String name) { this.name = name; }
@@ -827,6 +839,10 @@ public class RuleBasedXmlMappingService {
         public void setLimitDown(String limitDown) { this.limitDown = limitDown; }
         public String getCoefficient() { return coefficient; }
         public void setCoefficient(String coefficient) { this.coefficient = coefficient; }
+        public String getOffset() { return offset; }
+        public void setOffset(String offset) { this.offset = offset; }
+        public String getPltFlag() { return pltFlag; }
+        public void setPltFlag(String pltFlag) { this.pltFlag = pltFlag; }
     }
     
     static class IcdMetricInfo {

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/config/MappingModuleConfig.java

@@ -26,4 +26,12 @@ public class MappingModuleConfig {
     /** 默认输出目录。 */
     @Value("${icd.mapping.default-output-dir:}")
     private String defaultOutputDir;
+
+    /** JSON转XML使用的默认XML模板路径。 */
+    @Value("${icd.mapping.json-to-xml-template-path:template/JiangSu_Config2.xml}")
+    private String jsonToXmlTemplatePath;
+
+    /** JSON转XML使用的默认规则文件路径。 */
+    @Value("${icd.mapping.json-to-xml-rule-path:template/默认规则.txt}")
+    private String jsonToXmlRulePath;
 }

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/controller/MappingController.java

@@ -165,9 +165,13 @@ public class MappingController extends BaseController {
     public IcdToXmlResponse getXmlFromJson(@Validated @RequestPart("request") JsonToXmlRequest request) {
         String methodDescribe = getMethodDescribe("getXmlFromJson") + "，开始将 MMS JSON 转换为 XML";
 
-        // 直接返回 XML 内容给前端展示，不再输出临时文件。
+        Integer configType = request == null ? null : request.getConfigType();
+        if (configType == null || (configType != 1 && configType != 2)) {
+            configType = 2;
+        }
+
         IcdToXmlGenerateResult result =
-            icdToXmlTaskAppService.generateXmlFromJson(request == null ? null : request.getMappingJson());
+            icdToXmlTaskAppService.generateXmlFromJson(request == null ? null : request.getMappingJson(), configType);
         if (result.getMethodDescribe() != null && !result.getMethodDescribe().trim().isEmpty()) {
             methodDescribe = methodDescribe + "\n" + result.getMethodDescribe();
         }

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/controller/MmsDeviceTypeController.java

@@ -0,0 +1,72 @@
+package com.njcn.gather.icd.mapping.controller;
+
+import com.njcn.common.pojo.annotation.OperateInfo;
+import com.njcn.common.pojo.enums.common.LogEnum;
+import com.njcn.common.pojo.enums.response.CommonResponseEnum;
+import com.njcn.common.pojo.response.HttpResult;
+import com.njcn.common.utils.LogUtil;
+import com.njcn.gather.icd.mapping.pojo.param.IcdCheckResultSaveParam;
+import com.njcn.gather.icd.mapping.pojo.vo.MmsDeviceTypeVO;
+import com.njcn.gather.icd.mapping.pojo.vo.PqdifCheckPlaceholderVO;
+import com.njcn.gather.icd.mapping.service.MmsDeviceTypeService;
+import com.njcn.web.controller.BaseController;
+import com.njcn.web.utils.HttpResultUtil;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiOperation;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+/**
+ * 设备类型校验入口。
+ */
+@Slf4j
+@Api(tags = "设备类型ICD校验")
+@RestController
+@RequestMapping("/api/mms-mapping/dev-types")
+@RequiredArgsConstructor
+public class MmsDeviceTypeController extends BaseController {
+
+    private final MmsDeviceTypeService mmsDeviceTypeService;
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON)
+    @ApiOperation("查询设备类型校验列表")
+    @GetMapping
+    public HttpResult<List<MmsDeviceTypeVO>> listDeviceTypes() {
+        String methodDescribe = getMethodDescribe("listDeviceTypes");
+        LogUtil.njcnDebug(log, "{}，开始查询设备类型校验列表", methodDescribe);
+        List<MmsDeviceTypeVO> result = mmsDeviceTypeService.listDeviceTypes();
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON)
+    @ApiOperation("保存设备类型ICD唯一性校验结果")
+    @ApiImplicitParam(name = "id", value = "设备类型ID", required = true)
+    @PostMapping("/{id}/icd-check-result")
+    public HttpResult<Boolean> saveIcdCheckResult(@PathVariable("id") String id,
+                                                  @RequestBody IcdCheckResultSaveParam param) {
+        String methodDescribe = getMethodDescribe("saveIcdCheckResult");
+        LogUtil.njcnDebug(log, "{}，开始保存设备类型ICD校验结果，devTypeId={}", methodDescribe, id);
+        boolean result = mmsDeviceTypeService.saveIcdCheckResult(id, param);
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
+    }
+
+    @OperateInfo(info = LogEnum.BUSINESS_COMMON)
+    @ApiOperation("设备类型PQDIF校验")
+    @ApiImplicitParam(name = "id", value = "设备类型ID", required = true)
+    @PostMapping("/{id}/pqdif-check")
+    public HttpResult<PqdifCheckPlaceholderVO> pqdifCheck(@PathVariable("id") String id) {
+        String methodDescribe = getMethodDescribe("pqdifCheck");
+        LogUtil.njcnDebug(log, "{}，设备类型PQDIF校验预留入口，devTypeId={}", methodDescribe, id);
+        PqdifCheckPlaceholderVO result = mmsDeviceTypeService.pqdifCheck(id);
+        return HttpResultUtil.assembleCommonResponseResult(CommonResponseEnum.SUCCESS, result, methodDescribe);
+    }
+}

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/mapper/CsDevTypeMapper.java

@@ -0,0 +1,15 @@
+package com.njcn.gather.icd.mapping.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.icd.mapping.pojo.po.CsDevTypePO;
+import com.njcn.gather.icd.mapping.pojo.vo.MmsDeviceTypeVO;
+
+import java.util.List;
+
+/**
+ * 设备类型 Mapper。
+ */
+public interface CsDevTypeMapper extends BaseMapper<CsDevTypePO> {
+
+    List<MmsDeviceTypeVO> selectDeviceTypeCheckList();
+}

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/mapper/CsIcdPathMapper.java

@@ -0,0 +1,10 @@
+package com.njcn.gather.icd.mapping.mapper;
+
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.njcn.gather.icd.mapping.pojo.po.CsIcdPathPO;
+
+/**
+ * ICD 路径 Mapper。
+ */
+public interface CsIcdPathMapper extends BaseMapper<CsIcdPathPO> {
+}

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/mapper/mapping/CsDevTypeMapper.xml

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.njcn.gather.icd.mapping.mapper.CsDevTypeMapper">
+
+    <select id="selectDeviceTypeCheckList"
+            resultType="com.njcn.gather.icd.mapping.pojo.vo.MmsDeviceTypeVO">
+        SELECT
+            d.id AS id,
+            d.name AS name,
+            d.icd AS icdId,
+            p.Name AS icdName,
+            p.Path AS icdPath,
+            p.Result AS icdResult,
+            p.Msg AS icdMsg,
+            d.report_name AS reportName,
+            CASE WHEN d.icd IS NOT NULL AND d.icd != '' AND p.ID IS NOT NULL THEN 1 ELSE 0 END AS canCheckIcd,
+            0 AS canCheckPqdif
+        FROM cs_dev_type d
+        LEFT JOIN cs_icd_path p ON d.icd = p.ID
+        WHERE d.State = 1
+        ORDER BY d.Update_Time DESC, d.Create_Time DESC
+    </select>
+
+</mapper>

tools/mms-mapping/src/main/java/com/njcn/gather/icd/mapping/pojo/param/IcdCheckResultSaveParam.java

@@ -0,0 +1,25 @@
+package com.njcn.gather.icd.mapping.pojo.param;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+
+/**
+ * ICD 校验结果保存参数。
+ */
+@Data
+@ApiModel("ICD校验结果保存参数")
+public class IcdCheckResultSaveParam {
+
+    @ApiModelProperty("MMS映射JSON")
+    private String mappingJson;
+
+    @ApiModelProperty("MMS映射XML")
+    private String xml;
+
+    @ApiModelProperty("校验结论：0-否，1-是")
+    private Integer result;
+
+    @ApiModelProperty("校验结论描述")
+    private String msg;
+}