kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
3dde4fb6d7
datai/datai-scenes/datai-scene-salesforce/docs/index.md
Kris 3dde4fb6d7 docs: 完成REQ-010-2（基础实体类和Mapper创建）的所有6个阶段 
- 阶段4：执行会话与代码生成 - 创建会话记录：20260118-entity-mapper-create.md
- 阶段5：变更记录与归档 - 创建变更记录：20260118-entity-mapper-create.md
- 阶段6：闭环复盘 - 创建复盘报告：20260118-entity-mapper-create-retro.md
- 更新 index.md，标记 REQ-010-2 为已完成
- 更新 CHANGELOG.md，添加基础实体类和Mapper创建的变更记录

所有文档均按照SSOT方法论创建，包括需求定义、架构决策、提示词资产化、执行会话、变更记录和闭环复盘。
2026-01-19 10:15:21 +08:00

41 KiB
Raw Blame History

单一真源文档中心

项目概述

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

文档目录

【视觉看板】

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

1. 需求文档

2. 设计文档

3. 架构决策

4. 提示词库

5. 技能文档

6. 会话记录

6. 迭代复盘

7. 变更日志

8. 接口文档

9. SQL文件

10. 参考代码

  • 目录: reference-code/
  • 描述: 包含项目参考代码和示例实现
  • 参考代码:
    • Salesforce SOAP API Java 客户端: com/docs/ - Salesforce 官方 WSDL 对应的 Java 源代码参考文档
    • 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-18
  • 更新内容:
    • 新增 Salesforce SOAP API Java 客户端参考文档 - 包含 apex、metadata、tooling、partner 四个模块的完整说明
    • 新增 file 模块 index.vue 真源文档 - 文件模块 API 文档索引
    • 更新唯一真源文档中心 - 添加 Salesforce SOAP API Java 客户端参考文档和 file 模块索引链接
    • 2026-01-18 之前更新内容:
      • 新增 FileController API 文档 - 文件存储服务接口文档（8个接口）
      • 新增 SysFileInfoController API 文档 - 文件信息管理接口文档（6个接口）
      • 更新唯一真源文档中心 - 添加 FileController 和 SysFileInfoController API 文档链接
    • 2026-01-18 之前更新内容:
      • 更新 REQ-010-3 需求文档 - 标注需求状态为已完成
      • 新增 ADR-0012-org-config-management.md 架构决策记录 - Salesforce组织配置管理
      • 新增 Prompt-013-org-config-management.md 提示词文档 - Salesforce组织配置管理实现
      • 新增 20260118-org-config-management.md 会话记录 - Salesforce组织配置管理实现
      • 新增 0022-org-config-management.md 变更记录 - Salesforce组织配置管理
      • 新增 20260118-org-config-management-retro.md 复盘报告 - Salesforce组织配置管理复盘
      • 更新唯一真源文档中心 - 添加架构决策、提示词、会话记录、变更记录和复盘报告链接
    • 2026-01-18 之前更新内容:
      • 更新 REQ-010-1 需求文档 - 标注需求状态为已完成
      • 更新 010-metadata-retrieve-deploy-sub-requirements.md 子需求拆分文档 - 更新表数量从6张到9张，更新表名从sf_前缀到datai_meta_前缀
      • 新增 20260118-entity-mapper-create.md 会话记录 - 基础实体类和Mapper创建实现
      • 新增 0021-entity-mapper-create.md 变更记录 - 基础实体类和Mapper创建
      • 新增 20260118-entity-mapper-create-retro.md 复盘报告 - 基础实体类和Mapper创建复盘
      • 更新 REQ-010-2 需求文档 - 更新表数量从6张到9张，标注需求状态为已完成
      • 更新唯一真源文档中心 - 添加会话记录、变更记录和复盘报告链接
    • 2026-01-18 之前更新内容:
      • 新增 DataiSfLoginHistoryController API 文档 - 登录历史信息管理接口文档
      • 新增 0007-latest-success-grouped.md API 文档 - 查询所有登录成功历史分组数据接口
      • 更新 REQ-007 需求文档 - 添加 AC7 验收标准和 TC-009 测试用例，添加接口3说明
      • 更新 ADR-007 架构决策记录 - 添加接口3决策内容，包括实现方式和SQL实现
      • 更新唯一真源文档中心 - 添加 DataiSfLoginHistoryController API 文档链接
      • 标注 REQ-007 需求状态为 [阶段1-需求定义与入库]
      • 标注 ADR-007 架构决策状态为 [Accepted]
    • 2026-01-17 之前更新内容:
      • 新增 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 - 添加安全加固功能说明