A high-performance perfume eCommerce platform built with Laravel 12, designed to demonstrate professional backend architecture, scalable business logic, and enterprise-level API development.
This project showcases modern Laravel engineering practices including clean architecture, Redis caching, Stripe payments, and automated testing.
Luxe Parfum is a full-featured eCommerce system for premium fragrance retail.
The platform solves real-world retail challenges including:
- Accurate historical profit tracking
- High-performance product discovery
- Secure online payments
- Bilingual user experience (Arabic / English)
- Enterprise-grade reporting
The system is designed to simulate a real production-ready retail platform.
The application follows a Layered Clean Architecture approach to ensure maintainability and scalability.
Client (Browser / Mobile)
↓
Controllers (HTTP Layer)
↓
Service Layer (Business Logic)
↓
Repositories (Data Access)
↓
Models (Eloquent ORM)
↓
MySQL Database
↓
Redis Cache & Queues
- Thin Controllers
- Business logic isolated in Services
- Decoupled Data Access using Repositories
- API Resources for structured JSON responses
- Full Stripe API integration
- Payment Intents workflow
- Webhook-based order synchronization
- Real-time stock tracking
- Low stock detection
- Automatic out-of-stock status
- Redis caching
- Optimized database queries
- Background job queues
- Historical purchase & sale price snapshots
- Profit margin analytics
- Exportable reports (PDF & CSV)
- Full Arabic (RTL) and English (LTR) support
- Language-aware UI rendering
The platform provides a modern shopping experience with:
- Advanced product filtering
- Real-time search suggestions
- Persistent shopping cart
- Interactive wishlist system
- Multi-step secure checkout
- Stripe-powered payments
The wishlist system was engineered as a high-conversion user engagement tool.
Features include:
- AJAX wishlist toggling
- Public shareable wishlists
- Move-to-cart functionality
- Real-time UI updates
- Dynamic recommendation system
The platform includes modern web optimizations:
- Progressive Web App (PWA) support
- Service Worker offline caching
- OpenGraph & Twitter metadata
- SEO-friendly product URLs
Users have access to a complete account management center:
- Order history and tracking
- Wishlist management
- Address book (CRUD)
- Password and security controls
- Personalized dashboard insights
- Laravel 12
- PHP 8.2
- MySQL
- Redis
- Laravel Queues
- Stripe API
- Laravel Scout
- Scribe API Documentation
- PHPUnit
- Blade
- Vanilla JavaScript
- Chart.js
The project includes a comprehensive testing suite.
✔ 31 automated tests ✔ 155 assertions ✔ Feature tests ✔ Unit tests ✔ API tests
Run the tests:
php artisan test
Example:
php artisan test tests/Feature/Api/OrderApiTest.php
The platform includes multiple layers of security:
- Laravel Sanctum authentication
- Role-based access control
- Security headers (HSTS, CSP)
- Rate limiting
- Soft delete protection
The project includes a developer-friendly API documentation portal powered by Scribe.
Access the documentation:
/docs
Features:
- Interactive request testing
- OpenAPI export
- Postman collection generation
git clone https://github.com/your-username/ecomm-perfumes.git
composer install
npm install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm run dev
php artisan serve
Modern tooling was used to maintain code quality:
- Composer dependency management
- Vite asset bundling
- Database migrations
- Environment configuration
During development, the primary focus areas were:
- Data integrity
- System scalability
- Performance optimization
- Clean architecture
- Developer experience
This project was developed as a technical portfolio project to demonstrate:
- Advanced Laravel architecture
- REST API engineering
- Scalable backend design
- Real-world business logic implementation
- Security-first engineering mindset (Cybersecurity focus)
Yassin Ali Afifi
Cybersecurity Specialist & Backend Developer — Laravel & API Engineering
Specialized in web protection, secure code auditing, and building resilient production environments.
If you find this project useful, consider giving it a star on GitHub.