28296b390c
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>
62 lines
3.8 KiB
Markdown
62 lines
3.8 KiB
Markdown
# 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](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](01-rbac-model.md) | ZAKLJUČEN model: stablo orgs, 4 role, grantovi, invarijante, šeme tabela |
|
||
| [02-uredjaji-heartbeat-discovery.md](02-uredjaji-heartbeat-discovery.md) | šta uređaj VEĆ šalje (UDP formati) i šta server treba da primi |
|
||
| [03-provisioning-i-fw-katalog.md](03-provisioning-i-fw-katalog.md) | Model B/A, postojeći bootstrap FW, katalog `.bin`-ova, potpisani URL |
|
||
| [04-zadaci.md](04-zadaci.md) | zadaci redom sa kriterijumima prihvatanja |
|
||
| [05-pravila-rada.md](05-pravila-rada.md) | **OBAVEZNO prvo** — produkcija, backup, granice |
|
||
|
||
## Kontekst u 6 redova
|
||
|
||
1. **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).
|
||
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/`](../asp-terminia/README.md) (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
|
||
|
||
- **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/`](../asp-terminia/README.md) (isti server; Z-zadaci tamo idu PRE RBAC UI-ja
|
||
jer odblokiraju uređaje na terenu).
|
||
- Serverski kod i konvencije: [../../CLAUDE.md](../../CLAUDE.md),
|
||
[../ARCHITECTURE.md](../ARCHITECTURE.md), [../../API.md](../../API.md).
|