Base Business 通用 CRUD

Base Business 为应用自己的数据表提供可复用的 PO、DTO、VO、Query、Mapper 和 Service 抽象。例如，维护一张标签表时，应用定义字段、转换和查询规则，就能复用单条新增、修改、详情、列表及分页流程。

它属于 Component 的技术能力，不提供账号、组织、菜单等具体业务。Controller 的路由、数据权限、表结构和事务边界仍由应用定义。

能力与阅读入口

任务	内容	文档
接入第一张表	H2 演示、Mapper 扫描、模型转换、CRUD 接口	快速开始
定义实体和保存流程	审计字段、DTO 转换、服务 Hook、扩展 SQL 装配	使用与配置
查询和分页	条件与排序、简单/复杂分页、PageModel	查询与分页
编排关联和后台处理	单外键、双外键、对象绑定，以及合并任务触发	关系绑定与任务

接入坐标与装配

运行时依赖为 com.own.component:springboot-component-base-business:4.1.0-SNAPSHOT，由 Component BOM 管理版本，Java 包前缀为 com.own.component.base.business。该模块是 JAR，传递引入 Base、MyBatis-Plus Spring Boot 4 Starter、PageHelper Starter 和 Web。

本模块没有自己的 AutoConfiguration.imports 或配置属性开关。应用注册具体 Service、Controller 和 Mapper，并通过 @Import(MapperUtil.class) 或精确组件扫描注册 MapperUtil。仅在依赖中加入 JAR，不会生成表、注册业务路由或自动找到所有 Mapper。

与其他能力的边界

• Base 负责统一响应、异常、JSON、会话用户契约和执行器；Base Business 在其上提供持久化与 CRUD 抽象。
• 标准单条 CRUD 使用 MyBatis-Plus；BaseMapper 声明的额外批量、排序及忽略逻辑删除方法，还需要应用 SQL 映射或 springboot-component-mybatis 的 SQL 注入器。
• 模型提供审计字段和初始化方法，默认 CRUD 不自动调用它们；乐观锁也需要相应拦截器配合，不能仅凭继承字段认定已启用。
• 导入和 Word/Excel 导出默认只返回空 UploadModel，对象关系绑定基类也有待子类实现的契约。这些声明不代表已经提供文件处理或业务关联实现。

建议先完成单表快速开始，再根据实际使用的方法选择扩展。已有基础 Business模块的接口和权限规则，以对应业务文档为准。

按文件查阅方法

重点文件与方法逐项说明核心类、接口和方法重载的用途、参数、返回值、调用示例与注意事项，并链接到公开仓库对应源码。