Înapoi la portofoliu
WebappStudiu / personal

ERP Florărie

Aplicație Laravel + Livewire pentru administrarea stocului unei florării, cu produse, cantități, furnizor, cost și preț de vânzare, profit unitar, termene de expirare, imagini și operații CRUD într-o interfață reactivă.

ERP Florărie

Stack principal

PHP 8.2
Laravel 12
Eloquent ORM
Livewire 3
Livewire VoltLaravel BreezeBladeTailwind CSSAlpine.jsSQLiteLaravel StorageVite 6AxiosPHPUnit 11

Provocarea

Provocarea demonstrată de cod este modelarea unui stoc de produse perisabile într-o interfață internă simplă, unde operatorul trebuie să vadă simultan cantitatea, costul, prețul, furnizorul și termenul de expirare și să poată actualiza rapid datele fără un frontend SPA separat.

Soluția

Soluția folosește Laravel 12 cu Eloquent și o componentă Livewire pentru întregul flux CRUD. Căutarea, sortarea și paginarea rulează server-side, validarea este centralizată în acțiunile Livewire, imaginile sunt gestionate prin Laravel Storage, iar Blade + Tailwind oferă interfață responsive și dark mode. Modelul FlowerProduct păstrează datele operaționale și calculează profitul unitar direct din cost și preț.

Complexitate notabilă

ERP Florărie este un proiect de studiu construit ca bază pentru digitalizarea operațiunilor interne ale unei florării. Snapshotul analizat nu reprezintă încă un ERP complet: partea implementată este un modul coerent de catalog și stoc, în care un utilizator autentificat poate căuta, sorta, adăuga, modifica și șterge produse din aceeași interfață Livewire.

Modelul FlowerProduct păstrează numele, descrierea, categoria, cantitatea, costul de achiziție, prețul de vânzare, data intrării în stoc, data expirării, furnizorul ca atribut text, imaginea și starea activ/inactiv. Eloquent aplică tipuri pentru date, booleeni și prețuri, iar modelul include metode pentru verificarea stocului, expirării și calculul profitului unitar. În interfața curentă este afișat direct profitul ca diferență dintre prețul de vânzare și costul de achiziție.

Fluxul principal este implementat într-o componentă Livewire clasică, FlowerProductsTable. Căutarea este executată în baza de date după nume, categorie sau furnizor, rezultatele sunt paginate câte 10 și pot fi sortate după coloanele principale. Formularele de adăugare și editare validează câmpurile înainte de persistare, iar imaginile sunt validate ca fișiere image de maximum 1 MB și sunt salvate pe discul public. La înlocuirea sau ștergerea unui produs, aplicația elimină și imaginea veche atunci când aceasta există.

Frontend-ul folosește Blade, Livewire și Tailwind CSS, cu layout responsive, modale pentru CRUD, navigație desktop/mobile și dark mode păstrat în localStorage. Interacțiunile Livewire elimină nevoia unui SPA separat: starea formularului, căutarea, sortarea și paginarea sunt gestionate server-side, iar Alpine este folosit în componentele de interfață și pentru comportamente precum meniurile și tema.

Autentificarea și profilul provin în mare parte din scaffolding-ul Laravel Breeze + Livewire Volt: înregistrare, login, resetare parolă, verificare email, actualizare profil și logout. Login-ul este protejat prin rate limiting, însă modulul Flower Products cere doar autentificare, nu email verificat. Repository-ul nu definește roluri, policies sau ownership la nivel de produs, astfel încât orice cont autentificat poate opera asupra întregului catalog. Pentru un deployment public, înregistrarea liberă și lipsa autorizării granulare ar trebui restrânse.

Din punct de vedere al datelor, aplicația pornește implicit pe SQLite și are o singură tabelă de domeniu pentru flower_products, fără relații către tabele separate de furnizori, comenzi sau rețete. Nu există indexuri dedicate pentru câmpurile de căutare/sortare, constrângeri pentru duplicate, tranzacții în fluxurile CRUD, locking sau mecanisme de audit. Paginarea limitează volumul transferat către UI, iar modelul simplu evită probleme N+1 în forma actuală, dar căutările cu wildcard și lipsa indexurilor ar trebui revizuite înaintea unui volum mare de date.

Configurația Laravel include infrastructură standard pentru queue, cache, mail și S3, însă repository-ul nu conține joburi, workers de business, integrare cloud activă, webhook-uri, plăți, SMS, analytics, AI sau API-uri externe. Există un health endpoint Laravel la /up și o comandă Artisan custom care creează symlink-ul de storage și directorul public pentru imaginile produselor.

Istoricul Git disponibil conține un singur commit de tip portfolio backup, deci nu oferă o cronologie suficientă pentru a demonstra cine a implementat fiecare etapă sau dacă proiectul a fost greenfield. Ce poate fi separat clar în snapshot este scaffolding-ul Laravel/Breeze/Volt de logica de domeniu personalizată: modelul și migrarea FlowerProduct, componenta Livewire și tabelul de administrare, seed-ul de produse, ruta dedicată, integrarea în navigație și comanda pentru storage. Draftul legacy descria o țintă mai amplă de ERP cu comenzi, furnizori, rapoarte și alerte de expirare; acestea sunt tratate doar ca direcție de evoluție, nu ca funcții implementate.

Rezultate cheie

  • Modul funcțional de administrare a produselor de florărie cu creare, editare și ștergere
  • Catalog paginat cu căutare după nume, categorie sau furnizor și sortare după câmpurile principale
  • Evidență pentru cantitate, cost de achiziție, preț de vânzare, data intrării, expirare, furnizor și stare activă
  • Calcul de profit unitar expus în tabelul operațional
  • Upload de imagini cu validare, preview la formular și curățarea fișierului vechi la înlocuire sau ștergere
  • Autentificare, înregistrare, resetare parolă, verificare email și profil prin scaffolding Laravel Breeze/Volt
  • Login protejat prin rate limiting
  • Interfață responsive cu modale Livewire și dark mode persistent
  • Date demo pentru produse și comandă Artisan pentru pregătirea storage-ului public
  • Health endpoint Laravel disponibil la /up

Proiecte asemănătoare

Vrei ceva similar?

Începe cu wizard-ul de estimare — răspunzi la câteva întrebări și primești un range de preț + timeline realist.