Checklist tecnico
Como montar un modulo nuevo bien
La clave es que el modulo sea dueno de su logica, sus tablas, su DbContext, sus migraciones y sus servicios.
Pasos
- Crear carpeta de modulo y entidades.
- Crear
DbContextdel modulo. - Declarar
DbContextTypeenModuleDescriptor. - Registrar servicios en
ModuleInitializer. - Crear migracion inicial del modulo.
- Crear seed solo para modulo, permisos, menu y datos base.
- Si necesita integrarse en otra pantalla, crear hooks.
Patron recomendado de codigo
Modules/MIMODULO
Controllers/
Data/
Configurations/
MiEntidadConfiguration.cs
Migrations/
MIMODULODbContext.cs
Entities/
MiEntidad.cs
Hooks/
Seed/
Services/
Views/
ModuleDescriptor.cs
ModuleInitializer.cs
La entidad debe ser simple. La configuracion EF debe ir separada en Configurations.
El DbContext debe aplicar ApplyConfigurationsFromAssembly.
Estructura recomendada
public class MiEntidadConfiguration : IEntityTypeConfiguration<MiEntidad>
{
public void Configure(EntityTypeBuilder<MiEntidad> builder)
{
builder.ToTable("MIMODULO_MiEntidad");
builder.HasKey(x => x.Id);
builder.Property(x => x.Nombre).HasMaxLength(150).IsRequired();
}
}
Resultado esperado: si el modulo se carga por primera vez, debe poder registrar servicios, aplicar su esquema y sembrar sus datos base sin SQL manual disperso.