How wityliti/witylogix works
Witylogix is a multi-tenant, open-source e-commerce delivery logistics platform. Its central workflow spans checkout pricing and order intake, route planning and dispatch, driver execution with proof of delivery, and customer tracking. The API server registers domain routes and provides real-time and background-work infrastructure; separate dashboard, driver, and tracking apps serve operators, drivers, and customers. The README documents broad product capabilities, while sampled source confirms only selected runtime connections; unsupported implementation links are omitted.
Main entry points: routes.ts Routes & Stops · server.ts Fastify API · queue.ts Background Jobs · App.tsx Public Tracking
Components 26
API Platform
- Fastify API
apps/api/src/server.ts - Live Updates
apps/api/src/lib/socket.ts - Background Jobs
apps/api/src/lib/queue.ts - Notification Worker
apps/api/src/workers/notification-worker.ts
Delivery Operations
- Order Management
apps/api/src/routes/orders.ts - Routes & Stops
apps/api/src/routes/routes.ts - Delivery Tracking
apps/api/src/routes/tracking.ts - Proof of Delivery
apps/api/src/routes/proof-of-delivery.ts - Zone Pricing
apps/api/src/routes/zones.ts - Returns / RMA
apps/api/src/routes/returns.ts - Analytics
apps/api/src/routes/analytics.ts
User Applications
- Dispatch Dashboard
apps/dashboard/src/app/(dashboard)/dispatch/page.tsx - Customer Portal
apps/customer-portal/src/app/page.tsx - Public Tracking
apps/tracking-page/src/App.tsx - Driver Mobile App
apps/driver-app/src/screens/RoutesScreen.tsx
Commerce & Integrations
- Checkout Rates
apps/api/src/routes/checkout/rates.ts - Integration Catalog
apps/api/src/routes/integrations.ts - Shopify Webhooks
apps/shopify-app/app/routes/app.webhooks.receive.tsx
Domain Engines
- Workflow Engine
packages/framework/src/workflow/engine.ts - Route Optimization
apps/api/src/workers/optimization-worker.ts - Full-Text Search
packages/core/src/search/search-engine.ts - Fleet Management
packages/core/src/fleet/fleet-management-engine.ts - CRM Sync
packages/core/src/crm/crm-sync-engine-v3.ts
Other components
- Merchant / Dispatcher
- Customer
- Driver
Connections 25
- Merchant / Dispatcher → Dispatch Dashboard: manages deliveries
- Customer → Public Tracking: tracks delivery
- Driver → Driver Mobile App: executes route
- Fastify API → Order Management: registers routes
apps/api/src/server.ts - Fastify API → Routes & Stops: registers routes
apps/api/src/server.ts - Fastify API → Delivery Tracking: registers routes
apps/api/src/server.ts - Fastify API → Live Updates: initializes sockets
apps/api/src/server.ts - Fastify API → Background Jobs: shuts down queues
apps/api/src/server.ts - Routes & Stops → Background Jobs: enqueues jobs
apps/api/src/routes/routes.ts - Routes & Stops → Live Updates: publishes updates
apps/api/src/routes/routes.ts - Public Tracking → Delivery Tracking: loads tracking
- Public Tracking → Live Updates: receives live updates
apps/tracking-page/src/App.tsx - Driver Mobile App → Routes & Stops: loads routes
- Checkout Rates → Zone Pricing: uses zone pricing
- Shopify Webhooks → Order Management: forwards order updates
- Notification Worker → Background Jobs: consumes jobs
apps/api/src/workers/notification-worker.ts - Workflow Engine → Background Jobs: orchestrates work
- Returns / RMA → Workflow Engine: runs return lifecycle
- Route Optimization → Routes & Stops: optimizes routes
- Proof of Delivery → Delivery Tracking: updates delivery status
- Integration Catalog → Shopify Webhooks: configures commerce
- Full-Text Search → Order Management: searches orders
- Analytics → Routes & Stops: reports performance
- Fleet Management → Dispatch Dashboard: supports fleet operations
- CRM Sync → Integration Catalog: syncs CRM data