tdd-workflow

Skill do testowania sterowanego rozwojem (TDD). Automatyzuje pracę nad nowymi funkcjami, poprawkami i refaktoryzacją kodu poprzez wymuszenie pisania testów przed implementacją. Obejmuje testy jednostkowe, integracyjne i end-to-end z wymaganym pokryciem minimum 80%. Aktywuj go przy pisaniu nowych funkcji, naprawianiu błędów, dodawaniu endpointów API lub tworzeniu komponentów. Prowadzi Cię przez siedmiostopniowy workflow: od zdefiniowania scenariusza użytkownika, przez generowanie testów, aż do weryfikacji pokrycia kodu.

1. Zdefiniuj scenariusz użytkownika w formacie: "As a [rola], I want to [akcja], so that [korzyść]". Na przykład: "As a user, I want to search for markets semantically, so that I can find relevant markets even without exact keywords."

2. Wygeneruj zestawu testów dla każdego scenariusza — napisz testy jednostkowe (dla funkcji i komponentów), integracyjne (dla endpointów API i operacji bazodanowych) oraz end-to-end (dla kluczowych przepływów użytkownika). Każdy test powinien obejmować przypadki graniczne i scenariusze błędów.

3. Uruchom testy poleceniem npm test — powinny się nie powieść, ponieważ kod nie został jeszcze zaimplementowany. To jest oczekiwane zachowanie w TDD.

4. Napisz minimalny kod potrzebny do przejścia testów. Skupiaj się na spełnieniu wymagań testów, nie na perfekcji implementacji.

5. Uruchom testy ponownie — tym razem powinny przejść. Jeśli jakieś testy nie przechodzą, wróć do kroku 4 i popraw kod.

6. Refaktoryzuj kod, zachowując przechodzące testy — usuń duplikaty, popraw nazwy zmiennych, zoptymalizuj wydajność i zwiększ czytelność.

7. Zweryfikuj pokrycie testami poleceniem npm run test:coverage — upewnij się, że osiągnąłeś minimum 80% pokrycia kodu testami.