234 lines
6.4 KiB
Markdown
234 lines
6.4 KiB
Markdown
# 变更记录 - 基础实体类和Mapper创建
|
||
|
||
## 变更概述
|
||
|
||
本次变更为9张数据库表创建了对应的Java实体类、Mapper接口和XML映射文件，使用MyBatis Plus框架，提供基础的CRUD操作，为后续功能开发提供数据访问基础。
|
||
|
||
## 变更时间
|
||
|
||
2026-01-19
|
||
|
||
## 变更类型
|
||
|
||
功能增强
|
||
|
||
## 影响范围
|
||
|
||
### 数据库表
|
||
|
||
- datai_meta_org_config - Salesforce组织配置表
|
||
- datai_meta_task - 元数据任务定义表
|
||
- datai_meta_package_item - 元数据包项表
|
||
- datai_meta_component - 元数据组件表
|
||
- datai_meta_component_version - 元数据组件版本表
|
||
- datai_meta_job_execution - 元数据作业执行表
|
||
- datai_meta_deploy_history - 元数据部署历史表
|
||
- datai_meta_deploy_component_result - 元数据部署组件结果表
|
||
- datai_meta_job_log - 元数据作业日志表
|
||
|
||
### 代码文件
|
||
|
||
#### 实体类
|
||
|
||
- com.datai.salesforce.metadata.entity.DataiMetaOrgConfig
|
||
- com.datai.salesforce.metadata.entity.DataiMetaTask
|
||
- com.datai.salesforce.metadata.entity.DataiMetaPackageItem
|
||
- com.datai.salesforce.metadata.entity.DataiMetaComponent
|
||
- com.datai.salesforce.metadata.entity.DataiMetaComponentVersion
|
||
- com.datai.salesforce.metadata.entity.DataiMetaJobExecution
|
||
- com.datai.salesforce.metadata.entity.DataiMetaDeployHistory
|
||
- com.datai.salesforce.metadata.entity.DataiMetaDeployComponentResult
|
||
- com.datai.salesforce.metadata.entity.DataiMetaJobLog
|
||
|
||
#### Mapper 接口
|
||
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaOrgConfigMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaTaskMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaPackageItemMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaComponentMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaComponentVersionMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaJobExecutionMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaDeployHistoryMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaDeployComponentResultMapper
|
||
- com.datai.salesforce.metadata.mapper.DataiMetaJobLogMapper
|
||
|
||
#### Mapper XML 文件
|
||
|
||
- DataiMetaOrgConfigMapper.xml
|
||
- DataiMetaTaskMapper.xml
|
||
- DataiMetaPackageItemMapper.xml
|
||
- DataiMetaComponentMapper.xml
|
||
- DataiMetaComponentVersionMapper.xml
|
||
- DataiMetaJobExecutionMapper.xml
|
||
- DataiMetaDeployHistoryMapper.xml
|
||
- DataiMetaDeployComponentResultMapper.xml
|
||
- DataiMetaJobLogMapper.xml
|
||
|
||
#### 配置文件
|
||
|
||
- application.yml - 配置 MyBatis Plus 扫描路径和分页插件
|
||
|
||
#### 单元测试
|
||
|
||
- DataiMetaOrgConfigTest
|
||
- DataiMetaTaskTest
|
||
- DataiMetaPackageItemTest
|
||
- DataiMetaComponentTest
|
||
- DataiMetaComponentVersionTest
|
||
- DataiMetaJobExecutionTest
|
||
- DataiMetaDeployHistoryTest
|
||
- DataiMetaDeployComponentResultTest
|
||
- DataiMetaJobLogTest
|
||
|
||
### 文档文件
|
||
|
||
- docs/requirements/REQ-010-2.md - 基础实体类和Mapper创建需求文档
|
||
- docs/decisions/adr/0011-entity-mapper-create.md - 基础实体类和Mapper创建架构决策
|
||
- docs/prompts/002-entity-mapper-create.md - 基础实体类和Mapper创建实现提示词
|
||
- docs/sessions/20260118-entity-mapper-create.md - 基础实体类和Mapper创建会话记录
|
||
- docs/changelog/20260118-entity-mapper-create.md - 基础实体类和Mapper创建变更记录
|
||
- docs/retros/20260118-entity-mapper-create-retro.md - 基础实体类和Mapper创建复盘报告
|
||
|
||
## 变更内容
|
||
|
||
### 新增功能
|
||
|
||
1. 实体类创建
|
||
- 使用 MyBatis Plus 注解创建实体类
|
||
- 使用 Lombok 简化实体类代码
|
||
- 使用 String 类型处理 TEXT 类型大字段
|
||
- 使用 @TableField(select = false) 注解保护敏感字段
|
||
|
||
2. Mapper 接口创建
|
||
- 使用 BaseMapper 提供基础的 CRUD 方法
|
||
- 使用 @Mapper 注解标记 Mapper 接口
|
||
|
||
3. Mapper XML 文件创建
|
||
- 使用 MyBatis Plus 的 XML 映射语法
|
||
- 配置 namespace 和 resultType 正确
|
||
|
||
4. 配置文件更新
|
||
- 配置 MyBatis Plus 扫描路径
|
||
- 配置 MyBatis Plus 分页插件
|
||
|
||
5. 单元测试创建
|
||
- 使用 Spring Boot Test 框架
|
||
- 测试所有实体类和 Mapper 接口
|
||
|
||
### 功能改进
|
||
|
||
- 无
|
||
|
||
### Bug 修复
|
||
|
||
- 无
|
||
|
||
### 性能优化
|
||
|
||
- 无
|
||
|
||
### 安全改进
|
||
|
||
- 使用 @TableField(select = false) 注解保护敏感字段（client_secret、password、security_token）
|
||
|
||
### 代码重构
|
||
|
||
- 无
|
||
|
||
## 兼容性说明
|
||
|
||
### 向后兼容性
|
||
|
||
本次变更为新增功能，不影响现有功能，完全向后兼容。
|
||
|
||
### 数据库变更
|
||
|
||
本次变更不涉及数据库结构变更，不需要数据库迁移。
|
||
|
||
### API 变更
|
||
|
||
本次变更不涉及 API 变更。
|
||
|
||
### 配置变更
|
||
|
||
本次变更需要更新 application.yml 配置文件，配置 MyBatis Plus 扫描路径和分页插件。
|
||
|
||
## 依赖变更
|
||
|
||
### 新增依赖
|
||
|
||
- MyBatis Plus - 3.5.5
|
||
- Lombok - 1.18.30
|
||
|
||
### 依赖升级
|
||
|
||
- 无
|
||
|
||
### 依赖移除
|
||
|
||
- 无
|
||
|
||
## 测试情况
|
||
|
||
### 单元测试
|
||
|
||
- DataiMetaOrgConfigTest - 通过
|
||
- DataiMetaTaskTest - 通过
|
||
- DataiMetaPackageItemTest - 通过
|
||
- DataiMetaComponentTest - 通过
|
||
- DataiMetaComponentVersionTest - 通过
|
||
- DataiMetaJobExecutionTest - 通过
|
||
- DataiMetaDeployHistoryTest - 通过
|
||
- DataiMetaDeployComponentResultTest - 通过
|
||
- DataiMetaJobLogTest - 通过
|
||
|
||
### 集成测试
|
||
|
||
- 无
|
||
|
||
### 性能测试
|
||
|
||
- 无
|
||
|
||
### 安全测试
|
||
|
||
- 无
|
||
|
||
## 已知问题
|
||
|
||
无
|
||
|
||
## 后续计划
|
||
|
||
1. 进行集成测试，确保功能正常
|
||
2. 进行性能测试，确保性能满足要求
|
||
3. 编写用户文档，说明如何使用实体类和 Mapper 接口
|
||
4. 监控实体类序列化和反序列化性能
|
||
5. 监控 Mapper 接口查询性能
|
||
6. 定期优化实体类和 Mapper 接口
|
||
|
||
## 回滚方案
|
||
|
||
如果需要回滚本次变更，请执行以下步骤：
|
||
|
||
1. 删除所有实体类文件
|
||
2. 删除所有 Mapper 接口文件
|
||
3. 删除所有 Mapper XML 文件
|
||
4. 恢复 application.yml 配置文件
|
||
5. 删除所有单元测试文件
|
||
|
||
## 审批信息
|
||
|
||
- 变更申请人: SSOT 架构师
|
||
- 变更审批人: 待审批
|
||
- 变更执行人: SSOT 架构师
|
||
- 变更时间: 2026-01-19
|
||
|
||
## 相关链接
|
||
|
||
- [REQ-010-2.md](../requirements/REQ-010-2.md) - 基础实体类和Mapper创建需求文档
|
||
- [0011-entity-mapper-create.md](../decisions/adr/0011-entity-mapper-create.md) - 基础实体类和Mapper创建架构决策
|
||
- [002-entity-mapper-create.md](../prompts/002-entity-mapper-create.md) - 基础实体类和Mapper创建实现提示词
|
||
- [20260118-entity-mapper-create.md](../sessions/20260118-entity-mapper-create.md) - 基础实体类和Mapper创建会话记录
|
||
- [20260118-entity-mapper-create-retro.md](../retros/20260118-entity-mapper-create-retro.md) - 基础实体类和Mapper创建复盘报告
|