Înapoi la portofoliu
PlatformăClient realReprezentativ

Risa Time

Ecosistem digital pentru preluarea mașinii de la client, transportul la o spălătorie parteneră și returnarea în siguranță, coordonat prin aplicații separate pentru client și șofer, panou operațional și tracking în timp real.

Risa Time

Stack principal

TypeScript
Node.js
Express 5
PostgreSQL
PrismaRedisBullMQSocket.IOZodJWTbcryptPinoVitestStripeGoogle Maps PlatformGoogle Routes APIGoogle Geocoding APIFirebase Cloud MessagingNodemailer / SMTPAWS SDK / S3-compatible storagePDFKitSvelteKitSvelte 5Tailwind CSS 4FlutterDartRiverpodGoRouterDioFlutter Secure StorageLocal AuthenticationGoogle Maps FlutterGeolocatorAstro 6Docker ComposeGitHub ActionsFastlaneGoogle Play ConsoleApp Store Connect

Provocarea

Coordonarea sigură a unei mașini între client, șofer, spălătorie și operatori presupune mult mai mult decât o rezervare: plata trebuie confirmată înainte de publicarea comenzii, doi șoferi nu trebuie să poată revendica aceeași cursă, fiecare tranziție trebuie validată, iar preluarea și returul au nevoie de dovezi și proximitate GPS. În paralel, sistemul trebuie să păstreze istoricul chiar dacă utilizatorii sau spălătoriile își schimbă datele, să sincronizeze trei interfețe în timp real și să recupereze corect plăți, notificări sau facturi eșuate.

Soluția

Un API central TypeScript pe Node.js/Express, PostgreSQL și Prisma deține regulile critice și mașina de stări. Tranzacțiile bazei de date asigură revendicarea atomică a comenzilor, snapshot-urile și auditul protejează istoricul, iar Socket.IO sincronizează aplicațiile fără a înlocui starea durabilă din API. Flutter și Riverpod oferă două aplicații mobile separate pentru fluxurile foarte diferite ale clientului și șoferului; SvelteKit deservește operațiunile interne, iar Astro păstrează landing page-ul rapid. Stripe, Google Maps Platform, Firebase Cloud Messaging, SMTP, storage local sau S3-compatible, PDFKit, Redis/BullMQ și GitHub Actions acoperă plățile, traseele, notificările, documentele, joburile și release-urile.

Complexitate notabilă

Risa Time transformă spălarea auto într-un serviciu logistic complet: clientul configurează ridicarea, alege o spălătorie eligibilă, stabilește modul de returnare, propune prețul și plătește din aplicație; un șofer verificat revendică apoi comanda, preia mașina, documentează starea ei, o transportă la partener și o livrează înapoi. Clientul, șoferul și echipa operațională urmăresc aceeași comandă, dar prin interfețe și permisiuni adaptate responsabilităților lor.

Produsul este împărțit în cinci codebase-uri cu roluri clare. API-ul Node.js/Express concentrează identitatea, plățile, regulile de business și mașina de stări. Aplicația Flutter pentru clienți acoperă contul, mașinile, profilul de facturare, wizard-ul de comandă, plata Stripe, tracking-ul, istoricul, facturile, rating-urile, disputele și suportul. Aplicația Flutter pentru șoferi are propriul onboarding KYC, disponibilitate, anunțuri de comenzi, contraoferte, cursa activă, fotografii, navigație, tracking în fundal, venituri și retrageri. Panoul SvelteKit oferă vizibilitate operațională asupra comenzilor, clienților, șoferilor, spălătoriilor, facturilor, plăților, disputelor, suportului și traseelor. Landing page-ul Astro explică serviciul și trimite cererile de contact, parteneriat și recrutare către același backend.

Comanda este controlată server-side prin 11 stări explicite, de la AWAITING_PAYMENT și PENDING până la preluare, spălătorie, retur, COMPLETED sau CANCELLED. O comandă devine vizibilă șoferilor numai după confirmarea plății. Acceptarea nu este o asignare manuală din admin: primul șofer eligibil care finalizează revendicarea câștigă comanda printr-o tranzacție atomică ce blochează simultan comanda și disponibilitatea șoferului. Tranzițiile sensibile verifică actorul, starea curentă, dovezile foto, spălătoria aleasă și proximitatea GPS; unele stări, precum plecarea de la client după preluare sau finalizarea, nu pot fi setate arbitrar din aplicație.

Tracking-ul combină REST pentru starea durabilă cu Socket.IO pentru evenimente în timp real. Sunt păstrate coordonate, istoric de locație și polylines separate pentru traseele planificate și cele parcurse, pe segmentele către client, către spălătorie și la retur. Pentru returnarea la locația curentă a clientului, aplicația client poate transmite poziția live, iar aplicația șoferului pornește serviciul de localizare în fundal numai în stările de deplasare.

Plata este proiectată ca flux recuperabil. Stripe PaymentIntent este creat idempotent, comanda rămâne în AWAITING_PAYMENT dacă inițializarea plății eșuează, iar clientul poate relua plata fără a crea o nouă comandă. Webhook-ul confirmă finanțarea, actualizează ledger-ul și publică anunțul către șoferi. Contraofertele pot genera o diferență încasată off-session; când aceasta nu poate fi retrasă, suma este trecută într-un sold datorat și recuperată ulterior. Anulările și refund-urile păstrează sincronizarea dintre Stripe, comandă, ledger și soldul șoferului.

Pentru reziliență și trasabilitate, datele importante sunt înghețate în snapshot-uri la momentul comenzii: client, șofer, spălătorie, facturare și versiunea documentelor legale. Audit log-ul înregistrează operațiunile sensibile, assignment logs păstrează istoricul șoferilor, iar un transactional outbox livrează notificările web pentru administratori cu retry și recuperarea evenimentelor rămase în procesare. Redis și BullMQ rulează curățarea comenzilor abandonate, recuperarea soldurilor, retry-ul facturilor, curățarea fotografiilor și tokenurilor, plus procesarea outbox-ului.

Livrarea este automatizată separat. Backend-ul, adminul și landing page-ul se publică la push în main prin GitHub Actions, SSH și Docker/VPS, cu migrații și health checks. Aplicația client are build și deploy web automat, plus workflow-uri manuale de release pentru Google Play și TestFlight; aplicația șoferului are workflow-uri echivalente pentru Android și iOS, cu semnare, version bump, cache și upload în store-uri.

Rezultate cheie

  • 5 aplicații/codebase-uri coordonate: API, panou admin, aplicație client, aplicație șofer și landing page
  • 11 stări server-side pentru ciclul complet al comenzii, de la plată la pickup, spălătorie, retur, finalizare sau anulare
  • 3 categorii de actori autentificați — client, șofer și administrator — plus niveluri ADMIN și SUPER_ADMIN pentru operațiuni interne
  • 2 aplicații Flutter distincte: client pe web, iOS și Android; șofer pe iOS și Android
  • 2 etape de dovezi foto, pickup și return, cu minimum 2 și maximum 6 imagini per etapă în aplicația șoferului
  • 3 segmente logistice urmărite și 4 polylines persistente pentru trasee planificate versus parcurse la dus și retur
  • 6 joburi recurente BullMQ pentru curățare, debt recovery, retry facturi, outbox și igiena tokenurilor/fotografiilor
  • 5 ținte de release automatizate pentru aplicațiile utilizatorilor: customer web, customer Android, customer iOS, driver Android și driver iOS
  • Notificări persistente in-app, push mobil prin FCM, email SMTP și web push pentru echipa administrativă
  • Facturi PDF interne pentru persoane fizice sau companii, cu numerotare anuală și retry automat la eșec

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.