licence-server/docs/loggerservice/00-vizija-i-mvp.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

64 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# LoggerService — vizija i MVP (DOGOVORENO sa vlasnikom, 2026-07-24 uveče)
> Ovaj dokument je ISPRED svih ostalih u folderu: definiše ŠTA se gradi.
> Ostali fajlovi (0105) opisuju delove; gde se razlikuju, ovaj je merodavan.
## Vizija
**LoggerService je samostalna aplikacija za servisne firme** — praćenje opreme,
ljudi i posla. **Kreće interno (vlasnikova firma), kasnije se PRODAJE drugim
servisnim firmama** (od prvog dana više-firmi u bazi — RBAC stablo iz 01).
Naši pametni terminali su **MODUL „Uređaji"** koji se **uključuje u opcijama**
po firmi — nisu centar aplikacije.
## Jezgro (uvek prisutno)
| # | Celina | Dogovor |
|---|---|---|
| 1 | **Firme/nalozi** | vlasnikova firma prva; multi-tenant od starta (orgs stablo + 4 role iz `01-rbac-model.md`) |
| 2 | **Oprema — KIČMA aplikacije** | tačno se prati **SVAKI komad** (serijalizovan): identitet, istorija, kod kog klijenta je ugrađen. Zalihe/delovi (količine) takođe postoje, ali serijalizovana oprema je suština |
| 3 | **Klijenti** | zavode se **pri otvaranju PRVOG naloga** za tog klijenta; uz klijenta se vezuju oprema, reklamacije i servisi |
| 4 | **Nalozi za posao** | tipovi: **ugradnja / servis / reklamacija** → dodeljen serviseru → ishod se upisuje u ISTORIJU OPREME |
| 5 | **Zaduženja** | ko je od servisera šta poneo/vratio (naslanja se na opremu/robu) |
| — | Evidencija rada (sati/obračun) | **KASNIJE** — vlasnik već ima softver za to |
## Modul „Uređaji" (uključiv u opcijama) — MVP obim
Za sada **najosnovnije**, sa dve tvrde odrednice od vlasnika:
1. **Upravljanje firmverom**: biće **VIŠE firmvera** (linija ASP: ASP-Terminia,
parking, garderoba…) — modul zna koji proizvod/verzija ide na koji uređaj i
omogućava podešavanje/dodelu FW (naslanja se na katalog `fw.terminia.net`,
vidi `03-provisioning-i-fw-katalog.md`).
2. **Direktno vezan za licencni server** (`dal-license-server`): modul
komunicira sa njim (proizvodi, licence po MAC-u, entitlements) — NE gradi
svoju paralelnu evidenciju licenci. Vidi paket [`docs/asp-terminia/`](../asp-terminia/README.md).
Uz to iz postojećeg: uređaji se sami javljaju (heartbeat/discovery formati u
`02-uredjaji-heartbeat-discovery.md`) → status u modulu.
**Prirodna sprega sa jezgrom:** terminal JE serijalizovana oprema (celina 2) —
modul „Uređaji" je specijalizacija komada opreme koji se uz to i sam javlja.
## Šta ovo menja u zadacima (04-zadaci.md)
- S1 (šema) se PROŠIRUJE jezgrom: `oprema` (serijalizovana, istorija),
`klijenti`, `nalozi` (ugradnja/servis/reklamacija), `zaduzenja`, `zalihe`
pored već dogovorenih orgs/users/devices/entitlements/grants.
- „Dashboard" (S4) = MVP LoggerService aplikacije (jezgro), ne samo pregled
uređaja; modul „Uređaji" = toggle po firmi (entitlements).
- Infrastruktura je POSTAVLJENA 2026-07-24: `loggerservice.com` (+www) služi sa
151 (`/var/www/loggerservice`, nginx sajt `loggerservice`, Let's Encrypt);
`licenca.terminia.net` → backend 8090; `fw.terminia.net``/var/www/fw`.
## Redosled gradnje (predlog za agenta)
1. Šema jezgra (migracije, multi-tenant od starta) — uz postojeći MySQL.
2. Minimalni tok koji vlasnikova firma odmah koristi: **klijent (pri prvom
nalogu) → nalog (ugradnja) → komad opreme zaveden kod klijenta → istorija**.
3. Zaduženja.
4. Modul „Uređaji" (toggle): lista terminala + status + dodela FW + veza na
licencni server.
5. Prodajna spremnost (onboarding drugih firmi) — tek kad interno proradi.