Evaluarea potențialului eolian din Republica Moldova – dezvoltarea componentei frontend a aplicației web

Abstract

Proiectul este o aplicație web modernă dezvoltată cu Next.js și React, dedicată analizei potențialului eolian din Republica Moldova. Aplicația oferă o interfață intuitivă și un flux de lucru clar, prin care utilizatorul selectează o locație, vizualizează datele despre vânt, analizează performanța unei turbine și generează un raport PDF complet. Structura proiectului este realizată în TypeScript, folosind TailwindCSS pentru stilizare și un ecosistem de testare solid care acoperă toate nivelurile necesare unei aplicații profesionale. Interfața se bazează pe App Router din Next.js, ceea ce permite o organizare curată și un routing segmentat. Componentele sunt dezvoltate în mod modular, folosind biblioteci precum Radix UI și Lucide React. Sistemul de hartă folosește Mapbox GL și React Map GL, permițând selectarea interactivă a coordonatelor și afișarea unui overlay personalizat pentru Moldova. Harta poate fi capturată ca imagine pentru raportul PDF, iar marker-ele sunt realizate custom pentru o afișare clară a punctelor selectate. Unele date sunt completate automat, cum ar fi elevația, folosind un serviciu extern de tip Open Elevation API. Analiza vântului reprezintă centrul aplicației. Utilizatorul poate introduce manual coordonatele sau poate selecta un punct direct pe hartă. Backend-ul furnizează informații precum viteza vântului la diverse înălțimi, parametrii distribuției Weibull și frecvențele direcționale. Rezultatele sunt afișate sub formă de tabele și grafice interactive, realizate cu Chart.js și Recharts. Printre cele mai importante vizualizări se numără Wind Rose, Wind Frequency Rose și Power Curve Chart, fiecare contribuind la înțelegerea caracteristicilor vântului în zona selectată. Pentru selecția turbinei, aplicația oferă o listă furnizată de backend. Fiecare turbină include date tehnice esențiale, cum ar fi puterea nominală sau curba de putere. În funcție de turbină și de condițiile vântului, aplicația calculează energia anuală estimată. Generarea PDF-urilor este o funcționalitate avansată. Utilizatorul poate exporta raportul complet care include harta, graficele, datele tehnice ale turbinei și calculele energetice. Aplicația capturează imagini ale hărții și ale diagramelor și transmite toate aceste date către backend pentru compunerea documentului final. Sistemul de testare include teste unitare pentru API-uri, teste de integrare pentru contexte și fluxuri interne, precum și teste end-to-end cu Playwright pentru scenarii complete. Configurația proiectului conține Docker, variabile de mediu, optimizări Next.js și suport pentru dark mode. Proiectul oferă astfel o platformă robustă, bine structurată și complet funcțională pentru evaluarea potențialului eolian.

The project is a modern web application developed with Next.js and React, dedicated to analyzing wind energy potential in the Republic of Moldova. The application offers an intuitive interface and a clear workflow through which users select a location, visualize wind data, analyze turbine performance, and generate a comprehensive PDF report. The project structure is built in TypeScript, using TailwindCSS for styling and a solid testing ecosystem that covers all necessary levels of a professional application. The interface is based on Next.js App Router, which enables clean organization and segmented routing. Components are developed in a modular fashion, using libraries such as Radix UI and Lucide React. The map system uses Mapbox GL and React Map GL, allowing interactive coordinate selection and displaying a custom overlay for Moldova. The map can be captured as an image for the PDF report, and markers are custom-built for clear display of selected points. Some data is automatically populated, such as elevation, using an external service like the Open Elevation API. Wind analysis represents the core of the application. Users can manually enter coordinates or select a point directly on the map. The backend provides information such as wind speed at various heights, Weibull distribution parameters, and directional frequencies. Results are displayed as interactive tables and charts, built with Chart.js and Recharts. Among the most important visualizations are the Wind Rose, Wind Frequency Rose, and Power Curve Chart, each contributing to understanding wind characteristics in the selected area. For turbine selection, the application offers a list provided by the backend. Each turbine includes essential technical data, such as rated power or power curve. Based on the turbine and wind conditions, the application calculates the estimated annual energy output. PDF generation is an advanced feature. Users can export a complete report that includes the map, charts, turbine technical data, and energy calculations. The application captures images of the map and diagrams and transmits all this data to the backend for final document composition. The testing system includes unit tests for APIs, integration tests for contexts and internal flows, as well as end-to-end tests with Playwright for complete scenarios. The project configuration contains Docker, environment variables, Next.js optimizations, and dark mode support. The project thus provides a robust, well-structured, and fully functional platform for wind potential assessment.