WeBRT Template

Un template Laravel complet cu panel de administrare Filament, autentificare și funcționalități de backup/restore.

Caracteristici

Framework și Tehnologii

• Laravel 12 - Framework PHP modern pentru aplicații web
• Filament v3 - Panel de administrare elegant cu dark mode
• Laravel Breeze + Livewire - Sistem de autentificare simplu și elegant
• SQLite - Bază de date ușor de configurat pentru dezvoltare
• Tailwind CSS - Framework CSS pentru styling modern

Funcționalități Principale

Autentificare și Utilizatori

• Sistem complet de autentificare (login/register)
• Gestionare utilizatori cu roluri admin
• Protecție utilizator admin principal (nu poate fi șters)
• Dashboard personalizat cu statistici utilizatori

Panel de Administrare (Filament)

• Panou de control - Dashboard cu widget utilizatori
• Gestionare Utilizatori - CRUD complet cu protecții admin
• Setări Sistem - Backup, restore și editare .env
• Interface tradusă în română
• Dark mode suport
• Design responsive cu layout optimizat

Backup și Restore

• Backup SQL - Export bază de date în format SQL
• Backup Complet - Arhivă ZIP cu fișiere + bază de date
• Restore SQL - Import bază de date din fișier SQL
• Restore Fișiere - Restaurare din arhivă ZIP
• Editor .env - Modificare variabile de mediu prin popup modal

Design și UX

• Homepage clean cu butoane centrate Register/Login
• Meniu de navigare organizat pe grupuri cu separatoare vizuale
• Tabele full-width pentru utilizare optimă a spațiului
• Traducere completă în română a interfeței Filament

Structura Proiectului

app/
├── Filament/
│   ├── Pages/
│   │   ├── Dashboard.php        # Dashboard personalizat
│   │   └── Settings.php         # Pagina de setări sistem
│   ├── Resources/
│   │   └── UserResource/        # CRUD utilizatori
│   └── Widgets/
│       └── UsersOverview.php    # Widget statistici utilizatori
├── Models/
│   └── User.php                 # Model utilizator cu rol admin
└── Providers/
    └── Filament/
        └── AdminPanelProvider.php # Configurare panel Filament

database/
├── migrations/                  # Migrații bază de date
├── seeders/                     # Seeders cu utilizator admin
└── exports/                     # Director pentru backup-uri SQL

resources/
├── views/
│   ├── welcome.blade.php        # Homepage clean
│   └── filament/admin/theme.blade.php # Stiluri personalizate
└── lang/
    ├── ro.json                  # Traduceri generale
    └── vendor/filament/ro.json  # Traduceri Filament

Instalare

Cerințe

• PHP 8.2+
• Composer
• Node.js și npm
• SQLite (pentru dezvoltare) sau MySQL/PostgreSQL (pentru producție)

Pași de Instalare

1. Clonează repository-ul

   git clone https://github.com/BrTDevil/webrt-template.git
   cd webrt-template

2. Instalează dependențele PHP

   composer install

3. Instalează dependențele Node.js

   npm install

4. Configurează mediul

   cp .env.example .env
   php artisan key:generate

5. Configurează baza de date în .env Pentru SQLite (recomandat pentru dezvoltare):

   DB_CONNECTION=sqlite
   DB_DATABASE=/path/to/database/database.sqlite
   

6. Creează baza de date

   touch database/database.sqlite  # pentru SQLite

7. Rulează migrațiile și seeders

   php artisan migrate --seed

8. Creează directoarele necesare

   mkdir -p database/exports
   mkdir -p export

9. Compilează assets

   npm run build

10. Pornește serverul de dezvoltare

    php artisan serve

Utilizare

Accesare Aplicație

• Homepage: http://localhost:8000
• Panel Admin: http://localhost:8000/admin

Cont Administrator Implicit

• Email: admin@admin.com
• Parolă: admin

Funcționalități Principale

Pentru Utilizatori

1. Înregistrare/conectare prin homepage
2. Acces la dashboard după autentificare

Pentru Administratori

1. Acces la panelul de administrare
2. Gestionare utilizatori (CRUD)
3. Backup/restore sistem
4. Editare configurări .env
5. Vizualizare statistici utilizatori

Backup și Restore

Crearea unui Backup

1. Accesează Admin → Setări
2. Folosește butoanele din header:
   • "Backup Bază de Date" - pentru SQL dump
   • "Backup Complet" - pentru arhivă ZIP cu tot

Restaurarea din Backup

1. În pagina Setări, secțiunea corespunzătoare
2. Încarcă fișierul SQL sau ZIP
3. Sistemul va procesa automat restaurarea

Configurare

Personalizare Tema

Editează resources/views/filament/admin/theme.blade.php pentru a modifica stilurile CSS.

Adăugare Limbi

Adaugă fișiere de traducere în lang/ pentru suport multilingv.

Configurare Email

Configurează setările SMTP în .env pentru funcționalitatea de email.

Tehnologii și Pachete

• laravel/framework: ^12.0
• filament/filament: ^3.0
• laravel/breeze: ^2.0
• livewire/livewire: ^3.0
• tailwindcss: ^3.0

Suport și Contribuții

Pentru probleme sau îmbunătățiri, deschide un issue în repository sau trimite un pull request.