Modrich.Persistence 0.1.0

Modrich.Persistence

Generic migrate-and-seed pipeline for Modrich modules on .NET 10. Each module owns its DbContext and registers IModuleMigrator + IModuleSeeder; this package runs them in order.

What's in the box

• ModuleSeederRunner.RunAsync(IServiceProvider)
  1. Creates a DI scope.
  2. Resolves every IModuleMigrator and invokes MigrateAsync in ascending Order.
  3. Resolves every IModuleSeeder and invokes SeedAsync in ascending Order.

That's the whole package. The contracts live in Modrich.Abstractions.

Install

dotnet add package Modrich.Persistence

Usage — module-side

using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.DependencyInjection;
using Modrich.Modules;

public sealed class OrdersMigrator : IModuleMigrator
{
    public int Order => 100;

    public async Task MigrateAsync(IServiceProvider services)
    {
        var db = services.GetRequiredService<OrdersDbContext>();
        await db.Database.MigrateAsync();
    }
}

public sealed class OrdersSeeder : IModuleSeeder
{
    public int Order => 100;

    public async Task SeedAsync(IServiceProvider services)
    {
        var db = services.GetRequiredService<OrdersDbContext>();
        if (await db.OrderStatuses.AnyAsync()) return;
        db.OrderStatuses.AddRange(new("New"), new("Paid"), new("Shipped"));
        await db.SaveChangesAsync();
    }
}

public sealed class OrdersApiModule : IApiModule
{
    public string Name => "Orders";

    public void RegisterApiDependencies(IServiceCollection services, IConfiguration configuration)
    {
        services.AddDbContext<OrdersDbContext>(o =>
            o.UseSqlServer(configuration.GetConnectionString("Default")));

        services.AddScoped<IModuleMigrator, OrdersMigrator>();
        services.AddScoped<IModuleSeeder,  OrdersSeeder>();
    }
}

Usage — host-side

using Modrich.Persistence;

var app = builder.Build();

await ModuleSeederRunner.RunAsync(app.Services);

app.Run();

Modules run in the order they assign — pick conservative numbers (10, 100, 200) so later modules can slot between earlier ones. All migrators complete before any seeder runs, so a seeder in module A can safely read tables created by module B.

Related packages

• Modrich.Abstractions — IModuleMigrator, IModuleSeeder.
• Modrich.Modularity — discovers and registers your module's services so they end up in the DI container the runner enumerates.

Versioning

Strict semver. EnablePackageValidation is on.

License

MIT.