How huzaifatg/loadflow works
LoadFlow is a multi-tenant logistics SaaS. Users manage deliveries, drivers, trucks, and load plans through the dashboard; recommendation and load-planning services support resource assignment. A second major workflow ingests CSVs through parsing, adaptation, validation, mapping, preview, and transactional commit. Authentication resolves a user’s company, while API routes serve domain operations and Prisma persists data. The graph retains README-documented schedule and settings capabilities; relationships for unsampled modules are limited to documented or indexed wiring.
Main entry points: engine.ts Import pipeline · prisma.ts Prisma database · auth.ts Auth context · route.ts Delivery management
Components 25
Web experience
- Landing page
components/landing/LandingPage.tsx - Dashboard workspace
app/(dashboard)/dashboard/page.tsx - Login and signup
app/(auth)/login/page.tsx
Identity and tenancy
- Auth context
lib/auth.ts - Supabase session
lib/supabase/server.ts - Tenant safeguards
lib/security/tenant.ts
Logistics operations
- Delivery management
app/api/deliveries/route.ts - Item weights
lib/delivery-items.ts - Drivers and trucks
app/(dashboard)/drivers/page.tsx - Load planning
app/(dashboard)/loads/page.tsx - Plan validation
lib/services/load-plan-validation.ts - Recommendations
lib/services/recommendation-engine.ts - Schedule view
app/(dashboard)/schedule/page.tsx - Company settings
app/(dashboard)/settings/page.tsx
CSV ingestion
- CSV import API
app/api/import/csv/route.ts - Import pipeline
lib/import/pipeline/engine.ts - Import contract
lib/import/contract/types.ts - Parse and adapt
lib/import/csv/parser.ts - Import validation
lib/import/validation/engine.ts - Field mapping
lib/import/mapping/engine.ts - Import preview
lib/import/preview/engine.ts - Import commit
lib/import/commit/engine.ts - Commit persistence
lib/import/commit/persistence.ts
Persistence
- Prisma database
lib/prisma.ts
Other components
- User
Connections 33
- User → Landing page: visits
- User → Login and signup: signs in
README.md - User → Dashboard workspace: manages logistics
README.md - Landing page → Dashboard workspace: starts workflow
README.md - Login and signup → Auth context: authenticates via
README.md - Dashboard workspace → Auth context: resolves company
app/(dashboard)/dashboard/page.tsx - Auth context → Supabase session: checks session
lib/auth.ts - Auth context → Prisma database: resolves membership
lib/auth.ts - Delivery management → Auth context: authenticates
app/api/deliveries/route.ts - Delivery management → Tenant safeguards: checks tenant access
app/api/deliveries/route.ts - Delivery management → Item weights: computes weights
app/api/deliveries/route.ts - Delivery management → Prisma database: reads and writes
app/api/deliveries/route.ts - Drivers and trucks → Prisma database: manages records
README.md - Load planning → Recommendations: requests assignments
README.md - Recommendations → Item weights: converts weights
lib/services/recommendation-engine.ts - Recommendations → Prisma database: loads candidates
app/api/recommendations/route.ts - Load planning → Plan validation: validates plans
- Schedule view → Prisma database: shows schedule data
README.md - Company settings → Prisma database: updates company
README.md - User → CSV import API: submits CSV
README.md - CSV import API → Auth context: authenticates
app/api/import/csv/route.ts - CSV import API → Tenant safeguards: checks tenant access
app/api/import/csv/route.ts - CSV import API → Import pipeline: invokes import
app/api/import/csv/route.ts - Import pipeline → Parse and adapt: parses and adapts
lib/import/pipeline/engine.ts - Import pipeline → Import validation: validates
lib/import/pipeline/engine.ts - Import pipeline → Field mapping: maps fields
lib/import/pipeline/engine.ts - Import pipeline → Import preview: previews changes
lib/import/pipeline/engine.ts - Import pipeline → Import commit: commits approved rows
lib/import/pipeline/engine.ts - Import commit → Commit persistence: persists rows
lib/import/commit/engine.ts - Commit persistence → Prisma database: writes transaction
- Import pipeline → Import contract: uses document contract
lib/import/pipeline/engine.ts - Import preview → Import contract: consumes and enriches
lib/import/preview/engine.ts - Import commit → Import contract: guards document state
lib/import/commit/engine.ts