开始一个新模块
实体放哪?分层说明
默认精简结构:业务实体直接放 EasyAdminBlazor.Demo/Entities/(演示项目)或你自己的业务项目 Entities/ 文件夹下。
大型项目(有接口、有前台、有后台等多个入口)可以自行拆层:
- 新增共享层(如
XXX.Application/XXX.Core),放实体、DTO、公共服务等共用代码; - API、Web 前台、Admin 后台等宿主项目各自引用共享层;
- 常见做法:共享层(
Core/Application)承载实体、DTO、公共服务;宿主项目(API、Web 前台、Admin 后台)各自引用共享层,只负责入口和界面。
分层由项目规模决定,框架不做强制要求。
内容类栏目(服务/产品/新闻/案例等前台内容)不用建实体:走 CMS 扩展(
EasyAdminBlazor.Cms),写一个带[CmsPage]的 Razor 页面就自动获得后台内容管理,见 用 CMS 快速开发前台内容页面。本文讲的是需要建模实体的业务模块(订单、工单、库存这类真实业务数据)流程。
1. 创建实体类
先建个实体类,继承EntityFull就行:
public class MyNewEntity : EntityFull
{
public string Name { get; set; }
public string Description { get; set; }
}
偷懒小技巧:让 AI 帮你写实体类
不想手写?让 ChatGPT、DeepSeek、Claude 代劳:
示例提示词:
我需要一个产品表,有名称、价格、库存、分类ID(关联分类表),分类ID是外键。使用 Freesql 实体特性,实体类继承 EntityFull,加上必要的特性(Table、Column、DisplayName、Navigate)。
AI 输出的代码:
[Table(Name = "product")]
public class Product : EntityFull
{
[DisplayName("产品名称")]
[Column(StringLength = 100)]
public string Name { get; set; } = string.Empty;
[DisplayName("价格")]
[Column(Precision = 10, Scale = 2)]
public decimal Price { get; set; }
[DisplayName("库存")]
public int Stock { get; set; }
[DisplayName("分类ID")]
public long? ClassifyId { get; set; }
[Navigate(nameof(ClassifyId))]
public Classify Classify { get; set; } = default!;
}
把这段代码放进项目实体目录,再到代码生成器里生成页面。
2. 生成 Blazor 页面
打开 /Admin/CrudGenerator,可视化配置后生成 CRUD 页面。
详细操作可以参考 代码生成.md。