النشر والإعداد

الحصول على المصدر

المستودع المرجعي هو Rafik-OpenSource، وهو منفصل عن هذا الموقع. يتتبع فرع main أحدث الشيفرة المدمجة:

git clone --branch main --single-branch https://github.com/Rafik-Athlete-Managment/Rafik-OpenSource.git
cd Rafik-OpenSource

للتقييم القابل للتكرار، استخدم وسم الإصدار المنشور المحدد وسجّله في ملاحظات تشغيل النسخة. أحدث إصدار تجريبي منشور هو Squire 1.0.0-beta.2؛ وما زال الإصدار المستقر Squire 1.0.0 مخططاً.

تنزيل أرشيف المصدر

افتح إصدارات GitHub، واختر النسخة المطلوبة ونزّل Source code (tar.gz) من ملفاتها. أرشيف المصدر الحالي هو beta.2. فكّه وانتقل إلى مجلد التطبيق قبل المتابعة. لا تحتاج هذه الطريقة إلى Git. وللتنزيل من سطر الأوامر لوسم محدد، استبدل القيمة التالية بالوسم المنشور كاملاً:

RAFIK_TAG='REPLACE_WITH_PUBLISHED_TAG'
curl --fail --location "https://github.com/Rafik-Athlete-Managment/Rafik-OpenSource/archive/refs/tags/${RAFIK_TAG}.tar.gz" --output rafik-source.tar.gz
mkdir rafik-source
tar -xzf rafik-source.tar.gz -C rafik-source --strip-components=1
cd rafik-source

نفّذ كل أمر بعد نجاح السابق، واستخدم مجلد استخراج جديداً وفارغاً. الأرشيف مصدر برمجي وليس مثبت حاويات جاهزاً أو نسخة قاعدة بيانات احتياطية. حزمة Android المنشورة v1.0.0-beta.2 ملف ZIP لتطبيق APK موقّع وليست أرشيف المصدر. راجع حالة الإصدار.

إعداد المضيف

استخدم خادم Unix تتحكم فيه المؤسسة وDocker Compose ونطاقاً وتخزيناً دائماً. راجع المتطلبات. أبقِ الإعداد الأول خاصاً. من جذر مستودع التطبيق:

cp infrastructure/.env.selfhost.example infrastructure/.env.selfhost
# Edit the instance ID, domain and unique secrets first.
bash infrastructure/scripts/deploy.sh

اختر RAFIK_INSTANCE_ID فريداً بأحرف صغيرة وكلمات مرور عشوائية وفريدة بطول 64 خانة سداسية لـPostgreSQL وAPI. اضبط DNS قبل طلب Caddy لشهادة HTTPS. احمِ ملف البيئة ولا تضفه إلى Git أو تكشف PostgreSQL أو هويات تجريبية.

التشغيل والقوالب الاختيارية

يشغّل ملف selfhost الويب وAPI وPostgreSQL والترحيلات ووكيل HTTPS. لا يحتاج الدخول والدعوات الحاليان إلى SMTP أو مفاتيح حساب خدمة Google. بريد التواصل في هذا الموقع تكامل اختياري منفصل.

تهيئ قوالب AWS EC2 وGoogle Compute Engine وAzure Linux VM المكدس نفسه. لا توفر قاعدة مُدارة أو جدولة نسخ احتياطي أو مراقبة. لم يُتحقق من تشغيلها وتكلفتها وصلاحياتها وتحديثها واستردادها وإزالتها لدى المزودين. احمِ حالة Terraform ولا تودع الأسرار.

التقييم والاستخدام الفعلي

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

التنزيلات والدليل المرجعي

احتفظ بأرشيفات المصدر والملفات الثنائية المقبولة على GitHub، واربطها من الموقع دون نسخها إليه. تحقق من بصمات الملفات المرفوعة؛ وقد تتغير بايتات الأرشيفات المُولّدة آلياً حتى مع ثبات محتوى المصدر.

رُوجع في 22 أكتوبر 2026 وفق beta.2 المنشور وفرع main الحالي. اتبع دليل التشغيل المثبّت للمراجعة وحالة الإصدار.