# Uruchamianie i testowanie

Strona opisuje, jak uruchomić `tcp-service`, `admin` i `mock` lokalnie oraz jak uruchomić testy. Jest dla programistów i testerów, którzy rozwijają i testują aplikacje. Opis modułów i założeń projektu jest na stronie [Projekt](<https://docs.logintegra.com/weight-gateway/projekt/index.md>).

## Wymagania

| Element | Wymaganie |
| --- | --- |
| JDK | 25, dla wszystkich modułów |
| Gradle | wrapper z repozytorium, polecenie `./gradlew` |

## Porty

| Aplikacja | Protokół | Port | Konfiguracja |
| --- | --- | --- | --- |
| `tcp-service` | TCP, wejście od wagi | `14002` | `weight.port` |
| `tcp-service` | HTTP, `GET /weight` | `8080` | domyślny port Grails |
| `admin` | HTTP, panel | `8081` | `server.port` |

W środowisku `test` `tcp-service` nasłuchuje na losowym porcie TCP, bo `weight.port` ma tam wartość `0`.

## Uruchomienie tcp-service

```
git clone git@bitbucket.org:logintegraspzoo/weight-gateway.git
cd weight-gateway
./gradlew :tcp-service:bootRun
```

Po starcie aplikacja otwiera port TCP `14002` i odpowiada na `http://localhost:8080/weight`. Dopóki nie przyszedł żaden rekord, odpowiedź ma status 503 i kod `NO_DATA`.

```
curl -i http://localhost:8080/weight
```

## Uruchomienie mocka z linii poleceń

Mock łączy się z uruchomionym `tcp-service` i wysyła wagę co zadany czas. Składnia argumentów to `<host> <port> [periodMs] [weight]`.

```
./gradlew :mock:run --args="127.0.0.1 14002 500 1250"
```

Bez ostatniego argumentu mock wysyła losowe wagi z zakresu 0 do 100000. Zakończenie następuje przez Ctrl-C.

## Uruchomienie panelu admin

```
./gradlew :admin:bootRun
```

Strona mocka jest pod adresem `http://localhost:8081/mockScale`. Pozwala połączyć się z bramką, włączyć strumień wagi, wysłać pojedynczą wagę i wysłać rekordy niepoprawne. Strona działa tylko wtedy, gdy `mock.enabled` ma wartość `true`. W środowisku produkcyjnym panel admina powinien być dostępny tylko z VPN.

Adres bramki, z którym łączy się panel, ustawiają klucze `mock.gateway.host` i `mock.gateway.port` w `admin/grails-app/conf/application.yml`.

Status połączenia z wagą jest pod adresem `http://localhost:8081/gateway`. Strona czyta `GET /status` z `tcp-service`, więc `tcp-service` musi działać. Gdy działa na innym adresie, ustaw `gateway.status-url`.

## Sprawdzenie ręczne

Poniższy scenariusz potwierdza cały przepływ od wagi do odpowiedzi HTTP. Wymaga dwóch terminali.

1. W pierwszym terminalu uruchom `./gradlew :tcp-service:bootRun`.
2. W drugim terminalu sprawdź, że `curl -i http://localhost:8080/weight` zwraca 503 z kodem `NO_DATA`.
3. Uruchom mocka poleceniem `./gradlew :mock:run --args="127.0.0.1 14002 500 1250"`.
4. Ponów `curl -i http://localhost:8080/weight`. Odpowiedź ma status 200 i element `<span id="weight" ...>1250</span>`.
5. Zatrzymaj mocka przez Ctrl-C i odczekaj ponad 5 sekund.
6. Ponów `curl`. Odpowiedź ma status 503 i kod `STALE`.

Kod `INVALID` pojawia się, gdy ostatni rekord nie był poprawną wagą. Najprościej wywołać go presetem `NEGATIVE` albo `OVERWEIGHT` na stronie symulatora w panelu admin.

## Testy

| Zakres | Polecenie |
| --- | --- |
| Testy jednostkowe wszystkich modułów | `./gradlew test` |
| Testy jednego modułu | `./gradlew :weight-protocol:test` |
| Testy integracyjne `tcp-service` | `./gradlew :tcp-service:integrationTest` |
| Testy integracyjne `admin` | `./gradlew :admin:integrationTest` |
| Pełne budowanie z testami | `./gradlew build` |

Testy integracyjne `tcp-service` podnoszą aplikację na losowych portach i wysyłają dane przez `ScaleMock`. Testy integracyjne `admin` używają Geb z kontenerem, więc wymagają działającego Dockera.

Raporty z testów leżą w `<moduł>/build/reports/tests/`. Pojedynczą klasę testową uruchamia opcja `--tests`.

```
./gradlew :weight-protocol:test --tests RecordParserTest
```
