Használati útmutató – Vezérlőpult és Ügyfelek (részletes)¶

Ez a fejezet a Vezérlőpult és az Ügyfelek modul minden képernyőjét, gombját és bemeneti mezőjét részletesen leírja.

1. Vezérlőpult (Kezdőlap)¶

1.1 Elérés¶

Bejelentkezés után a kezdőlap automatikusan megjelenik.
Bármelyik oldalról: kattints a felső sáv bal oldalán a CégemOne logóra – visszavisz a vezérlőpultra.
A felső menüben nincs külön „Vezérlőpult” szöveg; a logó szerepelteti a kezdőlapot.

1.2 Képernyő felépítése – mit látsz pontosan¶

Felső hero / összefoglaló sáv: - Vezérlőpult címsor ikonnal (pl. speedometer). - Rövid szöveg a lap céljáról.

KPI kártyák vagy metrika sorok (a tényleges elrendezést a felület diktálja): - Mai feladatok – ma esedékes (magyar idő szerint) feladatok száma vagy listája. - Lejárt feladatok – határidő már elmúlt, de a feladat még nem „Kész” állapotú. - Következő 7 nap – ennyi feladat esik a holnaptól számított 7 napba. - Nyitott projektek – „Open” (Folyamatban) állapotú projektek száma. - Havi bevétel – az aktuális hónapban kiállított számlák bruttó összege (Ft vagy beállított pénznem). - Nyitott számlák – kiállított, még nem teljesen kifizetett, és a fizetési határidő még nem lejárt. - Lejárt számlák – kiállított, van hátralék, és a fizetési határidő már elmúlt. - Kintlévőség összege – nyitott (még nem lejárt) és lejárt kintlévőség külön (Ft). - Ajánlatkérés konverzió – összes ajánlatkérés és a „Projekt lett” (Converted) aránya (százalék). - Ebben a hónapban megnyert projektek – „Won” állapotú projektek száma az aktuális hónapban.

Ma fókusz blokk: - Lejárt feladatok listája (határidő + X nap formátummal). - Ma esedékes feladatok listája. - Mindkét listaelemre kattintva a feladat részleteihez vagy szerkesztéséhez juthatsz.

Közelgő feladatok: - A következő napokra eső feladatok (pl. legfeljebb 5 db). - Kattintás → feladat részletek vagy szerkesztés.

Legutóbbi tevékenységek: - Legutóbbi feladatok – lista, kattintás → feladat. - Legutóbbi projektek – lista, kattintás → projekt. - Legutóbbi ajánlatkérések – lista, kattintás → ajánlatkérés.

Trend diagramok (ha elérhetők): - Bevétel trend – havi bontásban (pl. GetRevenueTrend). - Ajánlatkérés trend – havi vagy dátumtartomány, állapot szerint szűrhető. - Projekt trend – havi vagy dátumtartomány, állapot szerint szűrhető.

Beállítások gomb (fontos): - A vezérlőpult jobb felső sarkában (a hero sávban) van egy Beállítások gomb (fogaskerék ikon). Asztali nézetben a szöveg „Beállítások” is látszik; mobilon csak az ikon. Kattintásra megnyílik a Beállítások ablak (modál). - Első bejelentkezés (vagy regisztráció) után erősen ajánlott rögtön belépni a Beállításokba és megadni a céges adatokat és az e-mail fiókot – ez alapvető a számlázáshoz és az e-mail küldéshez. A számlázási beállításokat (alapértelmezett ÁFA, Számlázz.hu) a Számlák oldalról lehet megnyitni (Számlázási beállítások gomb). Ezek nélkül a számlák és az e-mail küldés nem tud megfelelően működni.

Beállítások modál tartalma: A modál két fő blokkot tartalmaz (Admin jogosultság esetén mindkettő, különben csak az e-mail blokk): 1. Ügyféladatok (kibocsátói adatok) – a számlákra és árajánlatokra kerülő céges/számlázó adatok. 2. Email küldés – Google (vagy más) levelező összekapcsolása, hogy a CégemOne a te címedről küldhessen e-mailt (pl. számla, emlékeztető, árajánlat).

Ügyféladatok (kibocsátói adatok) – mezők: Ezek az adatok a számlákra és árajánlatokra kerülnek kibocsátóként. Kötelező megadni, ha számlázni vagy árajánlatot küldeni szeretnél. Csak Admin szerepkörrel látható és szerkeszthető.

Mező	Kötelező	Leírás
Ügyfélnév	Igen	A kibocsátó neve (pl. „Cégem Kft.”).
Adószám	Igen	Kibocsátó magyar adószám.
Cím (utca, házszám)	Igen	Számlázási cím – utca, házszám.
Irányítószám	Igen	Irányítószám.
Város	Igen	Város.
Bankszámlaszám	Nem	A számlán megjelenő bankszámlaszám (átutaláshoz).
E-mail cím	Nem	Kibocsátó e-mail (értekezlet, értesítések).
Telefonszám	Nem	Kibocsátó telefon.

A modál alján (Admin esetén) Mentés gombra kattintva az adatok mentésre kerülnek.

Google alapú e-mail összekapcsolása: A CégemOne e-mailt küld (pl. számla a vevőnek, emlékeztető, árajánlat). Ehhez csatlakoztatni kell egy e-mail fiókot. A rendszer Google alapú levelezést támogat (Gmail vagy Google Workspace). Custom domain (pl. info@cegemone.hu) is használható, ha az a fiók Google Workspace alatt van – a lényeg, hogy a szolgáltató Google legyen. - Ha nincs csatlakoztatva: „Nincs csatlakoztatott email fiók” + Google csatlakoztatás gomb → Google OAuth ablak (popup), bejelentkezés (pl. info@cegemone.hu), engedélyezés → a CégemOne összeköti a fiókot. Céges fióknál előfordulhat, hogy az IT-admin engedélye szükséges. - Ha már csatlakoztatva van: „Csatlakoztatva: cím@domain.hu”, „Szolgáltató: Google” + Teszt email magamnak (ellenőrzés) + Leválasztás.

Műveletek a vezérlőpulton: - Nincs „Új ügyfél” vagy „Új feladat” gomb a lap közepén; a navigáció a listaelemekre kattintással, vagy a felső menüben (Ügyfelek, Feladatok stb.) történik.

2. Ügyfelek modul¶

2.1 Ügyfelek listája – elérés és elemek¶

Elérés: Felső menü → Ügyfelek (ikon: épület).

Oldal fejléc: - Ügyfelek címsor. - Összesítő szöveg (asztali nézetben): pl. „X db Ügyfél · Saját portfólió: Y · Kapcsolattartós: Z · Aktív (van Projekt): W”. - Új Ügyfél gomb (asztali: „Új Ügyfél”, mobil: „Új ügyfél” szöveg + ikon). - Mobilnál: Statisztika gomb – megnyitja a statisztika modált (ügyfél számok, megoszlás).

Szűrők (a lista fölött): - Létrehozás dátuma: kezdő dátum (nap választó) és záró dátum. Ha megadod, csak az ezen tartományban létrehozott ügyfelek jelennek meg. - Kategória (ügyfél típus): legördülő vagy chip: Cég, Magánszemély, Egyéni vállalkozó. Egyet választhatsz; a lista csak a kiválasztott típusra szűkül. - Projekt szűrő: több projekt kiválasztható (pl. checkbox lista). Ha van kijelölés, csak azok az ügyfelek jelennek meg, akiknek van a kiválasztott projekthez kapcsolódó adata.

Ügyfél lista – oszlopok / mezők (típusos): - Ügyfél neve (kattintható). - Típus chip vagy badge: Cég / Magánszemély / Egyéni vállalkozó (ikonnal: épület, személy, aktatáska). - Kapcsolattartók száma (ha van ilyen oszlop). - Projektek száma vagy „Aktív” jelzés. - Létrehozás dátuma (opcionális). - Egy sorra kattintva → az ügyfél részletes nézete (ügyfélkártya) nyílik meg.

2.2 Új ügyfél – űrlap mezői és lépései (részletesen)¶

Elérés: Ügyfelek listán → Új Ügyfél gomb. Egy modál (felugró ablak) nyílik.

Űrlap felépítése: Három lépés (step indicator): 1. Típus → 2. Alapadatok → 3. Cím.

2.2.1 1. lépés: Ügyfél típusa¶

Címke: „Ügyfél típusa” – „Válaszd ki, hogy magánszemélyről, cégről vagy egyéni vállalkozóról van szó.”
Választék (rádiógombok / chipek):
Magánszemély – „Nincs adószám, tipikus lakossági ügyfél (pl. családi ház burkolás).”
Cég – „Számlázáshoz kötelező az adószám megadása.”
Egyéni vállalkozó – „Vállalkozóként szintén szükség van adószámra.”
Ha Cég vagy Egyéni vállalkozó van kiválasztva, a 2. lépésben megjelenik az Adószám mező, és céges/EV esetén ez kötelező. Magánszemélynél az Adószám mező rejtett vagy nem kötelező.

2.2.2 2. lépés: Alapadatok¶

Ügyfél neve (kötelező)
Mező típusa: szöveg (input).
Placeholder / példa: „Kovács István”, „Burkoló Kft.”, „Nagy Anna EV”.
Hibaüzenet ha üres: „Kérem adjon meg nevet”.
Min. 2, max. 60 karakter.
Adószám
Csak Cég és Egyéni vállalkozó esetén látható.
Kötelező céges/EV ügyfélnél (ellenőrzés a mentéskor).
Formátum: 8–11 számjegy (magyar adószám). Hibaüzenet: „Kérem helyes adószámot adjon meg”.
Telefonszám
Opcionális. Tipikus formátum: +36201234567.
Magánszemélynél ajánlott megadni.
E-mail
Opcionális. Érvényes e-mail formátum (EmailAddress validáció).

2.2.3 3. lépés: Cím (opcionális)¶

Irányítószám – szöveg, max. 10 karakter.
Város – szöveg, min. 3, max. 200 karakter.
Cím – szöveg, min. 3, max. 200 karakter.
Szöveges segítség: „Számlázási cím – megadhatod most, vagy később a számlázáskor is kiegészítheted.”

Mégse – bezárja a modált, nem ment. Adatok elvesznek.
Mentés (ikon: pipa) – validálja az űrlapot, menti az ügyfült, bezárja a modált és frissíti a listát (vagy átirányít a megadott returnUrl-re, ha volt).

2.3 Ügyfél részletes nézet (ügyfélkártya) – lapok és gombok¶

Elérés: Ügyfelek listában kattints egy ügyfél sorára (nevére).

Fejléc / hero (asztali és mobil): - Ügyfél neve (cím). - Státusz badge: Potenciális ügyfél / Aktív ügyfél / Kockázatos ügyfél / Nem aktív ügyfél (a rendszer számítja a projekt/aktivitás alapján). - Város (ha van) – badge formában. - Utolsó aktivitás dátuma (ha van). - Statisztika gomb (mobil) – modál: kapcsolattartók, ajánlatkérések, projektek, számlák számai. - Következő lépés blokk (mobil): ha van közelgő feladat, a feladat címe és határideje jelenik meg. - Szerkesztés gomb – megnyitja az ügyfél szerkesztő űrlapot (modálban vagy külön oldalon). - Törlés gomb – törlés visszaigazoló ablakot nyit.

Lapok (fülök): - Áttekintés – alapadatok, megjegyzések, feladatok, dokumentumok blokkok. - Kapcsolattartók – az ügyfélhez tartozó kapcsolattartók listája. - Egyéb lapok (ha vannak): pl. Megjegyzések, Dokumentumok külön fülön.

2.3.1 Áttekintés lap – blokkok és gombok¶

Alapadatok szekció: - Megjelennek: Név, Cím (irányítószám, város, utca/ház), Telefon, E-mail, Adószám (ha van). Ezek általában csak olvashatóak itt; a módosítás a Szerkesztés gombbal érhető el.

Megjegyzések blokk: - Fül/választó: „Összes” / „Legutóbbi” / „Saját” – a megjegyzések szűrése. - Új jegyzet gomb (ikon: jegyzet) – megnyit egy modált vagy űrlapot új megjegyzés írásához. A megjegyzés az ügyfélhez kötődik. - Lista: megjegyzés szöveg, szerző, dátum. Minden megjegyzésnél: - Szerkesztés (ikon) – megnyitja a megjegyzés szerkesztőt. - Törlés (ikon) – törli a megjegyzést (visszaigazolás lehet).

Feladatok blokk: - Fül/választó: „Összes” / „Ügyfél” / „Ajánlatkérés” / „Projekt” – a feladatok szűrése típus szerint (csak ügyfélhez kötött, vagy ajánlatkéréshez/projekthez kötött is). - Új feladat gomb – feladat létrehozása, alapból az ügyfélhez kötve. Megnyílik az „Új feladat” űrlap (modál). - Lista: feladat címe, határidő, állapot, kapcsolódó entitás (Ügyfél / Ajánlatkérés / Projekt). Következő lépés felirat is lehet. - Szerkesztés (ikon) a soron – feladat szerkesztése. - Lapozás (ha sok feladat van): Előző oldal / Következő oldal gombok.

Dokumentumok blokk: - Keresés mező – placeholder: „Keresés”, aria-label: „Dokumentumok keresése”. A lista szűrése szöveg alapján. - Új dokumentum / Új dokumentum feltöltése az ügyfélhez gomb – feltöltés indítása; kiválasztod a fájlt, majd a feltöltés befejezése. - Lista: dokumentum neve, típus badge (pl. Fotó, Tervrajz, Egyéb), forrás badge („Ügyfélhez”, „Projekt: …”, „Ajánlat: …”). Kattintás → megnyitás / letöltés. - Törlés (ikon) soronként – dokumentum törlése (visszaigazolás). - Lapozás: Előző / Következő gombok.

2.4 Ügyfél szerkesztése – mezők és gombok¶

Elérés: Ügyfél részletes nézetben → Szerkesztés gomb.

Két változat lehet: (1) Modál (AJAX), (2) Teljes oldal (premium). A modálban kevesebb mező lehet; a teljes oldalon általában ugyanazok, mint új ügyfélnél, plusz egyéb adatok.

Modál szerkesztő mezői (típusos): - Ügyfél neve – kötelező, placeholder: „Ügyfél neve”. - Adószám – placeholder: „Adószám”. - Irányítószám – placeholder: „Irányítószám”. - Város – placeholder: „Város”. - Cím – placeholder: „Cím”. - Rejtett mezők: Id, CreationDate (nem szerkeszthetők).

Teljes oldalas szerkesztő (ha van): - Ugyanazok a mezők, plusz esetleg Telefon, E-mail, ÁFA státusz, Ország, EU VAT szám stb. (a Client modell és a View alapján). - Vissza a Ügyfél adatlapjára gomb – visszanavigál a Details nézetre. - Mentés gomb – űrlap mentése.

Gombok a modál alján: - Mégse – bezárás mentés nélkül. - Mentés – menti a változásokat.

2.5 Ügyfél törlése¶

Elérés: Ügyfél részletes nézetben → Törlés gomb (ikon: kuka).

Folyamat: 1. Kattintás a Törlés gombra. 2. Megnyílik egy megerősítő modál vagy oldal: „Biztosan törölni szeretnéd?” (vagy hasonló). 3. Megerősítés (pl. „Törlés” / „Igen”) – az ügyfél logikailag törlésre kerül (IsDeleted = 1). A listában többé nem jelenik meg (kivéve, ha a listán van „Törölt megjelenítése” opció). 4. Mégse / „Nem” – ablak bezárása, nincs törlés.

Megjegyzés: Törölt ügyfél helyreállítása a standard felhasználói felületen általában nem elérhető; csak a listában lehet „törölt ügyfelek mutatása” (ha van ilyen funkció).

Ajánlatkérések és Projektek részletes útmutatójához: 04b-ajanlatkérések-projektek.md