Înapoi la portofoliu
WebappClient real

Calculator Calorii

Aplicație Laravel + Livewire care combină un constructor de mese cu valori calorice și macronutrienți, obiective și jurnal personal, grupuri recurente și o suită de calculatoare pentru BMR/TDEE, greutate, compoziție corporală, proteine și calorii arse.

Calculator Calorii

Stack principal

PHP 8.2
Laravel 11
Livewire 3
Blade
Eloquent ORMMySQLTailwind CSS 3Alpine.js 3Vite 6Carbonhtml2canvasLaravel MailPHPUnit 11cPanel

Provocarea

Provocarea a fost unificarea într-o singură experiență a două tipuri de logică: formule nutriționale independente, cu unități și limite de validare diferite, și un jurnal alimentar persistent în care aceleași alimente au valori diferite în funcție de preparare și cantitate. Peste acestea, obiectivele trebuie să țină cont atât de mesele salvate efectiv, cât și de grupurile recurente, fără dublarea caloriilor în agregări.

Soluția

Soluția folosește componente Livewire dedicate fiecărui calculator și un model relațional FoodItem → PreparationMethod → MealItem pentru calculele per porție. Calculatorul principal păstrează masa curentă în sesiune, permite alimente custom, salvează mesele autentificate în grupuri și calculează progresul obiectivului pe intervalul relevant. Grupurile recurente păstrează doar regula de repetare, iar dashboard-ul determină datele aplicabile și deduplică perechile masă-dată la agregare. Administrarea catalogului, blogul și SEO sunt integrate în același monolit Laravel.

Complexitate notabilă

Calculator Calorii este o aplicație web de nutriție care merge dincolo de o formulă izolată. Suprafața principală permite căutarea alimentelor, alegerea metodei de preparare, introducerea cantității și calcularea valorilor de calorii, proteine, carbohidrați și grăsimi proporțional cu porția. Utilizatorii neautentificați pot compune temporar o masă, iar conturile verificate pot salva mesele, pot crea alimente proprii și le pot organiza în grupuri.

Modelul de date separă alimentul de metodele sale de preparare, deoarece aceeași materie primă poate avea valori diferite în funcție de modul de gătire. Meal și MealItem păstrează jurnalul alimentar, MealGroup organizează mesele și poate defini repetare săptămânală sau lunară, iar CalorieGoal păstrează obiectivul activ pentru perioade zilnice, săptămânale sau lunare. Valorile nutriționale sunt calculate din cantitate raportată la 100 g, iar dashboard-ul agregă mesele pe perioade și include logică pentru a proiecta virtual grupurile recurente fără a materializa copii ale meselor în baza de date.

Aplicația include pagini distincte pentru slăbit, creștere în greutate, grăsime corporală, greutate ideală, proteine, macronutrienți și calorii arse. BMR-ul folosește formula Mifflin–St Jeor, TDEE aplică multiplicatori de activitate, iar calculatorul de calorii arse folosește valori MET și formula bazată pe greutate și durată. Modul de distanță estimează timpul din distanță și viteză și interpolează valoarea MET pentru mers, alergare sau ciclism. Calculatorul de grăsime corporală folosește formula US Navy și oferă suplimentar BMI și masă slabă, iar cel de greutate ideală compară formulele Robinson, Miller, Devine și Hamwi.

Interfața este server-driven prin Livewire 3, cu Blade pentru markup, Alpine.js pentru interacțiuni locale și Tailwind CSS pentru layout responsive și dark mode. Calculatorul principal are o structură în două coloane pe desktop și un slide-over pentru sumarul mesei pe mobil. Căutarea alimentelor este debounced, rezultatele sunt limitate, există quick-add și selectarea automată a metodei implicite pe categorie. Sumarul mesei poate fi randat într-un layout dedicat și exportat local ca PNG prin html2canvas încărcat la cerere.

Conturile folosesc autentificarea Laravel, verificare de email prin URL semnat și resetare de parolă. Un middleware separat blochează utilizatorii dezactivați, iar zona admin este protejată prin flag-ul is_admin. Administratorul poate gestiona catalogul de alimente și categorii, metodele de preparare, utilizatorii, articolele de blog și setările SEO. Layout-ul citește metadatele per pagină din baza de date și poate activa Google Analytics atunci când un ID este configurat.

Persistența folosește MySQL și relații Eloquent cu foreign keys și cascade acolo unde modelul de domeniu o cere. Lista de mese este paginată și încarcă relațiile nutriționale folosite în UI. Pentru căutarea alimentelor se folosește LIKE cu wildcard la început și inRandomOrder pentru quick-add, iar agregarea grupurilor recurente iterează datele în PHP; acestea sunt suficiente pentru dimensiunea aplicației din snapshot, dar ar necesita strategie de căutare/indexare și preagregare dacă volumul ar crește semnificativ.

Snapshotul include și infrastructură de operare legacy: manifest cPanel, health endpoint Laravel și endpointuri pentru webhook GitHub / execuție administrativă. Nu există GitHub Actions, Docker sau o suită de teste pentru formulele nutriționale; testele prezente acoperă în principal scaffolding-ul de autentificare și profil. Auditul a identificat și configurații sensibile comise în repository, rute de debug accesibile public și câteva verificări de ownership incomplete. Aceste elemente nu sunt prezentate ca avantaje ale produsului și trebuie hardenate înaintea unei reutilizări de producție.

Rezultate cheie

  • Constructor de mese cu căutare de alimente, metode de preparare, cantități și totaluri pentru calorii, proteine, carbohidrați și grăsimi
  • Persistență pentru mese și articole de jurnal asociate utilizatorului, cu organizare în grupuri
  • Grupuri de mese cu reguli de repetare săptămânală sau lunară și calcul virtual în statistici
  • Obiective calorice zilnice, săptămânale și lunare cu progres calculat din jurnalul curent
  • Șapte calculatoare specializate rutate pentru slăbit, creștere în greutate, grăsime corporală, greutate ideală, proteine, macronutrienți și calorii arse
  • Logică BMR/TDEE bazată pe Mifflin–St Jeor și estimarea consumului energetic prin MET
  • Dashboard cu statistici nutriționale și filtre today/week/month/all/custom
  • Alimente custom persistente pentru utilizatorii autentificați și metode multiple de preparare per aliment
  • Export local al sumarului unei mese ca imagine PNG
  • Administrare pentru catalogul alimentar, categorii, utilizatori, blog și SEO
  • Autentificare cu verificare de email, resetare parolă și dezactivare administrativă a conturilor
  • Interfață responsive cu dark mode, layout desktop în două coloane și sumar mobil tip slide-over
  • Health endpoint Laravel și configurație de deployment cPanel prezente în repository

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.