Hasim.Core 0.1.1

Hasim.Core

A customizable base library for Entity Framework Core providing reusable abstractions, repository patterns, unit of work, common configurations, and auditing to accelerate .NET application development.

This repository holds the reusable domain, identity, and audit entities shared across the Hasim.* ecosystem. The DbContext and EF Core mappings that consume these entities live in the companion project Hasim.EntityFrameworkCore.

✨ Features

• Identity-ready entities — AppUser, AppRole and the standard Identity types, all with int keys.
• Extended user model — AppUser adds profile fields (picture URL/data/content type, first/last name).
• Audit logging model — AuditLog and EntityChange to trace who changed what, and at which property level.
• Packaged as a NuGet library — a single base-model dependency for your data-access layer.

📦 Installation

dotnet add package Hasim.Core

🚀 Getting Started

Hasim.Core is the model layer. Reference it from your EF Core data-access project (e.g. Hasim.EntityFrameworkCore) and use its entities in your DbContext.

1. Add the package

dotnet add package Hasim.Core

2. Reference the model layer

Add a package reference from your data-access project to Hasim.Core.

3. Use the entities in your DbContext

Derive your context from IdentityDbContext using the Hasim.Core identity types, and expose the audit DbSets:

using Hasim.Core.Entities;
using Microsoft.AspNetCore.Identity.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;

public class MyDbContext
    : IdentityDbContext<AppUser, AppRole, int,
        AppUserClaim, AppUserRole, AppUserLogin, AppRoleClaim, AppUserToken>
{
    public DbSet<AuditLog> AuditLogs { get; set; } = default!;
    public DbSet<EntityChange> EntityChanges { get; set; } = default!;
}

🧱 Architecture

Hasim.Core/
└── Src/Hasim.Core/
    ├── Entities/
    │   ├── Identity/
    │   │   ├── AppUser.cs          # IdentityUser<int> + profile/picture fields
    │   │   ├── AppRole.cs          # IdentityRole<int>
    │   │   └── AppUserClaim, AppRoleClaim, AppUserLogin, AppUserRole, AppUserToken
    │   └── Audits/
    │       ├── AuditLog.cs         # audit record (action, entity, IP, correlation id, user)
    │       └── EntityChange.cs     # property-level change, FK → AuditLog
    └── Hasim.Core.csproj

Entities

📚 Dependencies

• Microsoft.AspNetCore.Identity.EntityFrameworkCore 8.x

🔧 Requirements

• .NET 8.0 SDK

🤝 Contributing

1. Fork the repository.
2. Create a feature branch.
3. Submit a pull request.

📄 License

This project is licensed under the MIT License.