2026-01-07 23:11:44 +08:00
|
|
|
|
# 单一真源文档中心
|
|
|
|
|
|
|
2026-01-08 19:52:43 +08:00
|
|
|
|
## 项目概述
|
|
|
|
|
|
|
|
|
|
|
|
本文件是 Salesforce 集成项目的单一真源入口,包含所有项目相关文档的链接清单。
|
|
|
|
|
|
|
|
|
|
|
|
## 文档目录
|
|
|
|
|
|
|
|
|
|
|
|
### 【视觉看板】
|
|
|
|
|
|
|
|
|
|
|
|
- **架构图**: [Authentication.canvas](../Authentication.canvas) - 项目架构视觉化展示,包含认证、集成、通用和配置模块的详细结构
|
|
|
|
|
|
|
|
|
|
|
|
### 1. 需求文档
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [requirements/](requirements/)
|
|
|
|
|
|
- **描述**: 包含项目的功能需求、非功能需求和验收标准
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **需求文档**:
|
|
|
|
|
|
- [0001-salesforce-realtime-sync.md](requirements/0001-salesforce-realtime-sync.md) - Salesforce数据及时同步至本地数据库
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [REQ-002.md](requirements/REQ-002.md) - syncObjectData 同步进度跟踪
|
|
|
|
|
|
- [REQ-003.md](requirements/REQ-003.md) - insertObjectDataToTarget 插入数据进度跟踪
|
|
|
|
|
|
- [REQ-004.md](requirements/REQ-004.md) - updateObjectDataToTarget 更新数据进度跟踪
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [REQ-005.md](requirements/REQ-005.md) - 定时任务自动同步、插入和更新对象数据
|
|
|
|
|
|
- [REQ-006.md](requirements/REQ-006.md) - 元数据变更自动同步本地数据库
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [REQ-007.md](requirements/REQ-007.md) - 查询不同类型ORG登录历史及自动登录功能
|
|
|
|
|
|
- [REQ-008.md](requirements/REQ-008.md) - datai-salesforce-auth 模块立即修复事项
|
|
|
|
|
|
- [REQ-009.md](requirements/REQ-009.md) - 元数据拉取和部署功能实现
|
|
|
|
|
|
- [REQ-010.md](requirements/REQ-010.md) - Salesforce元数据拉取和部署
|
|
|
|
|
|
- [010-metadata-retrieve-deploy-sub-requirements.md](requirements/010-metadata-retrieve-deploy-sub-requirements.md) - REQ-010子需求拆分文档
|
|
|
|
|
|
- **REQ-010子需求文档**:
|
|
|
|
|
|
- [REQ-010-1.md](requirements/REQ-010-1.md) - 数据库表结构设计和创建 [已完成]
|
|
|
|
|
|
- [REQ-010-2.md](requirements/REQ-010-2.md) - 基础实体类和Mapper创建 [阶段2-架构决策]
|
|
|
|
|
|
- [REQ-010-3.md](requirements/REQ-010-3.md) - Salesforce组织配置管理
|
|
|
|
|
|
- [REQ-010-4.md](requirements/REQ-010-4.md) - 元数据任务定义管理
|
|
|
|
|
|
- [REQ-010-5.md](requirements/REQ-010-5.md) - Metadata API客户端封装
|
|
|
|
|
|
- [REQ-010-6.md](requirements/REQ-010-6.md) - 元数据拉取核心功能
|
|
|
|
|
|
- [REQ-010-7.md](requirements/REQ-010-7.md) - 文件存储和解压处理
|
|
|
|
|
|
- [REQ-010-8.md](requirements/REQ-010-8.md) - 元数据部署核心功能
|
|
|
|
|
|
- [REQ-010-9.md](requirements/REQ-010-9.md) - Quick Deploy功能实现
|
|
|
|
|
|
- [REQ-010-10.md](requirements/REQ-010-10.md) - Destructive Changes功能实现
|
|
|
|
|
|
- [REQ-010-11.md](requirements/REQ-010-11.md) - 元数据组件索引和查询
|
|
|
|
|
|
- [REQ-010-12.md](requirements/REQ-010-12.md) - 文件哈希对比和增量检测
|
|
|
|
|
|
- [REQ-010-13.md](requirements/REQ-010-13.md) - 版本回溯功能
|
|
|
|
|
|
- [REQ-010-14.md](requirements/REQ-010-14.md) - 作业执行监控
|
|
|
|
|
|
- [REQ-010-15.md](requirements/REQ-010-15.md) - 详细日志记录和查询
|
|
|
|
|
|
- [REQ-010-16.md](requirements/REQ-010-16.md) - 异常处理机制完善
|
|
|
|
|
|
- [REQ-010-17.md](requirements/REQ-010-17.md) - 性能优化和限流处理
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [0000-template.md](requirements/0000-template.md) - 需求文档模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
### 2. 设计文档
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [design/](design/)
|
|
|
|
|
|
- **描述**: 包含系统架构设计、模块设计和接口设计
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **设计文档**:
|
|
|
|
|
|
- [0001-salesforce-cdc-realtime-sync.md](design/0001-salesforce-cdc-realtime-sync.md) - Salesforce CDC实时同步设计
|
|
|
|
|
|
- [0000-template.md](design/0000-template.md) - 设计文档模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
### 3. 架构决策
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [decisions/adr/](decisions/adr/)
|
|
|
|
|
|
- **描述**: 包含架构决策记录 (ADR),记录重要的架构决策过程
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **ADR文档**:
|
|
|
|
|
|
- [0001-salesforce-cdc-sync.md](decisions/adr/0001-salesforce-cdc-sync.md) - Salesforce CDC同步方案
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [0002-sync-progress-tracking.md](decisions/adr/0002-sync-progress-tracking.md) - syncObjectData 同步进度跟踪
|
|
|
|
|
|
- [0003-insert-progress-tracking.md](decisions/adr/0003-insert-progress-tracking.md) - insertObjectDataToTarget 插入数据进度跟踪
|
|
|
|
|
|
- [0004-update-progress-tracking.md](decisions/adr/0004-update-progress-tracking.md) - updateObjectDataToTarget 更新数据进度跟踪
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [0005-scheduled-tasks-implementation.md](decisions/adr/0005-scheduled-tasks-implementation.md) - 定时任务自动同步、插入和更新对象数据
|
|
|
|
|
|
- [0006-metadata-change-auto-sync.md](decisions/adr/0006-metadata-change-auto-sync.md) - 元数据变更自动同步本地数据库
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [0007-login-history-query-and-auto-login.md](decisions/adr/0007-login-history-query-and-auto-login.md) - 查询不同类型ORG登录历史及自动登录功能
|
|
|
|
|
|
- [0008-datai-salesforce-auth-immediate-fixes.md](decisions/adr/0008-datai-salesforce-auth-immediate-fixes.md) - datai-salesforce-auth 模块立即修复事项
|
|
|
|
|
|
- [0009-metadata-retrieve-deploy.md](decisions/adr/0009-metadata-retrieve-deploy.md) - 元数据拉取和部署功能实现
|
|
|
|
|
|
- [0010-database-table-design.md](decisions/adr/0010-database-table-design.md) - 数据库表结构设计和创建
|
|
|
|
|
|
- [0011-entity-mapper-create.md](decisions/adr/0011-entity-mapper-create.md) - 基础实体类和 Mapper 创建
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [0000-template.md](decisions/adr/0000-template.md) - ADR文档模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
### 4. 提示词库
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [prompts/](prompts/)
|
|
|
|
|
|
- **描述**: 包含 AI 提示词模板和最佳实践
|
|
|
|
|
|
- **模板**: [0000-template.md](prompts/0000-template.md)
|
2026-01-16 13:02:09 +08:00
|
|
|
|
-- **提示词文件**:
|
2026-01-08 20:07:14 +08:00
|
|
|
|
- [01创建白板提示词.md](prompts/01创建白板提示词.md)
|
|
|
|
|
|
- [02白板优化提示词.md](prompts/02白板优化提示词.md)
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [03-创建工作流提示词.md](prompts/03-创建工作流提示词.md)
|
2026-01-08 20:07:14 +08:00
|
|
|
|
- [04工作流整合白板提示词.md](prompts/04工作流整合白板提示词.md)
|
|
|
|
|
|
- [05创建项目规则提示词.md](prompts/05创建项目规则提示词.md)
|
2026-01-14 17:24:57 +08:00
|
|
|
|
- [06更新当前项目README说明文档.md](prompts/06更新当前项目README说明文档.md) - 更新项目README文档的提示词
|
2026-01-15 14:09:15 +08:00
|
|
|
|
- [07生成技能书提示词.md](prompts/07生成技能书提示词.md) - 生成技能书提示词
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [002-sync-progress-tracking.md](prompts/002-sync-progress-tracking.md) - syncObjectData 同步进度跟踪实现提示词
|
|
|
|
|
|
- [003-insert-progress-tracking.md](prompts/003-insert-progress-tracking.md) - insertObjectDataToTarget 插入数据进度跟踪实现提示词
|
|
|
|
|
|
- [004-update-progress-tracking.md](prompts/004-update-progress-tracking.md) - updateObjectDataToTarget 更新数据进度跟踪实现提示词
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [005-scheduled-tasks-implementation.md](prompts/005-scheduled-tasks-implementation.md) - 定时任务自动同步、插入和更新对象数据实现提示词
|
|
|
|
|
|
- [006-metadata-change-auto-sync.md](prompts/006-metadata-change-auto-sync.md) - 元数据变更自动同步本地数据库实现提示词
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [007-login-history-query-and-auto-login.md](prompts/007-login-history-query-and-auto-login.md) - 查询不同类型ORG登录历史及自动登录功能实现提示词
|
|
|
|
|
|
- [008-datai-salesforce-auth-immediate-fixes.md](prompts/008-datai-salesforce-auth-immediate-fixes.md) - datai-salesforce-auth 模块立即修复实现提示词
|
|
|
|
|
|
- [009-metadata-retrieve-deploy.md](prompts/009-metadata-retrieve-deploy.md) - 元数据拉取和部署功能实现提示词
|
|
|
|
|
|
- [010-metadata-retrieve-deploy-split-requirements.md](prompts/010-metadata-retrieve-deploy-split-requirements.md) - 拆分Salesforce元数据拉取和部署子需求提示词
|
|
|
|
|
|
- [011-database-table-design-create.md](prompts/011-database-table-design-create.md) - 数据库表结构设计和创建实现提示词
|
2026-01-15 14:09:15 +08:00
|
|
|
|
|
|
|
|
|
|
### 5. 技能文档
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [skill/](skill/)
|
|
|
|
|
|
- **描述**: 包含项目开发所需的技能文档,指导 AI 完成特定开发任务
|
|
|
|
|
|
- **技能文档**:
|
|
|
|
|
|
- [0001-bootstrap-workflow.md](skill/0001-bootstrap-workflow.md) - 项目协作基线初始化技能
|
|
|
|
|
|
- [0002-establish-ssot-hub.md](skill/0002-establish-ssot-hub.md) - 建立真源中心技能
|
|
|
|
|
|
- [0003-setup-information-architecture.md](skill/0003-setup-information-architecture.md) - 落地信息架构技能
|
|
|
|
|
|
- [0004-define-requirements.md](skill/0004-define-requirements.md) - 需求定义与入库技能
|
|
|
|
|
|
- [0005-architecture-decision.md](skill/0005-architecture-decision.md) - 架构决策技能
|
|
|
|
|
|
- [0006-prompt-engineering.md](skill/0006-prompt-engineering.md) - 提示词资产化技能
|
|
|
|
|
|
- [0007-context-anchoring.md](skill/0007-context-anchoring.md) - 上下文锚定技能
|
|
|
|
|
|
- [0008-execution-logging.md](skill/0008-execution-logging.md) - 执行与记录技能
|
|
|
|
|
|
- [0009-changelog-archiving.md](skill/0009-changelog-archiving.md) - 变更记录与归档技能
|
|
|
|
|
|
- [0010-retrospective.md](skill/0010-retrospective.md) - 闭环复盘技能
|
|
|
|
|
|
- [0011-verification-commit.md](skill/0011-verification-commit.md) - 测试与版本提交技能
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
2026-01-12 10:31:25 +08:00
|
|
|
|
### 6. 会话记录
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
- **目录**: [sessions/](sessions/)
|
|
|
|
|
|
- **描述**: 包含每次重要操作的会话记录
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **会话记录**:
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [20260116-sync-progress-tracking.md](sessions/20260116-sync-progress-tracking.md) - syncObjectData 同步进度跟踪实现
|
|
|
|
|
|
- [20260116-insert-progress-tracking.md](sessions/20260116-insert-progress-tracking.md) - insertObjectDataToTarget 插入数据进度跟踪实现
|
|
|
|
|
|
- [20260116-update-progress-tracking.md](sessions/20260116-update-progress-tracking.md) - updateObjectDataToTarget 更新数据进度跟踪实现
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [20260116-scheduled-tasks-implementation.md](sessions/20260116-scheduled-tasks-implementation.md) - 定时任务自动同步、插入和更新对象数据实现
|
|
|
|
|
|
- [20260116-metadata-change-auto-sync.md](sessions/20260116-metadata-change-auto-sync.md) - 元数据变更自动同步本地数据库实现
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [20260109-salesforce-cdc-sync.md](sessions/20260109-salesforce-cdc-sync.md) - Salesforce CDC实时同步实现
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [20260116-login-history-query-and-auto-login.md](sessions/20260116-login-history-query-and-auto-login.md) - 查询不同类型ORG登录历史及自动登录功能实现
|
|
|
|
|
|
- [20260116-datai-salesforce-auth-immediate-fixes.md](sessions/20260116-datai-salesforce-auth-immediate-fixes.md) - datai-salesforce-auth 模块立即修复实现
|
|
|
|
|
|
- [20260117-metadata-retrieve-deploy.md](sessions/20260117-metadata-retrieve-deploy.md) - 元数据拉取和部署功能实现
|
|
|
|
|
|
- [20260117-database-table-design-create.md](sessions/20260117-database-table-design-create.md) - 数据库表结构设计和创建实现
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [YYYYMMDD-template.md](sessions/YYYYMMDD-template.md) - 会话记录模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
### 6. 迭代复盘
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [retros/](retros/)
|
|
|
|
|
|
- **描述**: 包含每个迭代的复盘报告
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- **复盘报告**:
|
|
|
|
|
|
- [20260116-sync-progress-tracking.md](retros/20260116-sync-progress-tracking.md) - syncObjectData 同步进度跟踪实现复盘
|
|
|
|
|
|
- [20260116-insert-progress-tracking-retro.md](retros/20260116-insert-progress-tracking-retro.md) - insertObjectDataToTarget 插入数据进度跟踪实现复盘
|
|
|
|
|
|
- [20260116-update-progress-tracking-retro.md](retros/20260116-update-progress-tracking-retro.md) - updateObjectDataToTarget 更新数据进度跟踪实现复盘
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [20260116-scheduled-tasks-implementation-retro.md](retros/20260116-scheduled-tasks-implementation-retro.md) - 定时任务自动同步、插入和更新对象数据实现复盘
|
|
|
|
|
|
- [20260116-metadata-change-auto-sync-retro.md](retros/20260116-metadata-change-auto-sync-retro.md) - 元数据变更自动同步本地数据库实现复盘
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [20260116-login-history-query-and-auto-login-retro.md](retros/20260116-login-history-query-and-auto-login-retro.md) - 查询不同类型ORG登录历史及自动登录功能实现复盘
|
|
|
|
|
|
- [20260116-datai-salesforce-auth-immediate-fixes-retro.md](retros/20260116-datai-salesforce-auth-immediate-fixes-retro.md) - datai-salesforce-auth 模块立即修复实现复盘
|
|
|
|
|
|
- [20260117-database-table-design-create-retro.md](retros/20260117-database-table-design-create-retro.md) - 数据库表结构设计和创建复盘
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [YYYYMMDD-template.md](retros/YYYYMMDD-template.md) - 复盘报告模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
|
|
|
|
|
### 7. 变更日志
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [changelog/](changelog/)
|
|
|
|
|
|
- **描述**: 包含详细的变更记录
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **变更记录文档**:
|
|
|
|
|
|
- [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) - 文档完善
|
2026-01-12 17:02:32 +08:00
|
|
|
|
- [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 配置项添加与连接工厂优化
|
2026-01-13 13:51:33 +08:00
|
|
|
|
- [0009-realtime-service-manual-start.md](changelog/0009-realtime-service-manual-start.md) - 实时服务手动启动管理
|
|
|
|
|
|
- [0010-realtime-sync-statistics.md](changelog/0010-realtime-sync-statistics.md) - 实时同步统计接口
|
2026-01-14 14:08:33 +08:00
|
|
|
|
- [0011-target-org-login-functionality.md](changelog/0011-target-org-login-functionality.md) - 目标ORG登录功能实现
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [0012-sync-progress-tracking.md](changelog/0012-sync-progress-tracking.md) - syncObjectData 同步进度跟踪实现
|
|
|
|
|
|
- [0013-insert-progress-tracking.md](changelog/0013-insert-progress-tracking.md) - insertObjectDataToTarget 插入数据进度跟踪实现
|
|
|
|
|
|
- [0014-update-progress-tracking.md](changelog/0014-update-progress-tracking.md) - updateObjectDataToTarget 更新数据进度跟踪实现
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [0015-scheduled-tasks-implementation.md](changelog/0015-scheduled-tasks-implementation.md) - 定时任务自动同步、插入和更新对象数据实现
|
|
|
|
|
|
- [0016-metadata-change-auto-sync.md](changelog/0016-metadata-change-auto-sync.md) - 元数据变更自动同步本地数据库实现
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [0018-datai-salesforce-auth-immediate-fixes.md](changelog/0018-datai-salesforce-auth-immediate-fixes.md) - datai-salesforce-auth 模块立即修复实现
|
|
|
|
|
|
- [0020-database-table-design-create.md](changelog/0020-database-table-design-create.md) - 数据库表结构设计和创建
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [0000-template.md](changelog/0000-template.md) - 变更记录模板
|
2026-01-08 19:52:43 +08:00
|
|
|
|
|
2026-01-09 14:24:58 +08:00
|
|
|
|
### 8. 接口文档
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [api-docs/](api-docs/)
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- **描述**: 包含提供给前端调用的接口文档和定时任务文档
|
2026-01-14 14:08:33 +08:00
|
|
|
|
- **模块索引**:
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [API 文档索引](api-docs/index.md) - 所有接口和定时任务的索引
|
2026-01-14 14:08:33 +08:00
|
|
|
|
- [Setting 模块接口索引](api-docs/setting/index.md) - 配置管理相关接口索引
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- [定时任务文档索引](api-docs/task/index.md) - 定时任务文档索引
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- **接口文档**:
|
2026-01-14 14:08:33 +08:00
|
|
|
|
- [DataISfLoginController](api-docs/auth/DataISfLoginController/) - Salesforce登录认证接口
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [DataiIntegrationRealtimeSyncController](api-docs/integration/DataiIntegrationRealtimeSyncController/) - 实时同步服务管理接口
|
2026-01-16 13:02:09 +08:00
|
|
|
|
- [DataiIntegrationObjectController](api-docs/integration/DataiIntegrationObjectController/) - 对象同步控制接口(新增进度查询接口)
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [DataiIntegrationBatchController](api-docs/integration/DataiIntegrationBatchController/) - 批次同步控制接口
|
|
|
|
|
|
- [DataiIntegrationMetadataChangeController](api-docs/integration/DataiIntegrationMetadataChangeController/) - 元数据变更控制接口
|
2026-01-13 13:51:33 +08:00
|
|
|
|
- [RealtimeServiceController](api-docs/integration/RealtimeServiceController/) - 实时服务管理接口
|
2026-01-14 14:08:33 +08:00
|
|
|
|
- [DataiConfigAuditLogController](api-docs/setting/DataiConfigAuditLogController/) - 配置审计日志管理接口
|
|
|
|
|
|
- [DataiConfigEnvironmentController](api-docs/setting/DataiConfigEnvironmentController/) - 配置环境管理接口
|
|
|
|
|
|
- [DataiConfigSnapshotController](api-docs/setting/DataiConfigSnapshotController/) - 配置快照管理接口
|
|
|
|
|
|
- [DataiConfigurationController](api-docs/setting/DataiConfigurationController/) - 配置管理接口
|
2026-01-13 13:51:33 +08:00
|
|
|
|
- [SysJobController](api-docs/monitor/SysJobController/) - 定时任务管理接口
|
|
|
|
|
|
- [SysJobLogController](api-docs/monitor/SysJobLogController/) - 定时任务日志管理接口
|
2026-01-16 16:38:35 +08:00
|
|
|
|
- **定时任务文档**:
|
|
|
|
|
|
- [ObjectSyncTask](api-docs/task/ObjectSyncTask.md) - 对象自动同步任务
|
|
|
|
|
|
- [ObjectInsertTask](api-docs/task/ObjectInsertTask.md) - 对象自动插入任务
|
|
|
|
|
|
- [ObjectUpdateTask](api-docs/task/ObjectUpdateTask.md) - 对象自动更新任务
|
|
|
|
|
|
- [MetadataChangeAutoSyncTask](api-docs/task/MetadataChangeAutoSyncTask.md) - 元数据变更自动同步任务
|
|
|
|
|
|
- [RateLimitResetTask](api-docs/task/RateLimitResetTask.md) - 每日限流重置任务
|
2026-01-12 10:31:25 +08:00
|
|
|
|
|
|
|
|
|
|
### 9. SQL文件
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [sql/](sql/)
|
|
|
|
|
|
- **描述**: 包含数据库结构和初始化SQL文件
|
|
|
|
|
|
- **SQL文件**:
|
|
|
|
|
|
- [create-realtime-sync-log-table.sql](sql/create-realtime-sync-log-table.sql) - 实时同步日志表创建SQL
|
2026-01-12 17:02:32 +08:00
|
|
|
|
- [add_is_realtime_sync_column.sql](sql/add_is_realtime_sync_column.sql) - 添加实时同步列SQL
|
2026-01-12 10:31:25 +08:00
|
|
|
|
- [add_is_partitioned_column.sql](sql/add_is_partitioned_column.sql) - 添加分区列SQL
|
|
|
|
|
|
- [datai_table.sql](sql/datai_table.sql) - 数据表初始化SQL
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- [migration-change-password-encryption.sql](sql/migration-change-password-encryption.sql) - 密码加密方式迁移SQL
|
2026-01-09 14:24:58 +08:00
|
|
|
|
|
2026-01-12 17:02:32 +08:00
|
|
|
|
### 10. 参考代码
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [reference-code/](reference-code/)
|
|
|
|
|
|
- **描述**: 包含项目参考代码和示例实现
|
2026-01-15 14:13:55 +08:00
|
|
|
|
- **参考代码**:
|
|
|
|
|
|
- **data-dump**: [data-dump/](reference-code/data-dump/) - 数据导出参考代码
|
|
|
|
|
|
- [CommonServiceImpl.java](reference-code/data-dump/CommonServiceImpl.java) - Salesforce 数据插入逻辑参考
|
|
|
|
|
|
- [DataImportNewServiceImpl.java](reference-code/data-dump/DataImportNewServiceImpl.java) - 数据导入服务实现参考
|
|
|
|
|
|
- **salesforce-pubsub-realtime-sync**: [salesforce-pubsub-realtime-sync/](reference-code/salesforce-pubsub-realtime-sync/) - Salesforce Pub/Sub 实时同步参考代码
|
|
|
|
|
|
- **001-implement**: [001-implement/](reference-code/salesforce-pubsub-realtime-sync/001-implement/) - 实时同步实现
|
|
|
|
|
|
- [realtime/](reference-code/salesforce-pubsub-realtime-sync/001-implement/realtime/) - 实时同步核心接口和实现
|
|
|
|
|
|
- **multicloudj组件**: [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、处理事件、管理连接等功能的封装
|
|
|
|
|
|
|
|
|
|
|
|
### 11. 图片资源
|
|
|
|
|
|
|
|
|
|
|
|
- **目录**: [picture/](picture/)
|
|
|
|
|
|
- **描述**: 包含项目相关的图片资源
|
|
|
|
|
|
- **图片文件**:
|
|
|
|
|
|
- [image.png](picture/image.png) - 项目架构图
|
|
|
|
|
|
- [img.png](picture/img.png) - 流程图
|
|
|
|
|
|
- [img_1.png](picture/img_1.png) - 流程图1
|
|
|
|
|
|
- [img_2.png](picture/img_2.png) - 流程图2
|
|
|
|
|
|
- [img_3.png](picture/img_3.png) - 流程图3
|
|
|
|
|
|
- [img_4.png](picture/img_4.png) - 流程图4
|
|
|
|
|
|
- [img_5.png](picture/img_5.png) - 流程图5
|
2026-01-12 17:02:32 +08:00
|
|
|
|
|
2026-01-08 19:52:43 +08:00
|
|
|
|
## 协作基线文件
|
|
|
|
|
|
|
|
|
|
|
|
- **README.md**: [../README.md](../README.md) - 项目目标和真源入口
|
|
|
|
|
|
- **CONTRIBUTING.md**: [../CONTRIBUTING.md](../CONTRIBUTING.md) - 协作规则
|
|
|
|
|
|
- **CHANGELOG.md**: [../CHANGELOG.md](../CHANGELOG.md) - 变更摘要
|
|
|
|
|
|
|
|
|
|
|
|
## 导航说明
|
|
|
|
|
|
|
|
|
|
|
|
- 本文件是项目文档的唯一入口,所有文档变更必须在此添加链接
|
|
|
|
|
|
- 文档间引用必须使用相对路径链接
|
|
|
|
|
|
- 新文档必须使用相应目录中的模板文件
|
|
|
|
|
|
|
|
|
|
|
|
## 最后更新
|
|
|
|
|
|
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- 更新时间: 2026-01-17
|
2026-01-15 14:13:55 +08:00
|
|
|
|
- 更新内容:
|
2026-01-18 19:44:13 +08:00
|
|
|
|
- 新增 0011-entity-mapper-create.md 架构决策记录 - 基础实体类和 Mapper 创建
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 0011-entity-mapper-create.md 架构决策记录链接
|
|
|
|
|
|
- 标注 REQ-010-2 需求状态为 [阶段2-架构决策]
|
|
|
|
|
|
- 2026-01-17 之前更新内容:
|
|
|
|
|
|
- 更新 REQ-010-2 需求文档 - 补充用户故事和细化验收标准
|
|
|
|
|
|
- 标注 REQ-010-2 需求状态为 [阶段1-需求定义与入库]
|
|
|
|
|
|
- 新增 20260117-database-table-design-create-retro.md 复盘报告 - 数据库表结构设计和创建复盘
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 20260117-database-table-design-create-retro.md 复盘报告链接
|
|
|
|
|
|
- 新增 0020-database-table-design-create.md 变更记录 - 数据库表结构设计和创建
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 0020-database-table-design-create.md 变更记录链接
|
|
|
|
|
|
- 更新 CHANGELOG.md - 添加 V0.1.15 版本变更记录
|
|
|
|
|
|
- 标注 REQ-010-1 需求已完成
|
|
|
|
|
|
- 新增 20260117-database-table-design-create.md 会话记录 - 数据库表结构设计和创建实现
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 20260117-database-table-design-create.md 会话记录链接
|
|
|
|
|
|
- 新增 011-database-table-design-create.md 提示词文档 - 数据库表结构设计和创建实现提示词
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 011-database-table-design-create.md 提示词文档链接
|
|
|
|
|
|
- 新增 0010-database-table-design.md 架构决策记录 - 数据库表结构设计和创建
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 0010-database-table-design.md 架构决策记录链接
|
|
|
|
|
|
- 新增 17个REQ-010子需求文档 - REQ-010子需求独立需求文档
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 17个REQ-010子需求文档链接
|
|
|
|
|
|
- 新增 010-metadata-retrieve-deploy-sub-requirements.md 子需求拆分文档 - REQ-010子需求拆分文档
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 010-metadata-retrieve-deploy-sub-requirements.md 子需求拆分文档链接
|
|
|
|
|
|
- 新增 010-metadata-retrieve-deploy-split-requirements.md 提示词文档 - 拆分Salesforce元数据拉取和部署子需求
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 010-metadata-retrieve-deploy-split-requirements.md 提示词文档链接
|
|
|
|
|
|
- 新增 REQ-010 需求文档 - Salesforce元数据拉取和部署
|
|
|
|
|
|
- 新增 4 个参考代码文件 - 001-元数据模块设计、002-元数据拉取参考网页地址、003-元数据拉取和部署数据库设计推荐、004-元数据部署网页资料链接地址
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加 REQ-010 需求文档链接
|
|
|
|
|
|
- 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
|
|
|
|
|
|
- 更新唯一真源文档中心 - 添加定时任务文档链接
|
|
|
|
|
|
- 新增 REQ-007 需求文档 - 查询不同类型ORG登录历史及自动登录功能
|
|
|
|
|
|
- 新增 0007-login-history-query-and-auto-login.md 架构决策记录 - 查询不同类型ORG登录历史及自动登录功能
|
|
|
|
|
|
- 新增 007-login-history-query-and-auto-login.md 提示词资产 - 查询不同类型ORG登录历史及自动登录功能实现
|
|
|
|
|
|
- 新增 0017-login-history-query-and-auto-login.md 变更记录 - 查询不同类型ORG登录历史及自动登录功能实现
|
|
|
|
|
|
- 更新 4 个 Java 代码文件 - DataISfLoginController(更新)、IDataiSfLoginHistoryService(更新)、DataiSfLoginHistoryServiceImpl(更新)、DataiSfLoginHistoryMapper(更新)
|
|
|
|
|
|
- 更新 1 个 Mapper XML 文件 - DataiSfLoginHistoryMapper.xml(更新)
|
|
|
|
|
|
- 新增 20260116-login-history-query-and-auto-login.md 会话记录 - 查询不同类型ORG登录历史及自动登录功能实现
|
|
|
|
|
|
- 新增 20260116-login-history-query-and-auto-login-retro.md 复盘报告 - 查询不同类型ORG登录历史及自动登录功能实现复盘
|
|
|
|
|
|
- 新增 REQ-008 需求文档 - datai-salesforce-auth 模块立即修复事项
|
|
|
|
|
|
- 新增 0008-datai-salesforce-auth-immediate-fixes.md 架构决策记录 - datai-salesforce-auth 模块立即修复架构决策
|
|
|
|
|
|
- 新增 008-datai-salesforce-auth-immediate-fixes.md 提示词资产 - datai-salesforce-auth 模块立即修复实现提示词
|
|
|
|
|
|
- 新增 20260116-datai-salesforce-auth-immediate-fixes.md 会话记录 - datai-salesforce-auth 模块立即修复实现
|
|
|
|
|
|
- 新增 0018-datai-salesforce-auth-immediate-fixes.md 变更记录 - datai-salesforce-auth 模块立即修复实现
|
|
|
|
|
|
- 新增 20260116-datai-salesforce-auth-immediate-fixes-retro.md 复盘报告 - datai-salesforce-auth 模块立即修复实现复盘
|
|
|
|
|
|
- 新增 8 个代码文件 - pom.xml(更新)、DataiSfLoginHistory.java(更新)、SalesforceLoginServiceImpl.java(更新)、SessionManager.java(更新)、RateLimitInterceptor.java(新增)、WebConfig.java(新增)、application-auth.yml(更新)、migration-change-password-encryption.sql(新增)
|
|
|
|
|
|
- 更新 CHANGELOG.md - 添加 v0.1.18 版本变更
|
|
|
|
|
|
- 更新 README.md - 添加安全加固功能说明
|