How kanishjebamathewm/truxify works
Truxify is a broker-free freight marketplace connecting manufacturers directly with drivers. Its principal workflow is load discovery and matching, booking, in-trip tracking, delivery verification, and payment; the README identifies the API as the orchestrator for apps, persistence, ML, and blockchain. The graph also preserves documented voice, document-integrity, reputation, and automation capabilities. The tree and excerpts support the major subsystem paths, but do not establish all internal call wiring, so uncertain links are omitted; the Flutter app directories are represented at their available enclosing paths.
Main entry points: index.js Main API · main.py ML engine · order Order lifecycle · locationServer.js Live tracking
Components 22
Marketplace clients
- Customer app
apps/customer - Driver app
apps/driver
API and operations
- Main API
backend/api/src/index.js - Authorization
backend/api/src/security/policyEngine.js
Freight workflow
- Order routes
backend/api/src/routes/orderRoutes.js - Order lifecycle
backend/api/src/services/order - Routing services
backend/api/src/services/routingService.js - Live tracking
backend/api/src/sockets/locationServer.js - Delivery proof
backend/api/src/services/order/deliveryVerificationService.js
ML and assistance
- ML engine
backend/ml/app/main.py - Load matching
backend/ml/app/models/bilateral_matcher.py - Profit and ETA
backend/ml/app/models/driver_profit.py - Voice assistant
backend/llm/llm_service.py
Trust and integrations
- Supabase data
- Escrow services
backend/api/src/services/escrowService.js - Polygon contracts
- Document integrity
backend/api/src/services/documentService.js - Driver reputation
backend/api/src/services/reputation.js - Workflow automation
automation/n8n
Other components
- Manufacturer
- Truck driver
- OSRM routing
Connections 25
- Manufacturer → Customer app: places loads
- Truck driver → Driver app: finds loads
- Customer app → Main API: REST and sockets
- Driver app → Main API: REST and sockets
- Main API → Order routes: dispatches requests
- Order routes → Order lifecycle: handles lifecycle
- Order lifecycle → Supabase data: reads and writes
- Main API → ML engine: requests inference
- ML engine → Load matching: runs matching
- ML engine → Profit and ETA: predicts cost and ETA
- Main API → Routing services: requests routes
- Routing services → OSRM routing: gets route estimates
- Main API → Live tracking: serves live updates
- Live tracking → Driver app: streams location
- Live tracking → Customer app: streams location
- Order lifecycle → Delivery proof: verifies delivery
- Main API → Escrow services: coordinates payment
- Escrow services → Polygon contracts: locks and releases funds
- Main API → Document integrity: handles documents
- Document integrity → Polygon contracts: anchors integrity
- Main API → Driver reputation: supports reputation
- Driver reputation → Polygon contracts: records reputation
- Main API → Voice assistant: serves voice queries
- Main API → Authorization: checks permissions
- Workflow automation → ML engine: triggers retraining