feat(tools): 新增电能质量数据补录工具模块
- 添加 add-data 子模块提供批量补数能力 - 实现任务预估、创建、状态查询和模板规则查询接口 - 集成异步执行、批量写入和内存态任务状态管理功能 - 更新 tools 模块聚合配置包含新子模块 - 添加详细模块说明文档和架构设计文档 - 修改调试文件路径配置指向实际测试文件位置
This commit is contained in:
55
tools/add-data/README.md
Normal file
55
tools/add-data/README.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# add-data 模块说明
|
||||
|
||||
## 模块定位
|
||||
|
||||
`add-data` 当前提供电能质量 13 张表批量补数能力,支持补数规模预估、后台异步执行、任务状态查询和前端模板规则查询。
|
||||
|
||||
## 当前范围
|
||||
|
||||
当前模块本次实现范围聚焦在工具型批处理,不接入以下内容:
|
||||
|
||||
- 覆盖更新或先删后写
|
||||
- 监测点基础信息管理
|
||||
- 独立任务持久化表
|
||||
- 前端页面代码
|
||||
|
||||
目录中保留历史 SQL 脚本 `DATA_FLICKER.sql`,并同步复制到 `src/main/resources/sql/add-data` 供运行时解析表字段元数据。
|
||||
|
||||
## 当前结构
|
||||
|
||||
```text
|
||||
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` 四类数据类型生成和预估补数。
|
||||
|
||||
后续如果补齐逐表真实相别映射、任务持久化或更细粒度模板规则,应优先沿现有职责边界扩展,不回退为单一大类承载全部逻辑。
|
||||
Reference in New Issue
Block a user