Kris
ccc7109c31
主要变更： - 新增实时同步日志统计接口，支持多维度统计（综合、对象、操作类型、状态、时间趋势） - 新增实时同步统计接口，提供服务状态、对象统计和订阅统计 - 实现实时服务手动启动管理，移除自动启动注解 - 移除所有统计相关功能（EventProcessor、DataSynchronizer统计方法） - 解决DataiIntegrationObjectServiceImpl和ObjectRegistryImpl循环依赖问题 - 完善元数据变更统计功能，支持自动时间范围和缺失数据点填充 - 修复SQL布尔值兼容性问题（true/false改为1/0） - 新增SysJobController和SysJobLogController接口文档 - 更新项目文档和变更日志 技术细节： - 添加@Lazy注解解决循环依赖 - 实现时间趋势统计的自动时间范围处理 - 支持多种时间单位（天、周、月、季度）的趋势分析 - 优化同步成功率计算和数据处理完整性 - 遵循项目文档规范，更新唯一真源
4.8 KiB
4.8 KiB
变更记录 - 实时同步日志统计功能
变更信息
- 版本号: 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 权限
- 数据库表结构无变更，仅新增查询方法
升级指南
升级步骤
- 部署更新后的代码到生产环境
- 确保数据库连接正常，Mapper XML 文件已正确部署
- 为需要的用户或角色分配 integration:realtimelog:statistics 权限
- 验证统计接口功能是否正常
注意事项
- 统计接口对大数据量查询可能需要较长时间，建议合理设置时间范围
- 时间趋势统计会生成完整的时间序列数据，查询时间范围不宜过大
- 建议为相关数据库字段创建索引以提高查询性能
测试信息
测试环境
- 开发环境 - 本地开发环境，MySQL 8.0 数据库
- 测试环境 - 测试服务器，MySQL 8.0 数据库
测试结果
- 综合统计测试 - 通过，正确返回综合统计数据
- 对象统计测试 - 通过，正确按对象分组统计
- 操作类型统计测试 - 通过，正确按操作类型分组统计
- 状态统计测试 - 通过，正确按状态分组统计
- 时间趋势统计测试 - 通过，正确按时间单位统计并填充缺失数据
- 过滤条件测试 - 通过，正确应用各种过滤条件
- 时间格式测试 - 通过，支持日期和日期时间两种格式
- 异常处理测试 - 通过，正确处理时间格式错误等异常情况
相关链接
发布人员
- 开发人员 - AI Assistant
- 测试人员 - 待定
审核信息
- 审核人员: 待定
- 审核日期: 待定
- 审核状态: 待审核
- 审核意见: 待审核