datai/CHANGELOG.md

# Datai 项目变更日志

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

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

## [未发布]

### 新增

#### Apex 开发工具包

- **Apex 编译器接口与错误处理** (v1.0.0)
  - 实现统一错误模型，创建 ApexCompileIssue 类映射 Salesforce SOAP API 的 CompileIssue
  - 实现编译器结果封装，创建 CompileResult 类封装编译结果
  - 实现 WSDL 转 Apex 结果封装，创建 WsdlToApexResult 类封装 WSDL 转换结果
  - 实现异常体系，创建 ApexException 及其子类（ApexCompilationException、ApexRuntimeException、ApexConnectionException）
  - 实现服务接口，创建 ApexCompilerService 和 WsdlConverterService 接口
  - 实现服务实现，使用 force-wsc 库与 Salesforce SOAP API 集成
  - 实现单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-28-013-1-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-28-013-1-changelog.md)

- **符号表分析与 DTO 生成** (v1.0.0)
  - 实现符号表获取功能，通过 ToolingConnection 查询 Apex 类的 SymbolTable
  - 实现结构解析器，解析 SymbolTable 中的 innerClasses、methods 和 variables
  - 实现 Java 代码生成器，基于解析结果生成符合 Java Bean 规范的源代码
  - 实现 Apex 类型到 Java 类型的映射，支持精确映射和降级处理
  - 实现 RESTful API 接口，提供符号表查询和 DTO 生成功能
  - 实现权限控制和参数验证，确保 API 安全性
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-27-014-2-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-27-014-2-changelog.md)

- **Apex 动态代码执行与日志管理** (v1.0.0)
  - 封装 Salesforce SOAP API `executeAnonymous` 实现无状态代码执行
  - 支持细粒度日志级别配置 (`DebuggingOptions`)
  - 提供结构化执行结果 (`ExecuteResult`)，统一处理编译与运行时异常
  - 提供日志解析扩展能力 (`LogParser`)
  - 详细文档：[2026-01-27-013-2-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-27-013-2-changelog.md)

- **Apex 单元测试与覆盖率统计** (v1.0.0)
  - 封装 Salesforce SOAP API `runTests` 实现单元测试执行
  - 支持按类、方法、包或全量运行测试
  - 解析 `RunTestsResult` 返回的成功/失败详情与 `apexLogId`
  - 解析 `CodeCoverageResult` 与 `CodeLocation`，预计算覆盖率百分比
  - 详细文档：[2026-01-27-013-3-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-27-013-3-changelog.md)

- **元数据容器与原子性部署** (v1.0.0)
  - 实现元数据容器生命周期管理功能，包括创建容器（支持容器名称冲突处理）、删除容器、查询容器、获取容器详情
  - 实现容器成员管理功能，包括添加成员到容器，支持多种元数据类型（ApexClassMember、ApexTriggerMember、ApexComponentMember、ApexPageMember）
  - 实现异步部署请求功能，包括创建部署请求，支持 CheckOnly 模式和测试执行
  - 实现状态轮询与结果解析功能，包括查询部署状态、轮询部署状态（支持超时和重试）、获取部署详情、解析编译错误、解析测试结果
  - 实现 RESTful API 接口，提供元数据容器和部署管理的完整功能
  - 实现权限控制和参数验证，确保 API 安全性
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-27-014-4-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-27-014-4-changelog.md)

#### 后端国际化功能

- **后端国际化功能** (v1.0.0)
  - 实现错误消息国际化，包括 ErrorCode 枚举类和 GlobalExceptionHandler 扩展
  - 实现日志消息国际化，包括 LogAspect 切面类扩展
  - 实现验证消息国际化，包括 ValidationConfig 配置类
  - 实现通知消息国际化，包括 IMessageSystemService 接口和 MessageSystemServiceImpl 类扩展
  - 实现用户语言偏好管理，包括 SysUser 实体类扩展和 I18nController 控制器
  - 实现国际化资源管理，包括 I18nConfig 配置类更新和国际化资源文件
  - 在 sys_user 表中添加 lang_code 字段
  - 详细文档：[2026-01-25-002-02-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-25-002-02-changelog.md)

- **数据库国际化功能** (v1.0.0)
  - 实现字典数据国际化，包括 SysDictData 和 SysDictType 的国际化支持
  - 实现系统配置国际化，包括 SysConfig 的国际化支持
  - 实现菜单数据国际化，包括 SysMenu 的国际化支持
  - 在 sys_dict_data 表中添加 dict_label_en 和 dict_label_i18n 字段
  - 在 sys_dict_type 表中添加 dict_name_en 和 dict_name_i18n 字段
  - 在 sys_config 表中添加 config_name_en 和 config_name_i18n 字段
  - 在 sys_menu 表中添加 menu_name_en 和 menu_name_i18n 字段
  - 实现语言切换功能，包括 I18nController 控制器
  - 实现按语言分别缓存的机制，缓存键格式：{数据类型}:{标识}:{语言代码}
  - 实现数据回退机制，国际化数据缺失时显示默认语言（中文）的数据
  - 详细文档：[2026-01-25-002-03-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-25-002-03-changelog.md)

#### Salesforce 集成模块

- **环境从库初始化功能** (v1.0.0)
  - 实现环境从库初始化功能，包括数据库创建、配置写入、数据源注册、连接验证等步骤
  - 在 ISysDatasourceConfigService 接口中新增 createSlaveDatabase 方法
  - 在 IDataiConfigEnvironmentService 接口中新增 initSlaveDatasource 方法
  - 在 DataiConfigEnvironmentController 中新增 initSlaveDatasource 接口方法
  - 在 DataiConfigEnvironment 实体类中新增 datasourceId 字段
  - 在 datai_config_environment 表中新增 datasource_id 字段并添加索引
  - 主库配置从 application-druid.yml 配置文件中读取
  - 从库一经创建，不允许任何修改、删除或重新初始化
  - 详细文档：[2026-01-24-002-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-24-002-changelog.md)

- **datai-salesforce-auth 模块立即修复** (v0.1.18)
  - 密码加密方式从对称加密改为不可逆的 BCrypt 哈希算法
  - 对 Session ID、用户 ID 等敏感信息进行日志脱敏处理
  - 为登录接口添加请求频率限制功能（每分钟最多 5 次登录尝试）
  - 检查代码语法，确认不存在语法错误
  - 详细文档：[0018-datai-salesforce-auth-immediate-fixes.md](datai-scenes/datai-scene-salesforce/docs/changelog/0018-datai-salesforce-auth-immediate-fixes.md)

- **查询不同类型ORG登录历史及自动登录功能** (v0.1.17)
  - 新增查询不同类型ORG成功登录历史接口
  - 新增根据登录历史自动登录接口
  - 支持多种ORG类型（Source、Target、Sandbox、Production等）
  - 完善的日志记录和异常处理机制
  - 详细文档：[0017-login-history-query-and-auto-login.md](datai-scenes/datai-scene-salesforce/docs/changelog/0017-login-history-query-and-auto-login.md)

- **元数据变更自动同步本地数据库** (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/)