ClientApps/CN_Tool
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
38f910fccd3f4ee505627cf56382c9175620da03
CN_Tool/tools
History
yexb 38f910fccd feat(event): 添加暂态事件波形查看与导出功能 
- 新增 getTransientEventWave 接口用于查看暂态事件波形
- 新增 exportTransientEventWaves 接口用于批量导出暂态事件波形
- 添加 EventWaveExportParam 参数类支持波形导出
- 在 EventListMapper 中增加 selectTransientDetailsByIds 查询方法
- 更新事件列表查询参数支持毫秒级时间格式
- 移除事件描述模糊查询条件优化查询性能
- 添加波形导出相关的常量和工具类集成
2026-05-18 08:45:05 +08:00
..
activate-tool
项目初始化
2026-04-13 11:50:14 +08:00
add-data
feat(event): 添加暂态事件波形查看与导出功能
2026-05-18 08:45:05 +08:00
add-ledger
feat(event): 添加暂态事件波形查看与导出功能
2026-05-18 08:45:05 +08:00
mms-mapping
feat(event): 添加暂态事件波形查看与导出功能
2026-05-18 08:45:05 +08:00
wave-tool
feat(event): 添加暂态事件波形查看与导出功能
2026-05-18 08:45:05 +08:00
pom.xml
feat(add-ledger): 新增数据台账管理功能
2026-05-09 07:52:04 +08:00
README.md
feat(add-ledger): 新增数据台账管理功能
2026-05-09 07:52:04 +08:00

README.md

Tools 模块说明

当前状态

tools 当前是工具能力聚合模块，但在本仓库内已经完成一次收口。

当前真实保留的子模块有：

  • activate-tool
  • add-data
  • add-ledger
  • mms-mapping
  • wave-tool

因此，tools 现阶段仍然是聚合模块，但当前已实际承载激活工具、电能质量数据补录工具、数据台账工具空模块、ICD/MMS 映射工具和波形查看工具五个子模块。

当前结构

tools/
├── activate-tool/
├── add-data/
├── add-ledger/
├── mms-mapping/
└── wave-tool/

其中 tools/mms-mapping 当前 Maven artifactId 为 mms-mapping。

add-data 的职责

add-data 当前已提供电能质量数据批量补录能力，包含：

  • 任务预估接口
  • 任务创建接口
  • 任务状态查询接口
  • 模板规则查询接口
  • 异步执行、批量写入和内存态任务状态管理

模块内部已按职责拆分 controller、service、service/impl、component、pojo、config 和 util，并通过 JdbcTemplate + INSERT IGNORE 执行批量补数。

add-ledger 的职责

add-ledger 当前仅完成 Maven 空模块接入，后续用于承载数据台账相关能力。

当前未提供业务接口、Java 分层骨架、配置项或持久化逻辑。目录中的 ledger.sql 仅作为原始脚本保留，暂未接入运行时资源解析。

activate-tool 的职责

activate-tool 当前提供的能力主要围绕设备授权与许可证：

  • 生成设备申请码
  • 生成激活码
  • 校验激活码
  • 读取本地许可证信息

从接口层看，当前主要围绕 /activate/* 路径提供能力。

wave-tool 的职责

wave-tool 当前提供的能力主要围绕波形解析、查看数据组装与图片生成：

  • 解析单列/双列文本波形
  • 解析 COMTRADE cfg/dat 波形文件
  • 计算 RMS 与特征值
  • 组装前端查看明细
  • 生成瞬时、RMS、治理场景波形图片

从接口层看，当前主要围绕 /wave/* 路径提供能力。

mms-mapping 的职责

mms-mapping 当前提供的能力主要围绕 ICD 文件解析与 MMS 映射数据生成：

  • 解析 ICD / SCL 文件结构
  • 校验索引选择与绑定关系
  • 生成映射任务结果与文档数据

从接口层看，当前主要围绕 /api/mms-mapping 路径提供能力。

mms-mapping 配置

mms-mapping 当前支持以下配置项：

  • icd.mapping.default-template-path：默认模板资源路径，默认值为 template/DefaultCfg.txt
  • icd.mapping.default-author：请求未传作者时使用的默认作者，默认值为 system
  • icd.mapping.default-output-dir：请求开启落盘但未指定目录时使用的默认输出目录，默认值为空字符串（即当前工作目录）

模块定位

当前 activate-tool 更适合作为平台级基础能力模块，而不是业务检测模块的一部分。

它的职责边界建议理解为：

  • 负责授权相关的编码、解码和许可证文件处理
  • 不负责检测业务本身
  • 不负责系统级注册资源管理的全部逻辑

依赖关系

tools/activate-tool、tools/add-data、tools/add-ledger、tools/mms-mapping 与 tools/wave-tool 当前主要依赖：

  • com.njcn:njcn-common
  • com.njcn:spingboot2.3.12

并由 entrance 模块直接聚合使用。

文档说明

在本次 P0 收口前，tools/README.md 曾描述多个不存在于当前仓库中的工具子模块。 该描述已不再作为当前项目结构依据。

如果后续重新引入新的工具子模块，应：

  • 同步更新 tools/pom.xml
  • 同步更新本说明文档
  • 在 docs 下补充模块边界与职责说明