CAPACITORJS READYApp ID: sa.alkhayat.app

مركز التحكم بتطبيق الجوال الأصلي (Android & iOS CapacitorJS)

إدارة الجسر البرمجي الأصلي (الكاميرا، الـ GPS، المشاركة، الطابور الأوفلاين، وتوجيه الـ API إلى Cloudflare Workers).

بيئة التشغيل الحالية:web (Web / PWA)

طابور المزامنة الأوفلاين:0 عملية

توجيه واجهات `/api/*` داخل التطبيق (API Base Origin)

Fetch Interceptor Active

عند تشغيل التطبيق داخل حزمة `APK` أو `IPA` (`capacitor://localhost`)، يقوم الجسر بتحويل جميع طلبات `/api/*` تلقائياً إلى خادم Cloudflare Workers المحدد أدناه دون تعديل كود الواجهات.

طابور عدم الاتصال والذاكرة الدائمة (Offline Queue & Native Storage)

معلق: 0

إذا انقطع الإنترنت داخل المشغل أثناء تسجيل فاتورة كاشير أو مقاس عميل، تُحفظ العملية في الطابور المحلي وتُنسخ إلى `Capacitor Preferences` لمنع نظام iOS من مسحها، ثم تُرفع تلقائياً فور عودة الشبكة.

موكب كاش التطبيق بالجوال (Mobile App & Offline Cache Mockup)

معاينة شاشات تطبيق الجوال والذاكرة المؤقتة (Capacitor Preferences & Local Cache)

تبديل حي بين شاشات الجوال لمعاينة كيف يحفظ التطبيق الطلبات والمقاسات في كاش الجوال عند انقطاع الشبكة ويزامنها مع Cloudflare D1.

طلبات محفوظة بالكاش4

مقاسات عملاء بالكاش6

حجم كاش الجوال18.4 KB

Capacitor Native Preferences & Cache KeysSYNCED

• alkhayat_tailor_sessionActive (7d TTL)

• alkhayat_orders_v34 cached records

• alkhayat_customers6 measurement profiles

• alkhayat_offline_sync_queue0 pending D1 mutations

5G • 100%

تطبيق دار الخَيّاطCloudflare D1 Online

CAPACITOR

كاشير المشغل السريعكاش نشط

العميل: فهد العتيبي0501234567

الطول: 152

الكتف: 46

الكم: 62

سجل كاش الأوفلاين المحلي (IndexedDB / Preferences):

#5067 - سميراميس سويسريمحفوظ بالكاش

#5068 - ريتشي ياباني كريميمحفوظ بالكاش

عمليات بانتظار الشبكة:0 عملية

فحص جسور العتاد الأصلي للجوال (Native Hardware Bridge)

كاميرا القياس ومسح الدفاتر@capacitor/camera

يُستخدم في القياس الذكي بالكاميرا وفي تصوير دفاتر الخياطين الورقية القديمة (AI OCR).

الـ GPS والعنوان الوطني@capacitor/geolocation

يلتقط إحداثيات منزل العميل بدقة عالية ويربطها مع خرائط قوقل والرمز المختصر في شاشة الدفع.

مشاركة الفواتير والاهتزاز@capacitor/share

يفتح نافذة المشاركة الأصلية في أندرويد وآيفون لإرسال رابط الدفع `/pay` أو الفاتورة الضريبية للعميل.

أوامر بناء APK و IPA

# 1. تثبيت حزم Capacitor الأساسية والمنصات
npm install @capacitor/core @capacitor/cli @capacitor/android @capacitor/ios
npm install @capacitor/camera @capacitor/geolocation @capacitor/share @capacitor/preferences @capacitor/haptics @capacitor/app @capacitor/status-bar @capacitor/splash-screen

# 2. بناء حزمة المشروع ومزامنتها مع أندرويد و iOS
npm run build
npx cap add android
npx cap add ios
npx cap sync

# 3. فتح المشروع في Android Studio أو Xcode لإصدار APK / IPA
npx cap open android
npx cap open ios

صلاحيات AndroidManifest.xml

<!-- صلاحيات تطبيق دار الخياط في AndroidManifest.xml -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- الكاميرا والألبوم للقياس الذكي ومسح الدفاتر الورقية القديمة -->
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- تحديد الموقع الجغرافي للعنوان الوطني وخرائط قوقل -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-feature android:name="android.hardware.location.gps" android:required="false" />

صلاحيات iOS Info.plist

<!-- صلاحيات متجر آبل في ios/App/App/Info.plist -->
<key>NSCameraUsageDescription</key>
<string>يحتاج تطبيق دار الخياط إلى الكاميرا لأخذ مقاسات الثوب الذكية ومسح صفحات دفاتر الخياطة الورقية.</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>يحتاج التطبيق للوصول إلى الصور لرفع صور الأقمشة والنقشات ودفاتر المقاسات.</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>لحفظ الفواتير الضريبية وملفات المقاسات في جهازك.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>لتحديد موقع التوصيل الدقيق والرمز المختصر للعنوان الوطني على خرائط قوقل.</string>