Înapoi la portofoliu
PlatformăClient realReprezentativ

Stoc Manager

Aplicație operațională pentru gestiunea unui depozit de materiale de construcții, cu stoc în metri pătrați și bucăți, recepții multi-produs, POS responsive, comenzi, trasabilitate prin snapshot-uri, coduri QR și sincronizare în timp real.

Stoc Manager

Stack principal

PHP 8.2+
Laravel 12
Eloquent ORM
Laravel Fortify
Laravel ReverbLaravel EchoLaravel WayfinderInertia.js 2Vue 3TypeScriptVite 7Tailwind CSS 4Reka UIAxiosPusher JSDomPDFEndroid QR CodeProgressive Web AppService WorkerNginxApachePHP-FPMBashHetzner VPS

Provocarea

Provocarea principală a fost unificarea catalogului, recepțiilor, stocului și vânzărilor într-un produs simplu pentru utilizare zilnică, într-un domeniu în care cantitatea este exprimată în metri pătrați, dar operatorii au nevoie și de echivalentul în bucăți. În plus, istoricul trebuia să rămână inteligibil când datele comerciale ale produsului se schimbă, iar terminalele POS trebuiau să primească rapid modificările de disponibilitate.

Soluția

Soluția folosește un monolit Laravel 12 cu Inertia și Vue 3: regulile și persistența rămân pe backend, iar frontend-ul oferă o experiență reactivă de tip SPA. Stocul curent este păstrat pe produs și completat de un jurnal de StockMovement pentru intrări și ieșiri. La operațiunile relevante, ProductSnapshot salvează o copie denormalizată a datelor produsului și este asociat comenzilor și mișcărilor pentru trasabilitate. POS-ul persistă coșul în backend, finalizarea comenzii grupează operațiunile principale într-o tranzacție SQL, Reverb distribuie schimbările în timp real, iar Endroid QR Code și DomPDF generează etichete imprimabile care leagă produsele fizice de fluxurile aplicației.

Complexitate notabilă

Stoc Manager centralizează catalogul, stocul și vânzările unui business care comercializează materiale de placare și finisaje. Produsele sunt organizate pe categorii și au SKU unic, fotografie, dimensiuni, culoare, preț pe metru pătrat și stoc curent. Din lățime și lungime, aplicația calculează automat echivalentul estimat în bucăți, astfel încât aceeași evidență să poată fi folosită atât în depozit, cât și în interfața de vânzare.

Aplicația folosește trei roluri operaționale — Administrator, Agent și Vânzător — pentru navigație și separarea principalelor zone de lucru. Administratorul gestionează catalogul, categoriile, utilizatorii, dashboard-ul și etichetele QR, iar fluxul de recepție permite introducerea mai multor produse într-o singură operațiune, cu cantitatea în metri pătrați și motivul sau documentul asociat. Istoricul mișcărilor poate fi filtrat după produs, utilizator, tip, motiv și perioadă.

Interfața POS este optimizată pentru desktop, tabletă și mobil. Produsele disponibile sunt afișate vizual cu fotografie, SKU, dimensiuni, culoare, preț și stoc, iar utilizatorul poate căuta rapid, adăuga cantități în coș și vedea valoarea calculată înainte de finalizare. Coșurile sunt persistate server-side, iar finalizarea unei comenzi creează articolele comerciale și mișcările de ieșire, actualizând stocul în aceeași tranzacție SQL.

Pentru păstrarea contextului istoric, recepțiile și vânzările creează ProductSnapshot-uri imutabile cu datele produsului din momentul operațiunii. Order items și stock movements referă aceste snapshot-uri, astfel încât istoricul poate utiliza denumirea, SKU-ul, categoria, dimensiunile, prețul și imaginea existente la momentul tranzacției, în loc să depindă exclusiv de versiunea curentă a produsului.

Laravel Reverb și Echo propagă actualizările de stoc între instanțele POS și sincronizează coșul pe un canal privat per utilizator. Administratorul poate genera documente PDF A4 cu coduri QR pentru produsele selectate; scanarea QR deschide produsul direct în fluxul potrivit rolului. Aplicația este instalabilă ca PWA și rulează pe infrastructură VPS, cu Nginx pentru HTTPS și proxy WebSocket, Apache/PHP-FPM pentru Laravel și un script de deployment care execută instalarea dependențelor, build-ul Vite, migrările și cache-urile framework-ului.

Rezultate cheie

  • Catalog administrabil cu categorii, SKU unic, imagini, dimensiuni, culori, preț pe metru pătrat și stoc curent
  • Evidență în metri pătrați cu conversie automată în număr estimat de bucăți pe baza dimensiunilor produsului
  • Recepții multi-produs cu cantitate și motiv sau document asociat fiecărei operațiuni de intrare
  • Istoric de mișcări de stoc cu filtrare după produs, utilizator, tip, motiv și interval de date
  • POS responsive cu catalog vizual, căutare rapidă, coș persistent, calcul de total și verificarea disponibilității
  • Comenzi cu articole, preț unitar păstrat la momentul vânzării și mișcări automate de ieșire din stoc
  • ProductSnapshot-uri dedicate pentru păstrarea contextului istoric al produselor în tranzacții
  • Dashboard administrativ cu vânzări și comenzi pe 30 de zile, serie zilnică, stoc total, top produse și distribuție pe categorii
  • Coduri QR generate server-side în PDF A4, cu opțiune de afișare a prețului și rutare adaptată rolului
  • Actualizări de stoc în timp real între instanțele POS și sincronizarea coșului pe canal privat per utilizator
  • PWA instalabilă și interfață adaptată pentru desktop, tabletă și mobil
  • Deployment pe VPS cu build Laravel/Vite, migrări, cache-uri Laravel și proxy Nginx pentru Laravel Reverb

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.