Skip to content

docs: kompletna dokumentacja MkDocs — wszystkie biblioteki z AI Agent Prompts#32

Merged
nieprzecietny merged 14 commits intomasterfrom
fix/xml-docs-master
Mar 25, 2026
Merged

docs: kompletna dokumentacja MkDocs — wszystkie biblioteki z AI Agent Prompts#32
nieprzecietny merged 14 commits intomasterfrom
fix/xml-docs-master

Conversation

@szeregowy-agent
Copy link
Contributor

Co zawiera ten PR

📚 Dokumentacja (Material for MkDocs)

Kompletna dokumentacja dla wszystkich 23 bibliotek, publikowana na shared.tailoredapps.pl.

Każda strona zawiera:

  • 🇵🇱 Opis działania po polsku
  • 🇬🇧 Opis działania po angielsku
  • Instrukcja instalacji (dotnet add package)
  • Rejestracja w DI (Program.cs)
  • Realny przykład kodu C#
  • 🤖 AI Agent Prompt — gotowy do wklejenia w kontekst agenta

📦 Biblioteki

  • DateTime, Email (+ Models, Office365)
  • EntityFramework (+ UnitOfWork.WebApiCore)
  • ExceptionHandling
  • MediatR (+ Caching, Email, ML, PagedRequest)
  • Payments (core + 9 providerów: Adyen, CashBill, HotPay, PayNow, PayU, Przelewy24, Revolut, Stripe, Tpay)
  • Querying

⚙️ Infrastruktura

  • mkdocs.yml: pełna nawigacja + site_url → shared.tailoredapps.pl
  • DOCUMENTATION_RULE.md: żelazna zasada — PR bez dokumentacji = odrzucony
  • docs/contributing.md: zasady contributingu

🧪 Testy i pokrycie

  • Mocked integration testy dla wszystkich 9 providerów (378 ✅ | 0 ❌)
  • Coverage: 92% line, 76% branch
  • pre-commit hook: dotnet format
  • pre-push hook: dotnet build + test

Szeregowy added 14 commits March 25, 2026 09:52
…gle() rzucał InvalidOperationException

Register*Provider() nie powinno rejestrować IPaymentProvider — to zadanie PaymentOptionsBuilder.
RegisterPaymentProvider<T>(). Zostaje tylko concrete type + IWebhookPaymentProvider.
Builder aktualizowany: rejestruje IWebhookPaymentProvider gdy provider wspiera ten interfejs.
…PayU, Przelewy24, PayNow, Revolut, HotPay, Adyen

- Nowe pliki: ExtraCoverageTests.cs, ServiceCallerHttpTests.cs
- StripeProvider: mocked IStripeServiceCaller — GetChannels, RequestPayment, GetStatus, TransactionStatusChange, HandleWebhookAsync
- Każdy provider: dodatkowe testy gałęzi (chargeback, tr_status, ABANDONED, ORDER_CANCELLED, PAYMENT_DECLINED, itp.)
- ServiceCaller HTTP tests: mockowany HttpMessageHandler dla GetAccessToken, CreatePayment, GetStatus, VerifyTransaction
- ConfigureOptions tests: Configure() + null-section smoke tests dla wszystkich providerów
- Total line coverage: 66% → 92.04% (cel: ≥80% ✓)
…ą wywołania HTTP do momentu dostępności środowisk integracyjnych
…ki z opisem PL/EN i AI Agent Prompts

- Strona główna z tabelą wszystkich bibliotek
- 23 strony dokumentacji (DateTime, Email x3, EntityFramework x2,
  ExceptionHandling, MediatR x5, Payments + 9 providerów, Querying)
- Każda strona: opis PL+EN, instalacja, DI, przykład kodu, AI Agent Prompt
- mkdocs.yml: pełna nawigacja, site_url → shared.tailoredapps.pl
- DOCUMENTATION_RULE.md: żelazna zasada — PR bez dokumentacji = odrzucony
- docs/contributing.md: zasady wkładu w projekt
@nieprzecietny nieprzecietny merged commit 70a2a99 into master Mar 25, 2026
1 check passed
@codecov
Copy link

codecov bot commented Mar 25, 2026

Codecov Report

❌ Patch coverage is 67.88747% with 605 lines in your changes missing coverage. Please review.
✅ Project coverage is 56.70%. Comparing base (e46f9b7) to head (e248b25).
⚠️ Report is 5 commits behind head on master.

Files with missing lines Patch % Lines
...ed.Payments.Provider.Stripe/StripeServiceCaller.cs 14.28% 54 Missing ⚠️
...Apps.Shared.Payments.Provider.PayU/PayUProvider.cs 73.09% 46 Missing and 7 partials ⚠️
src/TailoredApps.Shared.Email/SmtpEmailProvider.cs 0.00% 50 Missing ⚠️
...pps.Shared.EntityFramework/Querying/PagingQuery.cs 0.00% 32 Missing ⚠️
...Shared.MediatR/PipelineBehaviours/RetryBehavior.cs 0.00% 32 Missing ⚠️
...ps.Shared.EntityFramework/UnitOfWork/UnitOfWork.cs 57.57% 27 Missing and 1 partial ⚠️
...oredApps.Shared.MediatR/DI/PipelineRegistration.cs 0.00% 27 Missing ⚠️
...pps.Shared.EntityFramework/Querying/PagedResult.cs 0.00% 23 Missing ⚠️
...red.MediatR/PipelineBehaviours/FallbackBehavior.cs 0.00% 18 Missing ⚠️
...MessageBuilder/TokenReplacingMailMessageBuilder.cs 0.00% 17 Missing ⚠️
... and 37 more
Additional details and impacted files
@@             Coverage Diff             @@
##           master      #32       +/-   ##
===========================================
+ Coverage   41.71%   56.70%   +14.99%     
===========================================
  Files          99      101        +2     
  Lines        3131     2871      -260     
  Branches      231      292       +61     
===========================================
+ Hits         1306     1628      +322     
+ Misses       1783     1167      -616     
- Partials       42       76       +34     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants