Înapoi la portofoliu
WebappClient real

Autoservice App

Aplicație operațională pentru centralizarea clienților, vehiculelor, programărilor, comenzilor de service, lucrărilor, dosarelor RCA/CASCO, documentelor, facturilor, plăților și deconturilor.

Autoservice App

Stack principal

React 19
TypeScript
Vite 7
Tailwind CSS 4
React Router 6Radix UIPhosphor IconsWeb Storage API

Provocarea

Provocarea principală a fost modelarea coerentă a două procese care se intersectează constant într-un service: ciclul programare → comandă → lucrare → facturare → predare și ciclul RCA/CASCO de la deschiderea dosarului până la aprobare, reparație și decontare. Datele trebuie legate între client, vehicul, comandă, documente și dosar, iar tranzițiile sensibile — predare, reaprobare de deviz și închiderea dosarului — trebuie să aplice reguli operaționale clare.

Soluția

Soluția folosește o aplicație React/TypeScript modulară cu React Router pentru suprafețele operaționale și un strat KV peste localStorage pentru persistența versiunii demo. Modelele TypeScript descriu relațiile dintre clienți, vehicule, programări, comenzi, linii de lucru, dosare, devize, suplimentări, documente, facturi, deconturi, timeline și audit. Interfața aplică validări și reguli de business în modulele relevante, restricționează vizibilitatea și acțiunile în funcție de rol și oferă navigare contextuală și căutare între entități. Pentru un deployment cu date reale, documentația proiectului separă explicit necesitatea mutării autentificării, autorizării, persistenței și fișierelor într-un backend autoritativ.

Complexitate notabilă

Autoservice App transpune într-o singură interfață fluxurile zilnice ale unui service auto: evidența clienților și vehiculelor, programări, fișe de intrare, comenzi de lucru, manoperă și piese, documente, dosare de daună, facturare, plăți, deconturi și raportare. Navigarea leagă entitățile între ele, astfel încât un client poate fi urmărit spre vehiculele, comenzile, dosarele și documentele sale, iar o programare confirmată poate fi convertită direct într-o comandă service.

Fluxul de service folosește statusuri de la comandă nouă până la predarea vehiculului, prioritate, kilometraj, constatare și linii de lucru pentru servicii, manoperă, piese și consumabile. Costurile liniilor includ cantitate, preț unitar, discount și TVA, iar timpul estimat și timpul real pot fi urmărite separat. Regula de predare împiedică trecerea unei comenzi la „Predată” înainte ca aceasta să fi ajuns într-o stare finalizată sau facturată.

Modulul RCA/CASCO modelează dosarul de daună separat de comanda service. Păstrează asiguratorul, polița, datele evenimentului, inspectorul, valorile financiare și un status operațional detaliat. Numărul dosarului este verificat ca unic per asigurator, iar închiderea poate fi blocată dacă lipsesc devizul, constatarea sau factura ori dacă există sold neclarificat. Devizele sunt versionate, iar o versiune nouă creată după o aprobare existentă intră automat în starea „necesită reaprobare”. Suplimentările și timeline-ul completează istoricul operațional al dosarului.

Documentele pot fi încărcate multiplu pentru client, vehicul, comandă sau dosar, cu tip, notițe, autor, timestamp și versiune pentru devize și constatări. Interfața validează extensiile PDF/JPG/PNG/DOCX și o limită de 20 MB, apoi păstrează fișierul ca Data URL în browser. Facturile și plățile calculează starea neachitat/parțial/achitat, iar deconturile pentru dosarele de daună urmăresc valorile solicitate, aprobate și plătite. Căutarea globală și filtrele contextuale fac legătura între module, iar rapoartele agregă indicatori operaționali, RCA/CASCO și financiari și permit export CSV.

Versiunea analizată este construită ca SPA React 19 + TypeScript + Vite, cu persistență locală printr-un strat KV peste Web Storage. Datele demo sunt generate pe domenii și reseed-uite controlat printr-o versiune a datasetului. Patru roluri — administrator, recepție, tehnician și contabilitate — controlează vizibilitatea modulelor și a unor acțiuni, inclusiv costuri și tipuri de documente. Aceste permisiuni și autentificarea sunt însă exclusiv client-side în repository-ul actual: parola demo nu este verificată, iar localStorage nu reprezintă o barieră de securitate pentru date reale.

Istoricul Git arată că proiectul a pornit dintr-un prototip generat cu GitHub Spark și a fost extins ulterior cu generatoare de date pe module, navigare contextuală, fluxuri de documente, reguli de acces pe rol, audit pentru acțiuni și căutare globală. Documentația din repository definește separat contractul și direcția unui backend server-side; acel backend nu este prezent în codul analizat și nu este revendicat ca rezultat implementat.

Rezultate cheie

  • Interfață unificată pentru clienți, vehicule, programări, comenzi service, dosare RCA/CASCO, documente, facturi, rapoarte și setări
  • Patru roluri operaționale cu acces diferențiat la module și acțiuni: administrator, recepție, tehnician și contabilitate
  • Conversie directă a unei programări confirmate într-o comandă service legată de același client și vehicul
  • Comenzi de lucru cu status, prioritate, kilometraj, constatare și linii separate pentru servicii, manoperă, piese și consumabile
  • Regulă de business care blochează predarea unei comenzi înainte de finalizare sau facturare
  • Dosare RCA/CASCO cu statusuri operaționale, valori financiare, inspector, poliță și verificarea unicității numărului per asigurator
  • Devize versionate care solicită reaprobare atunci când apare o versiune nouă după o aprobare existentă
  • Blocarea configurabilă a închiderii dosarului când lipsesc documentele obligatorii sau există sold neclarificat
  • Upload multiplu de documente PDF, JPG, PNG și DOCX pentru client, vehicul, comandă sau dosar, cu metadate și versionare unde este relevantă
  • Facturi, înregistrarea plăților și deconturi pentru dosarele de daună cu stări calculate din valorile persistate
  • Audit local pentru acțiuni de creare, modificare, ștergere și operații critice din principalele module
  • Căutare globală și navigare contextuală între entitățile asociate
  • Rapoarte operaționale, RCA/CASCO și financiare filtrabile pe perioadă, cu export CSV
  • Dataset demo generat pe module și versionat pentru inițializarea coerentă a aplicației

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.