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.
Publikus build:
https://thomas-horvath.github.io/EGS_Admin_Panel
- 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.
- React 18
- React Router DOM 6
- Context API az autentikáció állapotkezeléséhez
fetchalapú API-kommunikációsessionStorage: admin token tárolásalocalStorage: termékszűrő állapot mentése- SCSS alapú stíluskezelés
- Create React App build környezet
react-iconsaz ikonokhozreact-paginatea lapozáshozlibphonenumber-jsa telefonszám-validációhozsassaz SCSS fordításáhozgh-pagesa 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.
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
- A bejelentkezés az
/api/adminloginvé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 azAuthRoutesvezérli.
- 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éklista lapozással.
- Kategóriaalapú szűrés, amelyet
localStorageis megőriz. - Részletező, létrehozó és szerkesztő oldalak.
- 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.
- Két külön lista ugyanarra a felhasználói adatforrásra építve.
- A felhasználók
IsAdminmező alapján szétválasztva jelennek meg. - Részletező és szerkesztő oldalak mindkét entitástípushoz.
- A bejelentkezett admin saját adatainak megtekintése.
- Profilfrissítés kliensoldali validációval.
- Telefonszám-ellenőrzés
libphonenumber-jssegítségével.
- Feliratkozók listázása.
- Aktív/inaktív állapot módosítása.
- Feliratkozó törlése.
A projekt jelenleg az alábbi környezeti változót használja:
REACT_APP_API_URL=https://egs.thomasapi.euHozz létre egy .env fájlt a projekt gyökerében, ha helyi vagy más környezetben szeretnéd futtatni az alkalmazást.
npm installnpm startAlapértelmezés szerint az alkalmazás fejlesztői módban a böngészőben nyílik meg.
npm run sassnpm run buildnpm run sass-prodnpm run deploy| 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 |
- A routing
HashRouteralapú, ezért statikus tárhelyen is egyszerűen deployolható. - Az autentikáció kliensoldali állapotát az
AuthContextkezeli. - A stílusok forrása a
src/scssmappa, a fordított CSS asrc/index.css. - Több adminisztrációs művelethez Bearer token szükséges.
- 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.
- Központi API service réteg bevezetése az ismétlődő
fetchlogika 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.