Înapoi la portofoliu
WebappStudiu / personal

Photo Archive

Platformă pentru fotografi și organizatori care centralizează sesiunile foto, upload-ul și procesarea imaginilor și oferă clienților galerii accesibile prin cod unic, cu parolă opțională și download individual sau ZIP.

Photo Archive

Stack principal

Node.js
Express 4
React 19
Vite 7
Tailwind CSS 4React Router 6AxiosMySQL / MariaDBmysql2MulterSharpJWTbcryptjsarchiverfs-extraHelmetcompressionLucide ReactNginxPM2

Provocarea

Provocarea centrală este livrarea unui număr mare de imagini de eveniment într-o experiență simplă pentru client, fără cont obligatoriu, păstrând originalele pentru download și generând în același timp versiuni suficient de ușoare pentru navigarea galeriei. Pe partea operațională, fotograful are nevoie de sesiuni separate, coduri de acces, upload multiplu și vizibilitate asupra volumului și accesărilor.

Soluția

Soluția separă interfața React de un API Express cu persistență MySQL și storage local pe disk. Multer scrie upload-urile direct în directorul de originale, Sharp validează fișierele și generează thumbnail-uri și versiuni de galerie, iar metadatele necesare navigării sunt persistate relațional. Sesiunile primesc coduri unice generate server-side și pot avea parolă bcrypt; galeria client folosește paginare, căutare și preview, iar originalele pot fi descărcate individual sau agregate într-un ZIP stream-uit cu archiver. Administrarea este separată prin autentificare JWT și oferă CRUD de sesiuni, upload și statistici.

Complexitate notabilă

Photo Archive este o aplicație web construită pentru livrarea controlată a fotografiilor de eveniment către clienți. Administratorul creează câte o sesiune cu nume, descriere și dată de eveniment, iar backend-ul generează un cod unic de opt caractere. Sesiunea poate fi activată sau dezactivată și poate primi o parolă suplimentară, stocată ca hash bcrypt. Interfața administrativă afișează numărul de fotografii, volumul stocat și accesările înregistrate și permite copierea codului sau deschiderea directă a galeriei.

Upload-ul este realizat prin Multer cu stocare directă pe disk. Pentru fiecare imagine acceptată, Sharp validează formatul și dimensiunile, citește metadatele tehnice de bază și generează două versiuni derivate: thumbnail pătrat de 300 × 300 pentru listare și imagine de galerie de maximum 1200 × 1200, JPEG progresiv la calitate 85. Originalul este păstrat separat, iar MySQL persistă numele inițial, căile fișierelor, dimensiunea, rezoluția și momentul upload-ului. Procesarea este făcută secvențial în requestul de upload; codul nu introduce queue workers sau batching asincron separat.

Clientul ajunge în galerie folosind codul primit de la fotograf sau organizator. Pagina citește informațiile sesiunii, solicită parola atunci când sesiunea este protejată și încarcă fotografiile paginat, câte 20. Galeria oferă mod grid sau listă, căutare după numele fișierului, preview într-un modal și download al originalului. O rută separată construiește on-demand o arhivă ZIP cu toate originalele folosind archiver și stream-uiește răspunsul către browser. Accesările publice sunt înregistrate cu IP și user-agent, iar aceeași combinație sesiune/IP nu este relogată în mod normal mai des de o dată pe oră pe rutele principale de galerie.

Frontend-ul este un SPA React 19 + Vite 7 + Tailwind CSS 4, cu o identitate vizuală light bazată pe gradient albastru–indigo–mov, carduri albe translucide și iconografie Lucide. Backend-ul Express rulează separat pe Node.js, folosește pool MySQL, JWT pentru administrare și un flux client separat disponibil la nivel API, iar deployment-ul documentat folosește PM2 și Nginx pe un VPS HestiaCP. Repository-ul nu conține GitHub Actions și nici o suită automată de teste; există doar un script utilitar pentru verificarea limitelor de upload.

Din perspectiva hardening-ului, codul analizat are câteva probleme care trebuie tratate înainte de a prezenta platforma ca depozit privat de fotografii: rate limiting este dezactivat în server, există fallback-uri pentru secretul JWT și parola admin, iar repository-ul conține materiale TLS care nu ar trebui versionate. În plus, protecția cu parolă a sesiunii este aplicată pe endpointul paginat principal, dar nu este verificată consecvent pe toate endpoint-urile publice de fotografie/căutare/recent/download. Seed-ul prezintă funcționalitatea reală fără a transforma aceste mecanisme într-o afirmație de securitate completă.

Rezultate cheie

  • Aplicație React separată în suprafețe publice, galerie client și panou de administrare
  • Sesiuni foto cu nume, descriere, dată de eveniment, status activ/inactiv și cod unic de acces din opt caractere
  • Parolă opțională per sesiune, persistată ca hash bcrypt și solicitată de interfața principală a galeriei
  • Upload multiplu cu Multer, configurat la maximum 500 MB per fișier și până la 1000 de fișiere într-un request
  • Validare de imagine prin Sharp pentru JPEG/JPG, PNG, WebP și TIFF și respingerea imaginilor sub 100 × 100 px
  • Generare automată de thumbnail 300 × 300 și versiune de galerie de maximum 1200 × 1200, păstrând separat originalul
  • Persistență MySQL pentru sesiuni, fotografii, administratori și jurnalul de acces
  • Galerie paginată la 20 de fotografii, cu mod grid/listă, preview și informații de rezoluție
  • Căutare client după numele original al fișierului
  • Download individual al originalelor și download complet al sesiunii ca arhivă ZIP generată on-demand
  • Dashboard administrativ cu sesiuni active, total fotografii, accesări recente și număr total de sesiuni
  • Filtrare și sortare a sesiunilor după status, nume, dată, data evenimentului sau număr de fotografii
  • Logging al accesărilor publice cu sesiune, cod, IP, user-agent și timestamp
  • Deployment documentat pe VPS cu Nginx ca reverse proxy/static server și PM2 pentru procesul Node.js

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.