在FullStackHero项目中实现多租户License管理模块的经验分享

背景介绍

在开发基于FullStackHero框架的多租户应用时，我们经常需要为不同租户实现独立的License管理功能。本文分享在FullStackHero项目中添加License管理模块时遇到的技术问题及解决方案。

问题现象

在实现License管理模块时，开发者在Infrastructure项目中添加了新的LicenseDbContext后，系统报出以下错误：

The entity type 'IdentityUserLogin<string>' requires a primary key to be defined. If you intended to use a keyless entity type, call 'HasNoKey' in 'OnModelCreating'.

问题分析

这个错误通常发生在Entity Framework Core的DbContext配置中，特别是当DbContext继承了多租户上下文时。具体到FullStackHero项目，主要原因如下：

1. 在LicenseDbContext中使用了ApplyConfigurationsFromAssembly方法，该方法会加载程序集中所有的实体配置
2. 当多个模块的DbContext位于同一程序集时，会意外加载其他模块的实体配置
3. 这些额外的配置可能与当前DbContext的模型不兼容

解决方案

1. 简化DbContext配置

对于简单的License实体，可以直接在DbContext中配置，无需使用ApplyConfigurationsFromAssembly方法：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    modelBuilder.Entity<LicenseItem>().ToTable("license", "license");
}

2. 使用实体配置类

更规范的解决方案是创建专门的实体配置类：

public class LicenseItemConfiguration : IEntityTypeConfiguration<LicenseItem>
{
    public void Configure(EntityTypeBuilder<LicenseItem> builder)
    {
        builder.ToTable("license", "license");
        builder.HasKey(x => x.Id);
        // 其他配置...
    }
}

然后在DbContext中注册：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    modelBuilder.ApplyConfiguration(new LicenseItemConfiguration());
}

3. 模块化设计建议

对于FullStackHero这样的模块化项目，最佳实践是：

1. 将每个功能模块放在独立的程序集(项目)中
2. 每个模块维护自己的DbContext
3. 使用模块特定的数据库迁移

License实体设计

在实现License管理时，实体设计应考虑以下要素：

public class LicenseItem
{
    public string Id { get; set; } = default!;
    public string LicenseName { get; set; } = default!;
    public int AdminLimit { get; set; }  // 管理员数量限制
    public int UserLimit { get; set; }   // 用户数量限制
    public string TenantId { get; set; } = default!;  // 关联租户ID
    public int DiskSpaceLimit { get; set; }  // 磁盘空间限制(MB)
    public bool IsTrial { get; set; }    // 是否试用版
    public bool IsActivated { get; set; } // 是否激活
    public DateTimeOffset ExpiresAt { get; set; } // 过期时间
}

数据库初始化

FullStackHero框架提供了标准的数据库初始化接口IDbInitializer，我们可以实现License模块的初始化逻辑：

public async Task SeedAsync(CancellationToken cancellationToken)
{
    if (string.IsNullOrWhiteSpace(context.TenantInfo?.Id)) return;

    var license = new LicenseItem
    {
        Id = Guid.NewGuid().ToString(),
        TenantId = context.TenantInfo?.Id,
        UserLimit = 5,
        AdminLimit = 1,
        LicenseName = "Trial License for 20 Days",
        ExpiresAt = DateTimeOffset.Now.AddDays(20),
        DiskSpaceLimit = 100,
        IsTrial = true,
        IsActivated = true
    };

    await context.Licenses.AddAsync(license, cancellationToken);
    await context.SaveChangesAsync();
}

总结

在FullStackHero项目中实现多租户License管理时，需要注意DbContext的配置方式，避免意外加载其他模块的配置。通过简化配置或使用明确的实体配置类，可以避免常见的EF Core配置冲突问题。同时，良好的模块化设计和清晰的实体定义是构建可维护License系统的关键。