# 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/)