Kris
ccc7109c31
主要变更： - 新增实时同步日志统计接口，支持多维度统计（综合、对象、操作类型、状态、时间趋势） - 新增实时同步统计接口，提供服务状态、对象统计和订阅统计 - 实现实时服务手动启动管理，移除自动启动注解 - 移除所有统计相关功能（EventProcessor、DataSynchronizer统计方法） - 解决DataiIntegrationObjectServiceImpl和ObjectRegistryImpl循环依赖问题 - 完善元数据变更统计功能，支持自动时间范围和缺失数据点填充 - 修复SQL布尔值兼容性问题（true/false改为1/0） - 新增SysJobController和SysJobLogController接口文档 - 更新项目文档和变更日志 技术细节： - 添加@Lazy注解解决循环依赖 - 实现时间趋势统计的自动时间范围处理 - 支持多种时间单位（天、周、月、季度）的趋势分析 - 优化同步成功率计算和数据处理完整性 - 遵循项目文档规范，更新唯一真源
110 lines
4.8 KiB
Markdown
110 lines
4.8 KiB
Markdown
# 变更记录 - 实时同步日志统计功能
|
||
|
||
## 变更信息
|
||
|
||
- **版本号**: v0.1.12
|
||
- **发布日期**: 2026-01-13
|
||
- **变更类型**: 特性更新
|
||
|
||
## 变更摘要
|
||
|
||
本次变更为实时同步日志模块新增了全面的统计功能，支持多种分组维度和时间趋势分析，帮助用户深入了解实时同步服务的运行状况和性能指标。新增的统计接口提供了综合统计、对象统计、操作类型统计、状态统计和时间趋势统计等功能。
|
||
|
||
## 详细变更
|
||
|
||
### 特性更新
|
||
|
||
- **新增实时同步日志统计接口** - 在 DataiIntegrationRealtimeSyncLogController 中新增 /integration/realtimelog/statistics 接口，支持多种统计维度
|
||
- **综合统计功能** - 提供总记录数、成功数、失败数、待处理数、成功率和平均处理时间等关键指标
|
||
- **按对象统计** - 支持按 Salesforce 对象名称分组统计，了解各对象的同步情况
|
||
- **按操作类型统计** - 支持按 CREATE、UPDATE、DELETE、UNDELETE 操作类型分组统计
|
||
- **按状态统计** - 支持按 SUCCESS、FAILED、PENDING 状态分组统计
|
||
- **时间趋势统计** - 支持按天、周、月、季度等时间单位统计，自动填充缺失时间点，确保数据完整性
|
||
- **灵活的过滤条件** - 支持按对象名称、操作类型、同步状态、时间范围等多维度过滤
|
||
- **智能时间处理** - 自动处理时间范围，支持日期和日期时间两种格式，默认查询最近 30 天数据
|
||
|
||
### 数据库变更
|
||
|
||
- **新增 Mapper 方法** - 在 DataiIntegrationRealtimeSyncLogMapper 中新增 5 个统计查询方法
|
||
- selectOverallStatistics: 查询综合统计信息
|
||
- selectStatisticsByObject: 按对象统计
|
||
- selectStatisticsByOperationType: 按操作类型统计
|
||
- selectStatisticsByStatus: 按状态统计
|
||
- selectStatisticsByTrend: 按时间趋势统计
|
||
- **新增 SQL 查询** - 在 DataiIntegrationRealtimeSyncLogMapper.xml 中实现对应的 SQL 查询语句
|
||
|
||
### 服务层变更
|
||
|
||
- **新增 Service 接口方法** - 在 IDataiIntegrationRealtimeSyncLogService 中新增 getStatistics 方法
|
||
- **实现统计逻辑** - 在 DataiIntegrationRealtimeSyncLogServiceImpl 中实现完整的统计业务逻辑
|
||
- 支持多种分组策略
|
||
- 实现时间键生成和缺失数据填充
|
||
- 计算成功率和平均处理时间等指标
|
||
- 提供异常处理和错误信息返回
|
||
|
||
## 影响范围
|
||
|
||
### 受影响的模块
|
||
|
||
- **datai-salesforce-integration** - 新增实时同步日志统计功能
|
||
- Controller 层: DataiIntegrationRealtimeSyncLogController
|
||
- Service 层: IDataiIntegrationRealtimeSyncLogService 和 DataiIntegrationRealtimeSyncLogServiceImpl
|
||
- Mapper 层: DataiIntegrationRealtimeSyncLogMapper 和 DataiIntegrationRealtimeSyncLogMapper.xml
|
||
|
||
### 兼容性说明
|
||
|
||
- 本次变更为新增功能，不影响现有功能
|
||
- 新增接口需要 integration:realtimelog:statistics 权限
|
||
- 数据库表结构无变更，仅新增查询方法
|
||
|
||
## 升级指南
|
||
|
||
### 升级步骤
|
||
|
||
1. 部署更新后的代码到生产环境
|
||
2. 确保数据库连接正常，Mapper XML 文件已正确部署
|
||
3. 为需要的用户或角色分配 integration:realtimelog:statistics 权限
|
||
4. 验证统计接口功能是否正常
|
||
|
||
### 注意事项
|
||
|
||
- 统计接口对大数据量查询可能需要较长时间，建议合理设置时间范围
|
||
- 时间趋势统计会生成完整的时间序列数据，查询时间范围不宜过大
|
||
- 建议为相关数据库字段创建索引以提高查询性能
|
||
|
||
## 测试信息
|
||
|
||
### 测试环境
|
||
|
||
- **开发环境** - 本地开发环境，MySQL 8.0 数据库
|
||
- **测试环境** - 测试服务器，MySQL 8.0 数据库
|
||
|
||
### 测试结果
|
||
|
||
- **综合统计测试** - 通过，正确返回综合统计数据
|
||
- **对象统计测试** - 通过，正确按对象分组统计
|
||
- **操作类型统计测试** - 通过，正确按操作类型分组统计
|
||
- **状态统计测试** - 通过，正确按状态分组统计
|
||
- **时间趋势统计测试** - 通过，正确按时间单位统计并填充缺失数据
|
||
- **过滤条件测试** - 通过，正确应用各种过滤条件
|
||
- **时间格式测试** - 通过，支持日期和日期时间两种格式
|
||
- **异常处理测试** - 通过，正确处理时间格式错误等异常情况
|
||
|
||
## 相关链接
|
||
|
||
- [接口文档](../api-docs/integration/DataiIntegrationRealtimeSyncLogController/0001-realtime-sync-log-statistics.md) - 实时同步日志统计接口详细文档
|
||
- [实时同步统计接口](../api-docs/integration/DataiIntegrationRealtimeSyncController/0006-realtime-sync-statistics.md) - 实时同步服务统计接口
|
||
- [同步日志统计接口](../api-docs/integration/DataiIntegrationSyncLogController/0002-log-statistics.md) - 同步日志统计接口
|
||
|
||
## 发布人员
|
||
|
||
- **开发人员** - AI Assistant
|
||
- **测试人员** - 待定
|
||
|
||
## 审核信息
|
||
|
||
- **审核人员**: 待定
|
||
- **审核日期**: 待定
|
||
- **审核状态**: 待审核
|
||
- **审核意见**: 待审核
|