Înapoi la portofoliu
PlatformăClient realReprezentativ

Trade Container

Platformă web pentru publicarea cererilor de transport, declararea capacității disponibile, ofertare și coordonarea curselor de containere, cu KYC, abonamente, chat, documente și administrare pe roluri.

Trade Container

Stack principal

Node.js
TypeScript 5.7
Express 4
PostgreSQL
node-postgresZodJWTbcryptSocket.IOnode-cronMulterStripe Checkout & WebhooksNodemailerResendNext.js 16React 18Tailwind CSS 4Radix UIshadcn/uiGoogle Maps Places APIPM2

Provocarea

Provocarea principală a fost transformarea unei baze existente într-un produs self-hosted care coordonează reguli diferite pentru client, transportator și administrator: eligibilitate KYC, acces în funcție de abonament, cote de utilizare, cereri de transport, capacitate disponibilă, oferte, selectarea unui singur partener, conversații, statusuri operaționale, documente, evaluări și dispute. Migrarea de la Supabase la Express și PostgreSQL a mutat în aplicație responsabilități precum autentificarea, rotația sesiunilor, schema și migrațiile, storage-ul, webhook-urile, notificările și mentenanța periodică.

Soluția

Backend-ul TypeScript separă domeniile în rute pentru autentificare, profiluri, expediții, căutare, camioane, oferte, conversații, mesaje, documente, KYC, recenzii, abonamente, Stripe, dispute, notificări, setări și administrare. Zod validează contractele API, PostgreSQL aplică enum-uri, chei externe, unicități și indexuri, iar JWT-urile scurte sunt completate de refresh token-uri hash-uite și sesiuni per dispozitiv. Frontend-ul Next.js oferă dashboard-uri dedicate rolurilor, formularul logistic pentru porturi și opriri, căutare și filtrare, gestionarea ofertelor și navigarea către chat după acceptare. Socket.IO și emailurile propagă evenimentele importante, iar joburile programate tratează expirarea ofertelor și a cererilor vechi și lipsa actualizărilor de status.

Complexitate notabilă

Trade Container conectează companiile care au containere de transportat cu transportatori și operatori de flotă. Clientul construiește o cerere pornind de la portul și terminalul de preluare, destinația de tip port sau adresă, datele operaționale, tipul și numărul containerelor, marfa, bugetul și eventuale opriri pentru vamă, cântărire, încărcare sau descărcare. Transportatorii își pot publica disponibilitatea pe rute și perioade, cu echipamentul, containerele acceptate, capacitatea și tariful, apoi pot căuta expediții și înregistra oferte cu preț, disponibilitate, durată estimată, mesaj și termen de valabilitate.

Acceptarea unei oferte asociază transportatorul expediției, trece cursa în starea confirmată, respinge alternativele încă pending și inițializează conversația dedicată. Clientul este direcționat către chat, iar participanții pot comunica în timp real și pot urmări cursa prin stările pending, offer_received, confirmed, picked_up, in_transit, delivered, completed, disputed sau cancelled. Interfețele reunesc ruta, marfa, oferta acceptată, documentele încărcate, notificările și evaluarea de după finalizare, iar disputele pot fi analizate de administrator.

Regulile comerciale sunt aplicate diferențiat. Clientul are nevoie de KYC aprobat și de un abonament activ sau în trial pentru a publica expediții, iar transportatorul are nevoie de KYC aprobat pentru a trimite oferte. Stripe este folosit pentru abonamentul platformei — checkout, portal de facturare și sincronizare prin webhook-uri — în timp ce plata transportului este negociată și decontată direct între companii; fluxul curent nu implementează escrow sau payout-uri. Pentru planurile client, cota de expediții este revendicată atomic înainte de inserare și este restituită dacă salvarea cererii eșuează.

Produsul pornește de la o bază Next.js/Supabase care a fost extinsă și migrată către un backend propriu Express și PostgreSQL. Implementarea actuală gestionează autentificarea JWT, refresh token-uri hash-uite și sesiuni per dispozitiv, contracte API validate cu Zod, Socket.IO, fișiere locale, emailuri SMTP cu fallback Resend și joburi node-cron pentru expirări și remindere. Frontend-ul Next.js folosește cookie-uri httpOnly și un store comun care coordonează refresh-ul sesiunii între cererile HTTP și conexiunea realtime. Deployment-ul demonstrat rulează frontend-ul și backend-ul ca procese PM2 separate.

Rezultate cheie

  • 3 suprafețe operaționale confirmate: client/shipper, transportator și administrator, cu navigație, dashboard-uri și permisiuni distincte
  • Formular de expediere cu port și terminal, destinație port sau adresă, până la 10 opriri, containere, marfă, date, buget și instrucțiuni
  • Registru de disponibilitate pentru camioane, cu rută, perioadă, echipament, containere acceptate, capacitate și tarif
  • Căutare și filtrare pentru expediții și capacitate de transport după rută, dată, container, tip de transport și preț
  • Model de ofertă unic per transportator și expediție, cu preț, disponibilitate, durată, mesaj, valabilitate și stări operaționale
  • Selectarea unei oferte actualizează expediția, respinge alternativele pending și inițializează conversația dintre cele două companii
  • Chat text în timp real pe expediție, listă de conversații, unread count și marcarea mesajelor ca citite
  • Flux operațional pentru expediții: pending, offer_received, confirmed, picked_up, in_transit, delivered, completed, disputed și cancelled
  • KYC cu upload de documente, statusuri pending/submitted/approved/rejected și aprobare sau respingere administrativă
  • Trial de 30 de zile și planuri Stripe cu cote de expediții, checkout, portal de facturare și webhook-uri pentru ciclul abonamentului
  • Revendicare atomică a cotei de expediții înaintea inserării, cu compensare dacă salvarea cererii eșuează
  • Upload și listare pentru documente logistice și KYC, cu formate imagine/PDF și limită de 10 MB
  • Recenzii cu scor general, criterii logistice, răspuns la review și agregarea ratingului transportatorului
  • Dispute asociate curselor și rezoluție administrativă, cu audit pentru acțiuni critice de administrare
  • Emailuri tranzacționale prin SMTP cu fallback Resend pentru cont, KYC, oferte, mesaje, statusuri și abonamente
  • Joburi programate pentru expirarea ofertelor și expedițiilor vechi și pentru reminderele de actualizare a statusului
  • Sesiuni per dispozitiv, rotație de refresh token, revocare individuală și coordonarea refresh-ului concurent în frontend
  • Istoric de curse finalizate pentru client și transportator, cu totaluri și filtrare pe lună, trimestru, an sau întreaga perioadă

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.