整理控制台接口验收后的业务注释

yeg

2026-09-05 3a8c49426eb95f50bc3223098e9c4a1ddea90b06

 ruoyi-system/src/main/java/com/ruoyi/system/service/impl/TestDataQueryServiceImpl.java

@@ -37,28 +37,57 @@
    {
        requireTest(testId);
        List<Map<String, Object>> source = new java.util.ArrayList<>();
        List<Map<String, Object>> cabinet = mapper.selectPersistedRecords(testId);
        List<Map<String, Object>> collector = mapper.selectPersistedCollectorRecords(testId);
        if (cabinet != null) source.addAll(cabinet);
        if (collector != null) source.addAll(collector);
        List<Map<String, Object>> snapshots = mapper.selectPersistedFinalRealtimeRecords(testId);
        if (snapshots != null && !snapshots.isEmpty()) source.addAll(snapshots);
        else {
            // 迁移完成前兼容旧数据；新采集只从统一快照读取。
            List<Map<String, Object>> cabinet = mapper.selectPersistedRecords(testId);
            List<Map<String, Object>> collector = mapper.selectPersistedCollectorRecords(testId);
            if (cabinet != null) source.addAll(cabinet);
            if (collector != null) source.addAll(collector);
        }
        List<Map<String, Object>> effective = applyEffectiveData(testId, "REALTIME", source);
        attachCollectorStepContext(effective);
        return effective;
        return normalizeApiTimes(effective);
    }

    @Override public List<Map<String, Object>> steps(Long testId)
    {
        requireTest(testId);
        return applyEffectiveData(testId, "STEP", mapper.selectPersistedSteps(testId));
        List<Map<String, Object>> source = mapper.selectPersistedFinalStepRecords(testId);
        if (source == null || source.isEmpty()) {
            List<Map<String, Object>> legacy = mapper.selectPersistedSteps(testId);
            if (legacy != null && !legacy.isEmpty()) source = legacy;
        }
        return normalizeApiTimes(applyEffectiveData(testId, "STEP", source));
    }

    @Override public List<Map<String, Object>> cycles(Long testId)
    {
        requireTest(testId);
        return applyEffectiveData(testId, "CYCLE", mapper.selectPersistedCycles(testId));
        List<Map<String, Object>> source = mapper.selectPersistedFinalCycleRecords(testId);
        if (source == null || source.isEmpty()) {
            List<Map<String, Object>> legacy = mapper.selectPersistedCycles(testId);
            if (legacy != null && !legacy.isEmpty()) source = legacy;
        }
        return normalizeApiTimes(applyEffectiveData(testId, "CYCLE", source));
    }

    /** 将最新人工覆盖应用到设备事实，删除只影响当前有效视图，不抹除原始采样。 */
    /** 自研业务接口统一以 Unix epoch 毫秒返回时间，避免前端依赖数据库日期格式。 */
    private List<Map<String, Object>> normalizeApiTimes(List<Map<String, Object>> rows)
    {
        if (rows == null) return List.of();
        for (Map<String, Object> row : rows)
            for (String key : List.of("deviceTime", "collectorDeviceTime", "captureSlot", "recordedAt", "absoluteTime", "serverReceivedAt"))
            {
                Object value = row.get(key);
                if (value instanceof Date date) row.put(key, date.getTime());
                else if (value instanceof Instant instant) row.put(key, instant.toEpochMilli());
            }
        return rows;
    }

    /** 合并既有导入记录和人工修订供当前有效数据查询；不在此处执行物理删除。 */
    private List<Map<String, Object>> applyEffectiveData(Long testId, String dataType,
            List<Map<String, Object>> source)
    {
@@ -111,6 +140,8 @@

    private String stableIdentity(String dataType, Map<String, Object> row)
    {
        if ("REALTIME".equals(dataType) && "SNAPSHOT".equals(String.valueOf(row.get("sourceType"))))
            return String.valueOf(row.getOrDefault("stableIdentity", "snapshot:" + value(row, "snapshotId")));
        if ("REALTIME".equals(dataType) && "COLLECTOR".equals(String.valueOf(row.get("sourceType"))))
            return String.join(":", "collector", identityPart(row, "collectorId"),
                    identityPart(row, "channelCode"), value(row, "sequenceId"), identityPart(row, "metricCode"));