cGym Desktop
دليل تشغيل وتجربة نسخة الجهاز · إصدار 1.0.20 للفحص
التثبيت
- Windows 10 / 11 بمعمارية x64: شغّل ملف التثبيت واختر مجلد التطبيق.
- macOS: اختر Apple Silicon لأجهزة M أو Intel لأجهزة x64، ثم فك ملف ZIP وانقل تطبيق cGym Desktop إلى Applications.
- لا تثبّت PostgreSQL أو .NET أو Docker منفصلًا؛ مكونات التشغيل مضمّنة.
- أغلق التطبيق قبل تحديثه، واحتفظ بمجلد بياناته ونسخك الاحتياطية.
- في أول تشغيل أدخل اسم الصالة والمدير والبريد وكلمة مرور تختارها. لا توجد كلمة مرور افتراضية.
التجربة والترخيص
تبدأ التجربة عند أول تشغيل وتستمر شهرًا تقويميًا. تحديث التطبيق أو إعادة تثبيته أو استعادة قاعدة البيانات لا يعيد بداية التجربة ما دام مجلد بيانات التطبيق ومفتاح التثبيت محفوظين.
بعد التجربة يبقى عرض البيانات والنسخ الاحتياطي متاحًا وتُوقف الإضافة والتعديل. فعّل مفتاح صالتك من شاشة «الترخيص والمزامنة والنسخ الاحتياطي». يجب أن يكون اشتراك المنصة فعّالًا وغير تجريبي. استخدم مفتاح الصالة دون تحديد فرع؛ مفتاح الفرع لا يفعّل نسخة تحتوي بيانات الصالة كاملة. الترخيص مرتبط بالجهاز وحدود باقة الصالة.
موعد التحقق هو أقرب تاريخ بين مرور 6 أشهر وانتهاء الترخيص. تتم محاولة التحقق تلقائيًا قرب الموعد. إن حل الموعد دون اتصال، اتصل بالإنترنت للتحقق واستئناف العمل. عند معرفة تعليق الاشتراك أو إلغاء الجهاز تُوقف الكتابة ويُحتفظ بالبيانات.
اختبار مرتب بدل الاختبار العشوائي
- أنشئ باقة شهرية بمبلغ 50,000 IQD، ثم سجل مشتركًا واشتراكًا فيها.
- فعّل ضبط الصندوق وافتح وردية بمبلغ افتتاحي 10,000 IQD.
- سجّل دفعة 20,000 IQD. افتح الوصل واطبعه، وتحقق أن المتبقي على المشترك 30,000 IQD.
- سجّل حضورًا يدويًا، وأنشئ حصة واحجز للمشترك فيها.
- أنشئ منتجًا برصيد 10 وسعر 2,000 IQD، وبع وحدة. يجب أن يبقى المخزون 9.
- سجّل مصروفًا نقديًا 1,000 IQD واعتمده بحساب مخوّل آخر، أو باستثناء مالك صريح ومسبب إن كان هو المنشئ. يجب أن يكون رصيد الوردية 31,000 IQD.
- أغلق الوردية. اختبر رفض اعتماد الموظف لورديته، ثم اعتمدها بحساب محاسب آخر.
- أغلق التطبيق وافتحه. تحقق من المشترك والاشتراك والوصل والمخزون.
- احفظ نسخة احتياطية. الاستعادة تحفظ نسخة من البيانات الحالية أولًا، ولا تعيد فترة التجربة أو تغير الترخيص.
- فعّل الترخيص ثم راقب المزامنة. عدّل سجلًا على المنصة وتحقق من وصوله للجهاز، ثم عدّل سجلًا محليًا وتحقق من وصوله للمنصة.
المزامنة والتعارضات
تُحفظ العمليات محليًا ويُرسل كل تغيير مع آثاره داخل دفعة واحدة. تأكيد المنصة يمنع تكرار الدفعات. عند تعديل السجل نفسه في الطرفين، تُحفظ الدفعة المتأثرة وتبعياتها للمراجعة، وتستمر التحديثات المستقلة. تُحفظ التحديثات الواردة في طابور دائم قبل تقدم مؤشر الجلب، مع إبقاء مؤشر التطبيق عند آخر سلسلة مكتملة. إعادة التشغيل لا تفقد الدفعات المؤجلة؛ لا تُستبدل حركة مالية أو مخزون تلقائيًا.
من شاشة النسخة المحلية افتح «مقارنة ومعالجة» للاطلاع على البيانات قبل التعديل وعلى الجهاز والمنصة. للتعديل التعريفي المنفرد في المشترك أو المدرب أو العميل المحتمل يمكن اعتماد نسخة المنصة بعد التأكيد، ثم الضغط على «مزامنة الآن». التعديل الأصلي وقرار المدير يبقيان في ملف المراجعة. التعديلات اللاحقة أو المترابطة أو المالية أو المخزون أو صلاحيات الدخول تحتاج مراجعة مستقلة ولا تُستبدل بهذا الإجراء.
أرقام وصولات التجربة مؤقتة. عند التفعيل تُربط الصالة ويُعاد ترقيم الوصولات التجريبية مرة واحدة ضمن نطاق الجهاز المحجوز، مع بقاء معرفات السجلات. حسابات الدخول وكلمات المرور محلية؛ تُربط أسماء الموظفين بالتقارير دون نسخ كلمات المرور إلى المنصة.
مقارنة الدفعة المالية كاملة
في التعارضات المالية افتح «مراجعة الدفعة كاملة» لمقارنة كل حركة مع ما قبل العملية والجهاز والمنصة، مع سياق الاشتراك والصندوق والمخزون. يمكن للمالك حفظ نتيجة المقارنة؛ يعاد التحقق من القيم وتُرفض المراجعة القديمة. حفظ النتيجة لا يعد تسوية مالية ولا يغلق التعارض. يبقى سجل المراجع والنسخ المقارنة في ملف التصدير. تتيح «تسوية مالية تنفيذية» إعداد خطة تشمل جميع معاملات الجهاز المعلقة. راجع القيم وأكد أن العمليات مستقلة وغير مكررة، ثم اكتب سبب التسوية واعتمدها. تُحفظ معرفات الوصولات والمستندات والتاريخ الأصلي، وتُرفض الخطط القديمة والتعديلات المتنافسة غير الآمنة والورديات المعتمدة وتجاوز المستحقات أو المخزون أو النقد المتوفر. يبقى فرق عد الوردية بانتظار اعتماد موظف إداري آخر. عند انقطاع الاتصال أو إعادة التشغيل تبقى الكتابة مقفلة حتى استكمال القرار نفسه بالمزامنة. يُسترد القرار أيضاً بعد استعادة نسخة أقدم. سجل المراجعة والتسويات متاح للتنزيل حتى بعد إغلاق التعارض. يدعم النقل الأولي والمعاملات الكبيرة أجزاء محفوظة ببصمات تحقق، مع استئناف الأجزاء الناقصة بعد الانقطاع. تُطبق المعاملة كاملة دون ظهور أرصدة جزئية. الحد الحالي للنقل الواحد 250000 سجل و256 MiB؛ السجل المفرد لا يتجاوز 8 MiB، ومجموع الأجزاء المؤقتة للجهاز 1 GiB. تُرفض الأحجام الأكبر بوضوح دون قطع المعاملة أو حذف البيانات. تحتفظ المنصة بنسخة النقل الأولي لدعم الاستعادة؛ أجزاء التحديثات المؤقتة تُزال بعد الحفظ أو يعاد تكوينها من سجل المنصة. تسوية التعارضات المالية نفسها تبقى محدودة بـ50000 عملية معلقة، مع إمكان وجود تاريخ تشغيلي أكبر في الصالة.
النسخ الاحتياطي المشفّر
بدءًا من 1.0.2 تُشفّر قاعدة البيانات والمرفقات في النسخ الجديدة بـ AES-256-GCM. تبقى استعادة النسخ القديمة مدعومة. من شاشة النسخة المحلية احفظ «مفتاح الاسترداد» في مكان مستقل عن مجلد النسخ؛ يتيح فتح محتوى النسخ المشفرة عند إجراءات التعافي المعتمدة. احتفظ به كسِر ولا تنشره أو تضعه مع النسخة.
استعادة جهاز بديل وإعادة ربط ترخيصه تحتاج مسار النقل المعتمد قبل تشغيله؛ زر الاستعادة الحالي مخصص للتثبيت نفسه. تاريخ التجربة لا يبدأ مجددًا عند فقد ملف الحالة؛ النظام يسترد النسخة المحمية أو يطلب استرداد الترخيص مع حفظ البيانات.
تبديل قاعدتي البيانات ينفذ داخل معاملة واحدة. سجل استعادة محمي يستكمل تبديل المرفقات بعد انقطاع التشغيل. يحتفظ النظام بقاعدتي الاستعادة السابقتين على الأقل؛ تنظيف النسخ الأقدم من 30 يومًا يتطلب وجود نسخة احتياطية سليمة منها. هذه السياسة تخص النسخ السابقة الناتجة عن استعادة Desktop.
النسخ والاستعادة يتطلبان تسجيل دخول مالك الصالة في التطبيق. احفظ مجلد النسخة على وسيط مستقل. يحتوي قاعدة البيانات والمرفقات وملف تحقق. استعادة النسخة من التطبيق مخصصة للنسخ التي أنشأها هذا التثبيت ولنفس الصالة. لا يُعاد استخدام أرقام الوصولات القديمة. عند استعادة صالة مرتبطة بالمنصة، تتوقف الإضافة والتعديل حتى يكمل النظام استرداد المزامنة عبر الإنترنت، مع الاحتفاظ بتاريخ التجربة والترخيص. النسخة المأخوذة قبل ربط الصالة بالترخيص تحتاج نقلًا منظمًا ولا تُستعاد فوق الصالة المرتبطة؛ نقل جهاز أو استعادة بعد فقد مفتاح التثبيت يحتاج إجراء استعادة وترخيص من إدارة المنصة. لا تحذف مجلد بيانات التطبيق لاستكشاف مشكلة تشغيل.
البوابات والخدمات المتصلة
تُضبط بيانات ربط cAccess من حالة النظام. صلاحية الدخول لا تتجاوز مدة الترخيص أو موعد التحقق. يلزم عنوان HTTPS موثوق ومفتاح ربط صالح وأجهزة متصلة لاختبار الدخول الفعلي. الدفع الإلكتروني وإرسال WhatsApp الفعلي يتطلبان إعداد المزود والاعتمادات الخاصة بهما.
حدود التحقق الحالي
إصدار 1.0.20: اكتمل فحص الترقية من 1.0.19 على ملفات اصطناعية، ودخول المالك والعمليات والنسخ المشفر والاستعادة والإغلاق السليم على Mac Apple Silicon وWindows 11 ARM64 بمحاكاة x64. حُفظت بيانات الاختبار وفترة التجربة، ولم يُفتح الملف الحقيقي أثناء الفحص. نسبة الخطة الأصلية المقبولة 90% وتبقى 7 بوابات قبول مستقلة؛ لا يمثل هذا قبولًا تجاريًا كاملًا.
سجل فحص الإصدار السابق 1.0.19
إصدار 1.0.19: اختُبرت ترقية Windows من 1.0.18 ودخول المالك والنسخ والاستعادة والإغلاق داخل Windows 11 ARM64 بمحاكاة x64، مع فحص العمليات وخصوصية المرفقات. واختُبرت ترقية Mac Apple Silicon وعمليات الصالة والنسخ والاستعادة من التطبيق. يبقى قبول جهاز Windows بمعالج Intel/AMD وMac Intel والتوقيع التجاري والأجهزة الفعلية مستقلًا.
تجد حالة فحص كل حزمة ونوع توقيعها وبصمة SHA256 في تقرير الإصدار. كل حزمة مخصصة للفاحصين، ولا يعني بناؤها قبول جهاز Windows x64 أو Mac Intel أصلي أو طابعة أو بوابة فعلية. يتطلب الإصدار التجاري توقيع الناشر والتجارب الميدانية المناسبة.
فحص استعادة المنصة والرجوع للإصدار السابق
في 2026-11-12 نجحت استعادة خدمات cGym الست على جهاز مستقل من النسخة المشفرة، مع قواعد البيانات والمرفقات ومفاتيح الحماية. ونجح الرجوع من 1.0.19 إلى 1.0.18 ثم العودة، مع بقاء الأرصدة والوصولات والمخزون والجلسات. نجح أيضًا رصد توقف خدمة وتعافيها عبر لوحة الإدارة.
تواريخ نسخ المكونات مختلفة؛ نسخة البيانات بتاريخ 2026-11-11. هذا فحص لخدمات cGym، واستعادة صورة السيرفر لدى المزوّد والقبول الميداني للأجهزة والتوقيع التجاري ما زالت مستقلة. تقرير الاستعادة والرجوع وحدود القبول.
الاسترداد على جهاز بديل
- من حساب المالك على الجهاز السابق، احفظ مفتاح الاسترداد في مكان مستقل واحفظ نسخة مشفرة بإصدار 1.0.3 أو أحدث. لا تضع المفتاح داخل مجلد النسخة.
- على الجهاز البديل، اختر «استرداد نسخة من جهاز سابق» من شاشة البداية قبل إنشاء صالة. اختر مجلد النسخة ثم ملف المفتاح المنفصل.
- يعيد التطبيق تشغيل نفسه ويسترد قاعدة البيانات والمرفقات ومفاتيح الحماية. فترة التجربة الأصلية لا تبدأ من جديد، حتى عند استرداد نسخة منتهية.
- سجل الدخول ببيانات المالك المستردة. للنسخة المرخصة افتح إدارة النسخة واختر «نقل الترخيص لهذا الجهاز واسترداد المزامنة». يلزم اشتراك منصة فعّال واتصال بالإنترنت.
- تبقى النسخة للقراءة حتى اكتمال النقل واسترداد تحديثات المنصة. تُحجز أرقام وصولات جديدة وتبقى الوصولات السابقة وسجلات المزامنة محفوظة.
النقل يوقف تراخيص المزامنة السابقة؛ الجهاز السابق غير المتصل يبقى خاضعًا لموعد التحقق والانتهاء في ترخيصه السابق. لا تستخدم الجهازين للعمل المتوازي بعد النقل. إذا فُقد رد المنصة، أعد نفس المحاولة خلال 24 ساعة. لا تستبدل مجلد البيانات أو تنشئ طلب نقل مختلفًا.
النسخ القديمة تبقى قابلة للاستعادة على تثبيتها الأصلي. الاسترداد الكامل على تثبيت جديد يحتاج نسخة 1.0.3 لضمان تضمين مفاتيح الحماية. عند فشل الاسترداد تُحفظ ملفات التثبيت الفارغ السابقة ولا يبدأ النظام صالة فارغة بدل المصدر.
البيع المتزامن وربط cAccess
إذا ظهرت رسالة انشغال نقطة البيع، انتظر لحظة وأعد المحاولة بنفس السلة. لا تنشئ فاتورة بديلة قبل التحقق من نتيجة المحاولة السابقة؛ يحافظ النظام على مفتاحها لمنع التكرار.
اربط حساب cAccess بالصالة والفرع ورمز الموقع الصحيح، وسجّل هوية المشترك في cAccess برمز CGYM- متبوعًا بمعرفه دون شرطات. التسجيل لا يستبدل التقاط البصمة أو الوجه على الجهاز. تحقق من الاشتراك الفعال وصلاحية الفرع، ثم افحص السماح والتعليق والإلغاء والحضور. سجلات الأشخاص المحذوفة نهائيًا لا تُنشأ تلقائيًا من جديد.
System Workflow — فحص بالترتيب
استخدم صالة فحص وبيانات اصطناعية، وسجّل نتيجة كل خطوة. يُفحص فتح البوابة فعليًا مع جهاز متصل واعتماد cAccess ساري. الدفع الإلكتروني وتسليم الرسائل لهما قبول مستقل.
| الخطوة | الإجراء | علامة النجاح |
|---|---|---|
| 1 | مشترك ← اشتراك ← دفعة تجريبية | المشترك والاشتراك والوصل محفوظة، والمستحق يساوي إجمالي الاشتراك ناقص الوصولات. |
| 2 | تسجيل حضور ثم فتح الحضور | يتطابق مجموع الفترة وأعلى يوم مع الرسم وجدول «عرض الأرقام اليومية». جرّب التالي والسابق في سجل كبير. |
| 3 | بيع ومصروف ثم مراجعة الحسابات | تتطابق الفاتورة والمخزون والصندوق والصلاحيات؛ لا يتكرر المستند عند إعادة الطلب. |
| 4 | إضافة مشترك على المنصة وصفحة الأعضاء مفتوحة على الجهاز | يظهر تلقائيًا بعد دورتي المزامنة وقراءة الحالة، كل منهما 30 ثانية، دون تحديث الصفحة. |
| 5 | مزامنة متزامنة أو بيانات لم تكتمل | توضح الرسالة أن المزامنة تعمل بالفعل أو ستستكمل تلقائيًا. تظهر «اكتملت المزامنة» عند اكتمالها. |
| 6 | CSV من الأعضاء والتقارير | زر الأعضاء يصدّر الصفحة الحالية. العربية والفواصل والاقتباسات والأسطر محفوظة. تُضاف TAB إلى النص الذي يشبه الصيغ؛ تبقى القيم الرقمية قابلة للحساب. |
| 7 | نسخة مشفرة ← استعادة ← مراجعة الوصولات والمخزون | تُسترد نقطة النسخ، ثم تعاد مزامنة المنصة وتحفظ الوصولات الأصلية وتاريخ التجربة. |
افحص الحالات العادية، ثم الانقطاع وإعادة التشغيل والتعارض. راجع عدادات الإرسال والوارد والتعارضات في شاشة إدارة النسخة. قبول Windows وMac Intel والتوقيع التجاري والبوابات الفعلية والتجربة الميدانية يبقى منفصلًا عن فحص محرك macOS ARM.
فُعّلت مراقبة تلقائية عبر الحساب المتصل كل 5 دقائق، مع تنبيه وتعافٍ دون تكرار. تتطلب بقاء Mac متصلًا وتشغيل Codex. لم تُنسخ رموز اتصال البريد إلى السيرفر، ويبقى SMTP المباشر غير مهيأ. اختبارا العطل والتعافي اصطناعيان ومعزولان، ووصل بريدهما فعليًا؛ لا يثبت ذلك تشغيلًا دائمًا عند إغلاق جهاز المراقبة.
التنبيهات الخارجية وحالة الإرسال
نجح اختبار رسالتين عبر حساب البريد المتصل، وتحقق وجودهما في صندوق الوارد وأكد مدير المنصة الاستلام. تعرض لوحة سلامة التشغيل نتيجة هذا الاختبار وحالة قناة الإرسال التلقائي بصورة منفصلة.
محرك التنبيه يراقب خدمات التطبيق وحداثة تقرير المراقبة، ويتجنب تكرار الحادثة ويشعر بالتعافي. نتيجة الإرسال غير المؤكدة تحفظ للمراجعة؛ لا يعاد إرسالها تلقائيًا. إعداد SMTP المعتمد مطلوب لتشغيل إرسال السيرفر؛ قبول مزود البريد للرسالة وحده لا يثبت وصولها أو استجابة المدير. تقرير اختبار التنبيهات وحدوده.
حزم الفحص السابقة 1.0.19
أغلق التطبيق واحفظ نسخة قبل تبديل الإصدار. الاحتفاظ بالحزمة لا يعني قبول الرجوع إلى إصدار سابق مع أي بيانات جديدة.