Back to Archive
Case StudyAwlad Ragab EcosystemBackend Systems

The System Wholesale Runs On.

A Laravel management platform and REST API that owns the catalogue, the customers, the orders and the money rules behind a B2B wholesale operation.

Role
Full-Stack Engineer
Timeline
Production System
Industry
Wholesale Commerce
Status
Live
awlad-ragab-wholesale-platform
Awlad Ragab Wholesale Management System
01Overview

What this system is

Awlad Ragab Wholesale Management System was built to modernise wholesale distribution workflows. A management dashboard sits over a Laravel REST API that owns products, categories, customers, representatives, orders, promotions, loyalty points, permissions and reporting — one scalable source of truth that the business operates from and that every client application reads.

02The Problem

What we needed to solve

Managing wholesale operations manually creates difficulties in handling products, customers, representatives, orders, promotions, inventory visibility, and reporting — and leaves no single source of truth for the applications that need to read any of it.

03The Solution

How we shipped it

A centralised Laravel platform that models the business as data — products, customers, representatives, orders, promotions, points, roles — and exposes it through a versioned REST API, so operations run from one dashboard and every connected client reads the same records.

04Architecture

How the system is wired

A modular architecture separating presentation, application, and data layers with REST contracts between the frontend and backend. Designed for clean scaling, observability, and predictable deployments.

Data flow
01
Presentation

Server-rendered + responsive client UI with reusable components and animation primitives.

02
Application

Business logic in service classes, validated input, role-aware authorisation, and queueable side-effects.

03
Data

Relational schema with indexed lookups, soft deletes, and migration-backed evolution.

04
Integration

REST APIs, webhooks, and third-party SDKs surfaced through thin adapters.

05Tech Stack

Engineering choices

Frontend
TypeScript
Backend
LaravelPHPMySQLREST API
06Gallery

In the wild

Executive Dashboard

Business KPIs, order statistics, sales performance, and operational insights.

Orders Management

Manage wholesale orders, statuses, approvals, and processing workflows.

Products & Categories

Centralized management of products, units, categories, and inventory structures.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

Promotions & Loyalty

Control discounts, campaigns, points programs, and customer rewards.

01 / 19
11Challenges Solved

Hard problems, handled

Impact
Challenge 01

Managing wholesale operations manually creates difficulties in handling products, customers, representatives, orders, promotions, inventory visibility, and reporting — and leaves no single source of truth for the applications that need to read any of it.

Resolution

A centralised Laravel platform that models the business as data — products, customers, representatives, orders, promotions, points, roles — and exposes it through a versioned REST API, so operations run from one dashboard and every connected client reads the same records.

Impact
Challenge 02

Maintaining performance under realistic production load.

Resolution

Indexed queries, paginated lists, image optimisation, and lean client bundles kept the platform responsive end-to-end.

12Performance

Built to stay fast

Optimised images and lazy-loaded routes for fast first paint.
Cached read-heavy endpoints and indexed all hot lookup paths.
Pruned unused dependencies and tree-shook client bundles.
Graceful loading states across every async surface.
13UI / UX

Design and interaction

Consistent design tokens — spacing, type scale, radii, motion curves.
Tuned for both desktop precision and mobile thumb reach.
Empty states, error states, and skeletons across every screen.
Reduced-motion fallbacks and accessible colour contrast.
14Production Readiness

Ready to ship and operate

Environment-scoped configuration with no secrets in source.
Migrations + seeders that recreate the full state from zero.
Error boundaries and logging on critical paths.
Reproducible builds, ready for CI deployment.
15System Features

What it does

Wholesale products management
Categories & subcategories management
Customer accounts management
Sales representatives management
Orders management system
Promotions and discounts engine
16Technical Decisions

Why we chose what we chose

Decision 01

Built on Laravel, PHP, MySQL.

Mature ecosystem, strong typing where applicable, and predictable performance characteristics for the workload.

Decision 02

REST-first integration boundary.

Keeps clients (web, mobile, partner) decoupled and trivially swappable without coupling to a single transport.

17Outcome

Results

Production
Status
11+ features
Surface area
6 technologies
Stack depth
One platform, two surfaces

The applications this system serves

The catalogue, pricing, orders, promotions and loyalty records administered here are what the Awlad Ragab customer application reads and writes through the same REST API. The mobile side ships as its own case study.

Continue exploring

Other case studies

Building something similar?

Let's scope your platform — dashboard, mobile apps, APIs, the full stack.

WhatsApp