متجر رونق لبيع معدات النظافة وتقديم خدمات نظافة المنازل والسيارات
تفاصيل العمل
(رونق هو نظام متكامل ومتطور لإدارة متجر إلكتروني
• التجارة الإلكترونية
• إدارة الخدمات
• إدارة الفنيين - تتبع المهام والأداء
• التقارير والتحليلات - رؤى شاملة للأعمال
نقاط القوة الرئيسية
معمارية احترافية متطورة
الميزة الوصف
MVC Architecture بنية تطبيق منظمة وقابلة للصيانة والتوسع
Service Layer Pattern فصل منطق الأعمال في PayTabsService و ZatcaService
Eloquent ORM نماذج بيانات متطورة مع علاقات معقدة (Polymorphic, HasMany, BelongsTo)
RESTful API v1 واجهة برمجية كاملة للتطبيقات المحمولة
Multi-Panel System 4 لوحات تحكم (Admin, Technician, Customer, Store)
نظام دفع PayTabs متكامل
الملف: app/Services/PayTabsService.php
الوظيفة الوصف
createPaymentPage() إنشاء صفحة دفع آمنة
verifyPayment() التحقق من حالة الدفع
refund() معالجة استرداد المدفوعات
validateCallback() التحقق من webhook callbacks
المميزات:
• دعم البطاقات الائتمانية (Visa, MasterCard, Mada)
• دعم Apple Pay و STC Pay
• استرداد تلقائي للمدفوعات (Refund)
• تحقق آمن من المعاملات
• دعم Sandbox للاختبار
التوافق الكامل مع ZATCA (الفاتورة الإلكترونية)
الملف: app/Services/ZatcaService.php
الوظيفة الوصف
generateQrCodeData() إنشاء كود QR متوافق مع ZATCA
encodeTlv() ترميز TLV وفق المعايير السعودية
decodeTlv() فك ترميز بيانات QR
calculateVat() حساب ضريبة القيمة المضافة (15%)
validateVatNumber() التحقق من صحة الرقم الضريبي
generateInvoiceNumber() إنشاء رقم فاتورة بصيغة ZATCA
حقول QR Code المطلوبة:
1. اسم البائع (Seller Name)
2. الرقم الضريبي (VAT Number)
3. تاريخ الفاتورة (ISO 8601)
4. إجمالي الفاتورة مع الضريبة
5. مبلغ الضريبة
نظام مستخدمين وصلاحيات متقدم
الملف: app/Models/User.php
الدور الصلاحيات لوحة التحكم
Admin إدارة كاملة للنظام /admin
Technician إدارة المهام والحجوزات /technician
Customer الطلبات والحجوزات الشخصية /customer
المميزات:
• Spatie Laravel Permission للصلاحيات
• Laravel Sanctum للمصادقة API
• دعم OTP للتحقق
• تسجيل دخول بالهاتف
التقنيات والأدوات المستخدمة
Backend Stack
التقنية الإصدار الاستخدام
PHP 8.1+ لغة البرمجة الأساسية
Laravel 10.x إطار العمل الرئيسي
MySQL/MariaDB 5.7+ قاعدة البيانات
Laravel Sanctum 3.3 مصادقة API
Spatie Permission 6.24 إدارة الصلاحيات
Frontend Stack
التقنية الإصدار الاستخدام
Vite 5.0 أداة البناء الحديثة
Bootstrap 5.2.3 إطار CSS
SASS 1.56 معالج CSS
Axios 1.6.4 HTTP Client
Popper.js 2.11.6 Tooltips & Popovers
الحزم والخدمات
الحزمة الاستخدام
paytabscom/laravel_paytabs بوابة الدفع PayTabs
barryvdh/laravel-dompdf إنشاء ملفات PDF
mpdf/mpdf PDF مع دعم Arabic متقدم
simplesoftwareio/simple-qrcode إنشاء QR Codes
intervention/image معالجة الصور
laravel/ui واجهات المصادقة