datai/CHANGELOG.md

# Datai 项目变更日志

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

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

## [未发布]

### 新增

#### Apex 开发工具包

- **WSDL 转换功能** (v1.0.0, 2026-02-05)
  - 实现 Salesforce WSDL 转换功能，提供 WSDL 文件转换为 Apex 类的能力
  - **从 URL 转换 WSDL**：支持通过 WSDL URL 进行转换到 Apex 类
  - **从 XML 转换 WSDL**：支持通过 WSDL XML 内容进行转换到 Apex 类
  - **转换历史查询**：支持分页查询 WSDL 转换历史记录，可按状态、时间范围筛选
  - **转换详情查询**：根据 ID 查询单个 WSDL 转换记录的详细信息
  - **转换记录删除**：支持删除和批量删除转换记录
  - **生成的 Apex 类管理**：支持查询生成的 Apex 类列表和详情
  - **独立数据库表**：创建 datai_apex_wsdl_conversion 和 datai_apex_wsdl_class 表
  - **独立 Service 层**：创建独立 Service 层，遵循单一职责原则
  - **分层架构设计**：Controller → Service → Mapper → Entity
  - **完整错误码体系**：新增 8 个错误码（WSDL_001 ~ WSDL_008）
  - 生成 16 个新代码文件（2 个 Entity + 4 个 Mapper + 4 个 Service + 2 个 Controller + 2 个 DTO + 2 个 VO）
  - 新增 6 个 REST API 接口
  - 依赖 002-01（Apex 连接管理）提供连接管理功能
  - 使用 apex.jar 中的 WsdlToApexInfo、WsdlToApexResult 等类进行 WSDL 转换
  - 详细文档：[2026-02-05-002-07-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-002-07-changelog.md)

#### Tooling API 模块

- **AI 和智能功能** (v1.0.0, 2026-02-05)
  - 实现 Tooling API AI 和智能功能，提供 AI 应用管理和 AI 类型查询功能
  - **AI 应用管理**：支持创建、查询、更新、删除 AI 应用（AIApplication）
  - **AI 评估配置查询**：支持查询评估主题类型、处理状态、指标类型
  - **AI 创作工具查询**：支持查询创作包类型、版本状态、助手模板状态
  - **异步日志记录**：使用 Spring @Async 异步记录操作日志，避免影响主流程性能
  - **复用 004-01**：复用 ToolingConnectionFactory 进行连接管理
  - **SoqlBuilder 复用**：复用现有 SoqlBuilder 工具类构建 SOQL 查询
  - **完整错误码体系**：定义 11 个标准错误码（TOOLING_AI_001 ~ TOOLING_AI_011）
  - **分层架构设计**：Controller → Service → Factory → Tooling API
  - **数据库支持**：创建 datai_tooling_ai_operation_log 表记录操作日志
  - 生成 15 个新代码文件（11 个手动实现 + 4 个代码生成器生成）
  - 新增 10 个 REST API 接口
  - 详细文档：[2026-02-05-004-04-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-004-04-changelog.md)

#### Apex 开发工具包

- **日志记录功能** (v1.0.0, 2026-02-05)
  - 实现 Salesforce Apex 日志记录功能，提供日志查询、调试头部设置、日志分类管理等功能
  - **日志列表查询**: 支持分页查询 Apex 日志记录，可按应用名称、位置、操作、状态、时间范围筛选
  - **日志详情查询**: 根据 ID 查询单个日志记录的详细信息
  - **调试头部管理**: 支持设置和清除调试头部信息，包括日志分类和日志类型
  - **日志分类管理**: 支持日志分类的创建、查询、更新、删除操作
  - **独立数据库表**: 创建 datai_apex_log 和 datai_apex_log_category 表，存储日志和分类信息
  - **独立 Service 层**: 创建独立 Service 层，遵循单一职责原则
  - **分层架构设计**: Controller → Service → Mapper → Entity
  - **完整错误码体系**: 复用现有错误码体系，新增 8 个错误码
  - 生成 16 个新代码文件（2 个 Entity + 4 个 Mapper + 4 个 Service + 2 个 Controller + 2 个 DTO + 2 个 VO）
  - 新增 9 个 REST API 接口
  - 与测试执行功能（002-03）、代码覆盖率功能（002-04）、Flow 覆盖率功能（002-05）集成，提供日志追踪支持
  - 详细文档：[2026-02-05-002-06-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-002-06-changelog.md)

- **Flow 覆盖率功能** (v1.0.0, 2026-02-05)
  - 实现 Salesforce Apex Flow 覆盖率查询和统计功能
  - **Flow 覆盖率查询**: 支持分页查询 Flow 覆盖率记录，可按测试结果ID、Flow名称、类型、命名空间、覆盖率范围筛选
  - **Flow 覆盖率详情**: 根据 ID 查询单个 Flow 覆盖率记录详情，包含关联的警告信息
  - **Flow 覆盖率警告**: 支持查询 Flow 覆盖率相关的警告信息
  - **总体覆盖率统计**: 统计指定测试结果的总体 Flow 覆盖率，采用元素数量加权平均法
  - **按命名空间统计**: 按命名空间分组统计 Flow 覆盖率
  - **按类型统计**: 按 Flow 类型分组统计覆盖率
  - **独立数据库表**: 创建 datai_apex_flow_coverage 和 datai_apex_flow_coverage_warning 表，与代码覆盖率表分离
  - **独立 Service 层**: 创建独立 Service 层，与代码覆盖率 Service 分离，遵循单一职责原则
  - **统计视图**: 创建 v_apex_flow_coverage_summary 和 v_apex_flow_coverage_by_type 视图优化统计查询
  - **分层架构设计**: Controller → Service → Mapper → Entity
  - **完整错误码体系**: 复用现有错误码体系
  - 生成 17 个新代码文件（2 个 Entity + 4 个 Mapper + 4 个 Service + 2 个 Controller + 2 个 DTO + 3 个 VO）
  - 新增 6 个 REST API 接口
  - 与测试执行功能（002-03）集成，为测试结果提供 Flow 覆盖率数据支持
  - 详细文档：[2026-02-05-002-05-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-002-05-changelog.md)

#### Tooling API 模块

- **开发工具功能** (v1.0.0, 2026-02-05)
  - 实现 Tooling API 开发工具功能，提供 Salesforce 开发工具集
  - **代码覆盖率查询**：查询 Apex 类/触发器的代码覆盖率，支持按名称、ID、命名空间筛选
  - **测试队列管理**：查询测试队列项，支持按状态、类 ID、父作业 ID 筛选
  - **日志获取**：查询 Apex 日志，支持按应用、位置、操作、状态筛选
  - **成员查询**：支持查询 Apex 类成员、触发器成员、Visualforce 页面成员、组件成员
  - **异步日志记录**：使用 Spring @Async 异步记录操作日志，避免影响主流程性能
  - **复用 004-01**：复用 ToolingConnectionFactory 进行连接管理
  - **SoqlBuilder 复用**：复用现有 SoqlBuilder 工具类构建 SOQL 查询
  - **完整错误码体系**：定义 11 个标准错误码（TOOLING_DEVTOOLS_001 ~ TOOLING_DEVTOOLS_011）
  - **分层架构设计**：Controller → Service → Factory → Tooling API
  - **数据库支持**：创建 datai_tooling_devtools_operation_log 表记录操作日志
  - 生成 14 个新代码文件（6 个基础代码 + 8 个业务代码）
  - 新增 8 个 REST API 接口
  - 详细文档：[2026-02-05-004-03-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-004-03-changelog.md)

- **元数据操作** (v1.0.0, 2026-02-05)

- **Tooling 连接管理** (v1.0.0, 2026-02-05)
  - 实现 Tooling API 连接管理功能，提供获取连接、清除缓存、测试连接、设置调用选项、设置调试头部等核心功能
  - **连接工厂**: 实现 ToolingConnectionFactory，继承 AbstractConnectionFactory，复用现有连接管理基础设施
  - **会话管理**: 集成 SessionManager，通过 Session ID 和 Instance URL 创建连接
  - **连接缓存**: 使用 ConcurrentHashMap 实现线程安全的连接缓存
  - **连接验证**: 执行简单 SOQL 查询验证 Session 有效性
  - **分层架构**: Controller → Service → Factory → Tooling API
  - **错误码体系**: 定义 8 个标准错误码（TOOLING_CONN_001 ~ TOOLING_CONN_008）
  - 生成 8 个新代码文件（1 个 Factory + 2 个 Service + 1 个 Controller + 1 个 Enum + 4 个数据模型）
  - 新增 5 个 REST API 接口
  - 详细文档：[2026-02-05-004-01-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-004-01-changelog.md)

- **元数据操作** (v1.0.0, 2026-02-05)
  - 实现 Tooling API 元数据操作功能，支持对 Salesforce 元数据的创建、查询、更新、删除操作
  - **元数据创建**：支持创建 CustomObject、CustomField、ApexClass、ApexTrigger、Flow
  - **元数据查询**：支持通用 SOQL 查询，使用 SoqlBuilder 动态构建查询语句
  - **元数据更新**：支持通用元数据更新操作
  - **元数据删除**：支持通用元数据删除操作
  - **异步日志记录**：使用 Spring @Async 异步记录操作日志，避免影响主流程性能
  - **复用 004-01**：复用 ToolingConnectionFactory 进行连接管理
  - **SoqlBuilder 复用**：复用现有 SoqlBuilder 工具类构建 SOQL 查询
  - **完整错误码体系**：定义 11 个标准错误码（TOOLING_META_001 ~ TOOLING_META_011）
  - **分层架构设计**：Controller → Service → Factory → Tooling API
  - **数据库支持**：创建 datai_tooling_metadata_operation_log 表记录操作日志
  - 生成 18 个新代码文件（8 个基础代码 + 10 个业务代码）
  - 新增 9 个 REST API 接口
  - 详细文档：[2026-02-05-004-02-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-004-02-changelog.md)

#### Apex 开发工具包

- **代码覆盖率功能** (v2.0.0, 2026-02-05)
  - 实现 Salesforce Apex 代码覆盖率查询和统计功能
  - **代码覆盖率查询**: 支持分页查询，可按测试结果ID、类/触发器名称、类型、命名空间、覆盖率范围筛选
  - **代码覆盖率详情**: 根据 ID 查询单个覆盖率记录详情
  - **总体覆盖率统计**: 统计指定测试结果的总体覆盖率（包括类覆盖率、触发器覆盖率）
  - **按类型统计**: 按 Class 和 Trigger 分组统计覆盖率
  - **复用现有表**: 复用 002-02 的 datai_apex_code_coverage 表，无需数据库变更
  - **独立 Service 层**: 创建 IApexCodeCoverageService 接口和实现，遵循单一职责原则
  - **完整单元测试**: ApexCodeCoverageServiceImplTest 包含 9 个测试方法，覆盖正常和异常场景
  - 生成 10 个新代码文件（2 个 DTO + 4 个 VO + 2 个 Service + 1 个 Controller + 1 个单元测试）
  - 新增 4 个 REST API 接口
  - 详细文档：[2026-02-05-002-04-changelog-v2.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-002-04-changelog-v2.md)

### 优化

#### Apex 开发工具包

- **测试执行功能优化** (v2.1.0, 2026-02-05)
  - 基于 v2.0.0 复盘经验，优化 Apex 测试执行功能的设计和代码实现
  - **VO 类字段完整性**：所有 VO 类字段与 Salesforce API 完全匹配
    - RunTestsResultVo 包含 successes 和 flowCoverage 字段
    - TestFailureVo 包含所有 Salesforce RunTestFailure 字段
  - **依赖注入明确性**：明确列出 ApexTestServiceImpl 的所有依赖
    - 注入 5 个 Mapper：testResultMapper、testSuccessMapper、testFailureMapper、codeCoverageMapper、flowCoverageMapper
    - 注入 3 个 Service：testResultService、testSuccessService、testFailureService、codeCoverageService、flowCoverageService
    - 注入 1 个 Factory：apexConnectionFactory
  - **单元测试设计**：提前规划并生成 Service 层单元测试
    - ApexTestServiceImplTest 包含正常和异常场景测试
    - 使用 Mockito 进行模拟测试
  - **批量插入优化**：使用 MyBatis batchInsert 批量保存数据
  - **多线程安全**：使用 ReentrantLock 保证测试执行的多线程安全
  - **事务管理**：使用 @Transactional 保证数据一致性
  - 生成 16 个新代码文件（5 个 DTO + 5 个 VO + 2 个 Service + 3 个 Controller + 1 个单元测试）
  - 向后兼容 v2.0.0，API 接口和数据库表保持不变
  - 详细文档：[2026-02-05-002-03-changelog-v2.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-05-002-03-changelog-v2.md)

### 更新

#### Apex 开发工具包

- **测试执行功能重构** (v2.0.0, 2026-02-04)
  - 对 Salesforce Apex 测试执行功能进行全面重构
  - 优化数据库表结构，复用 002-02 的 3 张表，新建 2 张表，减少数据冗余
  - 统一错误码体系，定义 20 个标准错误码（APEX_TEST_001 ~ APEX_TEST_020）
  - 完善日志记录和监控，使用 Slf4j 日志框架
  - 批量插入优化，使用 MyBatis 批量插入提升性能
  - 修复 VO 类字段不匹配问题（RunTestsResultVo、TestFailureVo）
  - 修复 Service 层缺失方法问题（queryTestFailureList、queryCodeCoverage）
  - 修复依赖注入缺失问题（IDataiApexTestFailureService、IDataiApexCodeCoverageService）
  - 提供 8 个 REST API 接口（4 个测试执行接口、4 个查询接口）
  - 生成 22 个代码文件，约 1800 行代码
  - 详细文档：[2026-02-04-002-03-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-04-002-03-changelog.md)

### 更新

#### Apex 开发工具包

- **Apex 连接管理代码重构** (v1.1.0, 2026-02-04)
  - 重新生成 Apex 连接管理功能代码，优化代码结构和实现
  - 更新 ApexConnectionFactory，完善连接创建和验证逻辑
  - 更新 ApexConnectionServiceImpl，增强异常处理和日志记录
  - 更新 ApexConnectionController，统一接口响应格式
  - 优化 DTO 和 VO 类，完善 Swagger 文档注解
  - 固定使用 source org 类型，确保与需求一致
  - 继承 AbstractConnectionFactory<SoapConnection>，复用缓存机制
  - 集成 SessionManager 获取会话信息
  - 提供 7 个 REST API 接口（获取连接、设置会话头、设置调用选项、设置调试头部、设置字段截断头、设置包版本头、清除连接缓存）
  - 详细文档：[2026-02-02-002-01-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-02-002-01-changelog.md)

### 新增

#### Tooling API 模块

- **Tooling 连接管理** (v1.0.0)
  - 实现 Tooling API 连接管理功能，提供获取连接、清除缓存、测试连接、设置调用选项、设置调试头部等核心功能
  - 实现 ToolingConnectionFactory，继承 AbstractConnectionFactory，复用现有连接管理基础设施
  - 集成 SessionManager，实现连接的创建、缓存、测试和清除
  - 使用 ConcurrentHashMap 实现线程安全的连接缓存
  - 自动检查 Session 有效性，过期时自动重新创建连接
  - 提供 5 个 REST API 接口（获取连接、清除缓存、测试连接、设置调用选项、设置调试头部）
  - 定义 8 种错误类型，实现完善的异常处理机制
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-02-03-004-01-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-03-004-01-changelog.md)

#### Metadata API 模块

- **Metadata 连接管理** (v1.0.0)
  - 实现 Metadata API 源 Org 的连接管理功能
  - 实现 MetadataConnectionFactory，支持 Partner URL 自动转换为 Metadata URL
  - 集成 SessionManager，实现连接的创建、测试、刷新和关闭
  - 提供 4 个 REST API 接口（状态、测试、刷新、关闭）
  - 记录连接日志到数据库，支持连接状态追踪
  - 详细文档：[2026-01-28-003-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-28-003-changelog.md)

#### Apex 开发工具包

- **代码覆盖率** (v1.0.0)
  - 实现 Salesforce Apex 代码覆盖率查询和统计功能
  - 支持代码覆盖率列表查询（多条件筛选、分页查询、覆盖率范围筛选）
  - 支持代码覆盖率详情查询（单条记录查询）
  - 支持总体代码覆盖率统计（总体、类、触发器覆盖率）
  - 支持按类型统计代码覆盖率（Class/Trigger 分组统计）
  - 提供 4 个 REST API 接口（2 个查询接口、2 个统计接口）
  - 复用 002-03 的 `datai_apex_code_coverage` 数据库表
  - 使用独立 Service 层（IApexCodeCoverageService）与测试执行功能解耦
  - 实现覆盖率计算算法（保留两位小数、除零保护）
  - 使用 PageHelper 进行分页查询优化
  - 使用数据库索引优化查询性能
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-02-03-002-04-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-03-002-04-changelog.md)

- **测试执行** (v1.0.0)
  - 实现 Salesforce Apex 测试执行功能，支持运行所有测试、按类运行测试、按包运行测试、按方法运行测试
  - 提供查询测试结果、测试详情、代码覆盖率、Flow 覆盖率等辅助功能
  - 支持 8 个 REST API 接口（4 个测试执行接口、4 个查询接口）
  - 使用数据库持久化存储测试结果、成功详情、失败详情、代码覆盖率、Flow 覆盖率
  - 复用 002-02 的 3 张数据库表（测试结果、测试失败详情、代码覆盖率）
  - 新建 2 张数据库表（测试成功详情、Flow 覆盖率）
  - 使用 ReentrantLock 保证多线程安全
  - 使用 @Transactional 保证数据一致性
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-02-02-002-03-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-02-002-03-changelog.md)

- **Apex 代码编译和执行** (v1.0.0)
  - 实现 Apex 代码编译和执行功能，包括编译 Apex 类、编译 Apex 触发器、编译并运行测试、执行匿名 Apex 代码
  - 提供查询编译历史、测试结果、代码覆盖率等辅助功能
  - 支持批量编译（类和触发器）
  - 支持执行匿名 Apex 代码片段
  - 提供 7 个 REST API 接口（3 个编译接口、1 个执行接口、3 个查询接口）
  - 使用数据库持久化存储编译历史、测试结果和代码覆盖率
  - 创建 4 张数据库表（编译历史、测试结果、测试失败详情、代码覆盖率）
  - 使用 ReentrantLock 保证多线程安全
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-02-02-002-02-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-02-002-02-changelog.md)

#### Partner API 集成模块

- **认证和会话管理** (v1.0.0)
  - 实现认证和会话管理功能，包括获取会话信息、获取用户信息、修改密码
  - 采用工厂模式管理 PartnerConnection 连接
  - 集成 SessionManager 进行会话管理
  - 支持连接缓存和自动 Session 有效性检查
  - 提供 RESTful API 接口（3 个接口）
  - 实现异常处理和日志记录
  - 实现权限控制（@PreAuthorize("@ss.hasLogin()")）
  - 实现 Swagger 文档注解
  - 详细文档：[2026-01-30-001-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-30-001-changelog.md)

- **CRUD 操作** (v1.0.0)
  - 实现 Salesforce Partner API 的 CRUD 操作功能，包括 Create、Retrieve、Update、Delete、Upsert、Merge 六个核心操作
  - 支持单条记录和批量记录操作（最多 200 条）
  - 提供 6 个 REST API 接口
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现 SObjectConverter 工具类，支持 Map 到 SObject 的转换
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-30-002-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-30-002-changelog.md)

- **批量操作** (v1.0.0)
  - 实现 Salesforce Partner API 的批量操作功能，包括批量创建、批量更新、批量删除、批量 Upsert 四个核心操作
  - 支持最多 1000 条记录，自动分批处理（每批最多 200 条）
  - 支持部分失败情况，提供详细的成功/失败统计
  - 提供 4 个 REST API 接口
  - 实现 AllOrNoneHeader 控制（可选全部成功或全部失败）
  - 使用 DisableFeedTrackingHeader 提高性能
  - 实现批次间休眠机制（可配置，默认 100ms）
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-30-003-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-30-003-changelog.md)

- **查询功能** (v1.0.0)
  - 实现 Salesforce Partner API 的查询功能，包括 SOQL 查询（Query）、查询所有记录（QueryAll）、分页查询（QueryMore）和 SOSL 搜索（Search）四个核心功能
  - 支持自定义批次大小（1-2000，默认 500）
  - 支持关系查询（如 Account.Name）
  - 支持跨对象搜索（SOSL）
  - 提供 4 个 REST API 接口
  - 实现 SObject 到 Map 的转换
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-01-30-004-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-30-004-changelog.md)

- **描述功能** (v1.0.0)
  - 实现 Salesforce Partner API 的描述功能，包括 DescribeGlobal、DescribeSObject、DescribeSObjects、DescribeLayout、DescribeTabs、DescribeQuickActions 六个核心功能
  - 支持获取 Salesforce 对象的元数据信息，包括字段定义、布局信息、标签页信息、快速操作信息等
  - 支持批量描述优化（DescribeSObjects 批量 API，最多 100 个对象）
  - 支持字段信息处理（类型、长度、精度、必填性等）
  - 支持 Picklist 字段处理（选项值、默认值、有效性规则）
  - 支持关系字段处理（引用对象、关系名称、级联删除）
  - 支持布局信息处理（字段布局、按钮布局、相关列表）
  - 提供 6 个 REST API 接口
  - 实现 DescribeResultConverter 工具类，将 Salesforce 描述结果转换为 Map<String, Object> 格式
  - 实现参数验证、异常处理、权限控制、Swagger 文档
  - 实现完整的单元测试，测试覆盖率不低于 80%
  - 详细文档：[2026-02-02-005-changelog.md](datai-scenes/datai-scene-salesforce/docs/changelog/2026-02-02-005-changelog.md)

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