- UDP prijemnik (podrazumevano 46465, NE 46464 gde uredjaji slusaju discovery): dnevnik rada sa zaglavljem #TERMINIA, heartbeat JSON, sve ostalo se odbacuje - paket bez zaglavlja (FW < 0.13.4) se vodi kao "nepoznat uredjaj" po izvornoj IP adresi i tako je i oznacen u prikazu - dnevnik u fajlove po uredjaju i danu, rotacija po velicini + tri kvote (starost, po uredjaju, ukupno); otvoren fajl se nikad ne brise - heartbeat u memoriji; interval se meri iz razmaka javljanja, "tih" = 3x interval - web stranica (podrazumevano 127.0.0.1:8081): spisak uredjaja, crveno za tihe, poslednjih N linija sa pretragom, /dnevnik.txt i /api/uredjaji - bez baze i bez spoljnih zavisnosti; ne dira licencni servis, njegovu bazu, rute ni nginx - sanitizacija svega iz paketa (duzine, kontrolni znaci, ime foldera) — bez izlaska iz foldera dnevnika - systemd unit + primer env fajla + README sa uputstvom za pustanje na server - testovi: parsiranje (zaglavlje/JSON/bez zaglavlja/smece), registar, rotacija i kvote, web rute Nije pusteno na server — puštanje radi vlasnik po logger/README.md. |
||
|---|---|---|
| .. | ||
| 00-vizija-i-mvp.md | ||
| 01-rbac-model.md | ||
| 02-uredjaji-heartbeat-discovery.md | ||
| 03-provisioning-i-fw-katalog.md | ||
| 04-zadaci.md | ||
| 05-pravila-rada.md | ||
| README.md | ||
LoggerService — radni paket za agenta (kontrolna ravan)
Misija: izgraditi serversku kontrolnu ravan za flote terminala — RBAC stablo organizacija, uređaji + heartbeat, servisni grantovi, provisioning i katalog firmvera — kao proširenje postojećeg
licence-server-a (server 151). Jedan backend, dva lica:terminia.net= vendor (licence/fw),loggerservice.com= serviserski brend (isti mozak, drugi izgled).Jezik projekta: srpski (ekavica), latinica; Go komentari srpski ASCII.
Poreklo: paket je nastao u firmverskom repou (
asp-terminia/serviseri/) i prebačen ovde 2026-07-25 — isti backend/baza kao paketdocs/asp-terminia/(licenciranje), koordinacija migracija mora ići kroz jedan repo. Firmverska strana (svc.cpp, discovery/heartbeat) je gotova i ostaje u firmverskom repou. „ASP repo" u tekstu znači https://git.terminia.net/djuka/asp-terminia.
Sadržaj foldera
| Fajl | Šta je unutra |
|---|---|
| 00-vizija-i-mvp.md | ČITATI PRVO — LoggerService je aplikacija za servisne firme (oprema/klijenti/nalozi/zaduženja); uređaji su MODUL; MVP obim (dogovor 2026-07-24 uveče) |
| 01-rbac-model.md | ZAKLJUČEN model: stablo orgs, 4 role, grantovi, invarijante, šeme tabela |
| 02-uredjaji-heartbeat-discovery.md | šta uređaj VEĆ šalje (UDP formati) i šta server treba da primi |
| 03-provisioning-i-fw-katalog.md | Model B/A, postojeći bootstrap FW, katalog .bin-ova, potpisani URL |
| 04-zadaci.md | zadaci redom sa kriterijumima prihvatanja |
| 05-pravila-rada.md | OBAVEZNO prvo — produkcija, backup, granice |
Kontekst u 6 redova
- Proizvod: ESP32‑S3 terminali (linija ASP; prvi proizvod ASP‑Terminia — kontrola prolaza za bazene/spa). Terminal je autonoman i radi offline; platforma je opcioni sloj za flote (više vlasnika, servis, prodaja, OTA).
- Hijerarhija: Terminia = vendor/koren stabla (vlasnik svega); DAL = KUPAC (org pod Terminijom) — ne vendor.
- Serviseri NISU nivo u stablu nego grant preko stabla (razdvaja vlasništvo od servisnog pristupa) — detalji u 01.
- Server: isti
licence-server(Go/MySQL, produkcija!) — RBAC se DODAJE migracijama; koordinacija sa paketomdocs/asp-terminia/(deli bazu i admin sloj). - Uređaj već emituje: LAN discovery (UDP 46464, upit
TERMINIA?→ JSON identitet), heartbeat (UDP JSON na podesiv interval), dbg dnevnik (UDP) — formati u 02.devices.statusna serveru se hrani iz heartbeat-a. - Brend:
loggerservice.comdomen kupuje vlasnik (kredencijali kod njega); do tada se sve gradi i testira na IP-u / internim rutama.
Šta agent NE radi
- Ne kupuje/podešava domene (vlasnik) — ali priprema nginx blokove da se uključe.
- Ne dira postojeće proizvode/licence,
terminiaSaaS, ESIR, Gitea-u. - Ne implementira ništa na SAMOM uređaju (firmware) — uređaj je gotov za ovaj obim; ako zatreba izmena FW, zapisati ZAHTEV u 04 (sekcija „Zahtevi ka firmveru").
Veze
- Firmware repo (ASP repo): https://git.terminia.net/djuka/asp-terminia
(servisni kanal:
firmware/10_terminia/svc.cpp; bootstrap:firmware/00_inicijalni/). Firmverska strana je GOTOVA za ovaj obim — ovaj paket je ne dira. - Istorijat odluka: ASP repo
docs/21-platforma-i-provisioning.md(dogovor 2026-07-24). - Licencna strana:
docs/asp-terminia/(isti server; Z-zadaci tamo idu PRE RBAC UI-ja jer odblokiraju uređaje na terenu). - Serverski kod i konvencije: ../../CLAUDE.md, ../ARCHITECTURE.md, ../../API.md.