# Weight Gateway

Dokumentacja bramki, która odbiera odczyty wagi po TCP ze sterownika MOXA i udostępnia ostatni odczyt przez HTTP dla Apollo. Jest dla programistów, testerów, supportu i osób wdrażających aplikację na serwer z wagą. Zadanie źródłowe: [A-19606](<https://youtrack.logintegra.com/issue/A-19606/Aplikacja-weight-gateway-dla-wagi-Drogbruk-Pila>).

## Jak to działa

```
flowchart LR
    scale[Waga] --> moxa[MOXA]
    moxa -->|TCP 14002| tcp[tcp-service]
    apollo[Apollo] -->|GET /weight| tcp
    admin[admin] -->|GET /status| tcp
    mock[mock] -.->|TCP 14002| tcp
```

Waga wysyła rekordy zakończone CRLF, a `tcp-service` trzyma ostatni z nich w pamięci. `GET /weight` zwraca odczyt z kodem 200 tylko wtedy, gdy jest świeży, czyli młodszy niż 5 sekund. W pozostałych przypadkach odpowiedź ma status 503 i kod `NO_DATA`, `STALE` albo `INVALID`. Panel `admin` pokazuje status połączenia z wagą i zawiera symulator wagi, a `mock` jest jego odpowiednikiem w linii poleceń.

Linia przerywana oznacza ruch tylko testowy.

## Strony

| Strona | Zawartość | Dla kogo |
| --- | --- | --- |
| [Projekt](<https://docs.logintegra.com/weight-gateway/projekt/index.md>) | cel, moduły, kontrakt `GET /weight` i `GET /status`, mock, panel admin | wszyscy |
| [Protokół Moxa](<https://docs.logintegra.com/weight-gateway/protokol-moxa/index.md>) | założenia o MOXA, algorytm parsera, klasyfikacja rekordów | programiści, testerzy |
| [Uruchamianie i testowanie](<https://docs.logintegra.com/weight-gateway/uruchamianie/index.md>) | uruchomienie modułów lokalnie, scenariusz ręczny, testy | programiści, testerzy |
| [Konfiguracja](<https://docs.logintegra.com/weight-gateway/konfiguracja/index.md>) | klucze `application.yml`, zmienne środowiskowe, logowanie | programiści, wdrażający |
| [Wdrożenie](<https://docs.logintegra.com/weight-gateway/wdrozenie/index.md>) | pipeline TeamCity, rollback, czynności ręczne na serwerze | wdrażający |

## Szybki start

```
./gradlew :tcp-service:bootRun
curl -i http://localhost:8080/weight
```

Bez danych od wagi odpowiedź to 503 z kodem `NO_DATA`. Mocka uruchamia się poleceniem `./gradlew :mock:run --args="127.0.0.1 14002 500 1250"`. Pełny opis jest na stronie [Uruchamianie i testowanie](<https://docs.logintegra.com/weight-gateway/uruchamianie/index.md>).

## Moduły

| Moduł | Rola |
| --- | --- |
| `weight-protocol` | model rekordu, parser i klasyfikator |
| `tcp-service` | nasłuch TCP od MOXA i endpointy `GET /weight` oraz `GET /status` |
| `admin` | panel administracyjny, status połączenia i symulator wagi |
| `mock` | symulator wagi, klient TCP |

## Porty

| Aplikacja | Port | Do czego |
| --- | --- | --- |
| `tcp-service` | `14002/TCP` | połączenie od MOXA |
| `tcp-service` | `8080/HTTP` | `GET /weight` dla Apollo, `GET /status` dla panelu |
| `admin` | `8081/HTTP` | panel administracyjny |
