gora.
Last-mile delivery / multi-tenant platforma

Last-mile Delivery Platform

Multi-tenant last-mile pristatymo platforma: viena kodo bazė, penkios sąsajos, šešios rolės ir savitas lojalumo programa.

Regionas
Majamis, Florida
Vaidmuo
Tech lead, fullstack kūrėjas
Laikotarpis
2024–2026
Sritis
Last-mile delivery / multi-tenant platforma

Visi ekrano nuotraukos turi demo-duomenis: prekės ženklas, prekės, klientų kontaktai ir realūs domenai užmaskuoti pagal NDA. Sekcijų pavadinimai ir verslo logika aprašyti be priskyrimo konkrečiam užsakovui.

Projekto santrauka. Toliau — trys lygiagretūs pasakojimai, kiekvienas savai auditorijai: verslo logika ne-techniniams skaitytojams, admin-panel apžvalga operacijų komandai ir techninis stekas inžinieriams.

Kiekviena sekcija savarankiška.

Kas viduje

  • Vienuolika aplikacijų viename monorepe: API, web-vitrina, admin, trys Telegram mini-app, trys Python botai, du mobile skeletai.
  • 36 NestJS-moduliai ir 43 TypeORM entity — nuo orders iki audit-trail.
  • Realaus laiko vairuotojo trekinimas per Socket.IO + Redis pub/sub į Python botus.
  • Savita lojalumo programa: wallet, cashback, referal QR-programa, premium tier su išplėstom galimybėm.
  • Bulk unikalių promo-kodų generavimas ir QR-kampanijos su konversijų trekinimu.
  • Kasos finansinis suderinimas: cash drop, EOD, COG, P&L per dieną.
  • Savita įvykių analitika ant client_events + rrweb replay (auth-only, masked inputs).
  • Smart path-filtras CI'e perstato tik pakeistus servisus iš devynių.
  • Audit trail su pakeitimų grupavimu ir kontekstiniu reikšmių formatavimu.
  • Telegram WebApp HMAC, OTP per Twilio A2P + SMS-Gate Android round-robin.

Stekas

  • Turborepo monorepo
  • NestJS 10
  • TypeORM + PostgreSQL 16
  • Redis 7
  • Next.js 14
  • React 18 / 19
  • Vite 6 / 7
  • Tailwind CSS
  • Zustand + React Query
  • Recharts
  • Socket.IO
  • aiogram 3 (Python)
  • Telegram WebApp HMAC
  • Docker compose
  • GitHub Actions → GHCR
  • nginx + Let's Encrypt
  • Twilio A2P
  • SMS-Gate Android
  • Pushover
  • rrweb session replay
  • BTC / ETH / USDT / USDC / TRC-20
Trys pasakojimai

Vienas projektas — trys perspektyvos