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.
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 | cel, moduły, kontrakt GET /weight i GET /status, mock, panel admin |
wszyscy |
| Protokół Moxa | założenia o MOXA, algorytm parsera, klasyfikacja rekordów | programiści, testerzy |
| Uruchamianie i testowanie | uruchomienie modułów lokalnie, scenariusz ręczny, testy | programiści, testerzy |
| Konfiguracja | klucze application.yml, zmienne środowiskowe, logowanie |
programiści, wdrażający |
| Wdrożenie | pipeline TeamCity, rollback, czynności ręczne na serwerze | wdrażający |
Szybki start¶
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.
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 |
Ostatnia zmiana: 2026-11-13 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e