kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
85f71e1dc3
datai/datai-scenes/datai-scene-salesforce/docs/index.md
Kris 85f71e1dc3 feat: 实现数据同步进度跟踪功能 
- 新增 SyncProgress 实体类、ISyncProgressService 接口和 SyncProgressServiceImpl 实现类
- 在 DataiIntegrationObjectController 中添加 6 个进度查询接口：
  - 查询指定对象的同步进度
  - 查询所有正在同步的对象进度
  - 查询指定对象的插入进度
  - 查询所有正在插入的对象进度
  - 查询指定对象的更新进度
  - 查询所有正在更新的对象进度
- 在 DataiIntegrationObjectServiceImpl 中集成进度跟踪功能：
  - syncFullData 方法集成同步进度跟踪
  - syncIncrementalData 方法集成同步进度跟踪
  - insertObjectDataToTarget 方法集成插入进度跟踪
  - updateObjectDataToTarget 方法集成更新进度跟踪
- 进度信息存储在内存中（ConcurrentHashMap），任务完成后立即清除
- 新增 3 个需求文档（REQ-002、REQ-003、REQ-004）
- 新增 3 个架构决策记录（0002、0003、0004）
- 新增 3 个提示词文件（002、003、004）
- 新增 3 个会话记录
- 新增 3 个变更记录（0012、0013、0014）
- 新增 3 个复盘报告
- 新增 6 个 API 文档
- 更新 CHANGELOG.md 和 docs/index.md
2026-01-16 13:02:09 +08:00

15 KiB
Raw Blame History

单一真源文档中心

项目概述

本文件是 Salesforce 集成项目的单一真源入口，包含所有项目相关文档的链接清单。

文档目录

【视觉看板】

  • 架构图: Authentication.canvas - 项目架构视觉化展示，包含认证、集成、通用和配置模块的详细结构

1. 需求文档

2. 设计文档

3. 架构决策

4. 提示词库

5. 技能文档

6. 会话记录

6. 迭代复盘

7. 变更日志

8. 接口文档

9. SQL文件

10. 参考代码

  • 目录: reference-code/
  • 描述: 包含项目参考代码和示例实现
  • 参考代码:
    • data-dump: data-dump/ - 数据导出参考代码
    • salesforce-pubsub-realtime-sync: salesforce-pubsub-realtime-sync/ - Salesforce Pub/Sub 实时同步参考代码
      • 001-implement: 001-implement/ - 实时同步实现
        • realtime/ - 实时同步核心接口和实现
      • multicloudj组件: 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、处理事件、管理连接等功能的封装

11. 图片资源

协作基线文件

导航说明

  • 本文件是项目文档的唯一入口，所有文档变更必须在此添加链接
  • 文档间引用必须使用相对路径链接
  • 新文档必须使用相应目录中的模板文件

最后更新

  • 更新时间: 2026-01-16
  • 更新内容:
    • 新增 REQ-002 需求文档 - syncObjectData 同步进度跟踪
    • 新增 0002-sync-progress-tracking.md 架构决策记录 - syncObjectData 同步进度跟踪
    • 新增 002-sync-progress-tracking.md 提示词资产 - syncObjectData 同步进度跟踪实现
    • 新增 20260116-sync-progress-tracking.md 会话记录 - syncObjectData 同步进度跟踪实现
    • 新增 0012-sync-progress-tracking.md 变更记录 - syncObjectData 同步进度跟踪实现
    • 新增 20260116-sync-progress-tracking.md 复盘报告 - syncObjectData 同步进度跟踪实现复盘
    • 新增 5 个 Java 代码文件 - SyncProgress、ISyncProgressService、SyncProgressServiceImpl、DataiIntegrationObjectController（更新）、DataiIntegrationObjectServiceImpl（更新）
    • 新增 REQ-003 需求文档 - insertObjectDataToTarget 插入数据进度跟踪
    • 新增 0003-insert-progress-tracking.md 架构决策记录 - insertObjectDataToTarget 插入数据进度跟踪
    • 新增 003-insert-progress-tracking.md 提示词资产 - insertObjectDataToTarget 插入数据进度跟踪实现
    • 新增 20260116-insert-progress-tracking.md 会话记录 - insertObjectDataToTarget 插入数据进度跟踪实现
    • 新增 0013-insert-progress-tracking.md 变更记录 - insertObjectDataToTarget 插入数据进度跟踪实现
    • 新增 20260116-insert-progress-tracking-retro.md 复盘报告 - insertObjectDataToTarget 插入数据进度跟踪实现复盘
    • 更新 CHANGELOG.md - 添加 v0.1.13 版本变更
    • 更新 2 个 Java 代码文件 - DataiIntegrationObjectController（更新）、DataiIntegrationObjectServiceImpl（更新）
    • 新增 REQ-004 需求文档 - updateObjectDataToTarget 更新数据进度跟踪
    • 新增 0004-update-progress-tracking.md 架构决策记录 - updateObjectDataToTarget 更新数据进度跟踪
    • 新增 004-update-progress-tracking.md 提示词资产 - updateObjectDataToTarget 更新数据进度跟踪实现
    • 新增 20260116-update-progress-tracking.md 会话记录 - updateObjectDataToTarget 更新数据进度跟踪实现
    • 新增 0014-update-progress-tracking.md 变更记录 - updateObjectDataToTarget 更新数据进度跟踪实现
    • 新增 20260116-update-progress-tracking-retro.md 复盘报告 - updateObjectDataToTarget 更新数据进度跟踪实现复盘
    • 更新 CHANGELOG.md - 添加 v0.1.14 版本变更
    • 更新 2 个 Java 代码文件 - DataiIntegrationObjectController（更新）、DataiIntegrationObjectServiceImpl（更新）
    • 新增 2 个 API 文档 - 0014-query-update-progress.md、0015-query-all-update-progress.md