عافيتك | Afitik

📖 الوصف

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

🏆 الميزات

• 📚 تعريف بالعضلات: معلومات شاملة عن العضلات وتقسيماتها.
• 🏋️‍♂️ تمارين مخصصة: مجموعة متنوعة من التمارين بالصورة والفيديو.
• 🍎 أنظمة غذائية: خطط غذائية صحية لتحقيق أهدافك.
• 📊 أدوات حساب: حساب السعرات الحرارية وكتلة الجسم.
• 🏆 تتبع الإنجازات: متابعة تقدمك في التمارين والنظام الغذائي.
• 📅 جدول تمارين: تنظيم جدول تمارين أسبوعي أو شهري.
• 🏋️‍♂️ تعريف بالأجهزة الرياضية: معلومات عن الأجهزة الرياضية المختلفة.

📸 صور الشاشة

🛠️ التبعية الخلفية: FileServeX

تطبيق عافيتك يعتمد على FileServeX لتقديم الصور وملفات JSON. تأكد من إعداد FileServeX بالشكل التالي:

• العنوان الأساسي: http://localhost:7000
• تنزيل ملفات MuscleWiki: musclewiki.zip (الحجم: 77.4 جيجابايت)

تأكد من استخراج دليل musclewiki ووضعه في دليل files على خادم FileServeX.

http://localhost:7000/files/musclewiki

📦 متغيرات البيئة (.env)

ملاحظة: ملف keytool.js يعتمد على متغيرات بيئية تُحفظ في ملف .env. تأكد من إعداد ملف .env بالشكل التالي:

• STORE_PASSWORD:

  • الوصف: كلمة مرور المتجر (store password) للـ keystore.
  • النوع: سلسلة نصية (string).

• PORT_SERVER_EXPRESS:

  • الوصف: رقم المنفذ الذي يستخدمه خادم Express.
  • النوع: سلسلة نصية (string).

• ALIAS:

  • الوصف: الاسم المستعار (alias) للمفتاح داخل الـ keystore.
  • النوع: سلسلة نصية (string).

• KEY_PASSWORD:

  • الوصف: كلمة مرور المفتاح (key password) داخل الـ keystore.
  • النوع: سلسلة نصية (string).

• DNAME_CN:

  • الوصف: الاسم الشائع (Common Name) للكيان.
  • النوع: سلسلة نصية (string).

• DNAME_OU:

  • الوصف: وحدة التنظيم (Organizational Unit).
  • النوع: سلسلة نصية (string).

• DNAME_O:

  • الوصف: المؤسسة (Organization).
  • النوع: سلسلة نصية (string).

• DNAME_L:

  • الوصف: المدينة (Locality).
  • النوع: سلسلة نصية (string).

• DNAME_S:

  • الوصف: الولاية أو المقاطعة (State).
  • النوع: سلسلة نصية (string).

• DNAME_C:

  • الوصف: البلد (Country).
  • النوع: سلسلة نصية (string).

• REACT_APP_API_BASE_URL:

  • الوصف: عنوان الرئيسي API للوصول إلى خادم FileServeX.
  • النوع: سلسلة نصية (string).

🚀 السكربتات (scripts)

تحدد السكربتات في ملف package.json المهام التي يمكن تنفيذها. فيما يلي شرح لكل سكربت:

• server:

  • الوصف: يقوم بتشغيل خادم Express.js الذي يعيد توجيه جميع الطلبات إلى index.html، مما يتيح معالجة الروابط باستخدام React Router. يُستخدم هذا الأمر لتشغيل الموقع الإلكتروني المحلي.
  • الاستخدام: npm run server

• keytool:

  • الوصف: يقوم بتشغيل السكربت keytool.js لإنشاء keystore.
  • الاستخدام: npm run keytool

• dev:

  • الوصف: يبدأ بيئة تطوير React.
  • الاستخدام: npm run dev

• build:

  • الوصف: يبني التطبيق باستخدام سكربت prebuild.js ثم يبني مشروع React.
  • الاستخدام: npm run build

• android:

  • الوصف: يضيف منصة Android إلى مشروع Cordova.
  • الاستخدام: npm run android

• re-android:

  • الوصف: يزيل ويعيد إضافة منصة Android إلى مشروع Cordova.
  • الاستخدام: npm run re-android

• build-apk:

  • الوصف: يبني تطبيق Android على شكل APK.
  • الاستخدام: npm run build-apk

• build-aab:

  • الوصف: يبني تطبيق Android على شكل AAB (Android App Bundle).
  • الاستخدام: npm run build-aab

• device:

  • الوصف: يشغل التطبيق على جهاز Android متصل.
  • الاستخدام: npm run device

• bu-device:

  • الوصف: يبني التطبيق ويشغله على جهاز Android متصل.
  • الاستخدام: npm run bu-device

• logcat:

  • الوصف: يعرض سجلات adb logcat.
  • الاستخدام: npm run logcat

• log:

  • الوصف: يعرض سجلات adb logcat مع تصفية لرسائل INFO:CONSOLE.
  • الاستخدام: npm run log

• clean:

  • الوصف: ينظف مشروع Cordova وذاكرة التخزين المؤقت لـ npm.
  • الاستخدام: npm run clean

• rm:

  • الوصف: يزيل مجلدات node_modules وplatforms وplugins وملف package-lock.json، ثم يعيد بناء مشروع Android.
  • الاستخدام: npm run rm

• rm-linux:

  • الوصف: يقوم بنفس وظيفة السكربت rm ولكن على أنظمة Linux.
  • الاستخدام: npm run rm-linux

• sync:

  • الوصف: يحضر جميع منصات Cordova.
  • الاستخدام: npm run sync

تثبيت وتهيئة بيئة التطوير لـ Cordova 📱

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

📄 تثبيت وتهيئة بيئة التطوير لـ Cordova - عربي
📄 Setting Up Cordova Development Environment - English

هيكل المشروع

الملف / المجلد	الوصف
myPlg	مجلد يحتوي على الإضافات الخاصة بالمشروع.
platforms	مجلد يحتوي على ملفات ومنصات Cordova. (يتم إنشاؤه تلقائيًا)
plugins	مجلد يحتوي على إضافات Cordova المستخدمة في المشروع. (يتم إنشاؤه تلقائيًا)
public	مجلد يحتوي على ملفات عامة يمكن الوصول إليها من الواجهة.
resources	مجلد يحتوي على الموارد المختلفة للتطبيق.
setup_cordova	مجلد يحتوي على ملفات إعداد بيئة تطوير Cordova.
src	مجلد يحتوي على الشيفرات المصدرية للتطبيق.
unused	مجلد يحتوي على الملفات والصور غير المستخدمة حاليًا.
www	مجلد يحتوي على الملفات التي يتم تقديمها من الخادم.
build.json	ملف إعدادات البناء للتطبيق. (يتم إنشاؤه تلقائيًا)
config.xml	ملف إعدادات Cordova.
keytool.js	سكربت لإنشاء keystore لتوقيع التطبيقات.
LICENSE	ملف يحتوي على تفاصيل الترخيص.
package.json	ملف تعريف المشروع وحزم Node.js.
prebuild.js	سكربت يتم تنفيذه قبل عملية البناء.
README.EN.md	ملف توثيق باللغة الإنجليزية.
README.md	ملف توثيق باللغة العربية.
release.keystore	ملف keystore لتوقيع تطبيقات Android. (يتم إنشاؤه تلقائيًا)
server.mjs	سكربت خادم Express.js يشغل الخادم ويعيد توجيه جميع الطلبات إلى index.html لمعالجة الروابط باستخدام React Router.