Despro.Framework.Base 2.1.7

Despro.Framework.Base

The core abstractions layer of Despro Framework.

Despro.Framework.Base is the innermost package of the framework's Clean Architecture. It holds the contracts, base models and cross-cutting utilities that every other layer depends on and defines no concrete infrastructure of its own — the higher layers (Infrastructure, Presentation, WebClient, …) implement the interfaces declared here.

• Package: Despro.Framework.Base
• Version: 2.1.0
• Target framework: net10.0

        ┌──────────────────────────── everything depends on Base ────────────────────────────┐
Base ◄── Domain   Application   Infrastructure   Presentation   WebClient

Installation

dotnet add package Despro.Framework.Base

Base is pulled in transitively by every other Despro package, so you rarely install it directly unless you are authoring shared contracts/DTOs.

Dependencies

What's inside

Repository & Unit of Work contracts (IBaseServices)

The persistence abstractions implemented by Despro.Framework.Infrastructure.

All repository contracts are constrained to where TEntity : BaseEntity.

Base models (BaseModels)

Grid, filtering & paging (BaseModels/GridData)

• BaseGrid — pagination + ordering + FilterParam list; can hydrate itself from a JSON string (Set(string)) with sensible defaults.
• GridData<TData> — a materialized page (Data, EntityCount, PageCount).
• FilterService — IQueryable<T> extensions (FilterList, PagingList, FilterPagingList) that translate BaseGrid filters into EF Core expression trees, including nested property paths, collection Any(...), case-insensitive LIKE, enum, numeric, decimal, bool and date comparisons.

var page = dbSet.AsQueryable()
                .FilterPagingList(baseGrid)   // apply filters + ordering + skip/take
                .ProjectToType<ProductDto>();

Exceptions (BaseExceptions)

An abstract exception hierarchy that the higher layers extend and the presentation middleware maps to HTTP status codes: BaseException, BaseForbiddenException, BaseInvalidDataException, BaseNotFoundException.

Extensions & helpers (BaseExtensions)

• IncludeExtensions — IncludeFiltered / ThenIncludeFiltered that transparently filter out soft-deleted (IsDelete) navigations.
• PersianConvertorDate — Gregorian ⇄ Shamsi (Jalali) conversion (ToShamsi, ToShamsiWithTime, ShamsiToMiladi).
• StringExtensions — Persian/Arabic digit & character normalization.
• DateTimeExtension (IsBetween), MoneyHelper (Tooman formatting).

Validators (Validator)

• FileValidator — a configurable AbstractValidator<IFormFile> (max size, allowed extensions, required/optional) with localized failure messages.

Constants

Constants.HttpClientName (named HttpClient) and Constants.RoleIdKey.

Usage

public class Product : AggregateRoot          // gets Id, audit fields, domain events
{
    public string Name { get; private set; } = string.Empty;
    public decimal Price { get; private set; }
}

public class ProductDto : BaseDto             // eligible for grid queries
{
    public long Id { get; set; }
    public string Name { get; set; } = string.Empty;
}

// Command handlers return standardized results:
return OperationResult<ProductDto>.Success(dto);
return OperationResult.NotFound();

Project structure

Despro.Framework.Base
├── BaseExceptions/      # abstract exception hierarchy
├── BaseExtensions/      # IQueryable includes, Persian date, string/date/money helpers
├── BaseModels/          # BaseEntity, AggregateRoot, OperationResult, DTOs
│   ├── DbModels/        # MongoDbConfig
│   ├── GridData/        # BaseGrid, GridData<>, FilterService
│   └── HttpModels/      # ApiResultHttp envelope
├── IBaseServices/       # repository / UoW / auth / logger contracts
│   └── IDbServices/     # IDapperRepository
├── Validator/           # FileValidator
└── Constants.cs