Islamic_clock / validate_registries.js
Asem75's picture
Update validate_registries.js
a9d10a4 verified
Raw History Blame Contribute Delete
24.2 kB
{
"schema_name": "islamic_clock_fiqh_time_registry",
"schema_version": "1.6.0",
"registry_id": "fiqh_time_registry",
"project": "الساعة الإسلامية / الخط الزمني الروحي",
"language": "ar",
"rtl": true,
"status": "time_boundaries_registry",
"purpose": "تعريف محطات وحدود الزمن التي تعتمد عليها المسطرة. لا يحتوي هذا الملف على ألوان أو أحكام عبادات أو محتوى.",
"separation_contract": {
"this_registry_owns": [
"أسماء الحدود الزمنية",
"ترتيب الحدود في الدورة اليومية",
"نوع مصدر كل حد: فلكي أو محرك صلاة أو مشتق",
"علاقات البداية والنهاية بين الحدود"
],
"this_registry_does_not_own": [
"ألوان المسطرة",
"حكم النهي أو الاستحباب",
"محتوى العبادات",
"النوافذ المنبثقة",
"تسجيل إنجاز العبادات"
]
},
"clock_display": {
"format": "12_hour",
"arabic_dayparts": true,
"examples": [
"6:00 صباحًا",
"12:00 ظهرًا",
"4:00 مساءً",
"12:00 منتصف الليل"
],
"forbid_24_hour_labels_in_ui": true
},
"daily_cycle": {
"anchor": "false_dawn",
"continues_into_next_day": true,
"end_boundary": "next_false_dawn",
"ui_model": "continuous_horizontal_ruler",
"note": "الدورة الزمنية متصلة؛ الوصول إلى نهاية الدورة يدخل مباشرة في دورة اليوم التالي."
},
"authorities": {
"astronomy_engine": {
"role": "حساب موضع الشمس والحدود الفلكية والرصدية",
"hardcoded_clock_minutes_for_solar_boundaries": false
},
"prayer_engine": {
"role": "إعطاء أوقات الصلاة المعتمدة حسب إعدادات التطبيق"
},
"derived_time_engine": {
"role": "اشتقاق الحدود الزمنية المركبة من حدود محسوبة أخرى"
},
"fiqh_profile": {
"role": "اختيار الحد الفقهي عندما توجد أكثر من طريقة معتبرة لتفسير حد زمني",
"note": "هذا الملف يعرّف الزمن فقط؛ الحكم التعبدي يوضع في Registry مستقل."
}
},
"boundaries": [
{
"id": "false_dawn",
"label": "الفجر الكاذب",
"source": "astronomy_engine",
"kind": "observational_estimate",
"fixed_minutes": false,
"note": "حد رصدي/فلكي تقديري مستقل عن الفجر الصادق."
},
{
"id": "true_dawn",
"label": "الفجر الصادق",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false
},
{
"id": "sunrise",
"label": "الشروق",
"source": "astronomy_engine",
"kind": "solar_boundary",
"fixed_minutes": false
},
{
"id": "sunrise_clear",
"label": "ارتفاع الشمس بعد الشروق",
"source": "astronomy_engine",
"kind": "solar_boundary",
"fixed_minutes": false,
"note": "يحسب من حركة الشمس؛ لا يُختزل في عدد دقائق ثابت بعد الشروق."
},
{
"id": "solar_noon",
"label": "الاستواء الشمسي",
"source": "astronomy_engine",
"kind": "solar_boundary",
"fixed_minutes": false
},
{
"id": "zawal",
"label": "الزوال",
"source": "astronomy_engine",
"kind": "solar_transition",
"fixed_minutes": false,
"relation": "بعد الاستواء عندما تبدأ الشمس بالميل عن أعلى ارتفاع"
},
{
"id": "dhuhr",
"label": "الظهر",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false
},
{
"id": "asr_shadow_1",
"label": "حد الظل: المثل",
"source": "astronomy_engine",
"kind": "shadow_factor_boundary",
"shadow_factor": 1,
"exclude_noon_shadow": true,
"fixed_minutes": false,
"note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لبدء العصر عند الجمهور وبعض الأقوال الحنفية."
},
{
"id": "asr_shadow_2",
"label": "حد الظل: المثلان",
"source": "astronomy_engine",
"kind": "shadow_factor_boundary",
"shadow_factor": 2,
"exclude_noon_shadow": true,
"fixed_minutes": false,
"note": "يحسب من طول الظل بعد استبعاد فيء الزوال؛ يستخدمه ملف الفقه لقول أبي حنيفة المشهور في بدء العصر."
},
{
"id": "asr",
"label": "العصر",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false
},
{
"id": "last_daylight_hour_start",
"label": "بداية آخر جزء من النهار",
"source": "derived_time_engine",
"kind": "derived_boundary",
"formula": "sunrise + (11/12 * duration(sunrise, sunset))",
"fixed_minutes": false,
"note": "النهار اثنا عشر جزءًا متساويًا بين الشروق والغروب؛ الحد حسابي فقط وتستخدمه طبقة الفقه لعرض ساعة الإجابة."
},
{
"id": "sunset_approach",
"label": "اقتراب الغروب",
"source": "astronomy_engine",
"kind": "solar_boundary",
"fixed_minutes": false,
"note": "لا يساوي وقت العصر ولا يُحدد برقم ساعة ثابت."
},
{
"id": "sunset",
"label": "الغروب",
"source": "astronomy_engine",
"kind": "solar_boundary",
"fixed_minutes": false
},
{
"id": "maghrib",
"label": "المغرب",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false
},
{
"id": "red_twilight_end",
"label": "نهاية الشفق الأحمر",
"source": "astronomy_engine",
"kind": "observational_estimate",
"fixed_minutes": false,
"note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
},
{
"id": "white_twilight_end",
"label": "نهاية الشفق الأبيض",
"source": "astronomy_engine",
"kind": "observational_estimate",
"fixed_minutes": false,
"note": "حد رصدي تقديري مستقل عن حد دخول العشاء الفقهي."
},
{
"id": "isha",
"label": "العشاء",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false
},
{
"id": "first_third_of_night",
"label": "نهاية الثلث الأول من الليل",
"source": "derived_time_engine",
"kind": "derived_boundary",
"formula": "sunset + (1/3 * duration(sunset, next_true_dawn))",
"fixed_minutes": false,
"note": "حد حسابي فقط تستخدمه طبقة الفقه عند تمييز فترات العشاء."
},
{
"id": "islamic_midnight",
"label": "منتصف الليل الشرعي",
"source": "derived_time_engine",
"kind": "derived_boundary",
"formula": "midpoint(sunset, next_true_dawn)",
"fixed_minutes": false
},
{
"id": "last_third_start",
"label": "بداية الثلث الأخير من الليل",
"source": "derived_time_engine",
"kind": "derived_boundary",
"formula": "sunset + (2/3 * duration(sunset, next_true_dawn))",
"fixed_minutes": false
},
{
"id": "next_false_dawn",
"label": "الفجر الكاذب لليوم التالي",
"source": "astronomy_engine",
"kind": "observational_estimate",
"fixed_minutes": false,
"cycle_link": "false_dawn"
},
{
"id": "next_true_dawn",
"label": "الفجر الصادق لليوم التالي",
"source": "prayer_engine",
"kind": "prayer_boundary",
"fixed_minutes": false,
"cycle_link": "true_dawn"
}
],
"aliases": {
"note": "أسماء بديلة تُحسب في calculation_profile.boundaries وتحيل إلى حد معرّف، وتُستعمل في worship_fiqh_registry ومشغلات التنبيه.",
"fajr": {
"alias_of": "true_dawn",
"label": "الفجر"
},
"isha_entry_hanafi": {
"alias_of": "white_twilight_end",
"label": "دخول العشاء عند الحنفية (الشفق الأبيض)"
}
},
"derived_windows": [
{
"id": "post_sunrise_to_sunrise_clear",
"start": "sunrise",
"end": "sunrise_clear",
"semantic": "فترة زمنية فقط؛ الحكم واللون يحددان في ملفات مستقلة"
},
{
"id": "duha_time_geometry",
"start": "sunrise_clear",
"end": "solar_noon",
"semantic": "نافذة زمنية هندسية فقط؛ لا تحمل حكمًا أو لونًا هنا"
},
{
"id": "solar_noon_to_zawal",
"start": "solar_noon",
"end": "zawal",
"semantic": "انتقال الاستواء إلى الزوال؛ الحكم واللون خارج هذا الملف"
},
{
"id": "sunset_approach_to_sunset",
"start": "sunset_approach",
"end": "sunset",
"semantic": "فترة اقتراب الغروب فقط؛ لا تحمل حكمًا فقهيًا هنا"
},
{
"id": "night",
"start": "sunset",
"end": "next_true_dawn",
"semantic": "الفترة الليلية المستخدمة للاشتقاقات الزمنية"
},
{
"id": "first_third_of_night_window",
"start": "sunset",
"end": "first_third_of_night",
"semantic": "نافذة حسابية فقط؛ الحكم الفقهي خارج هذا الملف."
},
{
"id": "last_third_of_night_window",
"start": "last_third_start",
"end": "next_true_dawn",
"semantic": "نافذة حسابية فقط؛ الحكم والعبادة خارج هذا الملف."
}
],
"ordering": [
"false_dawn",
"true_dawn",
"sunrise",
"sunrise_clear",
"solar_noon",
"zawal",
"dhuhr",
"asr_shadow_1",
"asr_shadow_2",
"asr",
"last_daylight_hour_start",
"sunset_approach",
"sunset",
"maghrib",
"red_twilight_end",
"white_twilight_end",
"isha",
"first_third_of_night",
"islamic_midnight",
"last_third_start",
"next_false_dawn",
"next_true_dawn"
],
"validation": {
"no_colors": true,
"no_worship_rulings": true,
"no_fixed_solar_minute_offsets": true,
"continuous_cycle": true,
"implementation_ready": true,
"supports_madhhab_worship_registry": true,
"shadow_factor_boundaries_present": true,
"night_fraction_boundaries_present": true,
"aliases_resolve": true,
"solver_constants_in_registry": true
},
"integration_contract": {
"worship_fiqh_registry": "worship_fiqh_registry.json",
"role_ar": "هذا الملف يحسب الحدود فقط، وملف worship_fiqh_registry.json يختار أي حد تستخدمه العبادة بحسب المذهب.",
"madhhab_sensitive_outputs": [
"asr_shadow_1",
"asr_shadow_2",
"first_third_of_night",
"red_twilight_end",
"white_twilight_end"
],
"hijri_calendar_registry": "hijri_calendar_registry.json",
"cross_registry_validator": "validate_registries.js"
},
"calculation_profile": {
"id": "inherited_solar_estimates_v1",
"label_ar": "إعدادات شمسية تقديرية من النسخة القديمة",
"note_ar": "حساب شمسي تقديري يتغير بالموقع والتاريخ. ارتفاع الشمس 4.5° والشفق 15°/18° إعدادات تقديرية موروثة تحتاج اعتمادًا. الاستواء والزوال حدّا انتقال اتجاه حركة الشمس، دون افتراض فترة بالدقائق؛ هذه ليست مواقيت أذان رسمية.",
"provenance": {
"solar_geometry": "index-8.html: sunPosition / solarAltitudeAt",
"sunrise_clear": "index-8.html: solarFiqhBoundaries, 4.5 degrees",
"zawal": "fiqh_time_registry_solar_v1_1.json: post_transit_transition / after_upper_solar_transit؛ حل عددي لتغير اتجاه الارتفاع بعد القمة، دون مساواة alias أو عتبة انخفاض مخترعة.",
"sunset_approach": "index-8.html: estimateSunsetStart, -0.30 degrees",
"twilight": "spiritual_timeline_v3_fiqh_timers_FINAL.zip: fiqh_time_registry.json, red 15 and white 18 degrees",
"true_dawn": "index-8.html: FAJR_ANGLE = 18"
},
"default_madhhab": "shafii",
"locations": [
{
"id": "amman",
"name": "عمّان",
"lat": 31.9454,
"lng": 35.9284,
"height": 0,
"timezone": "Asia/Amman",
"note": "height يستهلكه solar_engine. timezone للمستهلك: حد اليوم يحتاج منطقة المدينة لا الجهاز عند اختلافهما."
}
],
"observational_limits": {
"false_dawn": null,
"next_false_dawn": null
},
"boundaries": {
"solar_noon": {
"op": "maximum"
},
"true_dawn": {
"op": "altitude",
"degrees": -18,
"direction": "ascending"
},
"sunrise": {
"op": "altitude",
"degrees": -0.833,
"direction": "ascending"
},
"sunrise_clear": {
"op": "altitude",
"degrees": 4.5,
"direction": "ascending",
"approximate": true
},
"zawal": {
"op": "post_transit_transition",
"boundary": "solar_noon",
"direction": "descending",
"transition_only": true,
"note_ar": "الزوال محسوب من بدء انخفاض ارتفاع الشمس بعد الاستواء. يعرض كحد شمسي؛ لا يستنتج الحساب منه فترة نهي ممتدة بالدقائق."
},
"sunset_approach": {
"op": "altitude",
"degrees": -0.3,
"direction": "descending",
"approximate": true
},
"sunset": {
"op": "altitude",
"degrees": -0.833,
"direction": "descending"
},
"red_twilight_end": {
"op": "altitude",
"degrees": -15,
"direction": "descending",
"approximate": true,
"allowed_degrees": [
-12,
-15
],
"degrees_note_ar": "القيمة الحالية -15° موروثة وتقديرية وتحتاج اعتمادًا. تحدد الزاوية وقت ذهاب الحمرة، وهي اصطلاح لا قياس مباشر للسماء. -12° هي نهاية الشفق البحري فلكيًا: يختفي الأفق وتظلم السماء بصريًا. اختيار المستخدم يمر عبر day(...,{boundaryDegrees:{red_twilight_end:-12}}) ولا يقبل إلا ما في allowed_degrees."
},
"white_twilight_end": {
"op": "altitude",
"degrees": -18,
"direction": "descending",
"approximate": true
},
"asr_shadow_1": {
"op": "shadow",
"factor": 1
},
"asr_shadow_2": {
"op": "shadow",
"factor": 2
},
"fajr": {
"op": "alias",
"boundary": "true_dawn"
},
"dhuhr": {
"op": "alias",
"boundary": "zawal"
},
"maghrib": {
"op": "alias",
"boundary": "sunset"
},
"asr": {
"op": "rule_start",
"rule_id": "asr"
},
"isha": {
"op": "rule_start",
"rule_id": "isha_entry"
},
"isha_entry_hanafi": {
"op": "alias",
"boundary": "white_twilight_end"
},
"next_true_dawn": {
"op": "next_day",
"boundary": "true_dawn"
},
"first_third_of_night": {
"op": "fraction",
"from": "sunset",
"to": "next_true_dawn",
"fraction": 0.3333333333333333
},
"islamic_midnight": {
"op": "fraction",
"from": "sunset",
"to": "next_true_dawn",
"fraction": 0.5
},
"last_third_start": {
"op": "fraction",
"from": "sunset",
"to": "next_true_dawn",
"fraction": 0.6666666666666666
},
"last_daylight_hour_start": {
"op": "fraction",
"from": "sunrise",
"to": "sunset",
"fraction": 0.9166666666666666
}
},
"relation_bindings": {
"after_isha": "isha",
"last_third_start_to_next_true_dawn": [
"last_third_start",
"next_true_dawn"
]
},
"rule_time_bindings": {
"isha_entry": {
"end": "next_true_dawn"
},
"isha_periods": {
"start": "isha"
}
},
"notice_runtime": {
"due_window_seconds": 90,
"trigger_bindings": {
"day_start": {
"boundary": "true_dawn"
},
"after_fajr": {
"boundary": "fajr"
},
"after_dhuhr": {
"boundary": "dhuhr"
},
"after_asr": {
"boundary": "asr"
},
"after_maghrib": {
"boundary": "maghrib"
},
"after_isha": {
"boundary": "isha"
},
"before_fajr": {
"boundary": "fajr",
"offset_sign": -1
},
"before_jumuah": {
"boundary": "dhuhr",
"offset_sign": -1
},
"duha_start": {
"boundary": "sunrise_clear"
},
"last_third_start": {
"boundary": "last_third_start"
},
"previous_evening": {
"boundary": "sunset",
"day_shift": -1
},
"sunday_evening": {
"boundary": "sunset",
"day_shift": -1
},
"wednesday_evening": {
"boundary": "sunset",
"day_shift": -1
}
},
"note_ar": "نافذة استدراك التنبيه سياسة تطبيق فقط. حدود أوقات النهي لا تستخدم هذه الإزاحات. التنبيهات تعمل أثناء فتح الصفحة، ويحدّد سجل الحدث عدد مرات ظهوره."
},
"solar_solver": {
"time_tolerance_ms": 1000,
"derivative_sample_ms": 1000,
"note_ar": "دقة عددية وحدود بحث فقط؛ ليست مدة نهي أو إزاحة زمنية للزوال. scan_step_ms خطوة مسح العبور، وbisect_iterations تكرارات التنصيف، وnoon_bracket_hours نصف نافذة البحث حول الاستواء، وhalf_day_hours نصف اليوم لنوافذ البحث، وdependency_passes أقصى عمق لاعتماد الحدود بعضها على بعض.",
"scan_step_ms": 300000,
"bisect_iterations": 36,
"maximum_iterations": 60,
"transit_iterations": 80,
"noon_bracket_hours": 6,
"half_day_hours": 12,
"dependency_passes": 5,
"longitude_degrees_per_hour": 15
},
"solar_motion": {
"engine": "local_solar_geometry",
"algorithm_reference": "Jean Meeus, Astronomical Algorithms",
"indicator_position_source": "device_clock_on_continuous_timeline",
"day_night_source": "computed_sunrise_and_sunset",
"apparent_horizon_degrees": -0.833,
"uses_prayer_time_provider": false,
"note_ar": "حركة المؤشر تتبع وقت الجهاز على الخط المتصل، وحالة الشمس/القمر تتبع ارتفاع الشمس المحسوب للموقع. حد الشروق والغروب الظاهري −0.833°؛ وقد يختلف الرصد الفعلي قليلًا بسبب الغلاف الجوي والأفق المحلي."
}
},
"prayer_calculation": {
"default_method": "JordanAwqaf",
"storage_key": "clock_calculation_method_v1",
"legacy_option": {
"id": "registry",
"label": "الحدود الشمسية والسجل الفقهي الحالي"
},
"engine": {
"url": "https://unpkg.com/adhan@4.4.6/lib/bundles/adhan.umd.min.js",
"version": "4.4.6",
"timeout_ms": 12000,
"source": "Adhan JS 4.4.6؛ الحسابات الفلكية مبنية على Astronomical Algorithms لِـ Jean Meeus",
"local_path": null,
"offline_note_ar": "يعتمد الرابط الحالي على الإنترنت. ضع نسخة adhan.umd.min.js (الإصدار 4.4.6) بجانب index.html وسمّها هنا في local_path ليعمل الحساب دون اتصال."
},
"methods": [
{
"id": "JordanAwqaf",
"label": "الأردن — وزارة الأوقاف",
"engine_mode": "custom_angles",
"fajr_angle": 18,
"isha_angle": 18,
"adjustments": {
"maghrib": 5
},
"provider_method_id": 23,
"solar_sunset_is_independent": true,
"authority_name": "وزارة الأوقاف والشؤون والمقدسات الإسلامية — الأردن",
"method_reference_url": "https://api.aladhan.com/v1/methods",
"daily_reference_url": "https://www.aliftaa.jo/Default",
"note_ar": "تطبيق محلي لمعاملات طريقة الأردن المنشورة: الفجر 18°، العشاء 18°، والمغرب بعد الغروب بخمس دقائق. تبقى مواقيت دائرة الإفتاء اليومية مرجع المقارنة الرسمي لمدينة عمّان."
},
{
"id": "MuslimWorldLeague",
"label": "رابطة العالم الإسلامي"
},
{
"id": "UmmAlQura",
"label": "أم القرى - مكة"
},
{
"id": "Egyptian",
"label": "الهيئة المصرية للمساحة"
},
{
"id": "Karachi",
"label": "كراتشي"
},
{
"id": "Dubai",
"label": "دبي"
},
{
"id": "Qatar",
"label": "قطر"
},
{
"id": "Kuwait",
"label": "الكويت"
},
{
"id": "MoonsightingCommittee",
"label": "لجنة تحري الهلال"
},
{
"id": "Singapore",
"label": "سنغافورة / ماليزيا / إندونيسيا"
},
{
"id": "Turkey",
"label": "تركيا"
},
{
"id": "Tehran",
"label": "طهران"
},
{
"id": "NorthAmerica",
"label": "ISNA - أمريكا الشمالية"
}
],
"shadow_factor_to_madhab": {
"1": "Shafi",
"2": "Hanafi"
},
"madhhab_engine_bindings": {
"hanafi": {
"asr_shadow_factor": 2,
"adhan_madhab": "Hanafi",
"moonsighting_shafaq": "Abyad"
},
"maliki": {
"asr_shadow_factor": 1,
"adhan_madhab": "Shafi",
"moonsighting_shafaq": "Ahmer"
},
"shafii": {
"asr_shadow_factor": 1,
"adhan_madhab": "Shafi",
"moonsighting_shafaq": "Ahmer"
},
"hanbali": {
"asr_shadow_factor": 1,
"adhan_madhab": "Shafi",
"moonsighting_shafaq": "Ahmer"
}
},
"output_bindings": {
"fajr": "fajr",
"dhuhr": "dhuhr",
"asr": "asr",
"maghrib": "maghrib",
"isha": "isha"
},
"period_bindings": {
"fajr": {
"start": "fajr",
"end": "sunrise"
},
"dhuhr": {
"start": "dhuhr",
"end": "asr"
},
"asr": {
"start": "asr",
"end": "maghrib"
},
"maghrib": {
"start": "maghrib",
"end": "isha"
},
"isha_entry": {
"start": "isha",
"end": "next_true_dawn"
}
},
"ramadan_interval": {
"method": "UmmAlQura",
"minutes": 120,
"storage_key": "clock_ummalqura_ramadan_v1"
},
"note_ar": "طريقة الأردن هي الافتراضية، وتستخدم معاملات وزارة الأوقاف المنشورة مع إبقاء صفحة دائرة الإفتاء مرجع المقارنة اليومي. فرق خمس دقائق يخص موعد المغرب في هذه الطريقة ولا يغيّر حد الغروب الشمسي المحسوب. تشمل القائمة جميع الطرق المسماة التي يوفرها Adhan JS 4.4.6 إضافة إلى طريقة الأردن المخصصة. مواقيت الصلاة لا تستبدل الحدود الشمسية المستقلة التي تحرك مؤشر الشمس. المذهب الحنفي يأخذ المثلين للعصر، والمذاهب الثلاثة تأخذ المثل؛ وتضبط طريقة لجنة تحري الهلال نوع الشفق كذلك. خيار رمضان لأم القرى يؤكد يدويًا ولا يستنتج من تقويم تقريبي."
},
"changelog": [
"1.6.0: aliases رسمية للحدود المستخدمة في الفقه والمحرك (fajr, isha_entry_hanafi) كانت مفقودة من boundaries",
"1.6.0: كل ثوابت الحل العددي (خطوة المسح، التكرارات، نافذة البحث) انتقلت من solar_engine.js إلى solar_solver",
"1.6.0: إضافة height وtimezone لموقع عمّان (height يستهلكه المحرك، وtimezone للمستهلك المستقبلي)",
"1.6.0: حقل local_path لمحرك Adhan حتى لا يعتمد التطبيق على CDN وحده",
"1.6.0: المدقق validate_registries.js يفحص الاتساق بين هذا الملف وworship_fiqh_registry",
"1.6.0: حد last_daylight_hour_start (11/12 من النهار) لعرض ساعة الإجابة يوم الجمعة",
"1.6.0: red_twilight_end.allowed_degrees [-12,-15] واختيار الزاوية من خيارات المستخدم دون تغيير الافتراضي (-15)"
]
}