CFPS.Moduli.Utenti 1.0.0-alpha.2.1

CFPS.Moduli.Utenti

Modulo utenti modulare basato su Clean Architecture + DDD + CQRS + MediatR.

Il modulo fornisce gestione completa utenti:

• Creazione utenti
• Aggiornamento utenti
• Eliminazione utenti
• Login con password hashing
• Query paginata utenti
• Gestione ruoli e livelli accesso
• Pipeline behaviors (Validation + UnitOfWork)

🧱 Architettura

Il modulo è composto da:

• Core → Entità dominio e DTO
• Application → CQRS, Handlers, Mapping, Security
• Infrastructure → EF Core + Repository + SQLite
• Bootstrap → Entry point DI + configurazione modulo

📦 Installazione

Installazione tramite NuGet:

dotnet add package CFPS.Moduli.Utenti

⚙️ Configurazione in WPF

Nel App.xaml.cs o bootstrap principale:

using CFPS.Moduli.Utenti.Bootstrap;
using Microsoft.Extensions.DependencyInjection;

public partial class App : Application
{
    public static IServiceProvider ServiceProvider { get; private set; }

    protected override void OnStartup(StartupEventArgs e)
    {
        var services = new ServiceCollection();

        services.AddUserModule(new UserModuleOptions
        {
            ConnectionString = "Data Source=users.db"
        });

        ServiceProvider = services.BuildServiceProvider();

        base.OnStartup(e);
    }
}

🔄 Migrazione Database

Al primo avvio:

ServiceProvider.EnsureUserModuleMigrated(); 🧠 Uso CQRS con MediatR ➕ Creazione utente

var result = await mediator.Send(new CreateUserCommand(userDto));

if (result.IsSuccess)
{
    // utente creato
}
else
{
    // gestione errore
}

✏️ Aggiornamento utente

var result = await mediator.Send(new UpdateUserCommand(userDto));

❌ Eliminazione utente

var result = await mediator.Send(new DeleteUserCommand(userId));

🔐 Login utente

var result = await mediator.Send(new LoginUserCommand(username, password));

if (result.IsSuccess)
{
    var user = result.Value;
}

📄 Query utenti paginata

var result = await mediator.Send(new GetUsersQuery(
    page: 1,
    pageSize: 20,
    search: "mario"
));

if (result.IsSuccess)
{
    var data = result.Value.Items;
    var totalPages = result.Value.TotalPages;
}

🧩 Result Pattern

Il modulo utilizza un Result pattern:

Result.Success(value)
Result.Fail(error)

🔐 Password hashing

Il modulo utilizza BCrypt.Net-Next per la sicurezza delle password.

🧪 Pipeline Behaviors

Sono inclusi automaticamente:

✔ ValidationBehavior

Valida i comandi tramite FluentValidation

✔ UnitOfWorkBehavior

Gestisce commit automatico delle transazioni

🏗️ Dependency Injection

Il bootstrap registra automaticamente:

DbContext (SQLite) Repository MediatR Validators Security services Pipeline behaviors