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 + MediatR.
Biblioteki¶
| Biblioteka | NuGet | Opis |
|---|---|---|
| DateTime | TailoredApps.Shared.DateTime |
Abstrakcja IDateTimeProvider do mockowania czasu w testach |
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 |
| ExceptionHandling | TailoredApps.Shared.ExceptionHandling |
Middleware i filter do obsługi wyjątków w Web API |
| MediatR | TailoredApps.Shared.MediatR |
Pipeline behaviors: Logging, Validation, Caching, Fallback, Retry |
| MediatR.Caching | TailoredApps.Shared.MediatR.Caching |
Marker interface ICachableRequest dla cachowania requestów |
| MediatR.Email | TailoredApps.Shared.MediatR.Email |
SendMail command + handler — email przez pipeline MediatR |
| MediatR.ML | TailoredApps.Shared.MediatR.ML |
Klasyfikacja obrazów przez ML.NET w pipelines MediatR |
| MediatR.PagedRequest | TailoredApps.Shared.MediatR.PagedRequest |
Bazowy request MediatR 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 |
Szybki start¶
# Zainstaluj wybraną bibliotekę
dotnet add package TailoredApps.Shared.MediatR
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.