datai/CHANGELOG.md

# Datai 项目变更日志

本文档记录 Datai 项目的所有重要变更。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [未发布]

### 新增

#### Salesforce 集成模块

- **元数据变更自动同步本地数据库** (v0.1.16)
  - 新增 MetadataChangeAutoSyncTask 定时任务类，支持自动同步元数据变更
  - 基于元数据变更类型、操作类型、对象配置的自动执行逻辑
  - 支持通过 SysJob 实体配置执行时间、启用状态等
  - 完善的日志记录和异常处理机制
  - 详细文档：[0016-metadata-change-auto-sync.md](datai-scenes/datai-scene-salesforce/docs/changelog/0016-metadata-change-auto-sync.md)

- **定时任务自动同步、插入和更新对象数据** (v0.1.15)
  - 新增 ObjectSyncTask 定时任务类，支持自动同步对象数据
  - 新增 ObjectInsertTask 定时任务类，支持自动插入对象数据
  - 新增 ObjectUpdateTask 定时任务类，支持自动更新对象数据
  - 基于对象字段配置的自动执行逻辑
  - 支持通过 SysJob 实体配置执行时间、启用状态等
  - 完善的日志记录和异常处理机制
  - 详细文档：[0015-scheduled-tasks-implementation.md](datai-scenes/datai-scene-salesforce/docs/changelog/0015-scheduled-tasks-implementation.md)

- **updateObjectDataToTarget 更新数据进度跟踪** (v0.1.14)
  - 新增更新进度查询接口
  - 集成进度跟踪功能到更新方法
  - 复用现有的内存存储方案
  - 详细文档：[0014-update-progress-tracking.md](datai-scenes/datai-scene-salesforce/docs/changelog/0014-update-progress-tracking.md)

- **insertObjectDataToTarget 插入数据进度跟踪** (v0.1.13)
  - 新增插入进度查询接口
  - 集成进度跟踪功能到插入方法
  - 复用现有的内存存储方案
  - 详细文档：[0013-insert-progress-tracking.md](datai-scenes/datai-scene-salesforce/docs/changelog/0013-insert-progress-tracking.md)

- **syncObjectData 同步进度跟踪** (v0.1.12)
  - 新增同步进度查询接口
  - 集成进度跟踪功能到同步方法
  - 使用 ConcurrentHashMap 存储进度信息
  - 详细文档：[0012-sync-progress-tracking.md](datai-scenes/datai-scene-salesforce/docs/changelog/0012-sync-progress-tracking.md)

- **目标ORG登录功能** (v0.1.11)
  - 支持目标 Salesforce 系统的多种认证方式
  - 实现目标系统登录会话管理
  - 详细文档：[0011-target-org-login-functionality.md](datai-scenes/datai-scene-salesforce/docs/changelog/0011-target-org-login-functionality.md)

- **实时同步统计接口** (v0.1.10)
  - 新增实时同步统计查询接口
  - 支持查询实时同步服务的运行状态
  - 详细文档：[0010-realtime-sync-statistics.md](datai-scenes/datai-scene-salesforce/docs/changelog/0010-realtime-sync-statistics.md)

- **实时服务手动启动管理** (v0.1.9)
  - 支持手动启动、停止、重启实时同步服务
  - 实时同步服务状态监控
  - 详细文档：[0009-realtime-service-manual-start.md](datai-scenes/datai-scene-salesforce/docs/changelog/0009-realtime-service-manual-start.md)

- **Pub/Sub API 配置项添加与连接工厂优化** (v0.1.8)
  - 新增 Pub/Sub API 配置项
  - 优化连接工厂实现
  - 详细文档：[0008-pubsub-config-optimization.md](datai-scenes/datai-scene-salesforce/docs/changelog/0008-pubsub-config-optimization.md)

- **Salesforce Pub/Sub API 实时同步功能实现** (v0.1.7)
  - 实现 Salesforce Event Bus 实时数据订阅
  - CDC 事件接收和处理
  - 实时数据同步到本地数据库
  - 详细文档：[0007-pubsub-api-implementation.md](datai-scenes/datai-scene-salesforce/docs/changelog/0007-pubsub-api-implementation.md)

### 变更

#### Salesforce 集成模块

- **文档完善** (v0.1.6)
  - 完善项目文档结构
  - 添加 API 文档
  - 详细文档：[0006-documentation-improvement.md](datai-scenes/datai-scene-salesforce/docs/changelog/0006-documentation-improvement.md)

- **测试和验证** (v0.1.5)
  - 完善测试用例
  - 验证功能正确性
  - 详细文档：[0005-testing-and-verification.md](datai-scenes/datai-scene-salesforce/docs/changelog/0005-testing-and-verification.md)

- **同步配置管理实现** (v0.1.4)
  - 实现同步配置管理功能
  - 支持动态配置同步参数
  - 详细文档：[0003-sync-configuration-management.md](datai-scenes/datai-scene-salesforce/docs/changelog/0003-sync-configuration-management.md)

- **实时同步日志功能完善** (v0.1.3)
  - 完善实时同步日志记录
  - 支持日志查询和统计
  - 详细文档：[0004-realtime-sync-log-enhancement.md](datai-scenes/datai-scene-salesforce/docs/changelog/0004-realtime-sync-log-enhancement.md)

- **数据库结构调整** (v0.1.2)
  - 调整数据库表结构
  - 优化数据存储方案
  - 详细文档：[0002-database-structure-adjustment.md](datai-scenes/datai-scene-salesforce/docs/changelog/0002-database-structure-adjustment.md)

### 修复

#### Salesforce 集成模块

- **核心组件实现** (v0.1.1)
  - 实现核心组件功能
  - 修复已知问题
  - 详细文档：[0001-core-components-implementation.md](datai-scenes/datai-scene-salesforce/docs/changelog/0001-core-components-implementation.md)

### 项目规则优化

- **项目规则优化** (v0.1.1)
  - 优化项目协作规则
  - 完善文档管理流程
  - 详细文档：[0.1.1-project-rules-optimization.md](datai-scenes/datai-scene-salesforce/docs/changelog/0.1.1-project-rules-optimization.md)

## 版本说明

### 版本号格式

- 主版本号：不兼容的 API 修改
- 次版本号：向下兼容的功能性新增
- 修订号：向下兼容的问题修正

### 变更类型

- **新增**：新功能
- **变更**：现有功能的变更
- **弃用**：即将移除的功能
- **移除**：已移除的功能
- **修复**：问题修复
- **安全**：安全相关的修复

## 相关链接

- **项目文档中心**：[datai-scenes/datai-scene-salesforce/docs/index.md](datai-scenes/datai-scene-salesforce/docs/index.md)
- **Salesforce 集成模块文档**：[datai-scenes/datai-scene-salesforce/docs/](datai-scenes/datai-scene-salesforce/docs/)
- **变更日志目录**：[datai-scenes/datai-scene-salesforce/docs/changelog/](datai-scenes/datai-scene-salesforce/docs/changelog/)