تقرأ توثيق الإصدار Squire ⁦1.0.0-beta.2⁩. اقرأ أحدث دليل

الأدلة

إدارة المؤسسة

الإعداد الأول والإدارة الآمنة للعضوية.

المؤسسة الأولى

ينشئ الإعداد الأول المسؤول الأعلى والمؤسسة معاً على نسخة فارغة وخاصة. أبقِ الإعداد خاصاً حتى لا يحصل شخص مجهول على الإدارة.

دعوة الفريق

ينشئ المسؤول عضويات بدور واحد للمدربين والرياضيين. رابط الدعوة يستخدم مرة وينتهي بعد سبعة أيام؛ شاركه سراً. البريد معرّف للحساب، ولا يتحقق منه التطبيق أو يرسل دعوة بالبريد.

الإدارة اليومية

راجع العضويات والمدربين المسندين والمجموعات والمواعيد والمهام. ألغِ الوصول عند المغادرة وأعد فحص حدود الدور. لا تحفظ حالة المتصفح القديمة صلاحية الوصول.

استعادة كلمة المرور

يمكن إصدار رابط إعداد لمرة واحدة ينتهي بعد 24 ساعة. إكماله يلغي الجلسات الحالية. تتطلب الكلمات الجديدة 8–128 حرفاً وحروفاً كبيرة وصغيرة ورقماً وعلامة أو رمزاً.

فائدة وضوح المسؤولية للمؤسسة

يمنح إسناد المدرب للرياضي نطاق عمل محدداً ومرجعاً للتحقق من المسؤولية عند التسليم. يحافظ تغيير المدرب على تاريخ المؤسسة ولا يخول المدرب السابق مواصلة قراءة السجلات الحالية. راجع العضويات والمهام والأحداث المقبلة معاً عند تغير المسؤوليات.

بدء تقييم عملي

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

استخدم الميزات وقيمتها للتخطيط، ثم البرامج والتقويم والتقييم والمهام والتقارير لمتابعة العمل بين أقسام المؤسسة.

الرياضات وفرق التدريب (أساس beta.2)

تنطبق هذه الخطوات على أساس الرياضات والتدريب المدمج، الجاري تجهيزه ضمن beta.2.

  1. في إعدادات المؤسسة، أضف رياضات المؤسسة والتخصصات التدريبية العامة، مثل الإعداد البدني والقوة. يمكنك إعادة تسميتها أو أرشفتها لاحقاً، وتبقى العناصر المؤرشفة في السجلات القائمة.
  2. في الأشخاص، افتح إدارة لأي شخص. اربط الرياضيين بالرياضات التي يمارسونها، والمدربين بالرياضات أو التخصصات التي يغطونها.
  3. للرياضي، حدّد المدرب الأساسي. ثم أضف من تشاء من المدربين المساندين، كلٌّ لرياضة من رياضات الرياضي أو لتخصص تدريبي.
  4. استخدم مرشح الرياضة في صفحة الأشخاص ورابط الملف للرياضي للتحقق من النتيجة.

إزالة رياضة من رياضي أو مدرب تُنهي روابط الدعم المعتمدة عليها. وإلغاء تنشيط عضوية، أو إزالة دور المدرب أو الرياضي، يُنهي روابط التدريب لذلك الشخص فوراً.

الترقية: تضيف هذه الشيفرة ترحيلات أمامية من 202610191200_sports_and_specialties حتى 202610191500_delegated_sessions. انسخ PostgreSQL والملفات الخاصة احتياطياً معاً أولاً. يصبح المدربون المسؤولون الحاليون مدربين أساسيين تلقائياً، وتبقى الخطط القائمة. لا تعِد ضبط المؤسسة أو تعبئتها ببيانات تجريبية. راجع مرجع API.

المصدر والنطاق

رُوجع وفق الفرع الجامعي المحلي الحالي في 17 أكتوبر 2026. docs/reference/api.md.

تحسينات الأشخاص والإعدادات (beta.2)

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

يمكن تضمين رياضات الرياضي أو رياضات المدرب وتخصصاته في الدعوة. لا تتضمن دعوات المسؤولين رياضات. تتطلب الترقية الترحيل الأمامي 202610210100_invitation_sports مع الحفاظ على الدعوات القائمة. تستخدم إعدادات المؤسسة أقساماً بعرض الصفحة. تبقى الهوية البصرية مقتصرة على المسؤول الأعلى الأول، وتُعرض الرياضات والتخصصات التدريبية جنباً إلى جنب. يتطلب إغلاق المؤسسة كتابة اسمها المطابق في مربع تأكيد.

تتضمن نماذج كلمات المرور زر إظهار وإخفاء مترجماً؛ ولم تتغير شروط كلمة المرور أو آلية التحقق من الحساب. لا تتطلب هذه التحسينات إعادة بناء تطبيق Android. يصف هذا القسم beta.2.

توحيد التحرير والتحكم في القوائم (beta.2)

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

تقدم القوائم الأساسية خيار لكل صفحة بجوار التنقل، بأحجام 10 و25 و50 و100 سجل؛ وتقدم شبكات البرامج والتمارين 12 و24 و48 و96 مع الحفاظ على الحجم الافتراضي. يستمر الاختيار بعد إعادة التحميل. تبقى صفحات مكتبة التمارين محلية، بينما تطلب القوائم الأخرى الحجم المحدد والمحدود من الخادم. تتضمن مربعات البحث تلميحات، ويستخدم الرفع المستقل منطقة لاختيار الملفات أو إفلاتها مع القيود القائمة. لا يظهر عمود تفاصيل الموارد إلا بعد اختيار ملف.

تعيين البرامج وتعديلها (beta.2)

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

الجدول والبحث (beta.2)

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

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