Przejdź do treści

TailoredApps .NET Shared Components

License: MIT GitHub

Witaj w dokumentacji TailoredApps Shared Components — zestawu wielokrotnego użytku bibliotek .NET, które przyspieszają tworzenie profesjonalnych aplikacji webowych. Każda biblioteka rozwiązuje jeden konkretny problem i jest zaprojektowana pod kątem testowalności, rozszerzalności i integracji z ekosystemem ASP.NET Core + mediator.


Biblioteki

Biblioteka NuGet Opis
DateTime TailoredApps.Shared.DateTime Abstrakcja IDateTimeProvider do mockowania czasu w testach (DateTime, DateTimeOffset) na System.TimeProvider
Email TailoredApps.Shared.Email SMTP provider, builder szablonów emaili, tryb konsolowy
Email.Models TailoredApps.Shared.Email.Models Model wiadomości MailMessage
Email.Office365 TailoredApps.Shared.Email.Office365 Wysyłanie przez Microsoft Graph API (IMAP OAuth2)
EntityFramework TailoredApps.Shared.EntityFramework UnitOfWork pattern na EF Core z auditingiem i hookami
EntityFramework.UnitOfWork.WebApiCore TailoredApps.Shared.EntityFramework.UnitOfWork.WebApiCore Automatyczne transakcje przez ASP.NET Core filter
EntityFramework.UnitOfWork.MinimalApi TailoredApps.Shared.EntityFramework.UnitOfWork.MinimalApi Automatyczne transakcje dla minimal API przez filtr endpointu
ExceptionHandling TailoredApps.Shared.ExceptionHandling Middleware i filter do obsługi wyjątków w Web API
ExceptionHandling.MinimalApi TailoredApps.Shared.ExceptionHandling.MinimalApi Obsługa wyjątków i walidacja FluentValidation dla minimal API (filtry endpointów), zgodna z NativeAOT
Mediator TailoredApps.Shared.Mediator Pipeline behaviors: Logging, Validation, Caching, Fallback, Retry
Mediator.Caching TailoredApps.Shared.Mediator.Caching Marker interface ICachableRequest dla cachowania requestów
Mediator.Email TailoredApps.Shared.Mediator.Email SendMail command + handler — email przez pipeline'em mediatora
Mediator.ML TailoredApps.Shared.Mediator.ML Klasyfikacja obrazów przez ML.NET w pipeline'ach mediatora
Mediator.PagedRequest TailoredApps.Shared.Mediator.PagedRequest Bazowy request mediatora z paginacją i sortowaniem
Payments TailoredApps.Shared.Payments Abstrakcja bramki płatności — IPaymentService + IPaymentProvider
Payments.Provider.Adyen TailoredApps.Shared.Payments.Provider.Adyen Integracja Adyen
Payments.Provider.CashBill TailoredApps.Shared.Payments.Provider.CashBill Integracja CashBill
Payments.Provider.HotPay TailoredApps.Shared.Payments.Provider.HotPay Integracja HotPay
Payments.Provider.PayNow TailoredApps.Shared.Payments.Provider.PayNow Integracja PayNow (mBank)
Payments.Provider.PayU TailoredApps.Shared.Payments.Provider.PayU Integracja PayU
Payments.Provider.Przelewy24 TailoredApps.Shared.Payments.Provider.Przelewy24 Integracja Przelewy24
Payments.Provider.Revolut TailoredApps.Shared.Payments.Provider.Revolut Integracja Revolut Pay
Payments.Provider.Stripe TailoredApps.Shared.Payments.Provider.Stripe Integracja Stripe Checkout
Payments.Provider.Tpay TailoredApps.Shared.Payments.Provider.Tpay Integracja Tpay
Querying TailoredApps.Shared.Querying Bazowe klasy do zapytań: QueryBase, PagedAndSortedQuery, IPagedResult
WebApi TailoredApps.Shared.WebApi Produkcyjne defaulty Web API: OpenTelemetry (metryki/tracing/logi przez OTLP), health checks, resilience HTTP

Aplikacja demo

Wszystkie biblioteki razem, w działającej aplikacji: Przykładowy serwis i testy integracyjne — sklep w Web API (samples/: kontrakt, logika i host, z ForkForward.Mediator i ForkForward.Mapper) z podstawionymi bramkami płatności, uruchamiany bez kont i bez sieci, oraz testy, które sprawdzają go przez HTTP w CI.


Aktualizacja z 1.x

Przechodzisz z 1.x na 2.0? Zmiany wymagane w kodzie aplikacji — obsługa awarii bramki płatności, wymagane pola PaymentRequest, webhooki Tpay i Adyen — zebrano na stronie Aktualizacja do 2.0.

Linia 3.0 jest w fazie testowej (3.0.0-preview.N): biblioteki mediatora przechodzą na ForkForward.Mediator i zmieniają nazwę z TailoredApps.Shared.MediatR* na TailoredApps.Shared.Mediator*. Co zmienić w aplikacji: Aktualizacja do 3.0.


Platformy docelowe

Od wersji 2.0 biblioteki są wydawane dla net10.0 i net11.0; starsze platformy obsługują paczki 1.x (1.6.x). Assety net11.0 są kompilowane z użyciem runtime async. Szczegóły, ograniczenia i sposób wyłączenia: Platformy docelowe i runtime async.


Szybki start

# Zainstaluj wybraną bibliotekę
dotnet add package TailoredApps.Shared.Mediator
dotnet add package TailoredApps.Shared.EntityFramework
dotnet add package TailoredApps.Shared.Payments

Pełna dokumentacja każdej biblioteki — łącznie z przykładami kodu, rejestracja DI i gotowymi promptami dla agentów AI — dostępna jest w sekcji Libraries w menu bocznym.


Contributing

Zanim dodasz nową bibliotekę, przeczytaj zasady contributingu i DOCUMENTATION_RULE.

Każda nowa biblioteka musi posiadać stronę dokumentacji — PR bez niej zostanie odrzucony.