# Przypadki testowe w TMA

Strona opisuje TMA, czyli zarządzanie testami w YouTrack. Jest dla testerów i programistów, którzy piszą albo uruchamiają testy Apollo.

## Czym jest TMA

TMA to projekt w YouTrack, w którym każde zgłoszenie jest przypadkiem testowym. Przypadek testowy opisuje, co sprawdzamy, jakie są kroki i jakiego wyniku oczekujemy.

Projekt: [TMA w YouTrack](<https://youtrack.logintegra.com/projects/TMA>).

Przypadek testowy żyje dłużej niż zadanie, w którym powstał. Zadanie `A-12345` opisuje zmianę, a przypadek w TMA opisuje zachowanie, które ma działać po każdym kolejnym wydaniu.

## Powiązanie z testami automatycznymi

Testy automatyczne leżą w repozytorium `swiss-krono-selenium-tests`. Scenariusz Cucumbera wskazuje zgłoszenie w YouTrack tagiem `@TmsLink`, a błąd, którego dotyczy, tagiem `@Issue`.

```
@TmsLink=TMA-123 @Issue=A-12345
Scenario: Przyjęcie zlecenia z aukcji po cenie minimalnej
```

Raport Allure zamienia oba tagi na linki do `https://youtrack.logintegra.com/issue/<ID>`. Wzorce linków ustawia `pom.xml` w `allure.link.tms.pattern` i `allure.link.issue.pattern`.

Jeden test uruchamiamy po jego zgłoszeniu:

```
mvn clean test -Dgroups="TmsLink=TMA-123"
```

Stan na 2026-09-30: większość z 592 tagów `@TmsLink` wskazuje zgłoszenia `A-*`, a nie przypadki w TMA. Kilka tagów ma inny format, np. `A-TAMA-3` albo sam numer.

## Zasady

1. Nowy scenariusz automatyczny MUSI mieć tag `@TmsLink` z identyfikatorem przypadku w TMA.
2. Scenariusz, który sprawdza poprawkę błędu, POWINIEN mieć też tag `@Issue` ze zgłoszeniem błędu.
3. Przypadek testowy w TMA POWINIEN wskazywać zadanie, w którym powstała testowana funkcja.
4. Zmiana zachowania aplikacji MUSI zmieniać przypadek w TMA w tym samym zadaniu, w którym zmienia się kod.
5. Scenariusz, którego dotyczy zmiana, POWINIEN dostać poprawny `@TmsLink`, jeśli ma tag w innym formacie.
