FlyMyMall
Nigeria
Web + Mobile (Laravel + Flutter)
US → Nigeria
Full-Stack Logistics Platform
Overview
End-to-End Cross-Border Logistics
FlyMyMall is a cross-border shipping and logistics platform that enables customers across Africa to shop from US, UK, and Chinese retailers and have their purchases shipped directly to their doorstep. The platform provides a complete end-to-end experience — from package registration and warehouse intake, through customs clearance, to last-mile home delivery across Nigeria.
The system serves thousands of active customers, processes tens of thousands of packages, and manages a dual-currency wallet system (USD/NGN) with multiple payment gateway integrations. We built the full stack: customer-facing web app, comprehensive admin dashboard with 10 distinct role levels, a RESTful API layer powering a Flutter mobile app, and an integrated financial management system.
The entire platform runs on Laravel with a service-oriented architecture — 75 service classes ensure that both the web admin dashboard and the mobile API call the same business logic methods, guaranteeing consistency across platforms.
Tech Stack
The Challenge
What the Client Needed
A unified logistics platform for customers to register packages shipped to a US warehouse and track them through to Nigerian delivery
Complex shipping calculations with actual weight, volumetric weight, and tiered pricing across multiple regions
A dual-currency financial ecosystem (USD and NGN) with real-time exchange rates and multiple payment gateways
A full-featured admin dashboard for warehouse staff, finance, operations, marketing, and management — each with role-specific access
Financial approval workflows with multi-level authorization for wallet credits, debits, and refund processing
A scalable platform supporting both web and mobile admin operations with a single shared business logic layer
What We Built
18 Major Features Delivered
DIY Package Entry & Tracking
Customers register packages by entering tracking numbers and item details. The system assigns unique package numbers, generates QR codes for warehouse scanning, and tracks through every status from US warehouse intake to Nigerian doorstep delivery.
Dual-Currency Wallet System
Full financial ecosystem supporting USD and NGN with automatic currency routing — transactions under $20 process in Naira at current exchange rates, $20+ in USD. Funding via Paystack, Stripe, VitalSwap, or bank transfer.
Financial Approval Workflow
Multi-level approval system for wallet credits, debits, and refunds. Auto-approval for Admin-level requests, dual approval for Finance-initiated operations, with full audit trails including initiator, approver, timestamps, and notes.
10-Role Access Control System
Granular RBAC with Super Admin, Admin, Customer, Manager, Employee, Finance, Customer Support, Warehouse Staff, Operations Admin, and Marketing roles — each with specific data visibility rules enforced at controller and service layers.
Intelligent Shipping Calculator
Multi-factor pricing engine comparing actual vs volumetric weight (L x W x H / 5000), tiered pricing ($30 flat under 4.6 lbs, $6.50/lb above), region-based home delivery fees for Lagos vs Outside Lagos.
Warehouse & BIN Management
Physical warehouse organisation with BIN shelf assignment, cutoff sessions for batch shipping, bulk status updates, and QR code scanning for rapid package identification and paperless handoff.
Marketing Analytics Dashboard
Aggregated business intelligence with revenue metrics (today, week, month), package volume tracking, service usage rates, top shipping destinations, and 6-month historical comparison with export functionality.
Multi-Channel Notifications
Firebase Cloud Messaging for push notifications, Pusher for real-time in-app updates, configurable SMTP email, and Twilio SMS — triggered on package status changes, payments, refunds, and request completions.
Pages & Screens
60+ Pages Across Customer Portal & Admin Dashboard
Customer: Dashboard, My Packages, Package Details, Weight Breakdown
Customer: Checkout, Wallet, Fund Wallet, Transaction History
Customer: Profile, Addresses, Incoming Shipments, Notifications
Customer: Shop For Me, Consolidation, Image Requests, Returns
Admin: Dashboard Analytics, Package Entry (DIY), Paid Packages
Admin: Customer Management, Wallet Management, Financial Approvals
Admin: Home Delivery Fees, Marketing Analytics, BIN Management
Admin: Warehouse Management, Cutoff Sessions, Staff Management
Admin: Revenue Reports, Audit Logs, Fraud Flags, Device Management
Architecture
How It's Built
Service-Oriented Architecture
Controllers handle HTTP only — no business logic. 75 service classes encapsulate all logic, shared between web and API controllers. Both platforms call the same methods, guaranteeing consistency.
→ Services (75 classes)
→ Models (90 models)
→ Enums (31 enums)
Security Layers
Sanctum token-based auth with configurable expiry, custom StrongPassword rule with breach checking, dual-layer role enforcement (middleware + controller), field-level data masking with reveal audit logging, and configurable reveal quotas per staff member.
API Platform
500+ RESTful endpoints powering the Flutter mobile app, organised across admin and customer namespaces. All endpoints follow a consistent JSON response format with Sanctum Bearer token authentication and role-based middleware enforcement.
Scale Metrics
500+
API Endpoints
75
Services
90
Models
31
Enums
77
API Controllers
10
User Roles
Results
What We Shipped
Production logistics platform serving thousands of customers shipping US to Nigeria
Dual-currency wallet system (USD/NGN) with 4 payment gateway integrations
10 distinct user roles with granular, field-level data access controls
500+ API endpoints for mobile app consumption with OpenAPI documentation
75-service business logic layer shared between web and mobile — zero code duplication
Financial approval workflows with auto-approve logic and dual-approval chains
Real-time notification system across Firebase, Pusher, email, and SMS channels
Comprehensive audit logging with data disclosure controls for regulatory compliance
QR code-based warehouse operations for paperless package tracking
Customer impersonation system with time-limited tokens and full session logging
Need a production-grade logistics platform or full-stack web application?
