stitza/d2d.emegrendeles.hu
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

guidlines update

Browse Source
This commit is contained in:
E98Developer 2026-03-02 06:46:44 +01:00
parent a22be19ecb
commit caf0cc3f54
1 changed files with 17 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
.junie/guidelines.md
View File

@ -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. - 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. - Használjunk `SoftDeletes`-t, ahol az adatok megőrzése fontos.
##### Hibrid Frontend Architektúra (Mix & Vite) ##### 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 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. - **Legacy (Laravel Mix)**: A meglévő jQuery, Bootstrap 4 és AdminLTE alapú kódokhoz.
- Forrásfájlok: `resources/js/`, `resources/sass/`, `resources/css/`. - Forrásfájlok: `resources/js/`, `resources/sass/`, `resources/css/`.
- **Modern (Vite)**: Új funkciókhoz, Tailwind CSS-hez és reaktív komponensekhez. - **Modern (Vite & Filament)**: Új funkciókhoz, Tailwind CSS-hez és Filament alapú admin felületekhez.
- Forrásfájlok: `resources/modern/js/`, `resources/modern/css/`. - Forrásfájlok: `resources/modern/js/`, `resources/modern/css/`, `resources/css/filament/`.
- Nézetek: `resources/modern/views/`. - Nézetek: `resources/modern/views/`, `resources/views/filament/`.
- Használat Blade-ben: `@vite(['resources/modern/css/app.css', 'resources/modern/js/app.js'])`. - 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. - 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 ##### JavaScript Architektúra és Modulok
- A JS kód alapja egy egyedi objektumorientált rendszer. - 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. - **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.