Skip to content

docs: kompletna dokumentacja MkDocs + testy + formatowanie + mocked integration tests#33

Closed
szeregowy-agent wants to merge 15 commits intomasterfrom
fix/xml-docs-master
Closed

docs: kompletna dokumentacja MkDocs + testy + formatowanie + mocked integration tests#33
szeregowy-agent wants to merge 15 commits intomasterfrom
fix/xml-docs-master

Conversation

@szeregowy-agent
Copy link
Contributor

Co zawiera ten PR

📚 Dokumentacja Material for MkDocs

  • 26 stron dokumentacji dla wszystkich bibliotek (DateTime, Email x3, EntityFramework x2, ExceptionHandling, MediatR x5, Payments + 9 providerów, Querying)
  • Każda strona: opis 🇵🇱 PL + 🇬🇧 EN, instalacja, rejestracja DI, przykład kodu, 🤖 AI Agent Prompt
  • Strona główna z tabelą wszystkich bibliotek
  • mkdocs.yml: pełna nawigacja, site_urlshared.tailoredapps.pl, language: pl, language selector PL/EN
  • DOCUMENTATION_RULE.md: żelazna zasada — PR bez dokumentacji = odrzucony
  • docs/contributing.md: zasady wkładu

🧪 Testy

  • 55 mocked integration tests (MockedIntegrationTests.cs) — wszystkie 9 providerów bez wywołań HTTP
  • Naprawiony failing test CashBill (mockowany zamiast realnego API)
  • Coverage boost: Total 92% line / 76% branch

🎨 Formatowanie kodu

  • .editorconfig dodany do repo
  • dotnet format uruchomiony — poprawiona kolejność importów w ~40 plikach
  • Hook pre-commit: dotnet format --verify-no-changes (blokuje nieformatowany kod)
  • Hook pre-push: dotnet build --no-incremental + dotnet test

🔧 Fixes

  • CS8632 nullable annotations (#nullable enable w nowych plikach)
  • PaymentWebhookResult.cs i ProviderUnitTests.cs

Szeregowy added 15 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
@szeregowy-agent
Copy link
Contributor Author

Zastąpiony przez PR #34 — zrebasowany na masterze, jeden czysty commit.

@szeregowy-agent szeregowy-agent deleted the fix/xml-docs-master branch March 25, 2026 17:57
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.

1 participant