Files

yexb f69eed857f feat(tools): 新增电能质量数据补录工具模块

- 添加 add-data 子模块提供批量补数能力
- 实现任务预估、创建、状态查询和模板规则查询接口
- 集成异步执行、批量写入和内存态任务状态管理功能
- 更新 tools 模块聚合配置包含新子模块
- 添加详细模块说明文档和架构设计文档
- 修改调试文件路径配置指向实际测试文件位置

2026-04-30 11:32:00 +08:00

1.7 KiB

Raw Blame History

add-data 模块说明

模块定位

add-data 当前提供电能质量 13 张表批量补数能力，支持补数规模预估、后台异步执行、任务状态查询和前端模板规则查询。

当前范围

当前模块本次实现范围聚焦在工具型批处理，不接入以下内容：

覆盖更新或先删后写
监测点基础信息管理
独立任务持久化表
前端页面代码

目录中保留历史 SQL 脚本 DATA_FLICKER.sql，并同步复制到 src/main/resources/sql/add-data 供运行时解析表字段元数据。

当前结构

add-data/
├── pom.xml
├── README.md
├── DATA_FLICKER.sql
└── src/main/java/com/njcn/gather/tool/adddata/
    ├── component/
    ├── config/
    ├── controller/
    ├── pojo/
    ├── service/
    └── util/

基础骨架说明

controller/AddDataTaskController
- 提供预估、创建任务、查询任务状态三个接口
controller/AddDataTemplateController
- 提供前端参数模板规则查询接口
component/AddDataTaskExecutor
- 负责后台异步补数任务执行
component/AddDataBatchWriter
- 负责 INSERT IGNORE 批量写入与失败降级
component/AddDataValueGenerator
- 负责按同源规则生成 13 张表数据
component/AddDataTableRegistry
- 负责从 SQL 资源解析字段元数据并注册表定义
component/AddDataTaskStatusHolder
- 首版以内存方式保存任务状态

扩展约束

当前实现按 A/B/C/T 四类数据类型生成和预估补数。

后续如果补齐逐表真实相别映射、任务持久化或更细粒度模板规则，应优先沿现有职责边界扩展，不回退为单一大类承载全部逻辑。

1.7 KiB Raw Blame History