升级

数据访问策略升级：EF Core 迁移到 Dapper

当前文档默认数据访问路径已经收敛为 Dapper / SQL，EF Core 仅作为遗留兼容方案保留。

如果项目仍依赖 DbContext、CrudRepository、AutoCommiterFilterAttribute 或 EF Core migration，升级时不要继续扩展 EF Core 面，而应按 EF Core 迁移到 Dapper 的分阶段规范收敛。

StartApplicationAsync 修改为异步

修改完成后需要带上默认的 DefaultMvcApplicationOptions。

对于 WebMvc/WebApi 项目需要设置 MvcBuilderCreateFunc。

await AgileLabApplication.StartApplicationAsync<DefaultMvcApplicationOptions>(options =>
{
	options.MvcBuilderCreateFunc = (IServiceCollection serviceCollection, Action<MvcOptions> action) => serviceCollection.AddControllersWithViews(action);
});

使用 IsIntegrateAspNetAuthentication

开启后不再需要手动注册 UseAuthentication() / UseAuthorization()，但仍需自行注册具体认证方案，例如 JWT Bearer、Cookie 或自定义认证 handler。完整引入步骤见 接入 ASP.NET Core 认证授权。

options.ConfigureHostBuilder += (IHostBuilder hostBuilder, AppBuildContext context) =>
{
	context.FeatureSwitch.IsIntegrateAspNetAuthentication = true;
};

AutoMapper 自动注册

services.RegisterAutoMapperServices(buildContext);