websitedev/docs/felhasznaloi-utmutato.md

mozdIT — Felhasználói útmutató

Ez az útmutató a mozdIT weboldalt és a hozzá tartozó Content Editor (CMS) felületet írja le nem műszaki felhasználóknak.

A dokumentum a repó része, és folyamatosan karbantartott: minden funkcióváltozásnál a fejlesztő frissíti. A CMS ❓ Súgó menüpontja ezt a fájlt jeleníti meg.

---

1. A weboldal

Hol érhető el?

• Staging (teszt) oldal: https://stage.mozdit.hu — itt ellenőrizhetők a friss változtatások éles környezetben, még a véglegesítés előtt.
• A staging oldal tetején sárga figyelmeztető sáv jelzi, hogy tesztkörnyezetet látsz.

Oldalak

• Kezdőlap — https://stage.mozdit.hu/
• Rólunk — /rolunk
• Szolgáltatások — /szolgaltatasok
• Kapcsolat — /kapcsolat (űrlap, ami beérkező üzenetként tárolódik)
• Adatvédelmi tájékoztató — /adatvedelem
• Felhasználási feltételek — /felhasznalasi-feltetelek

Hogyan változik a weboldal tartalma?

1. A szerkesztő a Content Editorban módosítja a szövegeket (2. fejezet).
2. 💾 Mentés — a módosítás elmentődik, azonnali biztonsági mentéssel.
3. 🚀 Publikálás — a változtatás bekerül a Git repóba, és automatikusan deployol a staging oldalra.
4. Az éles (production) weboldalra a tartalom csak ellenőrzött, szándékos deploy lépéssel kerül fel — a CMS-ből soha nem publisholódik automatikusan productionre.

---

2. Content Editor (CMS)

Belépés és kilépés

• A CMS a kiadott címen érhető el (staging: https://cms.stage.llmdev.mozdit.hu).
• Bejelentkezés: a logós bejelentkező oldalon add meg a felhasználónevet és jelszót (ezt az adminisztrátor adja), majd kattints a Belépés gombra.
• Több sikertelen próbálkozás (5) után a belépés kb. 15 percre zárolásra kerül.
• A belépés 8 óráig érvényes — ezután a CMS visszairányít a bejelentkező oldalra, ahol újra meg kell adni a jelszót.
• 🚪 Kilépés: az alsó sáv gombja — egy megerősítő kérdés („Biztosan ki szeretnél lépni?") után kijelentkezel, és megjelenik a bejelentkező oldal.

Felület áttekintés

• Fájl fülek (felül): oldalankénti tartalom — Kezdőlap, Rólunk, Szolgáltatások, Kapcsolat, jogi oldalak, közös szövegek.
• Szerkesztőfelület: a kiválasztott oldal összes szerkeszthető mezője.
• Alsó sáv: 💾 Mentés, 🚀 Publikálás, 🔗 Előnézet, ❓ Súgó, 🚪 Kilépés, valamint a futó verzió (pl. va7b1a2c) — ha a fejlesztő megkér, hogy ellenőrizd a verziót, ezt a jelölést mondd neki.

Szöveg szerkesztése

• A mezők fölötti útvonal (pl. hero.title) jelzi, hol jelenik meg a szöveg az oldalon.
• Mezőtípusok:
  • Egysoros / több soros szövegmező — általános szöveg; a hosszabb szöveg automatikusan nagyobb mezőben szerkeszthető.
  • Jelölőnégyzet — be/ki (igen/nem) érték.
  • Számmező — numerikus érték.
• A módosítás nem kerül azonnal az oldalra — ahhoz Mentés, majd Publikálás kell.

Listák szerkesztése

• Lista elem (pl. egy jelszó, egy szolgáltatás tulajdonság): ❌ gombbal törölhető.
• ➕ Új elem hozzáadása gomb: új elem beszúrása a lista végére (üres, a meglévőkhöz hasonló űrlappal).
• Kártyás listáknál (pl. szolgáltatások) minden kártya külön törölhető a kártya alján lévő gombbal.

🎨 Logó kezelése

• Az alsó sáv 🎨 Logó gombja megnyitja a logókezelő oldalt.
• Két logó cserélhető: a weboldal fejléclogója (szöveges) és a CMS bejelentkező oldal ikonja.
• Partner logó feltöltése: ugyanitt — a fájlnév megadása után a feltöltött PNG a /partners/… elérési útra kerül; ezt az utat másold a partner logo mezőjébe.
• Csak PNG, max. 1 MB; ajánlott átlátszó háttér a sötét fejléchez.
• A régi logó mentésre kerül — a csere biztonságos és visszavonható (a mentések a .content-backups mappában).
• A CMS azonnal az új logót mutatja; a weboldalon a Publikálás (deploy) után jelenik meg.

🤝 Partnerek

• A kezdőlap „Partnereink" szekciója a Szolgáltatások alatt jelenik meg (logó + név + hivatkozás).
• A Kezdőlap fülön a partners.items listában szerkeszthetők: name (név), url (hivatkozás), logo (elérési út, pl. /partners/acme.png).
• Új logó: a 🎨 Logó oldalon töltsd fel, a visszaadott utat illeszd a logo mezőbe.

⌨️ Gyorsbillentyűk

• Ctrl/Cmd + S — Mentés
• Ctrl/Cmd + P — Publikálás
• Ctrl/Cmd + Shift + V — Verziók panel megnyitása új fülön
• ? — gyorsbillentyű-súgó megjelenítése (Esc vagy kattintás zárja)

A gyorsbillentyűk csak a szerkesztő főoldalán működnek; beviteli mezőben gépelve a normál karakterként viselkednek.

🕘 Verziók — korábbi állapotok

• Az alsó sáv 🕘 Verziók gombja megnyitja az éppen szerkesztett fájl mentéseit (minden Mentés automatikus másolatot készít).
• ⚖ Összehasonlítás: megmutatja, mi változott az adott mentéshez képest (piros = a mentésben lévő régi szöveg, zöld = a jelenlegi).
• ↩ Visszaállítás: egy kattintással visszaállítja a mentést. A visszaállítás előtt a jelenlegi tartalom is mentésre kerül, tehát a visszaállítás is visszavonható.
• A visszaállítás sémaillesztésen megy át — hibás mentést nem lehet visszaállítani.
• Visszaállítás után a nyitott szerkesztő fülek frissítést kérnek (a tartalom megváltozott).

💾 Mentés

• A Mentés ellenőrzi a tartalmat: hiányzó vagy rossz típusú mező esetén hibaüzenetet kapsz, és a mentés nem történik meg — az oldal így nem tud elromlani.
• Ha a tartalom megváltozott, mióta a lapot megnyitottad (pl. közben deploy történt vagy egy másik fülben mentett valaki), a Mentés figyelmeztet: ilyenkor döntsd el, hogy frissíted a lapot az új tartalomra (a szerkesztésed elvész), vagy megszakítod. Ezzel a védelemmel nem írható véletlenül felül senki módosítása.
• Minden sikeres mentés biztonsági mentést készít a szerveren (.content-backups/), és naplózza a műveletet.
• Ha a Mentés sikeres, a mentett állapotot Előnézet gombbal nézheted meg a staging oldalon.

🚀 Publikálás

• A Publikálás commitolja és feltolja a változtatásokat, majd elindítja a staging deployt.
• „Nincs új változtatás." üzenet: nincs új mentett változtatás — ez nem hiba, ilyenkor deploy sem indul.
• A publikálás korlátozva van (3 próbálkozás / 15 perc) a véletlen tömeges deploy elkerülésére.
• A deploy eltarthat 1-2 percig; az eredményt az Előnézet gombbal ellenőrizheted.

Biztonság

• Több sikertelen belépési kísérlet után a rendszer átmenetileg letiltja a belépést a gépedről (kb. 15 percre).
• Minden mentés és publikálás naplózva van (audit log) a nyomonkövethetőség érdekében.

---

Karbantartás (fejlesztőknek)

• Forrás: docs/felhasznaloi-utmutato.md — a CMS a /guide útvonalon rendereli ki.
• Szabály: minden CMS- vagy honlapfunkció változásnál frissítsd ezt a fájlt ugyanabban a commitban.
• Az útmutató támogatott formátuma: címsorok, félkövér, kód, listák, linkek, elválasztó vonalak.