Skip to content

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EGS Admin Panel Frontend

Az EGS Admin Panel Frontend az Electric Guitar Shop adminisztrációs felületének React-alapú kliensalkalmazása. A projekt célja, hogy az adminisztrátorok egy átlátható felületen keresztül kezelni tudják a termékeket, rendeléseket, vásárlókat, admin felhasználókat, valamint a saját profiljukat és a hírlevél-feliratkozásokat.

Az alkalmazás create-react-app alapokra épül, HashRouter-t használ, és REST API-n keresztül kommunikál a háttérrendszerrel.

Élő elérés

Publikus build:

https://thomas-horvath.github.io/EGS_Admin_Panel

Fő funkciók

  • Admin bejelentkezés és jogosultságalapú hozzáférés tokennel.
  • Dashboard összesített mutatókkal: vásárlók száma, rendelések száma, termékek száma, teljes bevétel.
  • Termékkezelés: lista, szűrés kategória szerint, lapozás, részletek, létrehozás, szerkesztés, törlés.
  • Rendeléskezelés: lista, lapozás, részletek, szerkesztés, törlés.
  • Vásárlókezelés: lista, lapozás, részletek, szerkesztés, törlés.
  • Adminkezelés: lista, lapozás, részletek, új admin rögzítése, szerkesztés, törlés.
  • Saját profil megtekintése és szerkesztése.
  • Hírlevél-feliratkozások kezelése: állapotváltás és törlés.
  • Reszponzív admin felület nyitható/zárható oldalsávval.

Technológiai stack

  • React 18
  • React Router DOM 6
  • Context API az autentikáció állapotkezeléséhez
  • fetch alapú API-kommunikáció
  • sessionStorage: admin token tárolása
  • localStorage: termékszűrő állapot mentése
  • SCSS alapú stíluskezelés
  • Create React App build környezet

Használt csomagok

  • react-icons az ikonokhoz
  • react-paginate a lapozáshoz
  • libphonenumber-js a telefonszám-validációhoz
  • sass az SCSS fordításához
  • gh-pages a GitHub Pages deployhoz

Megjegyzés: a korábbi README említett néhány könyvtárat, amelyek a jelenlegi package.json alapján nem részei ennek a frontendnek.

Projektstruktúra

src/
  assets/         statikus képek és asset-exportok
  components/     újrafelhasználható UI elemek és route-kezelés
  contexts/       autentikációs context
  pages/          oldal szintű nézetek
  scss/           SCSS forrásfájlok
  App.js          alkalmazás belépési komponense
  index.js        renderelési belépési pont
public/           publikus assetek
build/            legenerált production build

Oldalak és modulok

Autentikáció

  • A bejelentkezés az /api/adminlogin végponton történik.
  • Sikeres belépés után a token sessionStorage-ba kerül.
  • A route-ok megjelenítését az AuthContext és az AuthRoutes vezérli.

Dashboard

  • Több végpont adatait párhuzamosan tölti be: felhasználók, rendelések, termékek.
  • Összesített statisztikákat és rövid listákat jelenít meg a legfrissebb adatokból.

Termékek

  • Terméklista lapozással.
  • Kategóriaalapú szűrés, amelyet localStorage is megőriz.
  • Részletező, létrehozó és szerkesztő oldalak.

Rendelések

  • Rendeléslista lapozással.
  • Részletes rendelésnézet a kapcsolódó vásárló- és termékadatokkal.
  • Rendelések szerkesztése és törlése.

Vásárlók és adminok

  • Két külön lista ugyanarra a felhasználói adatforrásra építve.
  • A felhasználók IsAdmin mező alapján szétválasztva jelennek meg.
  • Részletező és szerkesztő oldalak mindkét entitástípushoz.

Profil

  • A bejelentkezett admin saját adatainak megtekintése.
  • Profilfrissítés kliensoldali validációval.
  • Telefonszám-ellenőrzés libphonenumber-js segítségével.

Hírlevél

  • Feliratkozók listázása.
  • Aktív/inaktív állapot módosítása.
  • Feliratkozó törlése.

Környezeti változók

A projekt jelenleg az alábbi környezeti változót használja:

REACT_APP_API_URL=https://egs.thomasapi.eu

Hozz létre egy .env fájlt a projekt gyökerében, ha helyi vagy más környezetben szeretnéd futtatni az alkalmazást.

Telepítés és futtatás

1. Függőségek telepítése

npm install

2. Fejlesztői szerver indítása

npm start

Alapértelmezés szerint az alkalmazás fejlesztői módban a böngészőben nyílik meg.

3. SCSS figyelése fejlesztés közben

npm run sass

4. Production build készítése

npm run build

5. Tömörített SCSS build

npm run sass-prod

6. GitHub Pages deploy

npm run deploy

Elérhető npm scriptek

Script Leírás
npm start Fejlesztői szerver indítása
npm run build Production build készítése
npm test Tesztek indítása
npm run sass SCSS figyelése és fordítása
npm run sass-prod Tömörített CSS generálása
npm run deploy Build publikálása GitHub Pages-re

Működési sajátosságok

  • A routing HashRouter alapú, ezért statikus tárhelyen is egyszerűen deployolható.
  • Az autentikáció kliensoldali állapotát az AuthContext kezeli.
  • A stílusok forrása a src/scss mappa, a fordított CSS a src/index.css.
  • Több adminisztrációs művelethez Bearer token szükséges.

Fejlesztői megjegyzések

  • A projekt jelenleg nem használ TypeScriptet.
  • A kódbázis funkcionális komponensekre és React hookokra épül.
  • A jelenlegi repository elsősorban a frontend admin felületet tartalmazza, a backend külön rendszerként érhető el.

Továbbfejlesztési lehetőségek

  • Központi API service réteg bevezetése az ismétlődő fetch logika csökkentésére.
  • Egységesebb hibakezelés és loading state kezelés.
  • Automatizált tesztek bővítése komponens- és integrációs szinten.
  • Környezeti konfiguráció dokumentálásának további részletezése több deployment célra.

Used by

Contributors

Languages