kris/datai
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
develop
datai/docs/archive/changelog/20260118-entity-mapper-create.md

6.4 KiB
Raw Permalink Blame History

变更记录 - 基础实体类和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

相关链接