Advanced POS & Inventory Management API

نبذة عن المشروع: نظام إدارة المبيعات (POS) والمخازن ليس مجرد تطبيق لإضافة وحذف المنتجات؛ بل هو العصب المالي لأي مؤسسة. لذلك، تم بناء هذا الـ API (واجهة برمجة التطبيقات) ليكون "جاهزاً للعمل تحت الضغط" (Production-Ready)، مع التركيز التام على استقرار البيانات، السرعة الفائقة، ومنع أي أخطاء كارثية قد تحدث في أوقات الذروة. أبرز التحديات التي تم حلها في هذا النظام: حماية المخزون من البيع الوهمي (Race Conditions): في أوقات الضغط العالي (كأوقات العروض)، قد يقوم أكثر من كاشير ببيع نفس المنتج في نفس اللحظة. تم حل هذه المشكلة المعقدة برمجياً باستخدام (Atomic Operations & Pessimistic Locking) لضمان دقة الخصم من المخزون بنسبة 100% ومنع بيع منتجات غير متوفرة. الأمان المالي التام (Database Transactions): عمليات الدفع وإصدار الفواتير محمية بالكامل بمبدأ "الكل أو اللا شيء" (All-or-Nothing). إذا حدث أي انقطاع مفاجئ أثناء إنشاء الفاتورة، يقوم النظام بإلغاء العملية بالكامل وإرجاع المخزون تلقائياً لمنع أي تلاعب أو فقدان للبيانات. أداء صاروخي (Performance Optimization): تم تحسين استعلامات قواعد البيانات (Database Queries) والقضاء تماماً على مشكلة (N+1 Problem). النتيجة؟ النظام قادر على معالجة فواتير عملاقة تحتوي على مئات المنتجات في أجزاء من الثانية مع استهلاك الحد الأدنى من موارد الخادم (RAM). تقارير إحصائية سريعة ومعقدة: بناء تقارير تحليلية معقدة (مثل: أكثر المنتجات مبيعاً، وأفضل الموظفين أداءً) باستخدام (Raw SQL / Query Builder) لضمان استخراج التقارير في أقل من 10 أجزاء من الثانية، مهما بلغ حجم البيانات. هندسة برمجية نظيفة (Clean Architecture): النظام مبني باستخدام نمط (Service Pattern) لضمان فصل المهام (Single Responsibility Principle)، مما يجعل النظام قابلاً للتوسع وإضافة ميزات جديدة مستقبلاً بسهولة تامة ودون التأثير على الكود الحالي. التقنيات والأدوات المستخدمة: PHP & Laravel 12 MySQL Database Laravel Sanctum (للمصادقة وحماية الـ Endpoints) Postman (لاختبار وتوثيق الـ APIs) Laravel Telescope (لمراقبة الأداء وتحسينه)