الانتقال إلى المحتوى الأساسي

توثيق آلي

دليل الوكلاء الآليين والزواحف

هذه الصفحة تشرح هوية المنصة ومحتواها وكياناتها ومصادرها وسياسة الوصول الآلي إليها، بصياغة تصلح للقراءة البشرية والآلية معا. كل ما هنا مأخوذ من المنصة نفسها، ولا يحتوي أي معلومة لا تظهر على صفحاتها.

الهوية

الاسم
وِصَالُنَا (Wesalna)
الأصل الرسمي
https://wesalna.com
المشغّل
ناشر مستقل، غير تابع لأي جهة حكومية أو دينية رسمية.
الغرض
منصة إسلامية مجانية: القرآن الكريم قراءة وسماعا، مواقيت الصلاة، القبلة، التقويم الهجري، أدوات العبادة، وأدلة الحج والعمرة والسفر.
اللغات
العربية هي اللغة الأساسية على جذر الموقع، والإنجليزية تنسخ كل صفحة تحت /en.
النموذج التجاري
لا بيع ولا اشتراك ولا جدار دفع ولا تسجيل. لا توجد صفحات تجارية على المنصة.
التواصل
contact@wesalna.com

الموارد المقروءة آليا

الأول والثاني معياران رسميان للويب والبحث. الثالث اتفاق ناشئ اختياري خاص بالوكلاء الآليين، لا تطلبه جوجل ولا يلزم أي زاحف باتباعه.

sitemap.xml
https://wesalna.com/sitemap.xml كل رابط قابل للفهرسة في اللغتين مع أزواج hreflang. معيار رسمي.
robots.txt
https://wesalna.com/robots.txt سياسة الزحف المعتمدة، وهي المرجع عند أي تعارض. معيار رسمي.
llms.txt
https://wesalna.com/llms.txt ملخص markdown مولّد من المنصة نفسها. اتفاق اختياري ناشئ.
JSON-LD
رسم @graph واحد متصل في ترويسة كل صفحة، بمعرّفات ثابتة. معيار Schema.org.

الكيانات ومعرّفاتها

المعرّفات ثابتة ولا تتغير، ويمكن الاعتماد عليها لربط الكيانات ببعضها:

  • https://wesalna.com/#organization الناشر، معرّف مرة واحدة على الصفحة الرئيسية.
  • https://wesalna.com/#website الموقع نفسه، ويحمل إجراء البحث الداخلي.
  • https://wesalna.com/#quran القرآن الكريم ككيان Book ترتبط به كل السور.
  • <page-url>#webpage عقدة الصفحة، مرتبطة بالموقع والناشر.
  • <page-url>#breadcrumb مسار التنقل إلى الصفحة.
  • <page-url>#app الأداة التفاعلية على صفحات الأدوات.
  • <page-url>#article المقال أو القصة، مع تاريخ النشر والتعديل.
  • <page-url>#chapter السورة على صفحتها، مرتبطة بكيان القرآن.
  • <page-url>#faq الأسئلة الشائعة الظاهرة فعليا على الصفحة.

لكل صفحة رابط canonical يشير إلى نفسها، وزوج hreflang يربط النسختين العربية والإنجليزية، فلا تتنافس اللغتان على نفس المحتوى.

المحتوى وتصنيفه

تصنيف صريح لكل قسم: ما هو فهرس، وما هو أداة، وما هو محتوى تعريفي، وما هو سياسة.

القرآن الكريم

  • المصحف كامل (صفحة فهرس) فهرس سور القرآن الكريم الـ114، كل سورة على صفحة خاصة بالرسم العثماني مع الترجمة والتلاوة.
  • البحث في القرآن (أداة تفاعلية) بحث نصي في 6236 آية بالتشكيل أو بدونه. صفحات النتائج غير مفهرسة، والصفحة نفسها مفهرسة.
  • القرآن الصوتي (صفحة فهرس) تلاوات كاملة لقرّاء معروفين، تُبثّ من شبكة islamic.network دون تعديل.
  • الإذاعات القرآنية (صفحة فهرس) دليل إذاعات قرآنية تُبثّ مباشرة من مصادرها الأصلية.

العبادة والمواقيت

  • مواقيت الصلاة (أداة تفاعلية) حساب المواقيت الخمس في المتصفح بمكتبة adhan وطرق حساب معتمدة، مع جدول شهري.
  • مواقيت الصلاة لكل مدينة (مرجع ومنهجية) مجموعة كاملة من 36 صفحة مواقيت، صفحة لكل مدينة مدعومة على النمط /prayer-times/<slug> مثل /prayer-times/makkah و /prayer-times/london، محسوبة على السيرفر وتحتوي جدول اليوم والشهر واتجاه القبلة وفقرة تحريرية عن المدينة. القائمة الآلية في /api/public/cities.
  • اتجاه القبلة (أداة تفاعلية) زاوية دائرة عظمى نحو إحداثيات الكعبة مع بوصلة تعتمد على مستشعر الجهاز.
  • التقويم الهجري (أداة تفاعلية) تقويم أم القرى وتحويل بين الهجري والميلادي مع المناسبات الإسلامية.
  • رمضان (محتوى تعريفي) إمساكية رمضان بمواعيد الإمساك والإفطار وساعات الصيام لكل يوم.

الأدوات

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

الحج والعمرة والسفر

  • الحج والعمرة (صفحة فهرس) فهرس أدلة المناسك.
  • دليل الحج (محتوى تعريفي) خطوات الحج مرتبة بالأيام مع المواقيت والمشاعر والأدعية.
  • دليل العمرة (محتوى تعريفي) خطوات العمرة من الإحرام إلى التحلل.
  • السفر الإسلامي (محتوى تعريفي) أحكام وآداب السفر: الصلاة في السفر والقصر والجمع والصيام.

المحتوى التحريري

  • المقالات (صفحة فهرس) مقالات مراجعة عن العبادة والأدوات، كل مقال على مسار /blog/{slug}.
  • قصص الأنبياء (صفحة فهرس) قصص قرآنية مروية فصلا بعد فصل، كل قصة على مسار /stories/{slug}.

التوثيق

  • للمطورين (توثيق تقني) توثيق الواجهات العامة مع صندوق تجريب حي وأمثلة كود.
  • الوكلاء الآليون (توثيق تقني) توثيق موجّه للوكلاء الآليين ومحركات الإجابة: الهوية والمحتوى والكيانات والنسبة وسياسة الزحف.
  • توصيل مساعد ذكي (توثيق تقني) تعليمات خطوة بخطوة لربط ChatGPT وClaude وClaude Code وغيرها بخادم MCP.

عن المنصة

  • عن وِصَالُنَا (مرجع ومنهجية) من يشغّل المنصة وما تقدمه ولماذا لا تطلب تسجيلا.
  • المصادر والمنهجية (مرجع ومنهجية) مصدر كل بيانات المنصة: نص القرآن والترجمة والمواقيت والتقويم والتلاوات.
  • اتصل بنا (تواصل) قنوات التواصل للتصحيح والاستفسار وطلبات حقوق النشر.
  • السياسة التحريرية (سياسة) كيف يُكتب المحتوى ويُراجع ويُصحّح.

السياسات

إضافة إلى ذلك: 114 صفحة سورة على /quran/{slug}، و36 صفحة مواقيت مدينة على /prayer-times/{slug} (قائمتها الآلية في /api/public/cities)، ومقالات على /blog/{slug}، وقصص على /stories/{slug}. القائمة الكاملة في خريطة الموقع.

الواجهات البرمجية العامة

واجهات قراءة فقط بصيغة JSON، دون مفتاح ودون مصادقة، وموثقة مع صندوق تجريب حي على صفحة المطورين. الاستجابات مخزنة مؤقتا؛ لا يوجد حد صارم للطلبات، والمطلوب استخدام معقول وتعريف العميل عبر User-Agent.

  • GET /api/public/prayer-times حساب فلكي دقيق لمواقيت اليوم بالإحداثيات أو بمعرّف مدينة مدعومة، مع الإمساك ومنتصف الليل والثلث الأخير والتاريخ الهجري وزاوية القبلة. التخزين المؤقت: تخزين مؤقت 5 دقائق.
  • GET /api/public/cities قائمة كل مدينة لها صفحة مواقيت مستقلة، مع الاسم بالعربية والإنجليزية والدولة والإحداثيات والمنطقة الزمنية وطريقة الحساب المقترحة ورابطي صفحتها. التخزين المؤقت: تخزين مؤقت 24 ساعة.
  • GET /api/public/qibla زاوية القبلة من الشمال الحقيقي والمسافة إلى الكعبة بالكيلومتر والميل. التخزين المؤقت: تخزين مؤقت 24 ساعة.
  • GET /api/public/hijri تحويل ميلادي إلى هجري بتمرير date، أو هجري إلى ميلادي بتمرير hy وhm وhd. التخزين المؤقت: تخزين مؤقت 24 ساعة.
  • GET /api/public/quran/meta قائمة السور الـ114 وبدايات الأجزاء ومواضع السجدات، أو سورة واحدة عبر الرقم أو المعرّف. التخزين المؤقت: بيانات ثابتة، تخزين مؤقت طويل الأمد.

لا توجد واجهات خاصة أو إدارية معلنة هنا، ولا مفاتيح ولا رموز وصول.

النسبة والاقتباس

الناشر
وِصَالُنَا، ويُنسب إليه المحتوى التحريري للمنصة.
الرابط المفضّل
رابط الصفحة الأصلي (canonical) بلغة القارئ، لا رابط نتيجة بحث ولا نسخة معاد نشرها.
تواريخ المحتوى
المقالات والقصص تحمل datePublished و dateModified في عقدة Article، وصفحات السياسات تحمل تاريخ سريانها، وصفحات الأدوات تحسب نتائجها لحظيا فلا تاريخ محتوى لها.
المصادر
نص القرآن والترجمة والمواقيت والتقويم والتلاوات، كل مصدر منسوب في صفحة المصادر.
الترخيص
نصوص المنصة التحريرية محمية، ويُسمح بالاقتباس المحدود مع نسبة ورابط. بيانات المصادر الخارجية تبقى بترخيص أصحابها. التفاصيل في صفحة حقوق النشر و شروط الاستخدام.
التصحيح
أي خطأ في اقتباس أو محتوى يُراسل عليه contact@wesalna.com ويُصحّح على الصفحة الأصلية.

سياسة الوصول الآلي

الملف robots.txt هو المرجع الملزم. ما يلي شرح للسياسة نفسها:

زواحف البحث
مسموح لها بالكامل، ومنها Googlebot و Bingbot. لا يوجد أي منع يمسّها.
زواحف الإجابة والبحث بالذكاء الاصطناعي
مسموح لها، لأن الهدف أن تُقتبس المنصة بدقة مع رابطها الأصلي.
زواحف تدريب النماذج
مسموح لها بالمحتوى العام حاليا، مع الإشارة إلى الترخيص وشروط الاستخدام.
الروبوتات العامة
مسموح لها بالصفحات العامة. صفحات نتائج البحث الداخلي ونسخ التضمين تحمل noindex ولا فائدة من زحفها.
الوصول المسيء
الطلبات المكثفة أو المنتحلة تُحدّ على مستوى الخدمة، لا عبر robots.txt، فهو ليس وسيلة حماية.
تكرار التحديث
المواقيت والتقويم تُحسب لحظيا في كل زيارة، بما في ذلك صفحات مدن المواقيت التي تُبنى على السيرفر عند كل طلب، والمقالات والقصص تُحدّث دوريا، وصفحات القرآن ثابتة النص.

لا تعتمد المنصة على منع الزحف لحماية أي شيء: كل ما هو محجوب عن الزواحف محجوب أصلا بالتحقق من الهوية على مستوى الخدمة، ولا توجد بيانات شخصية على أي صفحة عامة.