438 lines
40 KiB
Markdown
438 lines
40 KiB
Markdown
# 变更摘要
|
||
|
||
## [Unreleased]
|
||
|
||
### Added
|
||
- 文件上传下载基础设施（REQ-011-1） - 实现了完整的文件上传下载基础设施，包括文件对象类型枚举、错误代码枚举、异常类、参数类、响应类和验证工具类
|
||
- FileObjectType 枚举类 - 文件对象类型枚举，包含 ATTACHMENT、CONTENT_DOCUMENT、DOCUMENT 三个值，包含 API 名称、描述、文件大小限制、推荐等级、上传方式和必填字段等元数据
|
||
- FileErrorCode 枚举类 - 错误代码枚举，包含 FILE_UPLOAD_FAILED、FILE_DOWNLOAD_FAILED、FILE_SIZE_EXCEEDED、FILE_TYPE_NOT_SUPPORTED、FILE_OBJECT_NOT_FOUND、ORG_CONFIG_NOT_FOUND、FILE_VALIDATION_FAILED、FILE_NOT_FOUND、FILE_READ_FAILED、FILE_WRITE_FAILED 10 个错误代码
|
||
- FileUploadException 异常类 - 文件上传异常，继承自 RuntimeException，包含错误代码和错误消息
|
||
- FileDownloadException 异常类 - 文件下载异常，继承自 RuntimeException，包含错误代码和错误消息
|
||
- FileSizeExceededException 异常类 - 文件大小超限异常，包含实际大小和最大限制
|
||
- FileTypeNotSupportedException 异常类 - 文件类型不支持异常，包含实际类型和支持的类型列表
|
||
- FileObjectNotFoundException 异常类 - 文件对象不存在异常，包含对象 ID 和对象类型
|
||
- OrgConfigNotFoundException 异常类 - 组织配置不存在异常，包含配置 ID
|
||
- FileValidationException 异常类 - 文件验证异常，包含验证类型
|
||
- FileUploadRequest 参数类 - 文件上传请求参数，包含组织配置 ID、文件对象类型、文件、关联记录 ID、文件名和描述，使用 Lombok 注解和 JSR-303 验证注解
|
||
- FileDownloadRequest 参数类 - 文件下载请求参数，包含组织配置 ID、文件对象类型、文件 ID 和保存路径，使用 Lombok 注解和 JSR-303 验证注解
|
||
- FileUploadResponse 响应类 - 文件上传响应，包含文件 ID、文件名、文件大小、文件类型、上传时间、状态和消息
|
||
- FileDownloadResponse 响应类 - 文件下载响应，包含文件名、文件大小、保存路径、下载时间、状态和消息
|
||
- FileValidationUtils 工具类 - 文件验证工具类，提供文件大小验证、文件类型验证、文件名验证、文件扩展名获取、文件 MIME 类型获取等功能，支持 13 种文件类型白名单和 13 种危险扩展名黑名单
|
||
- Attachment 文件上传下载功能（REQ-011-2） - 实现了 Salesforce Attachment 对象的文件上传下载功能，使用 REST API + Base64 编码方式进行文件上传，使用 REST API + 流式处理方式进行文件下载
|
||
- FileUploadStrategy 接口 - 文件上传策略接口，定义 upload() 方法，接收 FileUploadRequest 参数，返回 FileUploadResponse 响应
|
||
- FileDownloadStrategy 接口 - 文件下载策略接口，定义 download() 方法，接收 FileDownloadRequest 参数，返回 FileDownloadResponse 响应
|
||
- AttachmentUploadStrategy 类 - Attachment 上传策略实现，使用 REST API + Base64 编码方式上传文件，支持最大 50MB 文件大小，包含文件验证、会话管理、错误处理等功能
|
||
- AttachmentDownloadStrategy 类 - Attachment 下载策略实现，使用 REST API + 流式处理方式下载文件，使用 BufferedInputStream 和 ByteArrayOutputStream 避免内存溢出，包含会话管理、错误处理等功能
|
||
- AttachmentFileService 接口 - Attachment 文件服务接口，定义 uploadAttachment() 和 downloadAttachment() 方法
|
||
- AttachmentFileServiceImpl 类 - Attachment 文件服务实现，使用策略模式封装上传下载逻辑，通过 @Autowired 注入 FileUploadStrategy 和 FileDownloadStrategy
|
||
- ContentDocument/ContentVersion 文件上传下载功能（REQ-011-3） - 实现了 Salesforce ContentDocument/ContentVersion 对象的文件上传下载功能，使用 REST API + Multipart/form-data 方式进行文件上传，使用 REST API + 流式处理方式进行文件下载
|
||
- Apache HttpClient 依赖 - 在 datai-salesforce-integration 模块的 pom.xml 中引入 Apache HttpClient 依赖，包括 httpclient 4.5.13 和 httpmime 4.5.13
|
||
- ContentVersionUploadStrategy 类 - ContentVersion 上传策略实现，使用 REST API + Multipart/form-data 方式上传文件，支持最大 2GB 文件大小，包含文件验证、会话管理、错误处理等功能
|
||
- ContentVersionDownloadStrategy 类 - ContentVersion 下载策略实现，使用 REST API + 流式处理方式下载文件，使用 BufferedInputStream 和 ByteArrayOutputStream 避免内存溢出，包含会话管理、错误处理等功能
|
||
- ContentVersionFileService 接口 - ContentVersion 文件服务接口，定义 uploadContentVersion() 和 downloadContentVersion() 方法
|
||
- ContentVersionFileServiceImpl 类 - ContentVersion 文件服务实现，使用策略模式封装上传下载逻辑，通过 @Autowired 注入 FileUploadStrategy 和 FileDownloadStrategy
|
||
- Document 文件上传下载功能（REQ-011-4） - 实现了 Salesforce Document 对象的文件上传下载功能，使用 SOAP API + Base64 编码方式进行文件上传，使用 SOAP API + 流式处理方式进行文件下载
|
||
- DocumentUploadStrategy 类 - Document 上传策略实现，使用 SOAP API + Base64 编码方式上传文件，支持最大 20-30MB 文件大小，包含文件验证、会话管理、错误处理等功能
|
||
- DocumentDownloadStrategy 类 - Document 下载策略实现，使用 SOAP API + 流式处理方式下载文件，使用 BufferedInputStream 和 ByteArrayOutputStream 避免内存溢出，包含会话管理、错误处理等功能
|
||
- DocumentFileService 接口 - Document 文件服务接口，定义 uploadDocument() 和 downloadDocument() 方法
|
||
- DocumentFileServiceImpl 类 - Document 文件服务实现，使用策略模式封装上传下载逻辑，通过 @Autowired 注入 FileUploadStrategy 和 FileDownloadStrategy
|
||
- 文件上传下载 Controller 和 API 接口（REQ-011-5） - 实现了文件上传下载的 RESTful API 接口，支持 Attachment、ContentDocument、Document 三种文件对象类型，使用策略模式根据文件对象类型调用不同的 Service
|
||
- ApiResponse 统一响应类 - 统一响应格式，包含 code、message、data 三个字段，提供 success() 和 error() 静态方法
|
||
- FileController 控制器 - 文件上传下载控制器，提供 2 个 RESTful API 接口，支持文件上传和文件下载
|
||
- uploadFile 方法 - 文件上传接口（POST /files/upload），支持三种文件对象类型，使用 @RequestParam 和 @RequestPart 注解接收参数，使用 @Valid 注解进行参数验证，使用 @Operation、@Parameter、@ApiResponse 注解生成 API 文档，使用策略模式根据文件对象类型调用不同的 Service，返回统一的响应格式
|
||
- downloadFile 方法 - 文件下载接口（GET /files/download），支持三种文件对象类型，使用 @RequestParam 注解接收参数，使用 @Valid 注解进行参数验证，使用 @Operation、@Parameter、@ApiResponse 注解生成 API 文档，使用策略模式根据文件对象类型调用不同的 Service，返回统一的响应格式
|
||
- 元数据拉取核心功能（REQ-010-6） - 实现了完整的元数据拉取核心功能，包括手动触发拉取、异步拉取执行、状态监控、拉取历史记录、拉取进度查询、拉取取消功能
|
||
- JobExecutionStatus 枚举类 - 作业执行状态枚举，包含 PENDING、PROCESSING、SUCCESS、FAILED、PARTIAL_SUCCESS、CANCELLED 六个值，使用 @EnumValue 注解映射数据库值
|
||
- MetadataRetrieveController 控制器 - 元数据拉取控制器，提供 4 个 RESTful API 接口，支持手动触发拉取、查询拉取历史记录、查询拉取进度、取消拉取
|
||
- RetrieveRequest DTO - 拉取请求，包含 taskId 和 orgConfigId 字段
|
||
- RetrieveResponse DTO - 拉取响应，包含 jobId 和 message 字段
|
||
- RetrieveProgressResponse DTO - 拉取进度响应，包含 jobId、status、progress、message 字段
|
||
- IMetadataRetrieveService 服务接口 - 元数据拉取服务接口，定义 triggerRetrieve()、getRetrieveHistory()、getRetrieveProgress()、cancelRetrieve() 方法
|
||
- MetadataRetrieveServiceImpl 服务实现 - 元数据拉取服务实现，使用 MetadataApiClient 调用 retrieve() 方法，使用 @Async 注解实现异步执行，使用 ConcurrentHashMap 存储正在运行的作业
|
||
- RetrieveException 异常类 - 拉取异常，封装拉取异常
|
||
- 单元测试 - MetadataRetrieveServiceImplTest
|
||
- Metadata API客户端封装（REQ-010-5） - 实现了完整的Metadata API客户端封装功能，包括MetadataApiClient客户端类、retrieve()方法、deploy()方法、状态轮询机制、Zip文件处理、部署结果解析、错误处理机制、异步服务接口和实现、单元测试
|
||
- MetadataApiClient 客户端类 - Metadata API 客户端，使用 Salesforce WSC (Web Service Connector) 库，封装 Salesforce Metadata API 调用
|
||
- RetrieveRequest 类 - Retrieve 请求模型，包含 orgConfigId、packageNames、singlePackage、specificFiles、unpackaged、timeout 等字段
|
||
- RetrieveResult 类 - Retrieve 结果模型，包含 id、success、status、message、zipFile、fileProperties 等字段
|
||
- DeployRequest 类 - Deploy 请求模型，包含 orgConfigId、zipFile、allowMissingFiles、autoUpdatePackage、checkOnly、ignoreWarnings、performRetrieve、purgeOnDelete、rollbackOnError、testLevel、runTests、timeout 等字段
|
||
- DeployResult 类 - Deploy 结果模型，包含 id、success、status、message、startDate、finishDate、numberComponentErrors、numberComponentsDeployed、numberComponentsTotal、numberTestErrors、numberTestsCompleted、numberTestsTotal、testCoverage、messages 等字段
|
||
- DeployMessage 类 - Deploy 消息模型，包含 fileName、componentName、problem、line、column、success 等字段
|
||
- MetadataApiException 类 - Metadata API 异常，封装 API 调用异常
|
||
- AsyncConfig 配置类 - 异步配置，配置线程池，使用 ThreadPoolTaskExecutor 配置线程池
|
||
- IMetadataApiAsyncService 服务接口 - Metadata API 异步服务接口，定义 retrieveAsync() 和 deployAsync() 方法
|
||
- MetadataApiAsyncServiceImpl 服务实现 - Metadata API 异步服务实现，使用 @Async 注解实现异步执行，使用 CompletableFuture 支持异步结果
|
||
- 单元测试 - MetadataApiClientTest
|
||
- 元数据任务定义管理（REQ-010-4） - 实现了完整的元数据任务定义管理功能，包括任务定义CRUD、package.xml内容配置、调度类型选择、Cron表达式配置、任务验证功能
|
||
- ScheduleType 枚举类 - 调度类型枚举，包含 MANUAL 和 CRON 两个值，使用 @EnumValue 注解映射数据库值
|
||
- PackageXmlEditor 工具类 - package.xml 编辑器，使用 Java DOM 解析器处理 package.xml，支持添加、删除、查询元数据类型
|
||
- CronExpressionValidator 工具类 - Cron 表达式验证器，支持验证秒、分、时、日、月、周，支持通配符、范围、列表、步长
|
||
- MetadataTaskController 控制器 - 元数据任务控制器，提供 6 个 RESTful API 接口，支持元数据任务的增删改查和验证
|
||
- IMetadataTaskService 服务接口 - 元数据任务服务接口，定义元数据任务 CRUD 方法
|
||
- MetadataTaskServiceImpl 服务实现 - 元数据任务服务实现，使用 MyBatis Plus 的 BaseMapper 实现 CRUD
|
||
- ITaskValidationService 服务接口 - 任务验证服务接口，定义任务验证方法
|
||
- TaskValidationServiceImpl 服务实现 - 任务验证服务实现，使用 PackageXmlEditor 验证 package.xml，使用 CronExpressionValidator 验证 Cron 表达式
|
||
- TaskValidationResult 验证结果类 - 任务验证结果，提供成功和失败的静态工厂方法
|
||
- 单元测试 - MetadataTaskServiceImplTest
|
||
- Salesforce组织配置管理（REQ-010-3） - 实现了完整的Salesforce组织配置管理功能，包括组织配置CRUD、OAuth认证信息加密存储、环境类型管理、存储根路径配置、连接状态管理、配置验证功能
|
||
- EnvironmentType 枚举类 - 环境类型枚举，包含 SANDBOX 和 PRODUCTION 两个值，使用 @EnumValue 注解映射数据库值
|
||
- ConnectionStatus 枚举类 - 连接状态枚举，包含 ACTIVE、INACTIVE、AUTH_INVALID 三个值，使用 @EnumValue 注解映射数据库值
|
||
- EncryptionUtil 工具类 - 加密工具类，使用 Java Cryptography API 实现 AES 加密，使用 AES/CBC/PKCS5Padding 加密模式，使用 256 位密钥
|
||
- OrgConfigController 控制器 - Salesforce组织配置控制器，提供 6 个 RESTful API 接口，支持组织配置的增删改查和验证
|
||
- IOrgConfigService 服务接口 - 组织配置服务接口，定义组织配置 CRUD 方法
|
||
- OrgConfigServiceImpl 服务实现 - 组织配置服务实现，使用 MyBatis Plus 的 BaseMapper 实现 CRUD，使用 EncryptionUtil 加密敏感字段
|
||
- IOrgConfigValidationService 服务接口 - 组织配置验证服务接口，定义配置验证方法
|
||
- OrgConfigValidationServiceImpl 服务实现 - 组织配置验证服务实现，使用正则表达式验证 OAuth 信息格式，使用 @Async 注解实现异步验证
|
||
- OrgConfigValidationResult 验证结果类 - 组织配置验证结果，提供成功和失败的静态工厂方法
|
||
- application.yml - 配置加密密钥
|
||
- 单元测试 - OrgConfigServiceImplTest
|
||
- 基础实体类和Mapper创建（REQ-010-2） - 为9张数据库表创建了对应的Java实体类、Mapper接口和XML映射文件，使用MyBatis Plus框架，提供基础的CRUD操作
|
||
- DataiMetaOrgConfig 实体类 - Salesforce组织配置实体类，使用 @TableName 注解指定表名，使用 @TableId 注解标识主键，使用 @TableField 注解处理字段映射，使用 Lombok 简化代码，使用 @TableField(select = false) 注解保护敏感字段
|
||
- DataiMetaTask 实体类 - 元数据任务定义实体类
|
||
- DataiMetaPackageItem 实体类 - 元数据包项实体类
|
||
- DataiMetaComponent 实体类 - 元数据组件实体类
|
||
- DataiMetaComponentVersion 实体类 - 元数据组件版本实体类
|
||
- DataiMetaJobExecution 实体类 - 元数据作业执行实体类
|
||
- DataiMetaDeployHistory 实体类 - 元数据部署历史实体类
|
||
- DataiMetaDeployComponentResult 实体类 - 元数据部署组件结果实体类
|
||
- DataiMetaJobLog 实体类 - 元数据作业日志实体类
|
||
- DataiMetaOrgConfigMapper 接口 - Salesforce组织配置Mapper接口，继承 BaseMapper，使用 @Mapper 注解标记
|
||
- DataiMetaTaskMapper 接口 - 元数据任务定义Mapper接口
|
||
- DataiMetaPackageItemMapper 接口 - 元数据包项Mapper接口
|
||
- DataiMetaComponentMapper 接口 - 元数据组件Mapper接口
|
||
- DataiMetaComponentVersionMapper 接口 - 元数据组件版本Mapper接口
|
||
- DataiMetaJobExecutionMapper 接口 - 元数据作业执行Mapper接口
|
||
- DataiMetaDeployHistoryMapper 接口 - 元数据部署历史Mapper接口
|
||
- DataiMetaDeployComponentResultMapper 接口 - 元数据部署组件结果Mapper接口
|
||
- DataiMetaJobLogMapper 接口 - 元数据作业日志Mapper接口
|
||
- DataiMetaOrgConfigMapper.xml - Salesforce组织配置Mapper映射文件，配置 namespace 和 resultType
|
||
- DataiMetaTaskMapper.xml - 元数据任务定义Mapper映射文件
|
||
- DataiMetaPackageItemMapper.xml - 元数据包项Mapper映射文件
|
||
- DataiMetaComponentMapper.xml - 元数据组件Mapper映射文件
|
||
- DataiMetaComponentVersionMapper.xml - 元数据组件版本Mapper映射文件
|
||
- DataiMetaJobExecutionMapper.xml - 元数据作业执行Mapper映射文件
|
||
- DataiMetaDeployHistoryMapper.xml - 元数据部署历史Mapper映射文件
|
||
- DataiMetaDeployComponentResultMapper.xml - 元数据部署组件结果Mapper映射文件
|
||
- DataiMetaJobLogMapper.xml - 元数据作业日志Mapper映射文件
|
||
- application.yml - 配置 MyBatis Plus 扫描路径和分页插件
|
||
- 单元测试 - DataiMetaOrgConfigTest、DataiMetaTaskTest、DataiMetaPackageItemTest、DataiMetaComponentTest、DataiMetaComponentVersionTest、DataiMetaJobExecutionTest、DataiMetaDeployHistoryTest、DataiMetaDeployComponentResultTest、DataiMetaJobLogTest
|
||
- 性能优化和限流处理（REQ-010-17） - 实现了完整的性能优化和限流处理功能，包括API限流处理、并发控制、缓存优化、数据库优化、文件处理优化、性能监控
|
||
- RateLimitConfig 配置类 - 限流配置类，使用 Guava RateLimiter 实现令牌桶算法
|
||
- @RateLimit 注解 - 限流注解，定义注解属性
|
||
- RateLimitAspect 切面类 - 限流切面，使用 AOP 实现限流功能
|
||
- RateLimitException 异常类 - 限流异常类，统一管理限流异常
|
||
- RateLimitService 服务类 - 限流服务，使用 Spring Retry 实现重试机制
|
||
- ThreadPoolConfig 配置类 - 线程池配置类，配置线程池参数
|
||
- PriorityTask 任务类 - 优先级任务类，支持任务优先级
|
||
- ConcurrencyControlService 服务类 - 并发控制服务，使用 @Async 实现异步执行
|
||
- CacheConfig 配置类 - 缓存配置类，配置 Redis 缓存
|
||
- CacheService 服务类 - 缓存服务，使用 Spring Cache 注解简化缓存操作
|
||
- BatchOperationService 服务类 - 批量操作服务，使用 MyBatis Plus 的批量操作功能
|
||
- QueryOptimizationService 服务类 - 查询优化服务，使用 MyBatis Plus 的分页插件实现分页查询
|
||
- FileProcessingService 服务类 - 流式文件处理服务，使用 Java 的 Stream API 实现流式处理大文件
|
||
- ParallelFileProcessingService 服务类 - 并行文件处理服务，使用 CompletableFuture 实现并行处理多个文件
|
||
- PerformanceMonitoringConfig 配置类 - 性能监控配置类，使用 Micrometer 创建性能指标
|
||
- PerformanceMonitoringService 服务类 - 性能监控服务，使用 Micrometer 收集性能指标
|
||
- 异常处理机制完善（REQ-010-16） - 实现了完整的异常处理机制完善功能，包括异常捕获、异常分类、异常处理、异常恢复、异常告警、异常日志
|
||
- GlobalExceptionHandler 全局异常处理器 - 提供统一的异常处理，使用 @ControllerAdvice 和 @ExceptionHandler 注解
|
||
- ExceptionLogController 控制器 - 提供 4 个 RESTful API 接口，支持异常日志查询、删除
|
||
- RecoveryController 控制器 - 提供 6 个 RESTful API 接口，支持恢复点创建、查询、恢复、删除
|
||
- ExceptionAlarmController 控制器 - 提供 6 个 RESTful API 接口，支持异常告警创建、查询、发送、删除
|
||
- IExceptionLogService 服务接口 - 定义异常日志服务接口
|
||
- ExceptionLogServiceImpl 服务实现 - 实现异常日志服务，使用日志框架记录异常日志，使用 MyBatis Plus 实现异常日志查询
|
||
- IRecoveryService 服务接口 - 定义恢复服务接口
|
||
- RecoveryServiceImpl 服务实现 - 实现恢复服务，使用状态机管理恢复过程，使用恢复点记录恢复状态
|
||
- IExceptionAlarmService 服务接口 - 定义异常告警服务接口
|
||
- ExceptionAlarmServiceImpl 服务实现 - 实现异常告警服务，使用消息队列异步发送告警
|
||
- ExceptionType 枚举 - 异常类型枚举（NETWORK、API_CALL、FILE_OPERATION、DATABASE_OPERATION、BUSINESS_LOGIC）
|
||
- ExceptionLevel 枚举 - 异常级别枚举（INFO、WARN、ERROR、FATAL）
|
||
- ExceptionSource 枚举 - 异常来源枚举（METADATA_RETRIEVE、METADATA_DEPLOY、FILE_STORAGE、DATABASE）
|
||
- BaseException 基类 - 自定义异常基类
|
||
- NetworkException 网络异常类 - 网络异常类
|
||
- ApiCallException API 调用异常类 - API 调用异常类
|
||
- FileOperationException 文件操作异常类 - 文件操作异常类
|
||
- DatabaseOperationException 数据库操作异常类 - 数据库操作异常类
|
||
- BusinessLogicException 业务逻辑异常类 - 业务逻辑异常类
|
||
- ExceptionLog 实体类 - 异常日志实体类
|
||
- RecoveryPoint 实体类 - 恢复点实体类
|
||
- ExceptionAlarm 实体类 - 异常告警实体类
|
||
- ExceptionLogMapper 接口 - 异常日志 Mapper 接口
|
||
- RecoveryPointMapper 接口 - 恢复点 Mapper 接口
|
||
- ExceptionAlarmMapper 接口 - 异常告警 Mapper 接口
|
||
- 详细日志记录和查询（REQ-010-15） - 实现了完整的详细日志记录和查询功能，包括日志记录、日志查询、日志导出、日志分析
|
||
- LogQueryController 控制器 - 提供 4 个 RESTful API 接口，支持日志列表查询、条件查询、时间范围查询、作业ID查询
|
||
- LogExportController 控制器 - 提供 6 个 RESTful API 接口，支持日志导出为文本文件、Excel 文件、CSV 文件，支持按条件导出
|
||
- LogAnalysisController 控制器 - 提供 5 个 RESTful API 接口，支持日志分析、日志趋势分析、日志统计分析
|
||
- IOperationLogService 服务接口 - 定义操作日志服务接口
|
||
- OperationLogServiceImpl 服务实现 - 实现操作日志服务，使用异步日志记录，使用日志框架记录日志
|
||
- ILogQueryService 服务接口 - 定义日志查询服务接口
|
||
- LogQueryServiceImpl 服务实现 - 实现日志查询服务，使用 MyBatis Plus 的 QueryWrapper 实现多条件查询，使用分页插件实现分页
|
||
- ILogExportService 服务接口 - 定义日志导出服务接口
|
||
- LogExportServiceImpl 服务实现 - 实现日志导出服务，使用 Apache POI 和 EasyExcel 实现 Excel 文件导出，使用流式处理大文件导出
|
||
- ILogAnalysisService 服务接口 - 定义日志分析服务接口
|
||
- LogAnalysisServiceImpl 服务实现 - 实现日志分析服务，使用聚合查询实现日志统计，使用图表展示分析结果
|
||
- LogLevel 枚举 - 日志级别枚举（INFO、WARN、ERROR）
|
||
- OperationLog 实体类 - 操作日志实体类
|
||
- OperationLogMapper 接口 - 操作日志 Mapper 接口
|
||
- 作业执行监控（REQ-010-14） - 实现了完整的作业执行监控功能，包括作业状态监控、作业进度监控、作业耗时统计、作业失败告警、作业列表查询
|
||
- JobStatusController 控制器 - 提供 8 个 RESTful API 接口，支持作业状态创建、查询、更新、删除
|
||
- JobProgressController 控制器 - 提供 3 个 RESTful API 接口，支持作业进度查询、更新
|
||
- JobStatisticsController 控制器 - 提供 5 个 RESTful API 接口，支持作业耗时统计、作业统计查询
|
||
- JobAlarmController 控制器 - 提供 5 个 RESTful API 接口，支持作业告警创建、查询、发送、删除
|
||
- JobQueryController 控制器 - 提供 4 个 RESTful API 接口，支持作业列表查询、条件查询、时间范围查询
|
||
- IJobExecutionService 服务接口 - 定义作业执行服务接口
|
||
- JobExecutionServiceImpl 服务实现 - 实现作业执行服务，使用 MyBatis Plus 的 BaseMapper
|
||
- IJobProgressService 服务接口 - 定义作业进度服务接口
|
||
- JobProgressServiceImpl 服务实现 - 实现作业进度服务，使用缓存提高查询性能
|
||
- IJobStatisticsService 服务接口 - 定义作业统计服务接口
|
||
- JobStatisticsServiceImpl 服务实现 - 实现作业统计服务，使用时间戳记录作业开始和结束时间
|
||
- IJobAlarmService 服务接口 - 定义作业告警服务接口
|
||
- JobAlarmServiceImpl 服务实现 - 实现作业告警服务，使用消息队列异步发送告警
|
||
- IJobQueryService 服务接口 - 定义作业查询服务接口
|
||
- JobQueryServiceImpl 服务实现 - 实现作业查询服务，使用 MyBatis Plus 的 BaseMapper 和分页插件
|
||
- JobStatus 枚举 - 作业状态枚举（PENDING、RUNNING、SUCCESS、FAILED、CANCELLED）
|
||
- JobType 枚举 - 作业类型枚举（RETRIEVE、DEPLOY、QUICK_DEPLOY、DESTRUCTIVE_CHANGES）
|
||
- JobExecution 实体类 - 作业执行实体类
|
||
- JobAlarm 实体类 - 作业告警实体类
|
||
- JobExecutionMapper 接口 - 作业执行 Mapper 接口
|
||
- JobAlarmMapper 接口 - 作业告警 Mapper 接口
|
||
- 复用 IMetadataRetrieveService 服务接口 - 元数据拉取服务接口，用于监控拉取作业
|
||
- 复用 IMetadataDeployService 服务接口 - 元数据部署服务接口，用于监控部署作业
|
||
- 版本回溯功能（REQ-010-13） - 实现了完整的版本回溯功能，支持查看和恢复历史版本的元数据文件
|
||
- VersionHistoryController 控制器 - 提供 8 个 RESTful API 接口，支持版本历史记录创建、查询、删除
|
||
- VersionComparisonController 控制器 - 提供 3 个 RESTful API 接口，支持版本对比、文件内容对比、文件哈希对比
|
||
- VersionRecoveryController 控制器 - 提供 1 个 RESTful API 接口，支持版本恢复
|
||
- VersionRollbackController 控制器 - 提供 1 个 RESTful API 接口，支持版本回滚
|
||
- IMetadataVersionService 服务接口 - 定义元数据版本服务接口
|
||
- MetadataVersionServiceImpl 服务实现 - 实现元数据版本服务，使用 MyBatis Plus 的 BaseMapper
|
||
- IVersionComparisonService 服务接口 - 定义版本对比服务接口
|
||
- VersionComparisonServiceImpl 服务实现 - 实现版本对比服务，使用 Google Diff Match Patch 库
|
||
- IVersionRecoveryService 服务接口 - 定义版本恢复服务接口
|
||
- VersionRecoveryServiceImpl 服务实现 - 实现版本恢复服务，使用 @Transactional 注解确保恢复原子性
|
||
- IVersionRollbackService 服务接口 - 定义版本回滚服务接口
|
||
- VersionRollbackServiceImpl 服务实现 - 实现版本回滚服务，使用 @Transactional 注解确保回滚原子性
|
||
- MetadataVersion 实体类 - 元数据版本实体类
|
||
- MetadataVersionMapper 接口 - 元数据版本 Mapper 接口
|
||
- DTO 类 - VersionHistoryCreateRequest、VersionHistoryCreateResponse、VersionHistoryQueryRequest、VersionHistoryQueryResponse、VersionComparisonRequest、VersionComparisonResponse、FileContentComparisonRequest、FileContentComparisonResponse、FileHashComparisonRequest、FileHashComparisonResponse、VersionRecoveryRequest、VersionRecoveryResponse、VersionRollbackRequest、VersionRollbackResponse
|
||
- 异常类 - VersionHistoryException、VersionComparisonException、VersionRecoveryException、VersionRollbackException
|
||
- 复用 IFileStorageService 接口 - 文件存储服务接口，用于读取文件内容
|
||
- 复用 IMetadataRetrieveService 服务接口 - 元数据拉取服务接口，用于版本恢复
|
||
- 复用 IMetadataDeployService 服务接口 - 元数据部署服务接口，用于版本回滚
|
||
- 文件哈希对比和增量检测（REQ-010-12） - 实现了完整的文件哈希对比和增量检测功能，支持检测文件变化，只拉取或部署变化的文件
|
||
- FileHashController 控制器 - 提供 2 个 RESTful API 接口，支持文件哈希计算、批量哈希计算
|
||
- HashComparisonController 控制器 - 提供 2 个 RESTful API 接口，支持哈希对比、查找变化文件
|
||
- IncrementalDetectionController 控制器 - 提供 3 个 RESTful API 接口，支持增量检测、监听文件系统、停止监听
|
||
- IncrementalRetrieveController 控制器 - 提供 1 个 RESTful API 接口，支持增量拉取
|
||
- IncrementalDeployController 控制器 - 提供 1 个 RESTful API 接口，支持增量部署
|
||
- IFileHashService 服务接口 - 定义文件哈希服务接口
|
||
- FileHashServiceImpl 服务实现 - 实现文件哈希服务，使用 SHA-256 算法，使用流式处理大文件
|
||
- IHashComparisonService 服务接口 - 定义哈希对比服务接口
|
||
- HashComparisonServiceImpl 服务实现 - 实现哈希对比服务，使用并行处理提高对比性能
|
||
- IIncrementalDetectionService 服务接口 - 定义增量检测服务接口
|
||
- IncrementalDetectionServiceImpl 服务实现 - 实现增量检测服务，使用哈希对比和文件系统监听器
|
||
- IIncrementalRetrieveService 服务接口 - 定义增量拉取服务接口
|
||
- IncrementalRetrieveServiceImpl 服务实现 - 实现增量拉取服务，复用 IMetadataRetrieveService
|
||
- IIncrementalDeployService 服务接口 - 定义增量部署服务接口
|
||
- IncrementalDeployServiceImpl 服务实现 - 实现增量部署服务，复用 IMetadataDeployService
|
||
- ChangeType 枚举 - 文件变化类型枚举（ADDED、MODIFIED、DELETED）
|
||
- FileChange 实体类 - 文件变化实体类
|
||
- FileChangeMapper 接口 - 文件变化 Mapper 接口
|
||
- DTO 类 - FileHashCalculateRequest、FileHashCalculateResponse、FileHashBatchCalculateRequest、FileHashBatchCalculateResponse、HashComparisonRequest、HashComparisonResponse、ChangedFilesFindRequest、ChangedFilesFindResponse、IncrementalDetectionRequest、IncrementalDetectionResponse、IncrementalRetrieveRequest、IncrementalRetrieveResponse、IncrementalDeployRequest、IncrementalDeployResponse
|
||
- 异常类 - FileHashException、HashComparisonException、IncrementalDetectionException、IncrementalRetrieveException、IncrementalDeployException
|
||
- 复用 IFileStorageService 接口 - 文件存储服务接口，用于读取文件内容
|
||
- 复用 IMetadataRetrieveService 服务接口 - 元数据拉取服务接口，用于增量拉取
|
||
- 复用 IMetadataDeployService 服务接口 - 元数据部署服务接口，用于增量部署
|
||
- 元数据组件索引和查询（REQ-010-11） - 实现了完整的元数据组件索引和查询功能，支持按类型、名称、版本等条件查询元数据组件
|
||
- MetadataComponentIndexController 控制器 - 提供 8 个 RESTful API 接口，支持组件索引创建、组件查询、组件详情查看、组件统计
|
||
- IMetadataComponentIndexService 服务接口 - 定义组件索引服务接口
|
||
- MetadataComponentIndexServiceImpl 服务实现 - 实现组件索引服务，支持异步索引创建
|
||
- IMetadataComponentQueryService 服务接口 - 定义组件查询服务接口
|
||
- MetadataComponentQueryServiceImpl 服务实现 - 实现组件查询服务，使用 MyBatis Plus 的 QueryWrapper 实现多条件查询
|
||
- IMetadataComponentDetailService 服务接口 - 定义组件详情服务接口
|
||
- MetadataComponentDetailServiceImpl 服务实现 - 实现组件详情服务，支持查看组件文件内容和依赖关系
|
||
- IMetadataComponentStatisticsService 服务接口 - 定义组件统计服务接口
|
||
- MetadataComponentStatisticsServiceImpl 服务实现 - 实现组件统计服务，使用 MyBatis Plus 的聚合查询实现统计功能
|
||
- MetadataComponentParser 接口 - 元数据组件解析器接口
|
||
- ApexClassParser 实现类 - Apex Class 解析器
|
||
- VisualforcePageParser 实现类 - Visualforce Page 解析器
|
||
- CustomObjectParser 实现类 - Custom Object 解析器
|
||
- CustomFieldParser 实现类 - Custom Field 解析器
|
||
- MetadataComponentIndex 实体类 - 元数据组件索引实体类
|
||
- MetadataComponentIndexMapper 接口 - 元数据组件索引 Mapper 接口
|
||
- DTO 类 - ComponentIndexRequest、ComponentIndexResponse、ComponentQueryRequest、ComponentQueryResponse、ComponentDetailResponse、ComponentStatisticsResponse、ComponentTypeDistributionResponse、ComponentVersionDistributionResponse
|
||
- ComponentIndexException 异常类 - 组件索引异常类
|
||
- 复用 IFileStorageService 接口 - 文件存储服务接口，用于读取组件文件内容
|
||
- Destructive Changes功能实现（REQ-010-10） - 实现了完整的 Destructive Changes 功能，支持部署时删除指定的元数据组件，使用 destructiveChanges.xml 配置删除规则
|
||
- DestructiveChangesController 控制器 - 提供 6 个 RESTful API 接口，支持 destructiveChanges.xml 配置、Destructive Changes 部署、Destructive Changes 验证、Destructive Changes 历史记录、Destructive Changes 回滚
|
||
- IDestructiveChangesService 服务接口 - 定义 Destructive Changes 服务接口
|
||
- DestructiveChangesServiceImpl 服务实现 - 实现 Destructive Changes 服务，支持异步执行和状态管理
|
||
- IDestructiveChangesConfigService 服务接口 - 定义 Destructive Changes 配置服务接口
|
||
- DestructiveChangesConfigServiceImpl 服务实现 - 实现 Destructive Changes 配置服务，支持 destructiveChanges.xml 配置和验证
|
||
- DestructiveChangesXmlParser 工具类 - Destructive Changes XML 解析器，验证 destructiveChanges.xml 格式
|
||
- DestructiveChangesXmlBuilder 工具类 - Destructive Changes XML 构建器，构建 destructiveChanges.xml
|
||
- DestructiveChangeRule 实体类 - Destructive Change Rule 实体类
|
||
- DestructiveChangeRuleMapper 接口 - Destructive Change Rule Mapper 接口
|
||
- DTO 类 - DestructiveChangesConfigRequest、DestructiveChangesConfigResponse、DestructiveChangesValidateRequest、DestructiveChangesValidateResponse、DestructiveChangesDeployRequest、DestructiveChangesDeployResponse、DestructiveChangesHistoryResponse、DestructiveChangesRollbackRequest、DestructiveChangesRollbackResponse
|
||
- DestructiveChangesException 异常类 - Destructive Changes 异常类
|
||
- 复用 AsyncConfig 配置类 - 异步配置，自定义线程池
|
||
- Quick Deploy功能实现（REQ-010-9） - 实现了完整的 Quick Deploy 功能，支持基于最近一次成功的部署记录快速重新部署，无需重新运行测试
|
||
- QuickDeployController 控制器 - 提供 4 个 RESTful API 接口，支持 Quick Deploy 触发、进度查询、取消操作、历史记录查询
|
||
- IQuickDeployService 服务接口 - 定义 Quick Deploy 服务接口
|
||
- QuickDeployServiceImpl 服务实现 - 实现 Quick Deploy 服务，支持异步执行和状态管理
|
||
- DTO 类 - QuickDeployTriggerRequest、QuickDeployTriggerResponse、QuickDeployProgressResponse、QuickDeployHistoryResponse、QuickDeployResult
|
||
- 复用 DeployStatus 枚举 - 定义 Quick Deploy 状态（Pending/Processing/Success/Failed/Partial_Success/Cancelled）
|
||
- 复用 AsyncConfig 配置类 - 异步配置，自定义线程池
|
||
- 复用 DeployException 异常类 - Quick Deploy 异常
|
||
- 元数据部署核心功能（REQ-010-8） - 实现了完整的 Salesforce 元数据部署核心功能，包括手动触发部署、异步部署执行、状态监控、部署历史记录、部署进度查询、部署取消功能、部署结果解析
|
||
- DeployStatus 枚举 - 定义部署状态（Pending/Processing/Success/Failed/Partial_Success/Cancelled）
|
||
- MetadataDeployController 控制器 - 提供 4 个 RESTful API 接口，支持部署触发、进度查询、取消操作、历史记录查询
|
||
- IMetadataDeployService 服务接口 - 定义元数据部署服务接口
|
||
- MetadataDeployServiceImpl 服务实现 - 实现元数据部署服务，支持异步执行和状态管理
|
||
- DTO 类 - DeployTriggerRequest、DeployTriggerResponse、DeployProgressResponse、DeployHistoryResponse、DeployResult
|
||
- AsyncConfig 配置类 - 异步配置，自定义线程池
|
||
- DeployException 异常类 - 部署异常
|
||
- 文件存储和解压处理（REQ-010-7） - 实现了完整的文件存储和解压处理功能，包括 Zip 文件存储、文件解压、文件路径管理、存储空间管理和文件清理
|
||
- IFileStorageService 接口 - 文件存储服务接口，支持存储、读取、删除、存在性检查
|
||
- LocalStorageService 实现类 - 本地文件系统存储实现，支持配置动态切换
|
||
- OssStorageService 实现类 - OSS 存储实现，使用阿里云 OSS SDK
|
||
- IFileExtractService 接口 - 文件解压服务接口，支持进度回调和取消操作
|
||
- FileExtractServiceImpl 实现类 - 文件解压服务实现，使用 ZipInputStream 实现流式解压
|
||
- PathValidator 工具类 - 路径验证工具类，使用 Path API 和正则表达式验证路径安全性
|
||
- IStorageMonitorService 接口 - 存储空间监控服务接口
|
||
- StorageMonitorServiceImpl 实现类 - 存储空间监控服务实现，使用定时任务定期检查存储空间
|
||
- IFileCleanupService 接口 - 文件清理服务接口
|
||
- FileCleanupServiceImpl 实现类 - 文件清理服务实现，使用定时任务定期清理过期文件
|
||
- DTO 类 - FileStorageRequest、FileStorageResponse、FileExtractRequest、FileExtractResponse、ExtractProgressCallback、StorageSpaceInfo、FileCleanupRequest、FileCleanupResponse
|
||
- 枚举类 - StorageType、ExtractStatus
|
||
- 配置类 - FileStorageConfig、OssConfig
|
||
- 异常类 - FileStorageException、FileExtractException、PathSecurityException
|
||
- 工具类 - FileUtil、ZipUtil
|
||
- 单元测试 - LocalStorageServiceTest、FileExtractServiceTest、PathValidatorTest、StorageMonitorServiceTest、FileCleanupServiceTest、FileUtilTest、ZipUtilTest
|
||
- 元数据拉取核心功能（REQ-010-6） - 实现了完整的 Salesforce 元数据拉取核心功能，包括手动触发拉取、异步拉取执行、状态监控、拉取历史记录、拉取进度查询、拉取取消功能
|
||
- RetrieveStatus 枚举 - 定义拉取状态（Pending/Processing/Success/Failed/Partial_Success/Cancelled）
|
||
- MetadataRetrieveController 控制器 - 提供 4 个 RESTful API 接口，支持拉取触发、进度查询、取消操作、历史记录查询
|
||
- IMetadataRetrieveService 服务接口 - 定义元数据拉取服务接口
|
||
- MetadataRetrieveServiceImpl 服务实现 - 实现元数据拉取服务，支持异步执行和状态管理
|
||
- DTO 类 - RetrieveTriggerRequest、RetrieveTriggerResponse、RetrieveProgressResponse、RetrieveHistoryResponse
|
||
- 前端组件 - MetadataRetrieve.vue，基于 Vue 3 和 Element Plus 的元数据拉取界面
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.15] - 2026-01-17
|
||
|
||
### Added
|
||
- 数据库表结构设计和创建 - 为 Salesforce 元数据拉取和部署功能（REQ-010-1）设计了 6 个核心数据库表，采用 MyBatis Plus + MySQL 技术栈
|
||
- datai_meta_org_config - Salesforce组织配置表，支持 OAuth2 和 JWT 两种认证方式
|
||
- datai_meta_task - 元数据任务定义表，支持多种任务类型和版本控制
|
||
- datai_meta_job_execution - 作业执行记录表，跟踪作业执行状态和进度
|
||
- datai_meta_component - 元数据组件索引表，支持版本管理和哈希对比
|
||
- datai_meta_deploy_history - 部署历史记录表，记录部署详细信息
|
||
- datai_meta_job_log - 作业执行日志表，记录详细日志信息
|
||
- 索引策略优化 - 为每个表设计了合理的索引策略，确保查询性能
|
||
- 数据安全设计 - 对敏感字段进行了加密存储设计（client_secret、password、security_token、access_token、refresh_token）
|
||
- 命名规范统一 - 所有表名统一使用 datai_meta_ 前缀，与现有项目表结构保持一致
|
||
- 基础字段标准化 - 所有表包含标准基础字段（dept_id, create_by, create_time, update_by, update_time, remark）
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.14] - 2026-01-16
|
||
|
||
### Added
|
||
- updateObjectDataToTarget 更新数据进度跟踪功能 - 复用现有的内存存储方案（ConcurrentHashMap）存储进度信息，更新任务完成后立即清除进度信息，不保留历史记录
|
||
- 更新进度查询接口 - 支持按对象ID查询更新进度和查询所有正在更新的对象进度
|
||
- 更新进度跟踪集成 - 在 updateObjectDataToTarget 方法中集成了进度跟踪功能，与 syncObjectData 同步进度跟踪功能和 insertObjectDataToTarget 插入数据进度跟踪功能保持一致
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.13] - 2026-01-16
|
||
|
||
### Added
|
||
- insertObjectDataToTarget 插入数据进度跟踪功能 - 复用现有的内存存储方案（ConcurrentHashMap）存储进度信息，插入任务完成后立即清除进度信息，不保留历史记录
|
||
- 插入进度查询接口 - 支持按对象ID查询插入进度和查询所有正在插入的对象进度
|
||
- 插入进度跟踪集成 - 在 insertObjectDataToTarget 方法中集成了进度跟踪功能，与 syncObjectData 同步进度跟踪功能保持一致
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.12] - 2026-01-16
|
||
|
||
### Added
|
||
- syncObjectData 同步进度跟踪功能 - 使用内存存储方案（ConcurrentHashMap）存储进度信息，同步任务完成后立即清除进度信息，不保留历史记录
|
||
- 进度查询接口 - 支持按对象ID查询进度和查询所有正在同步的对象进度
|
||
- 进度跟踪服务 - 创建了 ISyncProgressService 接口和 SyncProgressServiceImpl 实现类，支持并发访问
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.11] - 2026-01-13
|
||
|
||
### Added
|
||
- 目标ORG登录功能 - 支持目标ORG的独立认证管理，为双向同步提供基础
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## [0.1.0] - 2026-01-08
|
||
|
||
### Added
|
||
- 项目初始化
|
||
- 认证模块：datai-salesforce-auth
|
||
- 通用模块：datai-salesforce-common
|
||
- 集成模块：datai-salesforce-integration
|
||
- 支持多种 Salesforce API：Bulk API v1/v2、Partner API、REST API
|
||
|
||
### Changed
|
||
- 无
|
||
|
||
### Fixed
|
||
- 无
|
||
|
||
## 变更记录规范
|
||
|
||
本文件遵循 [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) 规范，记录项目的重要变更。
|
||
|
||
### 变更类型
|
||
|
||
- **Added**: 新增功能
|
||
- **Changed**: 功能变更
|
||
- **Fixed**: 问题修复
|
||
- **Deprecated**: 废弃功能
|
||
- **Removed**: 移除功能
|
||
- **Security**: 安全相关
|
||
|
||
### 版本号格式
|
||
|
||
采用语义化版本号格式：MAJOR.MINOR.PATCH
|
||
|
||
- **MAJOR**: 不兼容的 API 变更
|
||
- **MINOR**: 向下兼容的功能新增
|
||
- **PATCH**: 向下兼容的问题修复
|
||
|
||
### 变更记录要求
|
||
|
||
- 每个版本的变更必须包含日期
|
||
- 变更描述必须清晰、简洁
|
||
- 重大变更必须详细说明影响
|
||
- 变更必须与代码提交对应
|