From caf0cc3f542c31233fdc5e17903be7b53c72e42c Mon Sep 17 00:00:00 2001 From: E98Developer Date: Mon, 2 Mar 2026 06:46:44 +0100 Subject: [PATCH] guidlines update --- .junie/guidelines.md | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/.junie/guidelines.md b/.junie/guidelines.md index 450cc32..510b30b 100644 --- a/.junie/guidelines.md +++ b/.junie/guidelines.md @@ -25,16 +25,28 @@ ##### Modellek és Auditálás - Ez biztosítja a `created_by`, `updated_by` és `deleted_by` mezők automatikus töltését a `ModelUserIdAppenderTrait` segítségével. - Használjunk `SoftDeletes`-t, ahol az adatok megőrzése fontos. -##### Hibrid Frontend Architektúra (Mix & Vite) -A projekt fokozatos modernizáció alatt áll, ezért két párhuzamos build rendszert használunk: +##### Hibrid Frontend Architektúra (Mix & Vite) és a "Clean Cut" elv +A projekt fokozatos modernizáció alatt áll, ezért két párhuzamos build rendszert használunk a **"Clean Cut"** (tiszta vágás) elv mentén: +- **Lényege**: A modern technológiával (Filament, Tailwind CSS, Vite) készülő modulok teljes mértékben elkülönülnek a régi, jQuery/Bootstrap alapú rendszertől. Nem ágyazzuk be őket AJAX-szal a régi keretbe, hanem saját, teljes oldalas layoutot kapnak a stílusütközések elkerülése érdekében. - **Legacy (Laravel Mix)**: A meglévő jQuery, Bootstrap 4 és AdminLTE alapú kódokhoz. - Forrásfájlok: `resources/js/`, `resources/sass/`, `resources/css/`. -- **Modern (Vite)**: Új funkciókhoz, Tailwind CSS-hez és reaktív komponensekhez. - - Forrásfájlok: `resources/modern/js/`, `resources/modern/css/`. - - Nézetek: `resources/modern/views/`. +- **Modern (Vite & Filament)**: Új funkciókhoz, Tailwind CSS-hez és Filament alapú admin felületekhez. + - Forrásfájlok: `resources/modern/js/`, `resources/modern/css/`, `resources/css/filament/`. + - Nézetek: `resources/modern/views/`, `resources/views/filament/`. - Használat Blade-ben: `@vite(['resources/modern/css/app.css', 'resources/modern/js/app.js'])`. - A modern nézeteket a Laravel automatikusan felismeri a `config/view.php` konfigurációja alapján. +##### Modernizációs és Design Irányelvek (Filament & Tailwind) +- **Vizuális Konzisztencia**: Az új moduloknak (Filament) illeszkedniük kell a legacy "Pepper Grinder" színvilágához. + - Használjunk egyedi színpalettát az `AdminPanelProvider`-ben (Primary: `#b83400`, Gray: Pepper Grinder bézs/barna skála). + - A kerekítéseket és árnyékokat a `theme.css`-ben rögzített szögletesebb stílushoz kell igazítani. +- **Tailwind v4 Konfiguráció**: A Vite build folyamatban a `@tailwindcss/vite` plugint használjuk. + - Minden új Filament/Livewire forrást rögzíteni kell a `theme.css` `@source` direktívái között. +- **Navigáció Szeparáció**: + - A legacy és modern részek közötti váltáshoz sima linkeket használunk (teljes oldalújratöltés). + - A navigációs linkeknél a `data-no-ajax="true"` attribútumot kell használni, hogy a legacy JS (`app.js`) ne próbálja AJAX-szal betölteni a modern tartalmat. +- **Közös Elemek (Render Hooks)**: A megszokott elemeket (pl. `speedButtonNavBar`) Filamentben Render Hook-ok segítségével injektáljuk a fejlécbe (`TOPBAR_START`), biztosítva a funkcionális folytonosságot. + ##### JavaScript Architektúra és Modulok - A JS kód alapja egy egyedi objektumorientált rendszer. - **Osztály-alapú felépítés**: Minden adminisztrációs felülethez (vagy összetettebb modulhoz) tartozzon egy specifikus JavaScript osztály (pl. `ProductAdmin`), amely a `resources/js/admin/` könyvtárban kap helyet.