SmartCoreHub.Core.SDK 20260714.2141.0

SmartCoreHub.Core.SDK

Biblioteca NuGet central do SmartCoreHub: primitivas de dominio, Result/Guard, contratos de cache/NoSql/cloud, helpers e — nos TFMs modernos — implementacoes reutilizaveis de repositorios genericos (EF Core / Dapper), providers de cache (Redis, Mongo, Cosmos, Disk) e adapters Azure.

Use este pacote quando precisar da mesma fonte de contratos e implementacoes genericas entre APIs, hosts .NET e SDKs que optarem por referenciar o Core.

Localization.SDK: pacote publico auto-isolado — nao depende deste Core no NuGet. Tipos HTTP/cache leves usados pelo Localization sao copia owned. Ver Isolamento-Core.md.

Instalacao

dotnet add package SmartCoreHub.Core.SDK

<PackageReference Include="SmartCoreHub.Core.SDK" Version="*" />

Frameworks suportados

Dependencias pesadas (Dapper, EF Core, StackExchange.Redis, MongoDB.Driver, Azure SDKs, etc.) entram no grafo NuGet somente quando o projeto consumidor tem como alvo net8.0 ou net10.0.

Light vs heavy

• Light: disponibilizado em todos os TFMs — Domain (interfaces/DTOs/entidades base), Others (Result, Guard, exceptions, HTTP leve), cache Memory/Disk, abstracoes NoSql, password hashers, helpers de Service.
• Heavy (net8/net10): DapperAdpterGenericRepository<T>, GenericRepository<T> (EF), factories/adapters Azure, providers Redis/Mongo/Cosmos, adapters Mongo NoSql.

CacheFactory (namespace Service) cria apenas o provider Memory. Em produção, registre Redis/Disk/Mongo/Cosmos diretamente pelos tipos deste pacote (ou via DI do host SmartCoreHub).

Mapa de namespaces

Layout em disco: pastas Domain/, Infrastructure/, Service/ e Others/ (tipos nativos do SDK; ver Others/README.md).

Catalogo reutilizavel

Cada tipo publico listado abaixo pode ser reutilizado por consumidores do pacote. Tipos em pastas Internal nao devem ser dependencia estavel (exceto onde indicado).

Others — Result, validacao e exceptions

Others — repositorio Guid e cache leve

Others — HTTP / headers

Domain — entidades e value objects

Domain — enums e DTOs

Domain — contratos comuns / data / Dapper

Domain — cloud e seguranca

Infrastructure — cache light (todos os TFMs)

Infrastructure — cache heavy (net8/net10)

Infrastructure — repositorios e dados

Infrastructure — NoSql

Infrastructure — Azure (net8/net10)

Infrastructure — security

Service

Exemplos

Result e Guard

using SmartCoreHub.Core.SDK.Others.Common;
using SmartCoreHub.Core.SDK.Others.Validation;

public Result<string> Normalize(string input)
{
    Guard.AgainstEmptyString(input, nameof(input));
    return Result.Success(input.Trim());
}

Cache Memory

using SmartCoreHub.Core.SDK.Infrastructure.Caching.Providers;
using Microsoft.Extensions.Caching.Memory;

services.AddMemoryCache();
services.AddSingleton<ICacheProvider, MemoryCacheProvider>();

Repositorio Dapper ou EF (net8/net10)

using SmartCoreHub.Core.SDK.Dapper.Generic;
using SmartCoreHub.Core.SDK.EntityFrameworkCore.Repositories;
using SmartCoreHub.Core.SDK.Infrastructure.Repositories.Generic;

// EF
services.AddScoped(typeof(IGenericRepository<>), typeof(GenericRepository<>));

// Dapper open-generic
services.AddScoped(typeof(DapperAdpterGenericRepository<>));

Entidades usam LongEntityBase (long Id). Construtor Dapper: ISmartCoreHubDataBaseConnectionFactory, IAppLogger, string? tableName.

Azure Blob factory (net8/net10)

using SmartCoreHub.Core.SDK.Cloud.Azure;
using SmartCoreHub.Core.SDK.Domain.Interfaces.Cloud;

services.AddScoped<IBlobStorageAdapterFactory, BlobStorageAdapterFactory>();

Constraints e breaking changes

• Generics EF/Dapper exigem where TEntity : LongEntityBase.
• Nomes historicos mantidos: DapperAdpterGenericRepository, CloudRessource.
• Cascas Obsolete em Domain/Infrastructure foram removidas. Use tipos deste pacote no monólito/host.
• SmartCoreHub.Localization.SDK e auto-isolado: nao depende deste NuGet; contratos HTTP/cache leves do Localization sao copia owned (nao usar Core types ao consumir Localization).
• Um unico PackageId=SmartCoreHub.Core.SDK — nao existem pacotes companheiros .Dapper / .Caching.* / .Cloud.Azure.

Desenvolvimento local (repositorio)

cd backend
dotnet build Core\SmartCoreHub.Core.SDK\SmartCoreHub.Core.SDK.csproj -c Release
dotnet test Core\SmartCoreHub.Core.SDK.Tests\SmartCoreHub.Core.SDK.Tests.csproj -c Release
dotnet pack Core\SmartCoreHub.Core.SDK\SmartCoreHub.Core.SDK.csproj -c Release

Licenca

Consulte o arquivo LICENSE incluido no pacote NuGet.