Admin kézikönyv

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.

1. Bejelentkezés

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).

2. Partner létrehozása és hozzáférés adása

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.

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, hozzárendelhet a terméktörzsből terméket, é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 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.

3. Esemény létrehozása és termékek hozzárendelése

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á kiosztott terméket (válassz a terméklistából, add meg a kiosztott mennyiséget). Ezt aktiválás előtt és után is bővíthető.

4. Esemény aktiválása és a QR-kód

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.

5. Esemény lezárása

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.

6. Segéd felhasználók (FIELD_UPLOADER) — több QR-kód egy eseményhez

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. 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.

7. Riport generálása

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 termékek darabszámos, jelölésekkel (gluténmentes/vegán/stb.) ellátott listája), é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 nem változnak meg utólag.

8. Kérdőív-válaszok böngészése és kiemelése

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.

9. Exportok és import

10. Visszajelzések

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.

Gyakori kérdések

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).