EasyData极简数据管理指南：从入门到精通

📌 核心价值：为什么选择EasyData？

1. 极速开发：3行代码实现完整CRUD界面

EasyData作为专为ASP.NET Core设计的轻量级CRUD（创建/读取/更新/删除）框架，能够帮助开发者在几分钟内构建完整的数据管理界面。无需手动编写增删改查逻辑，只需配置数据上下文并启用中间件，即可自动生成API端点和交互界面。

2. 无缝集成：与现有项目零冲突融合

框架采用非侵入式设计，可与任何ASP.NET Core应用无缝集成。无论是新开发项目还是已有系统升级，都能在不影响现有业务逻辑的前提下，快速添加数据管理功能。

3. 灵活扩展：满足复杂业务需求

提供丰富的定制选项，从数据过滤、权限控制到UI样式调整，支持通过Fluent API进行深度配置，既适合简单的数据展示场景，也能应对企业级复杂业务需求。

🚀 场景化应用：3步开启数据管理之旅

1. 环境准备：5分钟项目配置

• 确保已安装.NET 6+ SDK和相应开发工具
• 通过包管理器安装核心依赖：Install-Package EasyData.AspNetCore
• 克隆项目仓库：git clone https://gitcode.com/gh_mirrors/ea/EasyData

2. 基础集成：核心代码实现

步骤1：配置数据上下文

创建继承DbContext的应用上下文类
定义实体集合属性映射数据库表
配置数据库连接字符串

步骤2：启用EasyData服务

在Program.cs中注册服务：AddEasyData()
配置中间件：UseEasyData(options => options.UseDbContext<AppDbContext>())

步骤3：创建访问端点

添加Razor页面或MVC视图
引入EasyData前端资源
配置路由映射

3. 运行验证：验证安装结果

启动应用程序，访问配置的路由地址，系统将自动生成包含以下功能的管理界面：

• 数据表格展示与分页
• 条件筛选与排序
• 添加/编辑/删除操作表单
• 数据导出功能

⚙️ 灵活配置：3种实用配置方案

1. 实体与属性过滤

通过配置可以精确控制哪些实体和属性需要展示：

options.Include<Product>(p => p
    .IncludeProperty(p => p.Name)
    .IncludeProperty(p => p.Price)
    .ExcludeProperty(p => p.Description)
)
.Exclude<OrderHistory>()

2. 自定义元数据

为实体和属性添加友好名称、描述和验证规则：

options.ConfigureEntity<Product>(e => {
    e.DisplayName = "商品信息";
    e.Description = "系统中的所有商品记录";
    e.Properties["Price"].DisplayName = "单价";
    e.Properties["Price"].ValidationRules.Add(new RangeRule(0, 9999));
})

3. 权限控制集成

结合ASP.NET Core授权系统实现数据访问控制：

options.SetAuthorizationPolicy(policy => {
    policy.RequireAuthenticatedUser();
    policy.RequireRole("Admin", "Editor");
})

配置决策树

💡 进阶技巧：提升使用体验

1. 性能优化：大数据集处理策略

• 启用服务器端分页：默认已实现，自动处理大量数据
• 配置查询缓存：options.EnableQueryCache(TimeSpan.FromMinutes(5))
• 优化实体关系加载：使用Include/Exclude控制关联数据加载

2. 前端定制：打造品牌化界面

• 自定义CSS样式覆盖默认主题
• 配置自定义操作按钮：options.AddCustomAction("export", "导出数据")
• 定制表单布局：通过JSON配置文件定义字段排列方式

3. 高级集成：与现有系统协同工作

• 集成自定义验证逻辑：实现IEntityValidator接口
• 数据操作事件钩子：options.OnEntityCreated((entity, user) => { ... })
• 自定义数据访问层：实现IEasyDataStore接口替换默认实现

常见场景解决方案

场景1：多租户数据隔离

问题：需要为不同客户展示各自的数据 解决方案：

1. 在DbContext中添加租户ID筛选
2. 通过中间件获取当前租户信息
3. 配置全局过滤：options.AddGlobalFilter<ITenantEntity>(e => e.TenantId == currentTenantId)

场景2：复杂数据关系展示

问题：需要在产品列表中展示关联的分类名称 解决方案：

1. 在实体配置中定义导航属性
2. 使用DisplayTemplate指定显示格式：[DisplayTemplate("CategoryName")]
3. 配置关联数据加载：options.Include<Product>(p => p.IncludeNavigation(p => p.Category))

场景3：自定义数据导入功能

问题：需要提供Excel批量导入功能 解决方案：

1. 创建自定义导入API端点
2. 使用EasyData的DataLoader处理导入数据
3. 添加导入验证与错误处理机制

扩展资源导航

官方文档

• 快速入门指南：docs/quick-start.md
• API参考手册：docs/api-reference.md
• 配置选项大全：docs/configuration.md

社区资源

• 示例项目集合：samples/
• 常见问题解答：docs/faq.md
• 第三方扩展：contrib/

视频教程

• 基础安装配置：tutorials/basic-setup.mp4
• 高级功能实现：tutorials/advanced-features.mp4
• 性能优化技巧：tutorials/performance-tuning.mp4