========================================
  تحديث تطبيق Saloonsa POS (APK)
========================================

المسار على السيرفر:
  public/app-updates/

الملفات المطلوبة:
  1) version.json          — معلومات الإصدار
  2) saloonsa-pos-latest.apk — ملف التطبيق الجديد

مثال version.json:
{
  "version": "1.0.15",
  "build": 15,
  "apk_url": "https://testmobile.saloonsa.com/app-updates/saloonsa-pos-latest.apk",
  "notes": "وصف مختصر للتحديث"
}

خطوات رفع تحديث جديد:
  1. ابنِ APK جديد من Flutter (version في pubspec.yaml مثل 1.0.15+15).
  2. ارفع الملف باسم: saloonsa-pos-latest.apk إلى هذا المجلد.
  3. عدّل version.json: زد build و version و notes.
  4. من التطبيق: القائمة → تحديث النظام → تحديث الآن.

ملاحظات مهمة:
  - هذا استضافة ملفات ثابتة مباشرة عبر HTTPS؛ لا يحتاج Laravel API أو route.
  - يجب أن يقدّم السيرفر ملف APK بنوع MIME:
    application/vnd.android.package-archive
  - التطبيق يقارن رقم build مع النسخة المثبتة، والتحديث اختياري دائماً
    (تحديث الآن / لاحقاً).
  - الإصدار v14 لا يعرف رابط version.json الثابت؛ ثبّت v15 يدوياً أول مرة.
  - لاختبار التحديث بعد تثبيت v15: ابنِ v16 برقم build=16، ارفع APK باسم
    saloonsa-pos-latest.apk، ثم غيّر version.json إلى 1.0.16 و build=16.
    عندها سيكتشف v15 التحديث الاختياري.
  - مسار API القديم GET /api/v1/app/version يبقى احتياطياً فقط إذا فشل
    الوصول إلى version.json.
  - ارفع أيضاً ملفات API الورديات إن لم تكن مرفوعة:
    ShiftApiController.php + MobileShiftReportBuilder.php + routes/api.php
