kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ccc7109c31
datai/datai-scenes/datai-scene-salesforce/docs/index.md
Kris ccc7109c31 feat(salesforce-integration): 完善实时同步和统计功能 
主要变更：
- 新增实时同步日志统计接口，支持多维度统计（综合、对象、操作类型、状态、时间趋势）
- 新增实时同步统计接口，提供服务状态、对象统计和订阅统计
- 实现实时服务手动启动管理，移除自动启动注解
- 移除所有统计相关功能（EventProcessor、DataSynchronizer统计方法）
- 解决DataiIntegrationObjectServiceImpl和ObjectRegistryImpl循环依赖问题
- 完善元数据变更统计功能，支持自动时间范围和缺失数据点填充
- 修复SQL布尔值兼容性问题（true/false改为1/0）
- 新增SysJobController和SysJobLogController接口文档
- 更新项目文档和变更日志

技术细节：
- 添加@Lazy注解解决循环依赖
- 实现时间趋势统计的自动时间范围处理
- 支持多种时间单位（天、周、月、季度）的趋势分析
- 优化同步成功率计算和数据处理完整性
- 遵循项目文档规范，更新唯一真源
2026-01-13 13:51:33 +08:00

135 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 单一真源文档中心
## 项目概述
本文件是 Salesforce 集成项目的单一真源入口，包含所有项目相关文档的链接清单。
## 文档目录
### 【视觉看板】
- **架构图**: [Authentication.canvas](../Authentication.canvas) - 项目架构视觉化展示，包含认证、集成、通用和配置模块的详细结构
### 1. 需求文档
- **目录**: [requirements/](requirements/)
- **描述**: 包含项目的功能需求、非功能需求和验收标准
- **需求文档**:
- [0001-salesforce-realtime-sync.md](requirements/0001-salesforce-realtime-sync.md) - Salesforce数据及时同步至本地数据库
- [0000-template.md](requirements/0000-template.md) - 需求文档模板
### 2. 设计文档
- **目录**: [design/](design/)
- **描述**: 包含系统架构设计、模块设计和接口设计
- **设计文档**:
- [0001-salesforce-cdc-realtime-sync.md](design/0001-salesforce-cdc-realtime-sync.md) - Salesforce CDC实时同步设计
- [0000-template.md](design/0000-template.md) - 设计文档模板
### 3. 架构决策
- **目录**: [decisions/adr/](decisions/adr/)
- **描述**: 包含架构决策记录 (ADR)，记录重要的架构决策过程
- **ADR文档**:
- [0001-salesforce-cdc-sync.md](decisions/adr/0001-salesforce-cdc-sync.md) - Salesforce CDC同步方案
- [0000-template.md](decisions/adr/0000-template.md) - ADR文档模板
### 4. 提示词库
- **目录**: [prompts/](prompts/)
- **描述**: 包含 AI 提示词模板和最佳实践
- **模板**: [0000-template.md](prompts/0000-template.md)
- **提示词文件**:
- [01创建白板提示词.md](prompts/01创建白板提示词.md)
- [02白板优化提示词.md](prompts/02白板优化提示词.md)
- [03创建工作流提示词.md](prompts/03创建工作流提示词.md)
- [04工作流整合白板提示词.md](prompts/04工作流整合白板提示词.md)
- [05创建项目规则提示词.md](prompts/05创建项目规则提示词.md)
### 6. 会话记录
- **目录**: [sessions/](sessions/)
- **描述**: 包含每次重要操作的会话记录
- **会话记录**:
- [20260109-salesforce-cdc-sync.md](sessions/20260109-salesforce-cdc-sync.md) - Salesforce CDC实时同步实现
- [YYYYMMDD-template.md](sessions/YYYYMMDD-template.md) - 会话记录模板
### 6. 迭代复盘
- **目录**: [retros/](retros/)
- **描述**: 包含每个迭代的复盘报告
- **模板**: [YYYYMMDD-template.md](retros/YYYYMMDD-template.md)
### 7. 变更日志
- **目录**: [changelog/](changelog/)
- **描述**: 包含详细的变更记录
- **变更记录文档**:
- [0001-core-components-implementation.md](changelog/0001-core-components-implementation.md) - 核心组件实现
- [0002-database-structure-adjustment.md](changelog/0002-database-structure-adjustment.md) - 数据库结构调整
- [0003-sync-configuration-management.md](changelog/0003-sync-configuration-management.md) - 同步配置管理实现
- [0004-realtime-sync-log-enhancement.md](changelog/0004-realtime-sync-log-enhancement.md) - 实时同步日志功能完善
- [0005-testing-and-verification.md](changelog/0005-testing-and-verification.md) - 测试和验证
- [0006-documentation-improvement.md](changelog/0006-documentation-improvement.md) - 文档完善
- [0007-pubsub-api-implementation.md](changelog/0007-pubsub-api-implementation.md) - Salesforce Pub/Sub API 实时同步功能实现
- [0008-pubsub-config-optimization.md](changelog/0008-pubsub-config-optimization.md) - Pub/Sub API 配置项添加与连接工厂优化
- [0009-realtime-service-manual-start.md](changelog/0009-realtime-service-manual-start.md) - 实时服务手动启动管理
- [0010-realtime-sync-statistics.md](changelog/0010-realtime-sync-statistics.md) - 实时同步统计接口
- [0011-realtime-sync-log-statistics.md](changelog/0011-realtime-sync-log-statistics.md) - 实时同步日志统计功能
- [0000-template.md](changelog/0000-template.md) - 变更记录模板
### 8. 接口文档
- **目录**: [api-docs/](api-docs/)
- **描述**: 包含提供给前端调用的接口文档
- **接口文档**:
- [DataiIntegrationRealtimeSyncController](api-docs/integration/DataiIntegrationRealtimeSyncController/) - 实时同步服务管理接口
- [DataiIntegrationRealtimeSyncLogController](api-docs/integration/DataiIntegrationRealtimeSyncLogController/) - 实时同步日志管理接口
- [DataiIntegrationObjectController](api-docs/integration/DataiIntegrationObjectController/) - 对象同步控制接口
- [DataiIntegrationBatchController](api-docs/integration/DataiIntegrationBatchController/) - 批次同步控制接口
- [DataiIntegrationMetadataChangeController](api-docs/integration/DataiIntegrationMetadataChangeController/) - 元数据变更控制接口
- [RealtimeServiceController](api-docs/integration/RealtimeServiceController/) - 实时服务管理接口
- [SysJobController](api-docs/monitor/SysJobController/) - 定时任务管理接口
- [SysJobLogController](api-docs/monitor/SysJobLogController/) - 定时任务日志管理接口
### 9. SQL文件
- **目录**: [sql/](sql/)
- **描述**: 包含数据库结构和初始化SQL文件
- **SQL文件**:
- [create-realtime-sync-log-table.sql](sql/create-realtime-sync-log-table.sql) - 实时同步日志表创建SQL
- [add_is_realtime_sync_column.sql](sql/add_is_realtime_sync_column.sql) - 添加实时同步列SQL
- [add_is_partitioned_column.sql](sql/add_is_partitioned_column.sql) - 添加分区列SQL
- [datai_table.sql](sql/datai_table.sql) - 数据表初始化SQL
### 10. 参考代码
- **目录**: [reference-code/](reference-code/)
- **描述**: 包含项目参考代码和示例实现
- **组件详情**:
- **multicloudj组件**: [salesforce-pubsub-realtime-sync/multicloudj](reference-code/salesforce-pubsub-realtime-sync/multicloudj/)
- **来源**: 从 `com.salesforce.multicloudj:pubsub-client:0.2.10` 依赖编译而来
- **包含模块**:
- multicloudj-common-0.2.10: 通用异常处理和工具类
- pubsub-client-0.2.10: Pub/Sub API 客户端实现
- sts-client-0.2.10: STS 客户端实现
- **使用说明**: 往后直接使用 `com.salesforce.multicloudj:pubsub-client:0.2.10` 依赖，可参考此组件中的代码实现
- **核心功能**: 提供了订阅 Salesforce Event Bus、处理事件、管理连接等功能的封装
## 协作基线文件
- **README.md**: [../README.md](../README.md) - 项目目标和真源入口
- **CONTRIBUTING.md**: [../CONTRIBUTING.md](../CONTRIBUTING.md) - 协作规则
- **CHANGELOG.md**: [../CHANGELOG.md](../CHANGELOG.md) - 变更摘要
## 导航说明
- 本文件是项目文档的唯一入口，所有文档变更必须在此添加链接
- 文档间引用必须使用相对路径链接
- 新文档必须使用相应目录中的模板文件
## 最后更新
- 更新时间: 2026-01-13
- 更新内容: 新增实时同步日志统计功能，在DataiIntegrationRealtimeSyncLogController中添加/integration/realtimelog/statistics接口，支持综合统计、按对象统计、按操作类型统计、按状态统计和按时间趋势统计等多种维度；更新Mapper接口和XML文件，新增5个统计查询方法；更新Service接口和实现类，实现完整的统计业务逻辑；创建接口文档0001-realtime-sync-log-statistics.md；创建变更记录0011-realtime-sync-log-statistics.md；更新文档索引
Reference in New Issue View Git Blame Copy Permalink