write-test

Skill do pisania testów integracyjnych dla systemu rozliczeń Autumn. Obejmuje konfigurację scenariuszy, testy endpointów billing/attach/track/check, aktualizacje subskrypcji oraz narzędzia do asercji. Używaj go gdy tworzysz testy, piszesz scenariusze dla funkcji rozliczeń i subskrypcji, debugujesz błędy testów lub odpowiadasz na pytania o testowanie i QA.

1. Przed napisaniem jakiegokolwiek testu przeszukaj katalog testów w poszukiwaniu podobnych scenariuszy — grep pomoże ci znaleźć duplikaty. Przeczytaj plik reguł w .claude/rules/write-tests.mdc, który zawiera 20 najczęstszych błędów popełnianych przez agenty.

2. Zapoznaj się z systemem initScenario — to główny mechanizm do tworzenia klientów, produktów i jednostek testowych. Funkcja przyjmuje unikalny identyfikator klienta, listę kroków konfiguracji (setup) oraz listę akcji do wykonania.

3. Przygotuj dane testowe używając dostępnych fixture'ów: items do tworzenia pozycji (np. wiadomości miesięczne z limitami użycia), products do definiowania produktów (np. plan pro). Połącz je w strukturę, którą przekażesz do initScenario.

4. Zdefiniuj akcje testowe za pomocą helpera s.billing.attach() lub innych dostępnych akcji z systemu. Te akcje będą wykonane w ramach inicjalizacji scenariusza i pozwolą ci przetestować przepływ rozliczeń.

5. Po inicjalizacji scenariusza pobierz dane klienta za pomocą autumnV1.customers.get() i sprawdzaj je używając narzędzi asercji: expectCustomerFeatureCorrect do weryfikacji stanu funkcji oraz expectStripeSubscriptionCorrect do sprawdzenia poprawności subskrypcji Stripe.

6. Opakuj test w test.concurrent() z opisową nazwą, aby umożliwić równoległy przebieg testów i ułatwić identyfikację, która funkcja jest testowana.