| name | ef-mapper |
| description | Create and update Entity Framework Core mappings for domain entities in the hexagonal architecture template, including relationships, enum conversions, precision, and migrations. |
EF Mapper Generator — Hexagonal Architecture Template
Create or update EF Core mapping classes under Infrastructure, keeping persistence rules explicit and consistent.
When to Use
Activate this skill when:
- User asks to map a new entity to EF Core
- User adds or changes entity properties requiring DB config
- User introduces enums, decimal values, or relationships
- User requests migration generation after model changes
Skill-local References
| File | Purpose |
|---|
./references/ef-mapping-template.md | Base mapping template and relationship samples |
./references/migration-commands.md | Migration/update/script command quick reference |
Mapping Rules
- Place mappings in
src/Infrastructure/Data/Mapping/
- Inherit
BaseDbMapping<TEntity>
- Configure inside
ConfigureDomainEntity(EntityTypeBuilder<TEntity> builder)
- Use
HasMaxLength(...) for strings
- Use
HasPrecision(18, 2) for monetary decimals
- Use
.HasConversion<string>() for enums stored as text
- Configure relationships (
HasMany, WithOne, HasForeignKey) explicitly
Enum Mapping Example
builder.Property(p => p.NotificationStatus)
.HasConversion<string>()
.HasMaxLength(50)
.IsRequired();
Decimal Mapping Example
builder.Property(p => p.Total)
.HasPrecision(18, 2)
.IsRequired();
Final Checklist
