IRIS
Admin
Nastavenia
Uložená konfigurácia v DB: len admin / super_admin. Fallback: env VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY, VAPID_CONTACT_EMAIL.
| Názov | Stav |
|---|
| Čas | Stav | Zákazník | Nadpis |
|---|
Založenie spoločnosti (firma v skupine) + typ kódu.
Super admin: vytvorenie novej skupiny (holding).
/scan/UUID-KARTY
Prístup sa riadi rolou používateľa (user panel).
| Rola | Čo vidí |
|---|---|
| super_admin | Všetky firmy, skupiny, role, kompletné moduly. |
| admin | Len pridelená firma, zákazníci, predavačky, data, pokladňa. |
| manager | Pokladňa + zákazníci (čítanie/vyhľadanie), podľa priradenia. |
| cashier | Pokladňa/čítačka a rýchle info o zákazníkovi. |
| Skupina | Popis | Max. trvanlivosť (dní) | Logika zásoby |
|---|---|---|---|
| 🔴 A — Čerstvé | Mäso, pečivo | D+1/D+2 + % | |
| 🟡 B — Krátke | Syry, jogurty | -dňová zásoba | |
| 🟢 C — Stredné | Maslo, smotana | -dňová zásoba (informatívne) · rezerva % z týž. predaja | |
| ⚪ D — Dlhé | Suchý tovar, nápoje | >C | -dňová zásoba (informatívne) · rezerva % z týž. predaja |
100 = plný návrh, 80 = znížiť o 20 % (všetky predajne)
%Delí sa celok, nepridáva sa navyše: pri 30 % a potrebe 7 kg ide 5 kg voľného a 2 kg vákuového. 0 = nedeliť, všetko ide v jednom riadku presne podľa návrhu. Platí len pre artikle, ktoré majú u dodávateľa vákuový kód — tie sú vypísané nižšie a podiel sa im dá prepísať jednotlivo. Platnosť: artikel → predajňa → firma.
Pri motore: voľne sa objedná najviac denný predaj (100 %) mínus voľné, ktoré ešte zostalo z predošlého dňa; zvyšok ide vákuovo v celých výsekoch. Hovädzie a artikle s vlastným % na karte idú podľa karty. Percentá predajní sa pri motore nepoužijú.
€/kg %Každú noc o 21:30 (po poslednom importe z pokladní) sa prepočítajú normy, ktoré stoja na zápise: akcie z pokladne pre motor (predaj pod bežnú cenu bez cenníka — očistí históriu a trend), akcie z pokladne ako cenník pre kusový tovar (vrátane konca, keď pokladňa vráti bežnú cenu) a DMT z príjmov pre karty bez trvanlivosti. Čím viac príjmov a predaja, tým presnejšie. Kalendár závozov, naddodávka výroby a cyklus artikla sa počítajú naživo pri každom návrhu.
Každú noc sa porovná trvanlivosť na karte výrobku ISM s posledných 10 dodacími listami (toľko dní, koľko má aspoň 90 % dodávok). Kde sa karta líši, vznikne návrh — kartu zmení až potvrdenie tu. Dátum spotreby na šarži sa z dodacieho listu berie vždy, toto je len číslo na karte (kontrola pri príjme, dátum pre tovar bez dokladu). Čerstvé mäso sa neporovnáva.
Po každom importe predajného dokladu (GS5) sa vždy automaticky vytvorí výdaj zo skladu predajne a záznam v logu pohybov.
Predajňa vytvorí VRATKA PP → mail expedícii. Po importe CSB VRATKY sa doklady spárujú. Pri rozdiele množstiev sa odošle samostatný alert. Ak je VRAT systém zaseknutý, admin v WMS → Príjem pri CSB VRATKE použije tlačidlo „Admin: odpísať vratku bez VRAT“ (povinný dôvod, audit log).
| Udalosť | Kedy | Príjemcovia (čiarkou) |
|---|---|---|
| Nová VRATKA PP | Predajňa odošle doklad (sprievodný pre vodiča) | |
| Rozdiel PP vs CSB | Expedícia zadá iné množstvá ako PP originál |
Prázdne pole = predvolené expedicia@istermeat.sk, sales@istermeat.sk.
Env PP_RETURN_MAIL_TO / PP_RETURN_MAIL_DIFF_TO má prednosť len ak v DB nie je hodnota.
Kto, kedy a čo zmenil na dokladoch VRATKA PP. Plný WMS log: /api/wms/audit-log
| Čas | Druh | Množ. | Typ dokl. | Číslo dokl. | Expirácia | Kto | Akcia |
|---|---|---|---|---|---|---|---|
| Načítavam… | |||||||
Mailová komunikácia systému
Všetko, čo systém posiela mailom — kedy to odchádza a komu. Kanál je aktívny len keď je zapnutý a má aspoň jedného adresáta.
Načítavam…
Pripojenie Gmail účtu cez Google OAuth — rovnaký princíp ako v Pipedrive. Token sa uloží automaticky do databázy (šifrovaný), nie do .env.
Jeden účet pre celé SW (príjem faktúr, systémové notifikácie). Nastavuje len admin.
Vlastná adresa používateľa — odosielanie mailov v mene vás (pripravené aj pre budúci CRM inbox).
Redirect URI (musí byť v Google Cloud Console → OAuth klient):
—
Naskenujte čiarový kód mobilom alebo ho prepíšte z obalu, vyberte tovar a kód sa
uloží do jeho karty. Potom ho pozná inventúra, príjem aj pokladňa.
Rovnaká funkcia je aj v Mobilnej inventúre — keď naskenovaný
EAN nie je pri žiadnom tovare, systém sa hneď spýta, či ho priradiť.
Právo na zápis EAN má admin, super_admin, super_manager, vedúca a predavačka (server to kontroluje pri každom uložení).
Zoznam artiklov bez EAN, najpoužívanejšie prvé (podľa pohybov za mesiac). Kurzor stojí v políčku: naskenujte kód, čítačka pošle Enter, kód sa uloží artiklu „na rade" a zoznam sa posunie na ďalší. Nič netreba klikať.
Prejde všetky položky, ktoré od dodávateľa naozaj prišli na dodákoch, najčastejšie prvé. Pri každej potvrdíte náš artikel — uloží sa kód dodávateľa aj EAN na kartu, takže ďalší doklad sa spáruje presne a bez hádania podľa názvu.
Kompletný audit: príjem, predaj, inventúra, prevody, VRATKY PP, CSB zaúčtovanie. Každý skladový pohyb sa zapisuje automaticky.
| Čas | Druh pohybu | Množstvo | Typ dokl. | Číslo dokl. | Expirácia | Produkt | Predajňa | Kto |
|---|---|---|---|---|---|---|---|---|
| Načítavam… | ||||||||
Nahrajte CSV export z CSB (Obj_dodane*.csv alebo jednoduchý zoznam
číslo_DL;FA_kód / číslo_DL;F001).
Systém podľa čísla dodacieho listu (DLV) priradí predajňu k existujúcim
záznamom v csb_delivery_notes, doplní dátumy OBJ/DOD a umožní zaúčtovanie na sklad.
Pri formáte Obj_dodane sa riadky uložia aj do csb_obj_dodane_lines.
Log importov
Prehľad automatických behov (OneDrive → inbox) aj manuálnych importov. GS5 predaj každú hodinu o :15 (8:15–20:15), CSB dodacie listy každých 10 min.
Beh auto importu
| Čas | Typ | Spustenie | Súbory | Import | Preskoč. | Chyby | Účtenky | OneDrive |
|---|---|---|---|---|---|---|---|---|
| Načítavam… | ||||||||
Importované súbory
| Čas importu | Typ | Súbor | Dátum dát | Spustenie | Riadky | Bez matchu | Stav | Chyba |
|---|---|---|---|---|---|---|---|---|
| Načítavam… | ||||||||
Nezaučtované SKU, založenie produktov a kontrola DB: WMS → Import predaja
Dev prostredie
Meta servera, AI modely a živý request log. Na produkcii zapni ENABLE_DEV_CONSOLE=true v .env.prod.
Request log …
Používatelia a role
Prístupy do IRIS na jednom mieste — kto sa smie prihlásiť, akú má rolu a čo smie vidieť.
Kto sa smie prihlásiť, akú má rolu a či má výnimku proti role.
Používatelia a prihlásenie
Prístup sa posiela e-mailom. Pri novom používateľovi nechajte heslo prázdne — na jeho e-mail odíde pozvánka s odkazom na prihlásenie a heslo si nastaví sám. Existujúcemu pošlete odkaz tlačidlom ✉ Pozvánka / ✉ Nové heslo v jeho riadku. Odkaz platí 72 hodín, dá sa použiť raz a heslo nevidí nikto — ani správca. Rola z matice práv je pod základnou rolou; Práva otvorí jeho maticu.
| Meno | Rola | Oddelenie | Stav | Prihlásenie | Akcie |
|---|
Skupiny oddelení
Master skupiny pre viacero oddelení (napr. PP — Podnikové predajne). Jedna karta + zlučené body pre celú skupinu.
Pridať novú skupinu
Pobočky (pre portál Predajne)
Správa kontaktných údajov pobočiek. Pobočku môžeš naviazať na skupinu oddelení.
Jeden riadok na úsek dní alebo text z Google. Sviatky a výnimky v Google Maps sa pri syncu snažíme brať z aktuálnych hodín (tlačidlo Načítať z Google pri vyplnenom Place ID, prípadne nočný cron na serveri).
Katalóg akcií (portál zákazníka)
Publikované položky vidia zákazníci po prihlásení na /portal.
| Názov | Oddelenie / skupina | Platnosť | Publik. | Vernostná | Akcia |
|---|
Smart marketing
E-mail, push a SMS pri zhode obľúbeného SKU s akciou. Cache obľúbených produktov, trigger pri novej akcii, A/B predmet.
Zapínaj/vypínaj podmienky a sleduj, koľko zákazníkov každá zúži. Voliteľne zadaj artikel (napr. kare bk).
| Zákazník | Kontakt | Artikel | Frekvencia | Útrata | MOP akcia | Stav |
|---|---|---|---|---|---|---|
| Klikni „Preskúmať“ alebo zadaj artikel a stlač Enter. | ||||||
Zákazníci so súhlasom, portálom, nákupmi v zvolenom období a zhodou obľúbeného SKU s MOP akciou.
| Zákazník | Kontakt | Produkty v akcii |
|---|---|---|
| Načítavam… | ||
—
| Čas | Kanál | Zákazník | Kontakt | Produkty v akcii | Stav |
|---|---|---|---|---|---|
| Načítavam… | |||||
Akcie
Pečiatkové (5+1), bodové, kupóny – podľa oddelenia
Vernostné akcie – formulár a tabuľka
Kampane (pečiatky a ďalšie typy) a väzba na oddelenia.
Oddelenia *
| Č. | Názov | Typ | Platnosť | Stav | Akcia |
|---|
Branding kariet
Google / Apple Wallet – logo, hero, farby a odkazy podľa oddelenia.
Zákazníci
—
| Číslo | Meno | Telefón | Karta (body / tier) | Zľava | Zamestnanec | Oddelenie | Posledný nákup | Akcia |
|---|
Registrácia zákazníka
Vydanie karty a údaje zákazníka
Import zákazníkov
Hromadný import z Excelu (.xlsx)
GS5 — výmena zákazníkov (CSV)
Formát: Meno;Priezvisko;Číslo karty;Aktívne (1/0). Export má tieto 4 stĺpce ako prvé, ďalšie (e-mail, telefón, zák. číslo, externá karta, dátum pridania, body, tier) za nimi. Import číta prvé 4 stĺpce — páruje podľa čísla karty; nenájdená karta sa založí aj so zákazníkom.
Prístup pre zákazníka
Linky na registráciu a na zákaznícky portál — na poslanie, na web aj na plagát do predajne.
Staršie linky (UUID a výber oddelenia)
Registračné linky podľa oddelenia
Vyberte oddelenie alebo skopírujte link pre zákazníka.
Predavačky a pokladníci
Iba role "cashier" – pridelenie k oddeleniam. Heslo nechajte prázdne a na e-mail odíde pozvánka s odkazom; heslo si predavačka nastaví sama.
| Meno | Kontakt | Rola | Oddelenie | Stav | Prístup | Akcia |
|---|
/portal)Prázdny variant na oddelení = zdedí sa zo skupiny. Tu vyplnené hodnoty majú prednosť.
| Názov | Slug | F kód | CSB | FA dod. | FA vrát. | Portál | Ikona | Stav | Akcia |
|---|
MOP
Predajné ceny a obchodné ukazovatele
Graf
Predaje GS5
WMS — číselník tovarov
Produkty, kategórie, dodávatelia a import z Excelu
| Kód | Názov produktu | Kategória | Dodávateľ | Cena s DPH | Marža | Status | Atribúty | |
|---|---|---|---|---|---|---|---|---|
| Načítava sa... | ||||||||
pre zobrazenie produktov
| Interné č. | CSB kód | Názov | IČO | Adresa | Splatnosť | Tovar | Stav | |
|---|---|---|---|---|---|---|---|---|
| Načítava sa... | ||||||||
Použi vtedy, keď z pultu odišlo niečo iné, než pokladňa odpredala —
„predal sa bok bk, ale odišiel bok s kožou". Zásoba sa presunie
medzi dvoma kartami ku dňu, kedy sa to stalo. Zapíšu sa dva
pohyby (Zámena — odpísané a Zámena — pripísané)
s krížovými poznámkami a dôvodom, takže je po mesiaci vidieť, čo sa
s čím zamenilo. Odpis ide FIFO zo šarží, pripísanie len na kartu —
vymyslená šarža by klamala expirácie.
Nie je to inventúrny rozdiel ani prevodka: tovar predajňu neopustil. Keď je v mínuse aj jedna aj druhá karta, zámena nepomôže — tam chýba príjem a rieši to inventúra.
swap_allowed_users; admin a super_admin ho majú vždy.
Vyexportujte číselník, upravte v Exceli a nahrajte späť. Najprv uvidíte, čo sa zmení — doplnené aj zmenené polia. Prázdna bunka nič nevymaže; vymazanie sa ponúkne osobitne a potvrdzuje sa po jednom.
| # | Názov | EAN | Nákupná cena | DPH | Predajná cena | Status | Info |
|---|
Každá pokladňa čísluje účtenky súvisle. Číslo, ktoré v IRIS chýba, pokladňa neposlala v hodinových súboroch — storno alebo skúšobná účtenka, ale aj predaj, ktorý chýba v tržbách a na zásobe. Rozlíšiť to vie len GS5 (Novum). Hlásenie mailom chodí každé ráno (Nastavenia → Maily).
Načítavam…
Jeden súbor = predajňa + hodina, účtenky aj položky spolu. Automatický import každú hodinu o :15 (8:15–19:15) z OneDrive
EDI/Export nakupu zakznicke karty →
data/gs5_sales_inbox/.
| SW3/kód | PLU/EAN | Názov | Množstvo | Účtenka |
|---|
| Súbor | PP | Stav | Účtenky | Bez matchu | Chyba / pozn. |
|---|
| Súbor | Predajňa | Účtenky | Položky | Match | Stav | Spustenie | Čas |
|---|---|---|---|---|---|---|---|
| Načítavam… | |||||||
| Predajňa | Počet účteniek | Celková tržba |
|---|---|---|
| Celkom | 0 | 0 € |
Produkty bez párovania v DB — neodpisujú sa zo skladu. Po založení SKU sa presunú do záložky Založené. Pri chybe importu príde mail s CSV prílohou.
| Problém | SW3/kód | PLU/EAN | Názov | Množstvo | Výskytov | Naposledy |
|---|---|---|---|---|---|---|
| Načítavam… | ||||||
| Názov | Typ | Platný od | Platný do | Predajne | Status | Položiek | |
|---|---|---|---|---|---|---|---|
| Načítavam… | |||||||
Katalóg zahŕňa položky z PP importu nákupu a príjmov skladu. Marža = predajná cena GS5 − NC (cenník alebo posledná NC). „Predaj pod NC“ = predávame lacnejšie ako nákup.
| Produkt | Kód | SKU ISM | Dodávateľ | Cenník (€) | Platnosť | NC posledná | NC priemer rok | NC pre maržu (€) | Predajná akt. (€) | Marža (€) | Marža (%) | Zdroje NC | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Načítavam… | |||||||||||||
| OBJ číslo | Dodávateľ | Predajňa | Dátum | Termín dodania | Položiek | Status | |
|---|---|---|---|---|---|---|---|
| Načítajte zoznam | |||||||
Ďalšie filtre
Vyberte tovar alebo naskenujte EAN.
Vyberte predajňu a dodávateľa — hneď sa ponúkne jeho tovar podľa predaja.
| Číslo faktúry | Dodávateľ | Dátum | Splatnosť | Položiek | DL | Celkom | Status | |
|---|---|---|---|---|---|---|---|---|
| Načítajte zoznam | ||||||||
| Popis z faktúry | Mn. | MJ | Cena bez DPH | DPH% | Spolu s DPH | Priradený artikel | Stav |
|---|
Data Hub
Surové dáta na zber teraz, vyhodnotenie v ďalšej úrovni.
| Top zákazníci | Obrat | Transakcie |
|---|
Import dashboard
Posledný import nákupov + kvalita párovania.
Pokladňa / Čítačka
Vyhľadanie zákazníka cez QR UUID alebo číselný barcode; vernostné akcie podľa oddelenia.
Vernostné akcie
Vyberte oddelenie a vyhľadajte zákazníka – zobrazia sa akcie typu pečiatky a tlačidlo „Pridať pečiatku“.