Trag svake promjene u CMS-u

Revizijski trag izmjena unutar jednog dućana

Evidencija promjena je ekran u skupini Sustav koji automatski bilježi izmjene napravljene u CMS-u trenutačno otvorenog dućana. Ne treba je uključivati, stvarati ručne zapise ni prethodno postaviti pravilo praćenja. Kada netko spremi izmjenu cijene, kategorije, artikla, narudžbe ili druge CMS radnje, sustav dodaje zapis s vremenom, putanjom i metodom zahtjeva. Ekran je isključivo za čitanje: iz njega se ne mijenja sadržaj trgovine niti se može uređivati sam zapis evidencije.

Pristup imaju upravitelj i vlasnik

Za čitanje evidencije potrebna je razina upravitelj, pa je mogu otvoriti upravitelj i vlasnik. Djelatnik vidi stavku u navigaciji, ali nakon otvaranja dobiva poruku o ograničenju uloge umjesto tablice. Stavka nije skrivena unaprijed zato što CMS ulogu ne pretpostavlja samo iz prikaza; stvarni odgovor poslužitelja određuje ima li prijavljeni korisnik pravo čitati podatke za taj dućan.

Koje informacije nosi jedan zapis

Tablica ima stupce ID, Vrijeme, Tko, Metoda, Putanja, Status i Izmijenjena polja. ID je redni broj zapisa, vrijeme pokazuje kada se radnja dogodila, metoda razlikuje POST, PUT, PATCH, DELETE i iznimno GET, a putanja pokazuje API adresu na koju je zahtjev poslan. Status prikazuje HTTP ishod odgovora. Izmijenjena polja daju kratku bilješku o tome što je promijenjeno, pa zapis nije samo popis tehničkih kodova bez poslovnog konteksta.

Za uređivanje artikla ili narudžbe bilješka sadrži imena promijenjenih polja, primjerice cijena ili stock, ali ne i njihove stvarne vrijednosti. Iz nje se može zaključiti da se cijena promijenila, ne i je li bila 20 ili 25 eura. Kod drugih radnji može stajati kratka oznaka postupka, poput bez_obavijesti pri promjeni statusa narudžbe bez slanja e-maila kupcu, ili naziv uloge kod izmjene prava člana osoblja. Evidencija zato daje sažet trag radnje, ne kopiju cijelog zahtjeva ili njegovog sadržaja.

Tko u zapisu ne znači uvijek konkretnu osobu

Stupac Tko razlikuje automatizirane promjene napravljene kroz Javni API. Kada promjenu napravi tehnički pristup, evidencija prikazuje naziv te API veze, pa se različite veze mogu razlikovati. To je korisno kada više integracija mijenja podatke i treba utvrditi iz kojeg je automatiziranog izvora došla određena radnja.

Kod promjena napravljenih kroz prijavljeni CMS trenutačni sustav nema dovoljno identitetskih podataka da bi zapis prikazao ime ili e-mail konkretne osobe. Svi članovi osoblja koji rade kroz CMS zato ostavljaju istu oznaku izvora. Iz evidencije možeš vidjeti da je netko u CMS-u napravio izmjenu, kada i na čemu, ali ne možeš dokazati koji je točno član osoblja to učinio. Ne treba zato stupac Tko tumačiti kao individualnu evidenciju rada CMS korisnika kada je izvor obična CMS prijava.

Upis izmjena i granica čitanja

Sustav automatski evidentira svaku izmjenu putem POST, PUT, PATCH ili DELETE zahtjeva. Čitanje GET zahtjevima bilježi se samo iznimno. Zato tablica nije povijest svakog otvaranja stranice, pregleda artikla ili čitanja popisa, nego prvenstveno trag promjena stanja. Prvi zapis nastaje čim netko nešto spremi; prije toga CMS jasno razlikuje stvarno praznu evidenciju od kvara učitavanja ili rezultata koje je sakrio filtar.

Evidencija ne čuva vrijednosti osobnih podataka kupaca. Putanja sadržava tehnički ID kupca ili narudžbe, ne ime ni e-mail, a stupac izmijenjenih polja nosi nazive polja i oznake radnje, nikad sadržaj tih polja. Zato GDPR anonimizacija kupca ne uklanja zapis da je anonimizacija bila pokrenuta. Taj trag ostaje do isteka roka, ali nije zapis osobnog imena, e-maila, adrese ili vrijednosti podatka koji je ranije postojao.

Rok čuvanja je 12 mjeseci

Svaki zapis automatski se briše 12 mjeseci nakon nastanka, a čišćenje se pokreće svaki dan. Rok vrijedi jednako za sve dućane, uključujući i privremeno obustavljene. Ne postoji CMS gumb za trajno čuvanje pojedinog retka niti mogućnost da vlasnik ručno produlji rok samo za određenu promjenu. Kada je važan vanjski dokaz ili interna arhiva, treba na vrijeme preuzeti dostupne podatke prije nego zapis izađe iz propisanog razdoblja čuvanja.

Filtri pretražuju cijelu evidenciju na poslužitelju

Iznad tablice možeš filtrirati po stupcu Tko, dijelu API putanje, metodi te datumima Od i Do. Filtar Tko traži dio sadržaja tog stupca: kod API veza dio naziva veze, a kod CMS izmjena zajedničku oznaku izvora. Putanja mora početi kosom crtom, primjerice /api/v1/orders. Metoda se bira iz zatvorenog popisa dopuštenih vrijednosti, a kalendar omogućuje odabir raspona datuma.

Svaka promjena filtra ili stranice šalje novi zahtjev poslužitelju. Filtriranje se zato ne radi samo po retcima koji su trenutačno na zaslonu, nego kroz cijelu dostupnu evidenciju. Rezultati dolaze po stranicama, najnoviji prvi, a ukupan broj za primijenjene filtre određuje postoji li iduća stranica. Kada promijeniš filtar, CMS se vraća na prvu stranicu da se ne bi ostalo na velikom pomaku koji nakon sužavanja nema nijedan rezultat.

Nevaljan upit ne pretvara se tiho u praznu tablicu. Putanja bez početne kose crte, nedopuštena metoda ili neispravan raspon datuma vraćaju jasnu poruku poslužitelja. Utipkani filtri ostaju na ekranu kako bi se mogli popraviti. CMS također razlikuje poruku da još nema nijedne zabilježene promjene od poruke da trenutačni filtri nisu pronašli pogodak. Pritiskom na Očisti filtre vraćaš se na nefiltrirani pregled.

Preuzimanje filtrirane evidencije u CSV-u

Ekran ima akciju Izvezi CSV. Preuzimanje koristi trenutačno postavljene filtre za Tko, metodu, putanju i datumski raspon, pa dobivaš filtriranu evidenciju, a ne nužno cijeli nefiltrirani skup. Naziv datoteke sadrži datum i vrijeme preuzimanja. Ako uređaj ili preglednik ne mogu spremiti datoteku, CMS to jasno prijavljuje; ako poslužitelj odbije zahtjev, prikazuje njegovu poruku umjesto da naznači uspjeh bez stvarno preuzetog dokumenta.

Evidencija promjena zato je kontrolirani pregled onoga što se mijenjalo, a ne potpuni snimak svih podataka trgovine. Upravitelj ili vlasnik njome može suziti trag po vremenu, putanji, metodi i izvoru te po potrebi preuzeti filtrirani CSV. Pritom treba poštovati njezine stvarne granice: CMS izmjene ne pripisuje pojedinoj osobi, zapis ne prikazuje stare i nove vrijednosti, a podaci su dostupni samo 12 mjeseci od nastanka.