Revizioni trag
MlekErp automatski beleži svaku izmenu ključnih entiteta u generičku tabelu revizionog traga
(core.AuditLogs, CF-017). Ovo je pasivna, sistemska evidencija — korisnici aplikacije je
ne aktiviraju i ne konfigurišu; ona se ažurira u pozadini pri svakom snimanju podataka.
Šta se beleži
MlekErp beleži promene (kreiranje, izmenu, brisanje) na odabranim header entitetima označenim za praćenje. U trenutnoj verziji to uključuje ključne operativne i finansijske entitete sistema.
Za svaku promenu sistem beleži:
| Polje | Sadržaj |
|---|---|
| Entitet i ID | Koji zapis je promenjen (npr. SalesOrder #1234) |
| Akcija | Create / Update / Delete |
| Datum i vreme | Tačan trenutak snimanja |
| Korisnik | Ime i email korisnika koji je pokrenuo promenu |
| IP adresa | IP adresa korisnika |
| Staro stanje | Kompletan JSON snapshot pre izmene |
| Novo stanje | Kompletan JSON snapshot posle izmene |
Kada promenu izvrši pozadinski posao (cron, automatska akcija) umesto korisnika, polje Korisnik ostaje prazno.
Kako funkcioniše
Beleženje je potpuno automatsko — implementirano kao interceptor nad EF Core SaveChanges
mehanizmom. Ne postoji API endpoint niti dugme koje korisnik treba da pritisne.
Princip rada:
- Korisnik (ili pozadinski posao) izvrši neku akciju — npr. sačuva prodajni nalog.
- EF Core interceptor automatski detektuje promenu na entitetu koji je označen za praćenje.
- Sistem snima staro i novo stanje kao JSON uz podatke o korisniku i trenutku.
- Zapis se dodaje u
core.AuditLogsu istoj transakciji — ne može se propustiti.
Korisnici aplikacije nemaju pristup ovoj tabeli — niti je vide, niti je mogu menjati.
Gde se revizioni trag pregledava
Revizioni trag dostupan je isključivo administratorima sistema putem Admin panela:
Admin panel → Revizioni trag (/core-audit-logs)
Admin stranica prikazuje unose iz svih organizacija (cross-tenant prikaz) i pruža filtere po:
- Datumskom opsegu
- Tipu entiteta
- Organizaciji
- Korisniku
Ovaj prikaz je namijenjen isključivo sistemskim administratorima koji upravljaju platformom, ne korisnicima pojedinačnih organizacija.
Veza sa CF-011 i CF-013 revizionim tragovima
MlekErp ima tri odvojena sloja revizije koji se dopunjavaju:
| Sloj | Modul | Šta beleži | Ko može videti |
|---|---|---|---|
| Zaključavanje dokumenata | CF-011 | Lock/Unlock/Obrazložena izmena po dokumentu | Vlasnik/Admin u detalju dokumenta |
| Fiskalna godina | CF-013 | Zatvaranje/otvaranje fiskalne godine | Vlasnik/Admin u podešavanjima |
| Generički revizioni trag | CF-017 | Izmene svih praćenih entiteta (JSON) | Samo sistemski admin (Admin panel) |
Svi slojevi su aditivni — CF-017 ne zamenjuje CF-011 ni CF-013 tragove, već ih dopunjuje pregledom na nivou celog sistema.
Čuvanje podataka
Zapisi u revizionom tragu čuvaju se prema konfigurisanoj politici zadržavanja. Podrazumevano trajanje je 7 godina, što odgovara obavezama čuvanja poslovnih knjiga po srpskom računovodstvenom zakonodavstvu.
Čišćenje starih zapisa vrši se automatski pozadinskim poslom (CleanupCoreAuditLogsJob).
Trajanje zadržavanja konfiguriše sistemski administrator na nivou platforme — nije podešavanje
dostupno klijentima (organizacijama).
Šta nije pokriveno
- Korisničke sesije i prijavljivanje — evidencija prijave/odjave nije deo CF-017 (ovo je domen SF-009 autentifikacije).
- Linije dokumenta — v1 prati samo header entitete; linije stavki (npr. pojedinačne linije otpremnice) nisu u listi praćenih entiteta u prvoj verziji.
- Objedinjen timeline — mogućnost prikaza objedinjene hronologije iz sva tri sloja (CF-011 + CF-013 + CF-017) planirana je za buduću verziju (F-108).
- Korisnički pristup — korisnici organizacije ne mogu sami pregledati revizioni trag; uvid imaju samo sistemski administratori.
Napomene za administratore organizacije
Revizioni trag iz CF-017 nije direktno dostupan vlasnicima/administratorima organizacije kroz aplikaciju. Za praćenje izmena na konkretnim dokumentima, koristite:
- Revizioni trag dokumenta (CF-011) — na detaljnoj stranici svakog prodajnog naloga, otpremnice, radnog naloga itd.; prikazuje Ko/Kada/Zašto je menjao zaključan dokument.
- Revizioni trag fiskalne godine (CF-013) — u podešavanjima fiskalne godine; prikazuje ko je zatvorio/otvorio godinu i kada.
Veza sa ostalim modulima
| Modul | Veza |
|---|---|
| Tok dokumenata i zaključavanje | CF-011 revizioni trag po dokumentu |
| Finansije — Fiskalna godina | CF-013 revizioni trag zatvaranja |
| Sistem — organizaciona podešavanja | Konfiguracija organizacije |