تطبيق الهاتف

حالة الإصدار — 20 أكتوبر 2026: نُشر Squire 1.0.0-beta.1، بما فيه تطبيق Android للمدربين، واعتمد للتقييم التجريبي. نجحت فحوص التغليف والتوقيع، واعتمد المؤسس اختبار Galaxy S20+ المستقل والعمل الميداني دون اتصال، وطابقت بصمة APK في الحزمة المرفوعة سجل البناء. تُعد تغطية الأجهزة وإمكانية الوصول والترقيات التاريخية الأوسع أعمال متابعة، وليست شروط إصدار beta.1 غير مكتملة. تبقى موافقة كل مؤسسة على بيئتها والخصوصية والأمان مطلوبة قبل استخدام بيانات رياضيين حقيقية.

تطبيق Android قيد التطوير

يدعم تطبيق Android الميداني للمدربين الدخول بعنوان نسخة المؤسسة والمواعيد والحضور ونتائج التقييم والإنهاء والاسترداد. تتوفر نسخة 1.0.0-beta.1 من Squire في حزمة تنزيل Android أدناه؛ ولا توجد صفحة متجر.

نُفّذت محلياً وظائف تسجيل الحضور ومسودات التقييم ونتائجه وإنهاء الحدث وإعداد تخزين الحدث المشفّر وإعادة المحاولة والاسترداد. اجتازت اختبارات SQLite على Node واختبارات API فعلية معزولة. واجتاز ملف مؤقت على محاكي Android 14 إعادة إرسال نتيجة عشرية محفوظة بعد إيقاف عملية التطبيق وإعادة فتحه أثناء الاتصال، والسجل والإنهاء وإلغاء المشاركة دون فقدان العمل. فُحص بدء التخزين المشفّر وترويسة قاعدة غير نصية؛ وهذا ليس تدقيقاً تشفيرياً. في 19 أكتوبر بدأ APK الإنتاجي الموقّع دون اتصال أو Metro، وحافظ على حضور غير مؤكد ومسودة نتيجة غير مرسلة عبر تحديث بالمفتاح نفسه من versionCode 1 إلى 1000001 على محاكي Android 14 منفصل. بعد الاتصال أكد الخادم الحضور ونتيجة واحدة بالمراجعة 1 والإنهاء. استخدمت حزمة التأهيل ذات الرقم الأقل الشيفرة الإنتاجية نفسها؛ ولم يُتحقق من ترحيل إصدار تاريخي أو مخطط أقدم. أبلغ المؤسس لاحقاً عن نجاح أول اختبار على هاتف فعلي في 20 أكتوبر؛ راجع التفاصيل أدناه. قد تُبقي حزمة beta الأولى رسالة اتصال قديمة بعد المزامنة. إصلاح المصدر مدمج، وأبلغ المؤسس لاحقاً عن نجاح أول اختبار على S20+. استخدم بيانات تجريبية حتى تعتمد المؤسسة معلومات الرياضيين الحقيقية.

توقيت التسجيل وإنهاء الموعد

توضح النسخ المحدثة أن تسجيل الحضور والنتائج والإنهاء يصبح متاحاً عند بداية الموعد، مع عرض الوقت وفق منطقة الجهاز. نزّل القائمة أثناء الاتصال قبل العمل دون اتصال. إذا كان التوقيت خاطئاً فاطلب من الموظف إعادة الجدولة عبر الويب ثم حدّث القائمة. يعرض الموعد المكتمل ملخصاً مميزاً للقراءة فقط بعد تأكيد المؤسسة؛ أما الإنهاء الموجود في الطابور فما زال ينتظر التأكيد. استخدم المواعيد والتقييمات على الويب للتفاصيل وتاريخ التصحيحات.

أبلغ المؤسس عن نجاح مسار تسجيل الحضور دون اتصال ثم إعادة تشغيل الخادم ثم الاتصال والمزامنة في 18 أكتوبر 2026. لم يُؤكد نوع الجهاز مجدداً. هذه إفادة عن الحضور، وليست قبولاً لتسجيل النتائج أو الإنهاء أو الاسترداد بعد إغلاق عملية التطبيق أو التشفير الأصلي أو الأجهزة الفعلية.

السجل والاسترداد واللغة

توفر نسخ التطوير المحدثة سجل حضور ونتائج لكل رياضي أثناء الاتصال، بواقع ٢٥ إدخالاً للصفحة، مع الإدخال الأصلي والتصحيحات. يُتحقق من صلاحية الموعد في كل صفحة ولا يُحفظ السجل للعمل دون اتصال.

تقارن مراجعة العمل المحفوظ تغييرات الجهاز الدائمة بقراءة منفصلة حديثة من الخادم، دون استبدال أساس الطابور أو تغيير معرّفات العمليات. تُعاد محاولة النتيجة غير المؤكدة بالعملية نفسها؛ وتبقى العمليات المرفوضة أو الملغاة الصلاحية متوقفة. يمكنك مشاركة نسخة استرداد صراحة عبر خيارات Android قبل أي حذف. تحتوي على أسماء الرياضيين المعنيين والحضور والنتائج والملاحظات وبيانات الموعد والعمليات والمسودات المعلقة كنص غير مشفّر، دون بيانات دخول أو رياضيين غير معنيين. اختر جهة تعتمدها مؤسستك فقط. لا تؤكد المشاركة التسليم أو تعيد إرسال العمل أو تعكس سجلات الخادم، ولا توفر استيراداً تلقائياً. يُرفض النص الكبير دون اقتطاع، مع إمكانية مشاركة العناصر منفردة. النسخ المصدّرة خارج تشفير التطبيق وسياسة الاحتفاظ به.

تستعيد أزرار English/العربية تفضيل الجهاز وتحافظ على المسودات المفتوحة عند التبديل. نُفّذت الواجهة والملاحظات العربية وإدخال الأرقام العربية. فُحص سجل النتائج بالإنجليزية في الثيم الفاتح والاسترداد بالعربية في الثيم الداكن على محاكي Android أفقي بدقة 1280×800، إضافة إلى فحص اتجاه الجدول السابق. شمل فحص الإصدار اللاحق الوضع الرأسي بالإنجليزية والثيم الفاتح بعرض 400dp؛ وتبقى مصفوفة مقاسات الهاتف والثيمات وإمكانية الوصول ومسارات تعارض الصلاحيات وتبديل الحساب الأصلية الأوسع مفتوحة. مسح عنوان النسخة لم يُنفذ بعد.

التثبيت التجريبي والتحديثات

يوضح دليل إصدار Android المرجعي أمر npm run mobile:release والتوقيع المحلي الخاص وفحص APK وبصمته واختبارات التثبيت. تتضمن حزمة الإصدار JavaScript ولا تتطلب Metro أو Android Studio. الحزمة المنشورة معتمدة للتقييم التجريبي. استخدم بيانات اصطناعية حتى توافق المؤسسة على بيانات الرياضيين الحقيقية.

يجب أن تحافظ التحديثات على معرّف الحزمة ومفتاح التوقيع وقاعدة الجهاز ومعرّفات مفاتيحها، مع زيادة Android versionCode. حدّث فوق التطبيق الموجود؛ لا تحذفه ولا تمسح بياناته لمعالجة اختلاف التوقيع، فقد تفقد العمل المعلّق. يحتاج تطبيق التطوير ذو التوقيع المختلف إلى جهاز أو محاكي آخر لاختبار الإصدار. راجع حالة الإصدار قبل إتاحة تنزيلات.

الاستخدام الحالي على الهاتف واللوحيات

استخدم عنوان الويب المتجاوب لجامعتك واطلب من المشغل تفعيل حسابك. لا تثبت محاكاة المتصفح عمل التطبيق على الهواتف أو اللوحيات الفعلية.

نطاق الأنظمة

المنصة الأصلية الأولى هي Android. لا يشمل النطاق iOS ما لم يعتمد المشروع ذلك لاحقاً. نُشر APK الموقّع ضمن حزمة تنزيل Android. الحد المضبوط للبناء هو Android 7.0 / API 24، لهواتف ARM64 ومحاكيات x86_64؛ وهو إعداد وليس قبولاً لكل الأجهزة والإصدارات. أبلغ المؤسس عن نجاح أول اختبار على S20+؛ وتبقى تغطية الأجهزة والمقاسات الأوسع مفتوحة. لا نَعِد بإشعارات دفع أو مزامنة في الخلفية.

تطوير API

تتوفر مواصفة OpenAPI للخادم عبر /v1/openapi.json في النسخة التي تتضمن تصدير Stage 7. تقدّم الخوادم المحدّثة أيضاً Swagger UI عبر /v1/docs (مع Compose: /api/v1/docs)، للتفاعل محلياً والقراءة المرجعية فقط في الإنتاج. راجع تطوير API للمصادقة وتوفر العارض بعد النشر وحدود الأمان.

المصدر والحالة

حُدّثت في 20 أكتوبر 2026 بنتيجة الهاتف التي أبلغ عنها المؤسس؛ وتحتفظ أدلة المحاكي السابقة بنطاقها الأصلي. راجع نطاق تطبيق Stage 7.

التقييم على هاتف وملكية التوقيع

يوضح دليل المشغل المحدّث خطوات النسخ المشفّر لمفتاح التوقيع واختبار Galaxy S20+ عبر تحويل اتصال USB إلى الخادم المحلي؛ فلا يلزم نطاق أو محاكي أو Metro لهذا الاختبار المستقل. افصل USB وأوقف Wi-Fi وبيانات الهاتف لاختبار انقطاع حقيقي. يرافق الدليل الإصلاحات المدمجة؛ وأبلغ المؤسس عن نجاح أول اختبار على S20+.

تطبيق Android للمدربين؛ ويستخدم المسؤولون والرياضيون تطبيق الويب. النتائج ملاحظات أداء وليست تشخيصات طبية أو تنبؤات بالإصابات. تعمل المواعيد المنزّلة فقط دون اتصال، ولا تُوعد مزامنة خلفية أو إزالة عن بُعد. يمنع إلغاء الصلاحية القراءات وإعادة الإرسال اللاحقة، لكنه لا يمحو سجلات جهاز غير متصل. راجع إرشادات الخصوصية والتشغيل المرجعية قبل تقييم بيانات رياضيين حقيقية.

يفتح التحديث المدمج القوائم المحفوظة مباشرة من الجهاز مع تحديث الجدول بشكل مستقل. استخدم تحديث القائمة أثناء الاتصال لتنزيل بيانات أحدث للموعد، وعالج العمليات والمسودات المعلقة قبل استبدال الحزمة.

نتيجة الهاتف وتجهيز الإصدار — 20 أكتوبر 2026

في 20 أكتوبر 2026، أكد المؤسس أن خطوات التثبيت المستقل ومسار الاستخدام الميداني والاسترداد دون اتصال الموصوفة على Galaxy S20+ عملت كما هو متوقع. هذا نجاح مُبلّغ عنه من المالك لاختبار هاتف فعلي. لم تُقدَّم نسخة Android أو بصمة APK المثبّت أو نتائج كل لغة وفحوص إمكانية الوصول؛ وتبقى تغطية الأجهزة واللوحيات وإمكانية الوصول والترقيات التاريخية الأوسع منفصلة. راجع نتيجة الهاتف المسجّلة وطلب مراجعة التطبيق #136.

نُشرت حزمة تنزيل Android الرسمية ضمن إصدار beta.1 التجريبي على GitHub. استخرج ZIP وافتح 1.0.0-beta.1/Rafik-Squire-1.0.0-beta.1-android.apk. تتضمن الحزمة SHA256SUMS وملف build.json غير السري. في 20 أكتوبر طابقت بصمة APK المحسوبة بعد التنزيل كلا الملفين وسجل التغليف السابق: 1654e44fd6f324d2403984a6a880b3dffabf81f3615c9ac8a71c5992a417fb5e. مصدر التطبيق هو 5d1ce761505b07272c6d5b43414cd1d754b41517؛ ويبقى وسم أرشيفات المصدر 4ac70c8. لم يلزم بناء جديد أو تغيير الوسم أو تكرار اختبار الهاتف.

تثبيت رفيق الميداني أو بناؤه

للمدربين، نزّل حزمة Android المرتبطة أعلاه واستخرجها. يتصل التطبيق نفسه بخوادم المؤسسات المنفصلة: أدخل عنوان API الخاص بمؤسستك عبر HTTPS (ينتهي بـ /api مع Compose) وحساب المدرب. لا يتطلب استخدامه Node أو Metro أو محاكياً أو Android Studio. أرشيفات المصدر المنفصلة ZIP وtar.gz ليست مثبتات Android.

لبناء تطبيق مستقل، اتبع خطوات البناء من نسخة مستودع جديدة. على جهاز مجهز بـ Android SDK وJDK 17 وNode 22.16 أو 24، اختر مراجعة المصدر المعتمدة، وشغّل npm ci من الجذر، وجهّز هوية التوقيع الخاصة، ثم شغّل npm run mobile:release -- --prepare-only وnpm run mobile:release. ينتج APK موقّع وSHA256SUMS وملف build.json غير السري تحت artifacts/mobile/<app-version>/. اختيار الوسم المنشور يبني مصدر ذلك الوسم، وليس الإصلاحات اللاحقة.

تستخدم التوزيعات المستقلة مفتاح توقيع خاصاً بها وتتولى تحديثاتها؛ ولا يُشارك مفتاح إصدار رفيق الخاص. لا يمكن لحزمة بتوقيع مختلف تحديث تثبيت رسمي في مكانه. يستخدم المساهمون npm run mobile:android مرة للتثبيت ثم npm run mobile:start لتعديلات JavaScript المعتادة. راجع اختيار مسار البناء.

التثبيت على Android

نزّل حزمة Android على الهاتف.
استخرج ZIP عبر مدير الملفات (على Samsung: ملفاتي ← التنزيلات ← اختر ZIP ← استخراج).
افتح المجلد المستخرج واضغط ملف .apk. اسمح بتثبيت تطبيقات غير معروفة لمدير الملفات عند الطلب، ثم ثبّت Rafik Field. قد تتطلب أجهزة المؤسسة المُدارة موافقة المسؤول.
افتح رفيق الميداني، وأدخل عنوان API الخاص بالمؤسسة عبر HTTPS، ثم سجّل الدخول كمدرب. يتطلب الدخول وتنزيل المواعيد اتصالاً بخادم المؤسسة؛ وبعد التنزيل يمكن تسجيل العمل الميداني دون اتصال.