# 🚀 نظام تتبع الشحنات الكامل ## 📋 نظرة عامة نظام شامل لتتبع الشحنات يتضمن: - **تطبيق أندرويد** لمسح الباركود وإدارة الشحنات - **موقع ويب** لإدارة النظام والإحصائيات - **قاعدة بيانات MySQL** لحفظ البيانات - **API** للربط بين التطبيق والموقع ## 🛠️ التقنيات المستخدمة ### **تطبيق الأندرويد**: - **Kotlin** - لغة البرمجة - **AndroidX** - مكتبات Android الحديثة - **Room Database** - قاعدة بيانات محلية - **Retrofit** - للاتصال بالـ API - **ZXing** - لمسح الباركود - **Navigation Component** - للتنقل بين الصفحات - **ViewModel & LiveData** - لإدارة البيانات ### **الموقع**: - **PHP** - لغة البرمجة - **MySQL** - قاعدة البيانات - **Bootstrap 5** - للتصميم المتجاوب - **Font Awesome** - للأيقونات - **JavaScript** - للتفاعل ### **قاعدة البيانات**: - **MySQL** - قاعدة البيانات الرئيسية - **UTF-8** - ترميز النصوص العربية - **PDO** - للاتصال الآمن بقاعدة البيانات ## 📁 هيكل المشروع ``` packaging/ ├── app/ # تطبيق الأندرويد │ ├── src/main/java/ # كود Kotlin │ ├── src/main/res/ # الموارد │ └── build.gradle.kts # إعدادات التطبيق ├── website/ # موقع PHP │ ├── login.php # صفحة تسجيل الدخول │ ├── dashboard.php # لوحة التحكم │ ├── companies_management.php # إدارة الشركات │ ├── users_management.php # إدارة المستخدمين │ ├── shipments.php # استعراض الشحنات │ └── reports.php # التقارير ├── api/ # API │ ├── config.php # إعدادات قاعدة البيانات │ ├── getCompanies.php # جلب الشركات │ ├── addCompany.php # إضافة شركة │ ├── getShipments.php # جلب الشحنات │ └── getStats.php # الإحصائيات └── database/ # ملفات قاعدة البيانات ├── complete_database_setup.sql └── fix_database_encoding.sql ``` ## 🚀 التثبيت والتشغيل ### **1. قاعدة البيانات**: ```sql -- إنشاء قاعدة البيانات CREATE DATABASE ztjmal_shipmen CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- تشغيل ملفات SQL source complete_database_setup.sql source fix_database_encoding.sql ``` ### **2. الموقع**: 1. ارفع ملفات `website/` إلى خادم الويب 2. ارفع ملفات `api/` إلى خادم الويب 3. حدث إعدادات قاعدة البيانات في `api/config.php` 4. افتح الموقع في المتصفح ### **3. تطبيق الأندرويد**: 1. افتح المشروع في Android Studio 2. تأكد من تثبيت Java 17 3. File → Project Structure → SDK Location 4. اختر "Use embedded JDK" 5. Build → Clean Project 6. Build → Rebuild Project 7. Build → Build APK ## 🔧 حل المشاكل ### **مشاكل Java**: - **المشكلة**: Java 25 غير متوافق مع Gradle - **الحل**: استخدم Android Studio's built-in Java أو ثبت Java 17 ### **مشاكل قاعدة البيانات**: - **المشكلة**: ترميز النصوص العربية - **الحل**: شغل `fix_database_encoding.sql` ### **مشاكل البناء**: - **المشكلة**: Gradle sync failed - **الحل**: File → Invalidate Caches and Restart ## 📱 الميزات ### **تطبيق الأندرويد**: - ✅ مسح الباركود - ✅ إدارة الشركات - ✅ تتبع الشحنات - ✅ الإحصائيات - ✅ مزامنة البيانات ### **الموقع**: - ✅ لوحة تحكم إدارية - ✅ إدارة الشركات - ✅ إدارة المستخدمين - ✅ استعراض الشحنات - ✅ التقارير والإحصائيات - ✅ تصميم متجاوب ## 🌐 الروابط - **الموقع**: https://zabda-al-tajamil.com/shipment_tracking/website/ - **API**: https://zabda-al-tajamil.com/shipment_tracking/api/ - **GitHub**: https://github.com/ahmedhalim1001-coder/FREELANCE ## 📞 الدعم إذا واجهت أي مشاكل: 1. تحقق من ملفات الإصلاح 2. اتبع التعليمات في README 3. تواصل مع المطور ## 📄 الترخيص هذا المشروع مطور خصيصاً لنظام تتبع الشحنات. --- **تم التطوير بواسطة**: أحمد حليم **التاريخ**: 2025 **الإصدار**: 1.0# FREELANCE