licence-server/docs/loggerservice/README.md
Nenad Djukic 28296b390c Preuzet radni paket LoggerService (RBAC kontrolna ravan) iz firmverskog repoa
Paket je nastao u asp-terminia/serviseri/ ali je sav posao serverski (isti
backend i baza kao ASP-Terminia licenciranje), pa se seli ovde - isto
obrazlozenje i put kao docs/asp-terminia/.

- docs/loggerservice/ - 7 dokumenata: vizija/MVP (merodavan dokument),
  ZAKLJUCEN RBAC model (stablo orgs, 4 role, invarijante, seme tabela),
  heartbeat/discovery formati koje uredjaj vec salje, provisioning i
  katalog firmvera, zadaci S1-S7, pravila rada na produkciji
- reference prepravljene: "ASP repo" = https://git.terminia.net/djuka/asp-terminia,
  link ka docs/asp-terminia/ unutar istog repoa umesto stare "dal-license-server
  repo:" oznake
- CLAUDE.md: sekcija LoggerService + koordinacija sa docs/asp-terminia/
  (S1-S2 idu POSLE Z1 da se migracije ne sudare)

Firmverska strana (svc.cpp, discovery/heartbeat) ostaje u ASP repou i ne dira se.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-25 07:10:37 +02:00

3.8 KiB
Raw Blame History

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 dal-license-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 paket docs/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

  1. Proizvod: ESP32S3 terminali (linija ASP; prvi proizvod ASPTerminia — kontrola prolaza za bazene/spa). Terminal je autonoman i radi offline; platforma je opcioni sloj za flote (više vlasnika, servis, prodaja, OTA).
  2. Hijerarhija: Terminia = vendor/koren stabla (vlasnik svega); DAL = KUPAC (org pod Terminijom) — ne vendor.
  3. Serviseri NISU nivo u stablu nego grant preko stabla (razdvaja vlasništvo od servisnog pristupa) — detalji u 01.
  4. Server: isti dal-license-server (Go/MySQL, produkcija!) — RBAC se DODAJE migracijama; koordinacija sa paketom docs/asp-terminia/ (deli bazu i admin sloj).
  5. 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.status na serveru se hrani iz heartbeat-a.
  6. Brend: loggerservice.com domen 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, terminia SaaS, 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