Asem75 commited on
Commit
29eb60e
·
verified ·
1 Parent(s): 5371328

Upload 2 files

Browse files
Files changed (2) hide show
  1. README.md +34 -99
  2. integration_example.html +156 -0
README.md CHANGED
@@ -1,111 +1,46 @@
1
- ---
2
- title: الساعة الإسلامية
3
- emoji: 🌙
4
- colorFrom: indigo
5
- colorTo: purple
6
- sdk: static
7
- app_file: index.html
8
- pinned: false
9
- fullWidth: true
10
- header: mini
11
- short_description: الساعة الإسلامية — مواقيت وعبادات وقرآن وتنبيهات زمنية
12
- ---
13
 
14
- # الساعة الإسلامية
15
 
16
- تطبيق إسلامي زمني يعمل كمساحة Static على Hugging Face Spaces.
17
 
18
- ## ملفات مساحة التشغيل
 
 
 
 
 
19
 
20
- يجب رفع الملفات التالية إلى جذر الـSpace بالأسماء نفسها، دون إضافة أرقام أو كلمات إلى أسمائها:
21
 
22
- - `README.md`
23
- - `index.html`
24
- - `astronomy.browser.min.js`
25
- - `solar_engine.js`
26
- - `personal_reminder_engine.js`
27
- - `hijri_calendar_engine.js`
28
- - `worship_event_engine.js`
29
- - `registry_app.js`
30
- - `sw.js`
31
- - `visual_states_registry.json`
32
- - `fiqh_time_registry.json`
33
- - `worship_fiqh_registry.json`
34
- - `islamic_events_registry.json`
35
- - `religious_content_registry.json`
36
- - `contextual_knowledge_registry.json`
37
- - `on_this_day_registry.json`
38
- - `user_time_markers_registry.json`
39
- - `announcements_guidance_registry.json`
40
- - `content_channels_registry.json`
41
- - `astronomy_events_registry.json`
42
- - `external_sources_registry.json`
43
 
44
- الملف الرئيسي هو `index.html`، وأصبح خاصًا بالهيكل والواجهة وتحميل الوحدات فقط.
45
 
46
- - `astronomy.browser.min.js`: Astronomy Engine 2.1.19، نسخة محلية أصلية بترخيص MIT المحفوظ داخل الملف.
47
- - `solar_engine.js`: ربط API المكتبة الفلكية المحلية بالحدود الموجودة في سجل الزمن؛ لا يتصل بخدمة HTTP ولا يرسل إحداثيات المستخدم.
48
- - `personal_reminder_engine.js`: تخزين وجدولة التذكيرات الشخصية.
49
- - `hijri_calendar_engine.js`: قراءة التاريخ الهجري، تأكيد بداية الشهر محليًا، ومطابقة الأيام والليالي.
50
- - `worship_event_engine.js`: جدولة مشغلات العبادات والرواتب والمواسم، وحساب الكسوف والخسوف المحلي عبر Astronomy Engine.
51
- - `registry_app.js`: منسق التطبيق والواجهة وربط المحركات بالسجلات.
52
- - `sw.js`: دعم إشعارات النظام عند التشغيل عبر HTTPS.
53
 
54
- تبقى الأحكام والمحتوى والألوان والمواعيد التعريفية داخل ملفات الـRegistry المالكة لها؛ ملفات JavaScript تستهلكها ولا تنسخها.
55
 
56
- ## إصلاحات 26 سبتمبر 2026
 
 
 
 
 
57
 
58
- تحديث 27 سبتمبر: فصل نوع المحتوى عن طريقة التذكير. من إضافة تذكير اختر النوع مثل 📖 ورد القرآن، ثم «طريقة التذكير»: مرة واحدة، متكرر/عادة، أو جلسات تركيز. جميع الأنواع الشخصية المفعلة تدعم الطرق الثلاث. قوائم العادة والتركيز القديمة تبقى اختصارات بقيم افتراضية ولا تفرض الطريقة على المحتوى. التذكيرات والعبادات التلقائية ذات الجداول الشرعية لا تتغير بهذه الإعدادات الشخصية.
 
59
 
60
- يمكن تعديل التذكير نفسه وتغيير نوعه وطريقته دون إنشاء معرّف جديد أو ح��ف بقية المواعيد. يبقى رمز القرآن ظاهرًا مع التكرار والتركيز. تكرار الورد للتذكير فقط، دون سجل إنجاز أو سلسلة التزام. سجلات التخزين القديمة تبقى بالإصدار والمفتاح نفسيهما، مع قراءة جداول العادات اليومية/الأسبوعية القديمة.
61
 
62
- جلسات التركيز تبدأ الآن أو في موعد محدد. تعديل النص/النوع وحده يحافظ على مرحلة الجلسة الجارية؛ تغيير المدد أو موعد البداية يعيد تشغيل جدولها. بعد حفظ النموذج تظهر رسالة «تم الحفظ». لا يمثل انتهاء مدة الجلسة إكمال العبادة.
63
-
64
- تحديث علامات المواعيد: كل تذكير شخصي محفوظ يظهر برمز نوعه ونصه ووقته أسفل المسطرة، ضمن التواريخ المعروضة ومع علامات الأذكار. تظهر جميع مرات التكرار داخل هذه الفترة حتى إن بقي تنبيه سابق مستحقًا، دون نسخ السجل في التخزين. الضغط على العلامة يفتح سجل الموعد وتاريخ تلك المرة؛ إقرار التنبيه لا يحذف علاماته، وتبقى علامة جلسة التركيز عند بدايتها بعد انتهائها. هذا سجل مواعيد وليس سجل أداء للعبادات.
65
-
66
- بعد الحفظ تنتقل المسطرة إلى الموعد؛ إذا كان خارج الفترة الحالية تعرض تاريخه مع زر «العودة إلى اليوم». يمكن الوصول إليه مجددًا من تفاصيل التذكير عبر «عرض الموعد على المسطرة». يعاد حساب حدود الشمس والعبادات للتاريخ المعروض، وتبقى التنبيهات معتمدة على الوقت الفعلي. الرموز والنصوص تأتي من السجلات، وترتيب القراءة زمني داخل الساعات.
67
-
68
- - قارئ الشاشة يصل إلى أزرار الساعات ويسمع الساعة فقط، دون التاريخ أو عبارة إعدادات الساعة. عنوان النافذة عند الضغط هو الساعة أيضًا؛ تبقى خيارات الإعداد داخلها متاحة.
69
- - إدارة التذكيرات ← أذكار الصباح والمساء والنوم: تفعيل مستقل لكل تذكير، موعد يومي أو ربط بصلاة، إزاحة بالدقائق، وصوت اختياري. اختيار «أذكار» عند إضافة تذكير يفتح هذه القائمة، ومنها تذكير أذكار خاص لمرة واحدة. ليست هذه شاشة نصوص أذكار أو تلاوة صوتية.
70
- - لا تتبع إنجاز للعبادات، ولا تشغيل تلقائي لتلاوة. تبقى بيانات التذكيرات السابقة ومفاتيح تخزينها دون تغيير.
71
- - الحساب الشمسي يستخدم Astronomy Engine فعلًا عبر Equator/Horizon. تتحرك علامة الوقت على المسطرة وفق الساعة، وتأتي حالة الشمس وارتفاعها وحدودها من المحرك، لا من مواقيت الأذان. زوايا الشفق 15° و18° بقيت تقديرات موروثة تحتاج اعتمادًا رصديًا؛ المحرك الأدق لا يجعلها حقيقة رصدية قطعية.
72
- - فصل صفوف حدود الشمس بصريًا لمنع تداخل الأحمر والأبيض عند التفاف النص.
73
- - علامات الأذكار والعبادات والتذكيرات الشخصية في صفوف موازية أسفل مساحة الساعات. ترتيب DOM زمني داخل كل ساعة ثم الساعة التالية، بصرف النظر عن الصف البصري؛ لا يستخدم tabindex موجبًا أو نسخة مكررة مخفية للعلامة. ارتفاع العرض يتسع للصفوف المتزامنة.
74
- - تنبيهات العبادات والمناسبات متاحة من إدارة التذكيرات ومن نافذة الساعة. تعمل الرواتب والضحى والقيام والوتر والاثنين والخميس والجمعة والأيام البيض، والمواسم الهجرية بعد تحقق شروطها.
75
- - إعدادات التاريخ الهجري ← تأكيد بداية شهر هجري: السنة والشهر وتاريخ أول يوم ميلادي وعدد أيام الشهر المعتمد. تحفظ محليًا، ولا يؤكد الحساب شهرًا تلقائيًا. عدّل عدد الأيام عند إعلان نهاية الشهر. يبقى تصحيح ±2 أيام مستقلًا للتاريخ المحسوب غير المؤكد.
76
- - ليالي رمضان تبدأ من غروب اليوم السابق للتاريخ النهاري المقابل. تطبق حدود اليوم/الليلة عبر جميع المشغلات، وتستبعد الليلة الثلاثون في الشهر المؤكد ذي 29 يومًا. يبقى منع اقتراح الصيام في العيدين وأيام التشريق فعالًا.
77
- - ست شوال: تذكير بداية الموسم، وإعداد اختياري لأيام الأسبوع ووقت التذكير داخله؛ بلا تتبع لعدد أيام الصيام.
78
- - تذكير السنن القبلية يبدأ عند دخول وقت الفريضة؛ لا تُطرح عشرون أو خمس وعشرون دقيقة قبل دخول الوقت. تذكيرات البعدية مشروطة بأداء الفريضة ولا تفترض أداءها. المرجع: https://binbaz.org.sa/fatwas/17913/حكم-صلاة-السنن-القبلية-للفراىض-قبل-الاذان
79
- - تذكير الضحى المتأخر وآخر عصر الجمعة اختيار جدولة نسبي داخل النافذة المحسوبة، وموسوم في السجل بسياسة تطبيق؛ ليس تحديدًا شرعيًا بالدقيقة. لا يغيّر الحدود الشمسية أو ألوان المذهب.
80
- - بطاقة الكسوف والخسوف مرتبطة بالموقع وبمراحل الظاهرة من سجل الفلك. تفحص الظهور فوق الأفق، ويستبعد التذكير بصلاة الخسوف لشبه الظل وحده. التنبؤ لا يثبت المشاهدة الفعلية؛ النص يربط العبادة برؤية الظاهرة، وتنتهي التنبيهات النشطة بانتهاء الجزء المرئي. مصدر البطاقة: https://aliftaa.jo/research-fatwas/3405 . توثيق المحرك: https://github.com/cosinekitty/astronomy/blob/master/source/js/README.md
81
-
82
- ## نتيجة مراجعة الربط وحدوده
83
-
84
- السجلات الأساسية الـ12 في قائمة التحميل مستهلكة في التطبيق، لكن تحميلها لا يعني اكتمال كل خصائصها:
85
-
86
- | السجل | الاستخدام الفعلي |
87
- | --- | --- |
88
- | visual_states | النصوص والألوان والرموز ومسارات العرض |
89
- | fiqh_time | الحدود والحساب وطرق الصلاة وربط مشغلات التنبيه |
90
- | worship_fiqh | فترات العبادات والأحكام واختلافات المذاهب |
91
- | islamic_events | جميع صيغ مشغلات العبادات المسجلة وإعدادات الأذكار والمواسم وتأكيد الشهر؛ احترام popup:false للأحكام المعروضة كألوان |
92
- | religious_content | إحالات التوافق بين القواعد والحدود |
93
- | contextual_knowledge | المعلومات المرتبطة بالحدود ونافذة المعرفة |
94
- | user_time_markers | الأنواع والتخزين والتكرار والبومودورو والتأجيل |
95
- | on_this_day | عرض فهرس الأحداث ومصادرها؛ لا جدولة تلقائية كاملة |
96
- | announcements_guidance | قراءة وعرض العناصر؛ السجل الحالي خالٍ من العناصر |
97
- | content_channels | فهرس القنوات؛ لا يوجد جلب/جدولة اشتراكات مكتمل |
98
- | external_sources | عرض تعريفات ومراجع المزودين؛ ليس اتصالًا حيًا بجميع APIs |
99
- | astronomy_events | الكسوف والخسوف المحليان مرتبطان ببطاقة العبادة ومراحل التنبيه؛ بقية الظواهر غير التعبدية ما زالت فهرس تعريفات |
100
-
101
- `fiqh_time_registry_solar_v1_1.json` نسخة مرجعية قديمة، وليست سجل تشغيل ثانٍ؛ لا تُحمّل مع السجل الحالي ولا تُحذف.
102
-
103
- مرجع `eclipse_prayer` محلول الآن ببطاقة في سجل الأحداث الإسلامية، دون اختراع تفصيل مذهبي لكيفية الصلاة. الأحداث التي تمنع الصيام أو تصف النهي وتحدد `popup:false` تبقى أحكامًا وألوانًا وليست نوافذ منبثقة. الإغلاق الكامل للمتصفح لا يضمن التنبيهات؛ التطبيق المساعد المحلي الاختياري ما زال مرحلة لاحقة.
104
-
105
- ## التحقق المنفذ
106
-
107
- أصبح الإجمالي 117 تجربة ناجحة بعد إضافة 12 اختبارًا لعلامات المواعيد: التكرار مع وجود تنبيه سابق، جميع مرات التكرار في الساعة، بقاء بداية التركيز، العرض مع الأذكار، ترتيب القراءة، الإقرار، فتح المرة المحددة، الانتقال لتاريخ بعيد مع الموقع والحساب الشمسي، العودة لليوم، العثور على موعد محفوظ، إعادة التحميل دون نسخ السجلات، والحذف الانتقائي.
108
-
109
- نجحت 105 تجارب آلية على JavaScript وDOM محاكى. شملت المحافظة على وظائف الساعة والتذكيرات والبومودورو، العلامات السفلية وترتيب DOM، تغطية كل مشغّل تعبدي مسجل، شروط ثبوت الشهر، رمضان 29/30، الليالي الوترية وغروب اليوم السابق، تعارض الصيام مع العيد والتشريق، حفظ إعداد الموسم وتأكيد الشهر من الواجهة، وتنبؤات كسوف وخسوف فعلية مع استبعاد موقع لا يرى الظاهرة. أضيفت 40 تجربة لفصل النوع والطريقة، تشمل الأنواع الثمانية مع الطرق الثلاث، التبديل دون فقد النص أو مضاعفة التذكير، قراءة البيانات القديمة، ظهور رمز القرآن أسفل المسطرة، الحفظ وإعادة الفتح، بدء التركيز المؤجل، وعدم تتبع إنجاز العبادات.
110
-
111
- لم يجر اختبار TalkBack أو الصوت الفعلي على هاتف؛ فحص ترتيب القراءة يعتمد على DOM محاكى. لم تتوفر بيئة Chromium لقياس المظهر بصريًا؛ يلزم اختبار الجهاز بعد الرفع. هذه التغطية تخص العبادات المسجلة، ولا تعني اكتمال قنوات الأخبار والقرآن أو كل الظواهر الفلكية غير التعبدية.
 
1
+ # حزمة محاكاة السماء والقبلة - ساعة المسلم
 
 
 
 
 
 
 
 
 
 
 
2
 
3
+ هذه نسخة خفيفة من محركات القسم الثاني في مشروع **ساعة المسلم / الخط الزمني الروحي**.
4
 
5
+ ## ماذا تحتوي؟
6
 
7
+ | الملف | وظيفته |
8
+ |---|---|
9
+ | `celestial_simulation.js` | ملف واحد يجمع محركات الشمس والقمر والظل والقبلة والعرض |
10
+ | `sky_simulation_registry.json` | إعدادات العرض البصري فقط: ألوان السماء، حجم الرموز، حساسية القبلة |
11
+ | `integration_example.html` | صفحة تجربة وربط سريعة |
12
+ | `README.md` | شرح الحزمة |
13
 
14
+ ## القرار المعماري
15
 
16
+ - الحسابات ليست داخل `index.html`.
17
+ - الواجهة تعرض فقط.
18
+ - لون السماء يتغير تدريجيًا حسب ارتفاع الشمس دقيقة بدقيقة.
19
+ - القمر يظهر بطوره الحقيقي التقريبي ونسبة الإضاءة.
20
+ - الظل يعتمد على ارتفاع الشمس ويظهر ظل المثل والمثلين ضمن بيانات المحرك.
21
+ - القبلة تعتمد على موقع المستخدم واتجاه الهاتف عند توفر حساس الاتجاه.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
22
 
23
+ ## طريقة الربط لاحقًا داخل `index.html`
24
 
25
+ ```html
26
+ <script src="./celestial_simulation.js"></script>
27
+ ```
 
 
 
 
28
 
29
+ ثم:
30
 
31
+ ```js
32
+ const controller = new CelestialSimulation.CelestialSimulationController({
33
+ location: { lat: 31.9539, lng: 35.9106 },
34
+ registry,
35
+ renderer
36
+ });
37
 
38
+ controller.start({ intervalMs: 60000 });
39
+ ```
40
 
41
+ ## ملاحظات مهمة
42
 
43
+ - هذا الملف لا يملك أحكامًا فقهية ولا مواقيت صلاة.
44
+ - محاكاة الظل تشرح الحركة بصريًا، أما اعتماد وقت العصر والمذهب فيبقى من محرك الصلاة والـRegistry الفقهي.
45
+ - محاكاة القبلة عبر الهاتف تحتاج HTTPS وإذن حساس الاتجاه في المتصفح.
46
+ - ملف `integration_example.html` للتجربة فقط، وليس بديلًا عن ملف المشروع النهائي `index.html`.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
integration_example.html ADDED
@@ -0,0 +1,156 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ <!doctype html>
2
+ <html lang="ar" dir="rtl">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>تجربة محاكاة السماء والقبلة</title>
7
+ <style>
8
+ body {
9
+ margin: 0;
10
+ font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
11
+ background: #071326;
12
+ color: #fff;
13
+ }
14
+
15
+ .sky {
16
+ position: relative;
17
+ min-height: 100vh;
18
+ overflow: hidden;
19
+ transition: background 900ms linear;
20
+ }
21
+
22
+ .sun,
23
+ .moon,
24
+ .kaaba {
25
+ position: absolute;
26
+ left: 50%;
27
+ top: 50%;
28
+ width: 40px;
29
+ height: 40px;
30
+ border-radius: 50%;
31
+ transform: translate(-50%, -50%);
32
+ transition: left 900ms linear, top 900ms linear, opacity 500ms linear;
33
+ }
34
+
35
+ .sun {
36
+ background: #ffd45c;
37
+ box-shadow: 0 0 36px rgba(255, 212, 92, .72);
38
+ }
39
+
40
+ .kaaba {
41
+ right: 24px;
42
+ bottom: 82px;
43
+ left: auto;
44
+ top: auto;
45
+ width: 54px;
46
+ height: 54px;
47
+ border-radius: 8px;
48
+ background: linear-gradient(180deg, #191919, #050505);
49
+ border: 3px solid #d7b56d;
50
+ }
51
+
52
+ .shadow-base {
53
+ position: absolute;
54
+ right: 50%;
55
+ bottom: 86px;
56
+ width: 10px;
57
+ height: 64px;
58
+ background: rgba(255, 255, 255, .72);
59
+ border-radius: 8px;
60
+ }
61
+
62
+ .shadow {
63
+ position: absolute;
64
+ right: calc(50% + 4px);
65
+ bottom: 86px;
66
+ height: 10px;
67
+ width: 80px;
68
+ background: rgba(0, 0, 0, .42);
69
+ border-radius: 999px;
70
+ transform-origin: right center;
71
+ transition: width 900ms linear, transform 900ms linear, opacity 500ms linear;
72
+ }
73
+
74
+ .horizon {
75
+ position: absolute;
76
+ inset-inline: 0;
77
+ bottom: 0;
78
+ height: 105px;
79
+ background: linear-gradient(180deg, rgba(38, 79, 56, .2), rgba(21, 73, 45, .9));
80
+ }
81
+
82
+ .info {
83
+ position: absolute;
84
+ inset-inline: 16px;
85
+ bottom: 16px;
86
+ padding: 12px 14px;
87
+ border-radius: 8px;
88
+ background: rgba(0, 0, 0, .42);
89
+ backdrop-filter: blur(8px);
90
+ line-height: 1.7;
91
+ font-size: 14px;
92
+ }
93
+
94
+ .controls {
95
+ position: absolute;
96
+ top: 16px;
97
+ inset-inline: 16px;
98
+ display: flex;
99
+ gap: 8px;
100
+ flex-wrap: wrap;
101
+ }
102
+
103
+ button {
104
+ border: 0;
105
+ border-radius: 8px;
106
+ padding: 10px 12px;
107
+ font: inherit;
108
+ cursor: pointer;
109
+ }
110
+ </style>
111
+ </head>
112
+ <body>
113
+ <main id="sky" class="sky">
114
+ <div class="controls">
115
+ <button id="enableCompass">تفعيل اتجاه الهاتف</button>
116
+ </div>
117
+ <div id="sun" class="sun"></div>
118
+ <div id="moon" class="moon"></div>
119
+ <div id="kaaba" class="kaaba" title="محاكاة اتجاه القبلة"></div>
120
+ <div class="shadow-base"></div>
121
+ <div id="shadow" class="shadow"></div>
122
+ <div class="horizon"></div>
123
+ <div id="info" class="info">جاري تشغيل المحاكاة...</div>
124
+ </main>
125
+
126
+ <script src="./celestial_simulation.js"></script>
127
+ <script>
128
+ async function main() {
129
+ const registry = await fetch("./sky_simulation_registry.json").then((response) => response.json());
130
+ const renderer = new CelestialSimulation.SkySimulationRenderer({
131
+ container: document.getElementById("sky"),
132
+ sun: document.getElementById("sun"),
133
+ moon: document.getElementById("moon"),
134
+ kaaba: document.getElementById("kaaba"),
135
+ shadow: document.getElementById("shadow"),
136
+ info: document.getElementById("info")
137
+ }, registry);
138
+
139
+ const controller = new CelestialSimulation.CelestialSimulationController({
140
+ location: { lat: 31.9539, lng: 35.9106 },
141
+ registry,
142
+ renderer
143
+ });
144
+
145
+ controller.start({ intervalMs: 60000 });
146
+ document.getElementById("enableCompass").addEventListener("click", () => {
147
+ controller.enableCompass((message) => {
148
+ document.getElementById("info").textContent = message;
149
+ });
150
+ });
151
+ }
152
+
153
+ main();
154
+ </script>
155
+ </body>
156
+ </html>