Ez az útmutató az admin felület (/cladmin) teljes használatát
írja le, lépésről lépésre. Ez a felület szándékosan nincs linkelve a nyilvános navigációból/
főoldalról — csak az üzemeltető csapat ismeri a linkjét. Ha partner vagy (nem az üzemeltető csapat
tagja), a Felhasználói kézikönyv neked szól — sokkal kevesebbet tudsz/kell
tudnod, és a /portal oldalon jelentkezel be.
Nyisd meg a /cladmin oldalt, add meg az email címed és jelszavad. Bejelentkezés
után az Áttekintés fül fogad — itt látod az összesített KPI-kat (események
száma, becsült résztvevők, átlagos elégedettség, átlagos kitöltési arány, átlagos upcycled
arány) és két grafikont (események státusz szerinti eloszlása, átlagos hatás-mutatók).
A Partnerek fülön add meg a megrendelő (cég/étterem/iroda) nevét, típusát és kapcsolattartóját. Egy partnerhez később több esemény is tartozhat.
Ugyanezen az űrlapon van a „Működési mód” mező (választható: Esemény, Hotel — napi napló, Mindkettő) — ez dönti el, hogy a partner bejelentkezve csak a megszokott eseménylistát látja-e (Esemény — ez az alapértelmezett, minden korábbi partnernek ez van beállítva, náluk semmi nem változott), csak a napi naplót (Hotel — napi napló), vagy mindkettőt, egymás mellett két al-fülként (Mindkettő). A napi napló koncepcióját, mezőit és a hozzá tartozó automatikus értékelést a 9. pont írja le.
A partner kártyáján a Hozzáférés gombra kattintva tudsz neki saját bejelentkezést generálni (a kapcsolattartó email címére) — a jelszó csak egyszer jelenik meg, add tovább neki, később csak újragenerálható, nem kérhető vissza. A partner a saját bejelentkezésével önállóan hozhat létre, aktiválhat és zárhat le saját eseményeket (esemény-módban), illetve önállóan vezetheti a napi naplóját (hotel-módban), hozzárendelhet tételeket, és megnézheti/letöltheti a riportjait (user döntés, 2026-07-22: aki béreli a szoftvert, önállóan tudja futtatni a rendezvényeit, nem kell hozzá admin) — más partner adatához, a hivatalos terméktörzs szerkesztéséhez vagy más felhasználó létrehozásához viszont nincs jogosultsága.
A partner kártyáján a Trend gombra kattintva egy grafikon-panel jelenik meg az adott partner egymás utáni (riporttal rendelkező) eseményeinek mutató-alakulásáról — ugyanez a nézet automatikusan megjelenik a partnernek is, amikor ő maga jelentkezik be.
Az Események fülön hozz létre egy új eseményt (válaszd ki a partnert, add meg a nevet, típust, dátumot). Az esemény ekkor Tervezet állapotban van — ekkor még senki nem tölthet ki kérdőívet.
Az esemény kártyáján alul rendelhetsz hozzá tételeket a „Tételek és mennyiségek” táblázatban — 3 forrásból választhatsz: a hivatalos terméktörzsből, egy kb. 80 tételes sablon étel-listából (péksütemény, tojás, hús, tejtermék stb., kategóriánként), vagy felvehetsz egy egyedi tételt is (csak az adott partnernek látszik). Soronként öt mennyiség-mező van: Kihelyezett (kötelező), Elfogyott, Selejt, Megmentett, és a rendszer által számolt Maradt raktáron. Ezt aktiválás előtt és után is bővítheted.
Az Aktiválás gombra kattintva az esemény Aktív állapotba kerül, és megjelenik a QR-kód gomb. Rákattintva egy felugró rétegben jelenik meg a kérdőív-QR-kód — onnan lefotózható/kinyomtatható, vagy kiteheted a helyszínen (asztalra, csomagolásra), hogy a résztvevők a telefonjukkal be tudják olvasni.
A résztvevő a QR-kód beolvasása után egy rövid, 3 kérdéses kérdőívet lát (összbenyomás, ízélmény, újravásárlási szándék + opcionális megjegyzés). A kitöltés teljesen anonim — nincs bejelentkezés, nincs semmilyen azonosító tárolva.
Amikor az esemény véget ért, kattints a Lezárás gombra. Ettől kezdve a kérdőív-link már nem fogad új válaszokat.
Egy partner (a saját, önálló bejelentkezésével) létrehozhat "segéd" felhasználókat, akik csak QR-kódokat tudnak kezelni — eseményt/terméket nem szerkeszthetnek, riportot/exportot nem érnek el, napi naplót sem vezethetnek. Hasznos, ha egy nagy rendezvényen több pult/stáció osztja ki a termékeket: mindegyik segéd saját, egyedi QR-kódot kap ugyanahhoz az eseményhez, és a kérdőív-válaszok böngészésénél/exportjánál ("Forrás" oszlop) látszik, melyik segéd kódján jött be a válasz — a kitöltő személye ettől függetlenül továbbra is teljesen anonim marad. A segéd-létrehozás és -hozzárendelés kifejezetten partner-önkiszolgálásnak épült — nincs hozzá admin-oldali UI, de admin a backend API-n keresztül is tudna segédet létrehozni, ha kivételesen szükséges lenne.
A Riport generálása gomb kiszámolja az esemény hatás-mutatóit (snack helyettesítés, upcycled arány, ételhulladék-csökkenés, inkluzív hozzáférés, visszajelzés-pontszám, CO2e-becslés, plusz a kiosztott tételek darabszámos, jelölésekkel (gluténmentes/vegán/stb.) ellátott listája, ÉS egy „Értékelés és javaslatok” szekciót — pontszám 0–100, 4 fokozat, súlyosság szerint jelölt megállapítások és 3–5 konkrét teendő, ld. lentebb a 8. pontban a motor részletes leírását), és rögtön böngészőben is megnyitja — nincs szükség PDF-re, ha csak átnéznéd. Ha megnyílt, egy PDF letöltése gomb is megjelenik, ugyanahhoz a riporthoz. Minden generálás egy új, számozott verziót hoz létre — a régebbi riportok (és a bennük mentett mutató-/értékelés-adatok) nem változnak meg utólag, akkor sem, ha később a szabálykatalógus módosul.
Az „Értékelés” gomb az esemény kártyáján önmagában, riport-generálás nélkül is elérhető — ez a gyors, azonnali visszajelzésre való (a riport a hivatalos, letölthető/archiválható forma).
Egy Aktív/Lezárt esemény kártyáján a „Válaszok böngészése” gombra kattintva a felületen, export nélkül átnézheted a beérkezett válaszokat (értékelés, megjegyzés, forrás). Bármelyik válasznál a „Kiemelés idézetként” gombbal jelölheted ki, mely megjegyzések kerülhetnek be idézetként a PDF-riportba.
A „Napi napló” fő fül minden admin-bejelentkezésnél megjelenik (nem csak a hotel-módú partnereknél) — felül egy partner-választóval bármelyik partner naplóját megnézheted/szerkesztheted, függetlenül attól, milyen működési módra van beállítva (a „Működési mód” mező csak azt szűkíti, mit lát a PARTNER a saját bejelentkezésével — az admin mindent lát és szerkeszthet).
A napló felépítése: étkezés-választó (reggeli büfé / kávészünet / ebéd / vacsora / rendezvény / egyéb) és hónap-léptető felül; egy hónap-rács, ahol minden napon egy selejt% szerint színezett jelzés látszik; egy napra kattintva a nap-szerkesztő nyílik (vendégszám, tervezett létszám, „Nem volt szolgáltatás” kapcsoló, és a tétel-táblázat két gyorsgombbal: „Előző nap tételeinek átvétele” és „Reggeli alapkészlet betöltése”); alul egy „Havi összesítő” KPI-kártya grafikonnal, és az „Értékelés most” gomb (hó közben is lekérhető). A korábbi értékelésekből HTML/PDF havi riport is megnyitható — ugyanaz a motor és megjelenítés, mint az esemény-módban, csak a bemenet a hónap összesített napi adata, nem egyetlen esemény.
A partner-oldali használatot (napi rutin, gyorsgombok, mikor mit érdemes kitölteni) a Felhasználói kézikönyv 12. pontja írja le részletesen — érdemes azt is átfutni, mielőtt egy partnernek hotel-módot állítasz be, hogy tudd, mit fog látni.
?kind= szűréssel érhetők el az API-n, exportgomb nincs hozzájuk)A bejelentkezett felület bal alsó sarkában (asztali nézetben) egy ✉️ ikonos widget mindig elérhető bárkinek (admin, partner, segéd) — itt küldhet bárki rövid szöveges visszajelzést a rendszerről. Minden beküldött visszajelzés emailben is megérkezik, ÉS megjelenik a dashboard Visszajelzések fülén (ki küldte, melyik oldalról, mikor) — onnan admin/superadmin a Törlés gombbal el is tudja dobni, ha már elolvasta/kezelte.
A főoldalon két, publikusan hirdetett demó-bejelentkezés érhető el, hogy leendő ügyfeleknek élőben be lehessen mutatni a platformot:
demo@foodimpactplatform.com /
demo123: néhány lezárt, különböző típusú esemény (céges / HoReCa / iroda
snack), termékadattal, kérdőív-válaszokkal és legenerált riporttal/értékeléssel.hotel-demo@foodimpactplatform.com /
hotel123: „Működési mód: Mindkettő”, kb. 45 nap visszamenőleg reggeli
napi napló-adattal (hétvégi mintázattal, javuló trenddel), hogy az értékelés és a havi
riport élőben is látványos legyen.Ha a demó-adatot friss telepítés után újra fel kell tölteni (pl. egy adatbázis-visszaállítás
után), két admin-only, ADMIN-tokenes végpont áll rendelkezésre — nem kell hozzá szerver-oldali
(SSH/docker exec) hozzáférés:
POST /admin/seed/food-templates — feltölti/frissíti a kb. 83 sablon ételt.POST /admin/seed/demo-hotel — létrehozza (vagy frissíti) a hotel-demó
partnert és a napi napló adatait.Mindkettő idempotens (többször is lefuttatható, nem hoz
létre duplikátumot) — a hívó bejelentkezésnek admin/superadmin jogosultságúnak kell lennie,
máskülönben 401/403-at ad. A pontos curl-parancsokat (admin-bejelentkezés + a két
seed-hívás) a DEPLOYMENT.md "Admin-only seed-végpontok" szakasza tartalmazza — a
admin jelszót ott (és itt) szándékosan nem írjuk le, az a SECRETS.md-ben él.
Mit jelentenek pontosan a mutatók? Ld. a /docs oldalt — ott részletesen leírjuk mindegyik számítási módját (jelenleg DRAFT állapotúak).
Ki tölti ki a kérdőívet? Bárki, aki beolvassa a QR-kódot — nincs regisztráció, nincs korlátozás, csak esemény-státusztól függ (csak Aktív eseménynél működik).
Mikor állítsak be egy partnernek Hotel- vagy Mindkettő-módot Esemény helyett? Ha a partnernél nincs értelme "esemény"-ekben gondolkodni (pl. napi büfé/konyha, ahol a mérés folyamatos, nem egy-egy alkalomhoz kötött), Hotel-módot állíts be. Ha mindkettőre szükség van (pl. napi reggeli ÉS alkalmi rendezvények ugyanannál a partnernél), Mindkettő-t válaszd — ekkor a partner két al-fület lát, és mindkettőt önállóan tudja használni.