Solar — datu fotovoltaikoak ikusteko eta kudeatzeko web frontend-a
Solar web aplikazio bat da instalazio fotovoltaiko erreal baten datu energetikoak ikusi eta kudeatzeko.
Solar APIaren gaineko aurkezpen geruza da, datu bateratuak grafiko argi eta konparagarrietan bihurtuz denbora tarte desberdinetarako.
Autentifikazioa, rol bidezko sarbide kontrola eta administratzaileentzako kudeaketa tresnak ditu.
Testuingurua
Instalazio fotovoltaikoek datu energetiko kopuru handiak sortzen dituzte eta, aurkezpen egokirik gabe, interpretatzea zaila da:
- etxebizitzaren edo instalazioaren kontsumoa,
- ekoizpen fotovoltaikoa,
- sarearekiko energia trukea,
- eta, baliteke, biltegiratze sistemekin.
Solar-ek informazio hau zentralizatu eta panel bakar batean modu bisual, koherente eta eskuragarrian aurkezten du.
Zer konpontzen du
Aplikazioak hau ahalbidetzen du:
- Energia portaera egun, hilabete edo urteka ikustea
- Ekoizpena, kontsumoa eta export/import konparatzea
- Energia-balantzea berehala ulertzea
- Datu kargak eta babeskopiak kudeatzea (admin erabiltzaileak)
- Interfazeak testuak eta kontrolak egokitzen ditu hautatutako periodoen arabera.
Hori guztia backend APIak normalizatutako eta bateratutako datuak bakarrik kontsumituz.
Ikuspegi arkitektura eta osagaien berrerabilpena
Frontend-ean hiru ikuspegi nagusi daude: Daily, Monthly eta Yearly.
Hiruak grafiko osagai bera berrerabiltzen dute (chart mota bera eta oinarri bisual bera). Aldatzen dena:
- periodo hautatzailea (data / hilabetea / urtea),
- datuen agregazioa (orduak / egunak / hilabeteak),
- eta erabiltzaileari erakusten zaizkion etiketak eta testuak.
Grafikoa bera da; aldea datu logikan eta periodo kontrolan dago.
Funtzionalitate nagusiak
Eguneroko ikuspegia
- Data hautatzailea
- 24 ordutako balio dituen grafikoa
- Energia fluxuaren bistaratzea:
- ekoizpen fotovoltaikoa
Hileko ikuspegia
- Hilabete hautatzailea
- eguneko agregatutako datuekin grafikoa
- Hilabete osoan ekoizpena eta kontsumoa argi konparatzeko
Urteko ikuspegia
- Urte hautatzailea
- hileko agregatutako datuekin grafikoa
- Urteko energia portaeraren ikuspegi orokorra
Kudeaketa eta administrazioa
Admin sarbideak funtzionalitate gehigarriak aktibatzen ditu:
- CSV fitxategien karga anizkoa
- Babeskopien deskarga
- Web interfazean oinarrizko datu kudeaketa
'Profila eguneratu' aukera ikusgai dago, baina gaur egun funtzionalitatea eraikitzen mezua erakusten du.
Solar APIarekin integrazioa
Frontend-ak backend APIa bakarrik kontsumitzen du:
POST /users/login— autentifikazioaGET /photovoltaics/date/:date— eguneko, hileko edo urteko datuakPOST /photovoltaics/upload— CSV karga (admin)GET /photovoltaics— backup osoaren deskarga
APIaren oinarrizko URLa ingurune aldagaietan kudeatzen da (VITE_API_BASE_URL).
Segurtasuna eta sarbide kontrola
- login bidezko autentifikazioa
- Tokena eta rola sessionStorage-n gordetzen dira
- admin rolak 'Kudeatu' atala aktibatzen du
- Datu sentikorren lokalen persistenciarik ez
Frontend-aren segurtasuna APIarekin lerrokatuta dago, erantzukizunak bereizita mantenduz.
Arkitektura eta stack teknikoa
- Frameworka: Vue 3
- Build tool: Vite
- Routing: Vue Router
- UI: Vuetify
- Grafikoak: ECharts (vue-echarts bidez)
- HTTP: Axios
- Mobile: Capacitor (oinarrizko konfigurazioa barne)
Android / Mobile
- Capacitor konfigurazioa barne
- Mendekotasunak instalatuta
- Oraindik ez da plataforma natiborik sortu (Android/iOS)
Capacitor gehitzen duen commit espezifiko bat dago etorkizuneko Android app-erako.
Despliegua eta egoera
- Aplikazioa Vercel-en desplegatuta
- Build estandarra vite build eta dist irteerarekin
- Ingurune desberdinak .env bidez
Proiektu honek zer erakusten du
Proiektu honek nire gaitasuna erakusten du:
- Benetako datuetara orientatutako frontend-ak diseinatzea
- Osagaiak modu koherentean berrerabiltzea
- Datuen bistaratze aurreratua integratzea
- API konplexuak kontsumitzea logika bezeroari pasa gabe
- Web eta mobile despliegua diseinutik pentsatzea
- Softwarea ekoizpenean eraikitzea, ez demotzat
Proiektuaren irudiak
