TailoredApps .NET Shared Components¶
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 |
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.