- 新增 4 个定时任务类: - ObjectSyncTask: 对象自动同步任务 - ObjectInsertTask: 对象自动插入任务 - ObjectUpdateTask: 对象自动更新任务 - MetadataChangeAutoSyncTask: 元数据变更自动同步任务 - 新增 2 个多对象操作接口: - insertMultipleObjectDataToTarget: 批量插入对象数据到目标系统 - updateMultipleObjectDataToTarget: 批量更新对象数据到目标系统 - 新增完整的定时任务文档: - task/index.md: 定时任务文档索引 - ObjectSyncTask.md: 对象自动同步任务文档 - ObjectInsertTask.md: 对象自动插入任务文档 - ObjectUpdateTask.md: 对象自动更新任务文档 - MetadataChangeAutoSyncTask.md: 元数据变更自动同步任务文档 - RateLimitResetTask.md: 每日限流重置任务文档 - 新增 API 文档索引:api-docs/index.md - 更新唯一真源文档中心:docs/index.md - 新增完整的项目文档: - REQ-005.md: 定时任务自动同步、插入和更新对象数据需求 - REQ-006.md: 元数据变更自动同步本地数据库需求 - 0005-scheduled-tasks-implementation.md: 定时任务架构决策 - 0006-metadata-change-auto-sync.md: 元数据变更自动同步架构决策 - 005-scheduled-tasks-implementation.md: 定时任务实现提示词 - 006-metadata-change-auto-sync.md: 元数据变更自动同步实现提示词 - 20260116-scheduled-tasks-implementation.md: 定时任务实现会话记录 - 20260116-metadata-change-auto-sync.md: 元数据变更自动同步实现会话记录 - 20260116-scheduled-tasks-implementation-retro.md: 定时任务实现复盘 - 20260116-metadata-change-auto-sync-retro.md: 元数据变更自动同步实现复盘 - 0015-scheduled-tasks-implementation.md: 定时任务变更记录 - 0016-metadata-change-auto-sync.md: 元数据变更自动同步变更记录 - 更新 CHANGELOG.md 和 README.md
19 KiB
19 KiB
单一真源文档中心
项目概述
本文件是 Salesforce 集成项目的单一真源入口,包含所有项目相关文档的链接清单。
文档目录
【视觉看板】
- 架构图: Authentication.canvas - 项目架构视觉化展示,包含认证、集成、通用和配置模块的详细结构
1. 需求文档
- 目录: requirements/
- 描述: 包含项目的功能需求、非功能需求和验收标准
- 需求文档:
- 0001-salesforce-realtime-sync.md - Salesforce数据及时同步至本地数据库
- REQ-002.md - syncObjectData 同步进度跟踪
- REQ-003.md - insertObjectDataToTarget 插入数据进度跟踪
- REQ-004.md - updateObjectDataToTarget 更新数据进度跟踪
- REQ-005.md - 定时任务自动同步、插入和更新对象数据
- REQ-006.md - 元数据变更自动同步本地数据库
- 0000-template.md - 需求文档模板
2. 设计文档
- 目录: design/
- 描述: 包含系统架构设计、模块设计和接口设计
- 设计文档:
- 0001-salesforce-cdc-realtime-sync.md - Salesforce CDC实时同步设计
- 0000-template.md - 设计文档模板
3. 架构决策
- 目录: decisions/adr/
- 描述: 包含架构决策记录 (ADR),记录重要的架构决策过程
- ADR文档:
- 0001-salesforce-cdc-sync.md - Salesforce CDC同步方案
- 0002-sync-progress-tracking.md - syncObjectData 同步进度跟踪
- 0003-insert-progress-tracking.md - insertObjectDataToTarget 插入数据进度跟踪
- 0004-update-progress-tracking.md - updateObjectDataToTarget 更新数据进度跟踪
- 0005-scheduled-tasks-implementation.md - 定时任务自动同步、插入和更新对象数据
- 0006-metadata-change-auto-sync.md - 元数据变更自动同步本地数据库
- 0000-template.md - ADR文档模板
4. 提示词库
- 目录: prompts/
- 描述: 包含 AI 提示词模板和最佳实践
- 模板: 0000-template.md
-- 提示词文件:
- 01创建白板提示词.md
- 02白板优化提示词.md
- 03-创建工作流提示词.md
- 04工作流整合白板提示词.md
- 05创建项目规则提示词.md
- 06更新当前项目README说明文档.md - 更新项目README文档的提示词
- 07生成技能书提示词.md - 生成技能书提示词
- 002-sync-progress-tracking.md - syncObjectData 同步进度跟踪实现提示词
- 003-insert-progress-tracking.md - insertObjectDataToTarget 插入数据进度跟踪实现提示词
- 004-update-progress-tracking.md - updateObjectDataToTarget 更新数据进度跟踪实现提示词
- 005-scheduled-tasks-implementation.md - 定时任务自动同步、插入和更新对象数据实现提示词
- 006-metadata-change-auto-sync.md - 元数据变更自动同步本地数据库实现提示词
5. 技能文档
- 目录: skill/
- 描述: 包含项目开发所需的技能文档,指导 AI 完成特定开发任务
- 技能文档:
- 0001-bootstrap-workflow.md - 项目协作基线初始化技能
- 0002-establish-ssot-hub.md - 建立真源中心技能
- 0003-setup-information-architecture.md - 落地信息架构技能
- 0004-define-requirements.md - 需求定义与入库技能
- 0005-architecture-decision.md - 架构决策技能
- 0006-prompt-engineering.md - 提示词资产化技能
- 0007-context-anchoring.md - 上下文锚定技能
- 0008-execution-logging.md - 执行与记录技能
- 0009-changelog-archiving.md - 变更记录与归档技能
- 0010-retrospective.md - 闭环复盘技能
- 0011-verification-commit.md - 测试与版本提交技能
6. 会话记录
- 目录: sessions/
- 描述: 包含每次重要操作的会话记录
- 会话记录:
- 20260116-sync-progress-tracking.md - syncObjectData 同步进度跟踪实现
- 20260116-insert-progress-tracking.md - insertObjectDataToTarget 插入数据进度跟踪实现
- 20260116-update-progress-tracking.md - updateObjectDataToTarget 更新数据进度跟踪实现
- 20260116-scheduled-tasks-implementation.md - 定时任务自动同步、插入和更新对象数据实现
- 20260116-metadata-change-auto-sync.md - 元数据变更自动同步本地数据库实现
- 20260109-salesforce-cdc-sync.md - Salesforce CDC实时同步实现
- YYYYMMDD-template.md - 会话记录模板
6. 迭代复盘
- 目录: retros/
- 描述: 包含每个迭代的复盘报告
- 复盘报告:
- 20260116-sync-progress-tracking.md - syncObjectData 同步进度跟踪实现复盘
- 20260116-insert-progress-tracking-retro.md - insertObjectDataToTarget 插入数据进度跟踪实现复盘
- 20260116-update-progress-tracking-retro.md - updateObjectDataToTarget 更新数据进度跟踪实现复盘
- 20260116-scheduled-tasks-implementation-retro.md - 定时任务自动同步、插入和更新对象数据实现复盘
- 20260116-metadata-change-auto-sync-retro.md - 元数据变更自动同步本地数据库实现复盘
- YYYYMMDD-template.md - 复盘报告模板
7. 变更日志
- 目录: changelog/
- 描述: 包含详细的变更记录
- 变更记录文档:
- 0001-core-components-implementation.md - 核心组件实现
- 0002-database-structure-adjustment.md - 数据库结构调整
- 0003-sync-configuration-management.md - 同步配置管理实现
- 0004-realtime-sync-log-enhancement.md - 实时同步日志功能完善
- 0005-testing-and-verification.md - 测试和验证
- 0006-documentation-improvement.md - 文档完善
- 0007-pubsub-api-implementation.md - Salesforce Pub/Sub API 实时同步功能实现
- 0008-pubsub-config-optimization.md - Pub/Sub API 配置项添加与连接工厂优化
- 0009-realtime-service-manual-start.md - 实时服务手动启动管理
- 0010-realtime-sync-statistics.md - 实时同步统计接口
- 0011-target-org-login-functionality.md - 目标ORG登录功能实现
- 0012-sync-progress-tracking.md - syncObjectData 同步进度跟踪实现
- 0013-insert-progress-tracking.md - insertObjectDataToTarget 插入数据进度跟踪实现
- 0014-update-progress-tracking.md - updateObjectDataToTarget 更新数据进度跟踪实现
- 0015-scheduled-tasks-implementation.md - 定时任务自动同步、插入和更新对象数据实现
- 0016-metadata-change-auto-sync.md - 元数据变更自动同步本地数据库实现
- 0000-template.md - 变更记录模板
8. 接口文档
- 目录: api-docs/
- 描述: 包含提供给前端调用的接口文档和定时任务文档
- 模块索引:
- API 文档索引 - 所有接口和定时任务的索引
- Setting 模块接口索引 - 配置管理相关接口索引
- 定时任务文档索引 - 定时任务文档索引
- 接口文档:
- DataISfLoginController - Salesforce登录认证接口
- DataiIntegrationRealtimeSyncController - 实时同步服务管理接口
- DataiIntegrationObjectController - 对象同步控制接口(新增进度查询接口)
- DataiIntegrationBatchController - 批次同步控制接口
- DataiIntegrationMetadataChangeController - 元数据变更控制接口
- RealtimeServiceController - 实时服务管理接口
- DataiConfigAuditLogController - 配置审计日志管理接口
- DataiConfigEnvironmentController - 配置环境管理接口
- DataiConfigSnapshotController - 配置快照管理接口
- DataiConfigurationController - 配置管理接口
- SysJobController - 定时任务管理接口
- SysJobLogController - 定时任务日志管理接口
- 定时任务文档:
- ObjectSyncTask - 对象自动同步任务
- ObjectInsertTask - 对象自动插入任务
- ObjectUpdateTask - 对象自动更新任务
- MetadataChangeAutoSyncTask - 元数据变更自动同步任务
- RateLimitResetTask - 每日限流重置任务
9. SQL文件
- 目录: sql/
- 描述: 包含数据库结构和初始化SQL文件
- SQL文件:
- create-realtime-sync-log-table.sql - 实时同步日志表创建SQL
- add_is_realtime_sync_column.sql - 添加实时同步列SQL
- add_is_partitioned_column.sql - 添加分区列SQL
- datai_table.sql - 数据表初始化SQL
10. 参考代码
- 目录: reference-code/
- 描述: 包含项目参考代码和示例实现
- 参考代码:
- data-dump: data-dump/ - 数据导出参考代码
- CommonServiceImpl.java - Salesforce 数据插入逻辑参考
- DataImportNewServiceImpl.java - 数据导入服务实现参考
- 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、处理事件、管理连接等功能的封装
- 来源: 从
- 001-implement: 001-implement/ - 实时同步实现
- data-dump: data-dump/ - 数据导出参考代码
11. 图片资源
- 目录: picture/
- 描述: 包含项目相关的图片资源
- 图片文件:
协作基线文件
- README.md: ../README.md - 项目目标和真源入口
- CONTRIBUTING.md: ../CONTRIBUTING.md - 协作规则
- CHANGELOG.md: ../CHANGELOG.md - 变更摘要
导航说明
- 本文件是项目文档的唯一入口,所有文档变更必须在此添加链接
- 文档间引用必须使用相对路径链接
- 新文档必须使用相应目录中的模板文件
最后更新
- 更新时间: 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
- 新增 2 个接口 - insertMultipleObjectDataToTarget、updateMultipleObjectDataToTarget
- 新增 2 个 API 文档 - 0016-insert-multiple-object-data-to-target.md、0017-update-multiple-object-data-to-target.md
- 更新 2 个 Java 代码文件 - DataiIntegrationObjectController(更新)、IDataiIntegrationObjectService(更新)、DataiIntegrationObjectServiceImpl(更新)
- 新增 REQ-005 需求文档 - 定时任务自动同步、插入和更新对象数据
- 新增 0005-scheduled-tasks-implementation.md 架构决策记录 - 定时任务自动同步、插入和更新对象数据
- 新增 005-scheduled-tasks-implementation.md 提示词资产 - 定时任务自动同步、插入和更新对象数据实现
- 新增 20260116-scheduled-tasks-implementation.md 会话记录 - 定时任务自动同步、插入和更新对象数据实现
- 新增 0015-scheduled-tasks-implementation.md 变更记录 - 定时任务自动同步、插入和更新对象数据实现
- 新增 20260116-scheduled-tasks-implementation-retro.md 复盘报告 - 定时任务自动同步、插入和更新对象数据实现复盘
- 新增 3 个 Java 代码文件 - ObjectSyncTask、ObjectInsertTask、ObjectUpdateTask
- 新增 REQ-006 需求文档 - 元数据变更自动同步本地数据库
- 新增 0006-metadata-change-auto-sync.md 架构决策记录 - 元数据变更自动同步本地数据库
- 新增 006-metadata-change-auto-sync.md 提示词资产 - 元数据变更自动同步本地数据库实现
- 新增 20260116-metadata-change-auto-sync.md 会话记录 - 元数据变更自动同步本地数据库实现
- 新增 0016-metadata-change-auto-sync.md 变更记录 - 元数据变更自动同步本地数据库实现
- 新增 20260116-metadata-change-auto-sync-retro.md 复盘报告 - 元数据变更自动同步本地数据库实现复盘
- 新增 1 个 Java 代码文件 - MetadataChangeAutoSyncTask
- 新增 6 个定时任务文档 - index.md、ObjectSyncTask.md、ObjectInsertTask.md、ObjectUpdateTask.md、MetadataChangeAutoSyncTask.md、RateLimitResetTask.md
- 新增 1 个 API 文档索引 - index.md
- 更新唯一真源文档中心 - 添加定时任务文档链接