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.

Stack principal
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
- GrileAMGEcosistem de pregătire pentru asistenți medicali: cursuri, grile, simulări, statistici și teste distribuite de profesori, pe web, iOS și Android, cu abonamente, AI și administrare editorială.
- Risa TimeEcosistem 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.
- MixboxMarketplace multi-vendor pentru produse locale, cu un singur coș pentru mai multe magazine, aplicații separate pentru client, comerciant și curier, plăți flexibile și un sistem avansat de import și administrare a cataloagelor furnizorilor.
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.