licence-server/logger/README.md

Prijemnik dijagnostike sa TERMINIA uređaja

Mali samostalan servis: sluša UDP pakete koje terminal šalje (dnevnik rada i heartbeat), piše ih u fajlove po uređaju i po danu, i prikazuje na jednoj web stranici.

• Nema bazu, nema spoljnih Go zavisnosti (samo standardna biblioteka).
• Ne dira licencni servis — zaseban proces, zaseban port, zaseban systemd unit. Deli samo Go modul (isti repo).
• Ugovor o formatu paketa: ASP repo, docs/24-servisni-kanal.md.

Šta prima

Vrsta	Kako se prepoznaje	Šta radi sa njim
Dnevnik rada (dbg)	čist tekst; prvi red #TERMINIA <naziv> <MAC> <fw>	linije se upisuju u fajl uređaja
Heartbeat	paket počinje sa { (JSON sa "hb":1)	pamti se u memoriji (naziv, MAC, IP, FW, vreme)
Sve ostalo	—	tiho se odbacuje, brojač „odbačeno" na stranici

Zaglavlje dnevnika postoji tek od FW 0.13.4. Stariji uređaj šalje goli tekst — takav se vodi kao nepoznat uređaj, razvrstava po izvornoj IP adresi i tako je i označen na stranici (ne pravimo se da znamo ko je).

Prijemnik ne odgovara na pakete. Prijem naloga na uređaju nije implementiran i traži potpis (docs/24 §3.2), pa slanja naloga ovde nema.

Web stranica

Ruta	Šta daje
/	spisak uređaja: naziv, MAC, IP, FW, „poslednji put pre X"; crveno = nije se javio duže od 3× svog intervala
/uredjaj?k=<ključ>&q=<pretraga>&n=<broj>	poslednjih N linija dnevnika, sa pretragom po tekstu
/dnevnik.txt?k=<ključ>&n=&q=	isto, kao čist tekst (za curl)
/api/uredjaji	JSON spisak uređaja (za alate)

Interval javljanja se meri iz razmaka između dva heartbeat-a; dok ga nema, koristi se LOGGER_HB_DEFAULT_SEC.

Pokretanje lokalno

cd D:\Terminia\TERMINIA-SOFTWARE\licence-server
go build -o terminia-logger.exe .\logger\cmd\terminia-logger

$env:LOGGER_UDP_PORT="46465"
$env:LOGGER_HTTP_PORT="8081"
$env:LOGGER_DIR="D:\Terminia\TERMINIA-SOFTWARE\licence-server\data\logger"
.\terminia-logger.exe

Zatim otvoriti http://127.0.0.1:8081.

Proba bez uređaja (PowerShell, u drugom prozoru):

$u=New-Object System.Net.Sockets.UdpClient; $u.Connect("127.0.0.1",46465)
function Send($s){ $b=[System.Text.Encoding]::UTF8.GetBytes($s); [void]$u.Send($b,$b.Length) }
Send '{"app":"TERMINIA","name":"TERM-001","mac":"1C:DB:D4:A6:A4:60","ip":"192.168.0.20","fw":"0.13.4","hb":1}'
Send "#TERMINIA TERM-001 1C:DB:D4:A6:A4:60 0.13.4`n[stampac] javio se na 192.168.123.100`n"
$u.Close()

Testovi:

go test ./logger/...

Env promenljive

Promenljiva	Podrazumevano	Značenje
LOGGER_UDP_PORT	46465	port na koji uređaji šalju. Ne 46464 — tamo uređaji slušaju discovery
LOGGER_UDP_HOST	(prazno)	adresa za slušanje; prazno = sve
LOGGER_HTTP_HOST	127.0.0.1	web sluša samo lokalno jer dnevnik sadrži brojeve karata
LOGGER_HTTP_PORT	8081	port web pregleda
LOGGER_TOKEN	(prazno)	ako je postavljen, web traži ?t=<token> (obavezno ako web nije samo lokalni)
LOGGER_DIR	./data/logger	folder sa dnevnicima
LOGGER_KEEP_DAYS	14	koliko dana se dnevnici čuvaju
LOGGER_MAX_FILE_MB	10	preko toga se dnevni fajl rotira (.log.001, .002…)
LOGGER_MAX_DEVICE_MB	50	kvota po uređaju; preko toga se briše najstarije
LOGGER_MAX_TOTAL_MB	1024	ukupna kvota za sve uređaje
LOGGER_MAX_DEVICES	500	koliko uređaja se drži u memoriji
LOGGER_HB_DEFAULT_SEC	60	pretpostavljeni interval dok se ne izmeri

Neispravna vrednost = servis se ne pokreće i kaže koja promenljiva ne valja (bolje nego da tiho radi sa pogrešnim podešavanjem).

Šta se upisuje u uređaj

U SPA uređaja: Podešavanja → Servis

Polje	Vrednost
svcLogHost	157.180.119.151:46465
„Šalji dnevnik rada na server"	uključeno
heartbeat (svcHbSeconds)	npr. 60

Uređaj šalje samo brojčani IP:port — domen se ne može upisati (docs/24 §1).

⚠️ Ovo ide preko interneta u čistom tekstu, a u dnevniku ima brojeva karata. Za trajno praćenje flote predviđen je HTTPS kanal (docs/24 §3); ovaj prijemnik je za dijagnostiku dok se problem lovi.

Puštanje na server (radi vlasnik)

# 1) build na serveru
cd /root/projects/licence-server
git pull
go build -o terminia-logger ./logger/cmd/terminia-logger

# 2) podešavanja
cp logger/deploy/terminia-logger.env.example logger.env
$EDITOR logger.env

# 3) systemd
cp logger/deploy/terminia-logger.service /etc/systemd/system/
systemctl daemon-reload
systemctl enable --now terminia-logger
systemctl status terminia-logger
journalctl -u terminia-logger -f

# 4) firewall — SAMO taj port, UDP
ufw allow 46465/udp

# 5) provera sa strane (ne sme da vrati odgovor, samo da ne pukne)
echo '#TERMINIA PROBA AA:BB:CC:DD:EE:FF 0.13.4
proba veze' | nc -u -w1 157.180.119.151 46465

# 6) pregled (web je vezan za 127.0.0.1) — SSH tunel sa svog racunara:
ssh -L 8081:127.0.0.1:8081 root@157.180.119.151
# pa u pregledacu: http://127.0.0.1:8081

Ako web treba da bude dostupan bez tunela: postaviti LOGGER_TOKEN, staviti nginx ispred sa TLS-om i lozinkom, i tek onda promeniti LOGGER_HTTP_HOST. Ne otvarati port 8081 direktno na internet.

Šta ovaj servis ne dira: bazu licence_db, proces licence-server, nginx konfiguraciju, portove 8090/8091/8092.

Granice i odbrane

• Paket može poslati bilo ko: sve iz paketa je ograničeno po dužini, kontrolni znaci se izbacuju, a ime foldera se pravi isključivo od belih znakova ([A-Za-z0-9_-]) — sadržaj paketa ne može da odluči gde se piše.
• Broj uređaja u memoriji je ograničen; kad se granica dostigne, izbacuje se onaj koji se najduže nije javio.
• Dnevnici se brišu po tri pravila redom: starost → kvota po uređaju → ukupna kvota. Fajl koji je trenutno otvoren za pisanje se nikad ne briše.
• Greška pri upisu ne obara prijem — vidi se kao brojač „greške upisa".