Înapoi la portofoliu
WebappStudiu / personal

MyElectrica

Aplicație web standalone care sincronizează date MyElectrica într-un model PostgreSQL și centralizează contracte, locuri de consum, facturi, plăți, contoare, autocitiri și statistici de consum.

MyElectrica

Stack principal

TypeScript
Node.js
Hono
PostgreSQL
Drizzle ORMSvelteKit 2Svelte 5Tailwind CSS 4VitepdftotextNode.js Crypto

Provocarea

Provocarea a fost transformarea unui API orientat spre contul furnizorului într-o experiență web coerentă și rapidă: mai multe niveluri de contract/NLC, tokenuri care pot expira, date SAP cu formate neuniforme, operații live precum autocitirea și plata, plus informații utile disponibile doar în PDF-urile facturilor. În același timp, sincronizarea trebuia să evite request-uri excesive și să păstreze datele istorice suficient de structurate pentru analiză.

Soluția

Soluția separă accesul la furnizor de experiența aplicației. Hono orchestrează autentificarea, autorizarea pe resurse și sincronizarea; Drizzle modelează relațiile și aplică indexuri/chei unice pentru upsert și deduplicare; PostgreSQL păstrează istoricul local. PDF-urile sunt procesate server-side și rezultatul este cache-uit în JSONB cu versiune și TTL. SvelteKit consumă backend-ul prin load-uri și endpoint-uri server-side, oferă selector global de NLC și ecrane responsive, iar agregările statistice sunt calculate pe backend pentru a păstra browserul simplu și interactiv.

Complexitate notabilă

MyElectrica este un proiect personal construit ca aplicație web standalone peste fluxurile disponibile în contul MyElectrica. În loc să afișeze direct fiecare răspuns al furnizorului, backend-ul sincronizează ierarhia client → contract → loc de consum (NLC), facturile, plățile, contoarele, registrele, citirile, detaliile contractuale și convențiile de consum într-o bază PostgreSQL. Datele locale permit interogări rapide, filtrare, paginare și analiză istorică fără ca fiecare ecran să depindă de un apel live către furnizor.

Backend-ul este implementat în TypeScript cu Hono, Drizzle ORM și PostgreSQL. Autentificarea validează credențialele prin API-ul MyElectrica, creează o sesiune proprie și păstrează parola upstream criptată cu AES-256-GCM pentru reautentificarea automată atunci când tokenul furnizorului expiră. Sincronizarea folosește upsert-uri și chei unice pentru entitățile principale, normalizează datele și valorile numerice venite din API și rulează controlat, secvențial, pentru a evita rafalele de request-uri.

Facturile au un al doilea nivel de procesare: PDF-ul furnizorului poate fi descărcat server-side, transformat în text cu pdftotext și interpretat într-o structură cu perioadă de facturare, consum, TVA, sold anterior, total de plată, contor, elemente facturate și penalități. Rezultatul este persistat într-un cache JSONB versionat, cu invalidare după modificarea sursei, schimbarea versiunii parserului sau expirarea TTL-ului. Acest strat alimentează atât modalul detaliat al facturii, cât și analizele de cost și consum.

Frontend-ul SvelteKit 2 / Svelte 5 este server-rendered și folosește un strat server-side pentru comunicarea cu backend-ul, astfel încât cheia sesiunii rămâne într-un cookie httpOnly. Interfața responsive include dashboard financiar, listă de facturi cu status și inițiere de plată, istoric plăți, contoare și citiri, trimitere de autocitire în fereastra PAC, detalii de contract, editarea convenției de consum și o zonă de statistici. Statisticile agregă costul și consumul lunar, prețul mediu per kWh, structura costurilor, comportamentul plăților, sezonalitatea, comparația între ani, evoluția indexului și consumul real față de convenție.

Ca reper funcțional a fost documentată integrarea publică cnecrea/myelectrica pentru Home Assistant. Implementarea analizată aici are însă o suprafață diferită: este o aplicație full-stack standalone cu bază de date proprie, sincronizare și cache, fluxuri de plată/autocitire și dashboard-uri web dedicate. Nu sunt revendicate funcționalități ale integrării Home Assistant și nici API-ul furnizorului ca fiind construit de autorul acestui proiect.

Rezultate cheie

  • Aplicație standalone cu dashboard, facturi, plăți, citiri, contracte și statistici într-o singură interfață responsive
  • Model relațional persistent pentru clienți, contracte, NLC-uri, contoare, registre, facturi, plăți, citiri, detalii contractuale și convenții
  • Sincronizare a datelor MyElectrica cu normalizare, upsert și deduplicare pe cheile de business disponibile
  • Parser server-side pentru PDF-uri de factură, cu extragerea consumului, TVA-ului, soldului, elementelor facturate și penalităților
  • Cache JSONB versionat pentru detaliile facturilor, cu TTL și invalidare atunci când sursa sau versiunea parserului se schimbă
  • Inițiere de plată pentru facturi neachitate prin fluxul API al furnizorului și redirecționare către URL-ul de plată primit
  • Trimitere de autocitiri și actualizare a convenției de consum pentru NLC-uri care aparțin utilizatorului autentificat
  • Analize server-side pentru cost și consum lunar, preț mediu per kWh, structură de cost, comportament de plată, sezonalitate și comparație anuală
  • Interfață light/dark adaptată pentru desktop și mobil, cu selector persistent pentru mai multe locuri de consum

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.