Marventa.Framework 3.5.1

Marventa Framework

Enterprise-grade .NET framework with Clean Architecture, CQRS, and 47+ modular features for .NET 8.0/9.0

What's New in v3.5.1

✅ Service Registration Fixes

• Repository<T> pattern now auto-registered (no manual setup!)
• Elasticsearch service auto-registered via EnableSearch flag
• Outbox/Inbox pattern services via EnableMessaging flag
• Projection management via EnableProjections flag

🔧 Dependency Management Fixed All dependencies (Serilog, StackExchange.Redis, etc.) now automatically installed - no manual package installation needed!

📚 Accurate Documentation

• 27 production-ready features verified
• Mock/placeholder implementations clearly marked
• Complete feature status transparency

Quick Start

Installation

dotnet add package Marventa.Framework --version 3.5.1
# All dependencies automatic - no manual Serilog/Redis install needed!

Migrating from v3.4.x?

# 1. Remove manually installed dependencies (if any)
dotnet remove package Serilog
dotnet remove package Serilog.AspNetCore
dotnet remove package StackExchange.Redis
# ... etc

# 2. Update to v3.5.1
dotnet add package Marventa.Framework --version 3.5.1

# 3. Remove manual Repository registration (now automatic)
# Delete: services.AddScoped(typeof(IRepository<>), typeof(BaseRepository<>));

Basic Setup

using Marventa.Framework.Web.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMarventaFramework(builder.Configuration, options =>
{
    options.EnableCQRS = true;
    options.EnableRepository = true;
    options.EnableLogging = true;
    options.EnableCaching = true;
});

var app = builder.Build();
app.UseMarventaFramework(builder.Configuration);
app.Run();

Core Features

Base Entity Classes

• BaseEntity - Audit tracking, soft delete, timestamps
• AuditableEntity - Version control and concurrency
• TenantBaseEntity - Multi-tenant isolation

CQRS with MediatR

• Automatic validation with FluentValidation
• Transaction management
• Logging and performance tracking
• Idempotency support

Repository Pattern

• Generic repository with common operations
• Unit of Work pattern
• Specification pattern support
• Soft delete handling

Pipeline Behaviors

• ValidationBehavior - Automatic input validation
• LoggingBehavior - Performance monitoring
• TransactionBehavior - Automatic transaction management
• IdempotencyBehavior - Duplicate prevention (implemented, manual registration required)

Example: Product CRUD

Entity

public class Product : BaseEntity
{
    public string Name { get; set; }
    public decimal Price { get; set; }
}

Command

public class CreateProductCommand : ICommand<Guid>
{
    public string Name { get; set; }
    public decimal Price { get; set; }
}

public class CreateProductCommandValidator : AbstractValidator<CreateProductCommand>
{
    public CreateProductCommandValidator()
    {
        RuleFor(x => x.Name).NotEmpty().MaximumLength(200);
        RuleFor(x => x.Price).GreaterThan(0);
    }
}

public class CreateProductCommandHandler : IRequestHandler<CreateProductCommand, Guid>
{
    private readonly IUnitOfWork _unitOfWork;

    public async Task<Guid> Handle(CreateProductCommand request, CancellationToken ct)
    {
        var product = new Product { Name = request.Name, Price = request.Price };
        await _unitOfWork.Repository<Product>().AddAsync(product, ct);
        return product.Id;
    }
}

Query

public class GetProductByIdQuery : IQuery<ProductDto>
{
    public Guid Id { get; set; }
}

public class GetProductByIdQueryHandler : IRequestHandler<GetProductByIdQuery, ProductDto>
{
    private readonly IRepository<Product> _repository;

    public async Task<ProductDto> Handle(GetProductByIdQuery request, CancellationToken ct)
    {
        var product = await _repository.GetByIdAsync(request.Id);
        return new ProductDto { Id = product.Id, Name = product.Name, Price = product.Price };
    }
}

Controller

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly IMediator _mediator;

    [HttpGet("{id}")]
    public async Task<ActionResult<ProductDto>> Get(Guid id)
        => Ok(await _mediator.Send(new GetProductByIdQuery { Id = id }));

    [HttpPost]
    public async Task<ActionResult<Guid>> Create(CreateProductCommand command)
        => CreatedAtAction(nameof(Get), new { id = await _mediator.Send(command) }, null);
}

Advanced Features

Multi-Tenancy

public class Customer : TenantBaseEntity
{
    public string CompanyName { get; set; }
}

Event Sourcing

public class OrderCreatedEvent : IDomainEvent
{
    public Guid OrderId { get; set; }
    public decimal Amount { get; set; }
}

Saga Pattern

public class OrderSaga : ISaga<OrderSagaState>
{
    public async Task ExecuteAsync(OrderSagaState state, CancellationToken ct)
    {
        // Distributed transaction logic
    }
}

CDN Integration

public class FileService
{
    private readonly IMarventaCDN _cdn;

    public async Task<string> UploadAsync(Stream file)
        => await _cdn.UploadAsync(file, new CDNUploadOptions());
}

Feature Status (v3.5.1)

✅ Production Ready (27 features)

• BaseDbContext, Repository, Unit of Work, CQRS, Saga, Outbox/Inbox, Projections
• Caching (Memory/Redis), Elasticsearch
• Email, SMS, Storage (Local/Cloud), CDN (Azure/AWS/CloudFlare)
• JWT, Encryption, Multi-tenancy, Health Checks

⚠️ Mock/Development (6 features)

• ML Service, Analytics, Mock CDN/Storage (for testing)

🚧 Roadmap (14 features)

• Event Sourcing (infrastructure ready), Background Jobs, E-commerce features

See full README for detailed feature breakdown and usage examples.

Resources

• Documentation: https://github.com/AdemKinatas/Marventa.Framework#readme
• GitHub: https://github.com/AdemKinatas/Marventa.Framework
• Issues: https://github.com/AdemKinatas/Marventa.Framework/issues
• Email: ademkinatas@gmail.com

License

MIT License - Free for personal and commercial use.

Built with love by Adem Kinatas