Skip to content

AdammLab/Hisn

Repository files navigation

حصن / Hisn 🕌

حصن المسلم الشامل - رفيقك اليومي المبتكر للعبادة، التحصين، ومتابعة الصلوات

Vite Build React Capacitor Android APK Size License

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

🔗 رابط المعاينة المباشرة للموقع التعريفي (Live Showcase): AdammLab.github.io/Hisn/


🎨 الهوية البصرية والتصميم (Design System)

تم بناء واجهة المستخدم بالاعتماد على فلسفة الزجاج المصقول (Glassmorphism) والمؤشرات البصرية الميكروية (Micro-animations):

  • تدرج ألوان رمادي/زمردي مريح للعين (bg-neutral-50 dark:bg-[#16161a] مع هوامش وحدود border-neutral-200 dark:border-neutral-800).
  • خطوط عربية كلاسيكية أصيلة (font-amiri لقراءة القرآن الكريم، وfont-naskh للأذكار والنصوص العامة).
  • دعم السمة الداكنة التلقائية المتزامنة مع نظام الهاتف بالكامل.

🌟 الميزات الجبارة المضافة (Key Features)

1. المصحف الشريف (أوفلاين 100% مدى الحياة) 📖

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

🛡️ 2. بروتوكول الرقية العلاجية الموحدة (67 خطوة)

  • دمج شامل ومسلسل: دمج الـ 25 خطوة العامة مع الـ 42 خطوة علاجية تخصصية (السحر، المس، العين، القرين، التفريق) في جدول علاجي موحد ومستمر.
  • عداد تنازلي تفاعلي: الضغط على الخطوة ينقص عدد التكرارات تلقائياً، ومع اكتمال التكرارات تتحول الخطوة لحالة المكتمل مع تظليل ناعم.
  • إعادة ضبط ذكي: إمكانية تصفير أو إعادة ضبط تقدم الرقية بالكامل بنقرة واحدة.

🔔 3. التنبيهات المكررة الذكية للأذكار اليومية

  • تنبيهات مجدولة: تنبيهات نظام تلقائية لأذكار الصباح (7:00 ص)، أذكار المساء (4:30 م)، وأذكار النوم (10:00 م).
  • إلحاح التحصين: في حال عدم قراءة الورد، يرسل التطبيق إشعاراً تذكيرياً لطيفاً كل 30 دقيقة متتالية.
  • إلغاء فوري ذكي: بمجرد دخول المستخدم وإتمام قراءة الورد، يلغي التطبيق فوراً كافة التذكيرات المتبقية لذلك اليوم لتوفير طاقة البطارية ومنع الإزعاج.

📈 4. التزام الصلوات الأسبوعي ومؤشر التهجد

  • رسم بياني متفاعل بمتوسط الصلوات: تدرج لوني دافئ يتصاعد من الأخضر الباهت عند أداء صلاة واحدة إلى اللون الزمردي الزاهي والصلد عند إتمام الصلوات الخمس كاملة (5/5).
  • متابعة ركعات قيام الليل: يظهر رمز هلال ورقم الركعات المبسط (مثل 🌙 8) أعلى العمود كحافز إيماني لمتابعة السنن والنوافل الليلية.

📻 5. البث الإذاعي الصوتي والمشغل الذكي

  • مشغل صوتي مستقر: مشغل صوتي محلي مدعوم بخدمة أندرويد أصلية في الخلفية (Foreground Audio Service) لمنع خنق WebView.
  • إذاعات البث المباشر: إذاعة القرآن من القاهرة والرياض، إذاعة الرقية الشرعية على مدار 24 ساعة.
  • مؤشرات التحميل والاتصال (Buffer States): إظهار مؤشار تحميل دوار (Spinner) متناسق داخل أزرار التشغيل لتوضيح حالة الاتصال وسرعة استجابة البث المباشر.

📿 6. مسبحة التسبيح التفاعلية

  • عداد رقمي كبير مع مؤشر تقدم دائري تفاعلي.
  • اهتزازات تفاعلية خفيفة ولطيفة (Haptic Feedback) مع كل تسبيحة وعند بلوغ الهدف المحدد (33، 99، أو هدف مخصص).

🛡️ 7. تحدي العفة والتعافي (تعقب النقاء)

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

🛠️ التكنولوجيات المستخدمة (Tech Stack)

  • الواجهة الأمامية (Frontend): React (Single Page Application)
  • أداة البناء (Build Tool): Vite & Rollup
  • التصميم والتنسيق: Vanilla CSS & TailwindCSS (للصفحة التعريفية والمكونات الزجاجية)
  • الجسر الهجين (Hybrid Bridge): @capacitor/core & @capacitor/android
  • معالجة الصوت المحسن: @capacitor/app & Native Android Service
  • الاستضافة والتوثيق: GitHub Pages (/docs directory)

⚙️ تشغيل وتهيئة المشروع محلياً (Local Setup)

  1. قم بعمل Clone للمستودع:
    git clone https://github.com/AdammLab/Hisn.git
  2. قم بتثبيت الحزم البرمجية:
    npm install
  3. تشغيل التطبيق في بيئة التطوير المحلية:
    npm run dev
  4. بناء نسخة الإنتاج والمزامنة مع الأندرويد:
    npm run build
    npx cap sync

📱 ترجمة التطبيق للأندرويد (Android Compilation)

  • افتح المجلد android بداخل أداة Android Studio.
  • لتصدير حزمة الـ APK المباشرة عبر الطرفية، قم بتشغيل الأمر:
    cd android && ./gradlew assembleDebug
  • الحزمة الناتجة ستكون متوفرة في المسار: android/app/build/outputs/apk/debug/app-debug.apk بحجم 4.9 ميجابايت فقط!

About

حصن - رفيقك اليومي للعبادة والأذكار، أوفلاين 100% ويحتوي على تعقب الصلوات ومستويات التعافي والعفة

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors