Przejdź do treści

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

./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.

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