Modern Iraqi Food Truck
Management
Platform
A comprehensive, cloud-based platform designed specifically for managing dispersed food truck operations with enterprise-grade multi-tenancy.
01. System Overview
Areeka & Kerek is an integrated solution combining multi-tenant franchise management, advanced real-time POS, and a customer-facing loyalty ecosystem.
Unified Operations
Manage multiple truck locations from a single dashboard with centralized inventory and staff control.
Real-time Performance
Instant order processing with live cart updates using Livewire 3 websocket connections.
Native Bilingual
Complete English/Arabic interface support for diverse operational teams and customers.
Data-Driven
Role-based access control with deep analytics into sales, items, and peak operational times.
| Component | Technology | Purpose |
|---|---|---|
| Framework | Laravel 12 | Enterprise PHP framework, Security, ORM |
| Admin UI | Filament 4 | Modern admin panel builder |
| Real-time | Livewire 3 | Live updates without page refresh |
| Database | PostgreSQL 15+ | ACID-compliant relational database |
02. Core Architecture
System Layers
┌─────────────────────────────────────────────────────────┐
│ Presentation Layer (UI) │
│ ┌──────────────────────┬──────────────────────────┐ │
│ │ Admin Panel │ Customer Frontend │ │
│ │ (Filament 4) │ (Blade/Livewire) │ │
│ └──────────────────────┴──────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
↓ HTTP/Blade
┌─────────────────────────────────────────────────────────┐
│ Application Layer (Logic) │
│ ┌────────────────────────────────────────────────┐ │
│ │ • Controllers • Services │ │
│ │ • Policies • Jobs & Queues │ │
│ └────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
↓ Eloquent
┌─────────────────────────────────────────────────────────┐
│ Domain Layer (Business Logic) │
│ ┌────────────────────────────────────────────────┐ │
│ │ • 8 Eloquent Models │ │
│ │ • Relationships, Scopes, Business Rules │ │
│ └────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
↓ Query Builder
┌─────────────────────────────────────────────────────────┐
│ Infrastructure Layer (Data & Storage) │
│ ┌────────────────────────────────────────────────┐ │
│ │ PostgreSQL Database • Redis Cache │ │
│ └────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
Data Flow
Typical request lifecycle for customer interactions vs. real-time POS updates.
Customer App (Browser)
│ HTTP Request
↓
Laravel Server
1. Route & Middleware (Auth/Tenant)
2. Controller Action
3. Service Layer (Business Logic)
4. Database Query (Eloquent)
│
← Response (JSON/HTML)
Multi-Tenancy
Single application instance serving multiple isolated franchise tenants.
Incoming Request
│ brooklyn.areeka.iq
↓
Tenant Middleware
│ Resolves 'Brooklyn' Tenant
│ Scopes DB Queries to Tenant ID
↓
Shared Infrastructure
│ PostgreSQL (Single DB)
│ Redis (Tenant-scoped Keys)
03. Platform Features
Sales & Order Management
- ✓ POS System: Real-time cashier interface.
- ✓ Order Pipeline: 5-Stage status tracking.
- ✓ Scheduling: Pickup time selection.
- ✓ Audit: Complete order history log.
Menu Management
- ✓ Structure: Categories & Products (30+ items).
- ✓ Pricing: Multi-currency (IQD/USD).
- ✓ Dietary: Vegan/GF/Allergen indicators.
- ✓ Media: Up to 5 high-res images per item.
Operational Management
- ✓ Locations: GPS & Operating hours per truck.
- ✓ QR Codes: Digital menu access generation.
- ✓ Access: Staff scoped to specific trucks.
Loyalty Program
- ✓ Points: 1pt per $1 spent.
- ✓ Tiers: Bronze, Silver, Gold, Platinum.
- ✓ Multipliers: Up to 2.0x earning power.
- ✓ Rewards: Redemption for order discounts.
04. Demo Media
Unable to play? Open the demo video directly.
What This Demo Shows
- -Admin dashboard workflows for tenant and menu operations.
- -POS cashier flow from item selection to payment completion.
- -Customer lifecycle data across orders, payments, and loyalty tracking.
- -Reporting and analytics views used for operational decisions.
Screenshot Gallery
Click any screenshot to open full size and browse with keyboard arrows.
05. User Roles & Capabilities
Permission Matrix
106 granular permissions across 4 distinct roles.
| Action | Super Admin | Tenant Mgr | Staff |
|---|---|---|---|
| Manage Tenants | ✅ Yes | ❌ No | ❌ No |
| View Reports | ✅ Yes | ✅ Own Only | ⚠ Limited |
| Process Orders | ✅ Yes | ✅ Yes | ✅ Yes |
| Manage Menu | ✅ Yes | ✅ Yes | ❌ No |
06. Admin Dashboard
Widgets & Analytics
- ▪ Real-time Sales: Revenue by hour, peak times.
- ▪ Order Queue: Interactive pending order tracking.
- ▪ Revenue Charts: 7/30/90-day interactive trends.
- ▪ Top Products: Best sellers by count and revenue.
Management Modules
- ▪ Menu: Products, Categories, Availability toggles.
- ▪ Operations: Truck locations, Staff rostering.
- ▪ Content: Cultural stories, Media library.
- ▪ System: Tenant config, Localization settings.
07. POS System
┌───────────────────────────────────────────────────────────┐ │ AREEKA & KEREK POS │ ├────────────────┬──────────────────────┬───────────────────┤ │ │ │ 👤 Select │ │ PRODUCTS │ SHOPPING CART │ Customer │ │ │ │ │ │ Search: ___ │ ┌──────────────────┐ │ Walk-in Option │ │ / │ │ Item 1 × 2 │ │ │ │ [All Cats] │ │ 50,000 IQD │ │ │ │ │ ├──────────────────┤ │ TOTAL ITEMS: 3 │ │ ┌──────────────┤ │ Subtotal: 80,000 │ │ SUBTOTAL: 130K │ │ │ Kebab │ │ Discount: -10K │ │ DISCOUNT: 10K │ │ │ 50,000 IQD │ │ ═════════════════│ │ TOTAL: 120K │ │ │ [Add +] │ │ TOTAL: 70,000 IQD│ │ │ │ └──────────────┘ │ [Remove Items] │ │ [ Complete ] │ │ │ └──────────────────┘ │ [Ctrl+Enter] │ └────────────────┴──────────────────────┴───────────────────┘
Smart Features
Bilingual live search (300ms debounce), Category pill filters, and keyboard shortcuts (/ to search, Ctrl+Enter to pay).
Cart Experience
Real-time Livewire updates, session persistence, quick quantity adjustments, and visually distinct totals.
08. Customer Frontend
-
1
Menu Browsing
Mobile-first design with category filtering, bilingual search, and dietary indicators.
-
2
Ordering Process
Seamless cart management, pickup time scheduling, and special request handling.
-
3
Engagement
Order history tracking, re-order capabilities, and integrated loyalty dashboard.
09. Loyalty Program
Points = Order Total (IQD) × 0.01 × Tier Multiplier
| Tier | Spending Threshold | Multiplier | Benefits |
|---|---|---|---|
| 🥉 Bronze | $0 - $1,999 | 1.0x | Standard earning rate |
| 🥈 Silver | $2,000 - $4,999 | 1.25x | +25% points, priority |
| 🥇 Gold | $5,000 - $9,999 | 1.5x | +50% points, exclusive menu |
| 💎 Platinum | $10,000+ | 2.0x | +100% points, concierge |
10. Data Models & ERD
┌────────────┐ 1:N ┌────────────┐ 1:N ┌────────────┐
│ TENANT │ ───────────> │ TRUCK │ ───────────> │ ORDER │
└────────────┘ └────────────┘ └────────────┘
│ │ │
│ 1:N │ 1:N │ 1:N
v v v
┌────────────┐ ┌────────────┐ ┌───────────────┐
│ CUSTOMER │ <─────────── │ USER │ │ ORDER_ITEMS │
└────────────┘ N:1 └────────────┘ └───────────────┘
│
│ N:1
v
┌────────────┐
│ PRODUCTS │
└────────────┘
Product Model
Translations, Media, Pricing (USD/IQD), Dietary Flags
Customer Model
Loyalty Points, Tier Status, Order History
Loyalty Trx
Type (Earn/Redeem), Balance Snapshot, Expiry
11. Technical Excellence
Engineering Foundations
- -Tenant-aware architecture with strict scope boundaries.
- -Livewire-driven real-time UI updates with low operational overhead.
- -Role-based access control enforced across API and admin surfaces.
- -Modular domain models for products, orders, and loyalty workflows.
Operational Readiness
- -Clear auditability across order lifecycle and administrative actions.
- -Designed for multi-location rollout with centralized governance.
- -Scalable data model suitable for growth in tenants, trucks, and users.
- -Bilingual UX support for mixed English and Arabic operations.
12. Security
Security & Compliance Controls
- RBAC with 106 granular permissions
- CSRF & XSS Protection
- BCRYPT Password Hashing
- SQL Injection Prevention
- Rate Limiting on APIs
- Automated Audit Logging
13. Performance
Scalability Profile
The platform is tuned for responsive tenant operations with efficient query scoping, cache-backed session state, and low-latency order processing paths.