开始一个新模块

实体放哪?分层说明

默认精简结构:业务实体直接放 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。