توثيق تقني — API مفتوح

مؤشر مخاطر التسرب المائي

وحدة جافاسكربت (API) تعمل بالكامل داخل المتصفح — بلا خادم وبلا اتصال شبكي — محدّثة 2026-09-21

مؤشر مخاطر التسرب المائي (المعروف سابقاً بـ«أوراكل السلامة المائية») أداة برمجية مفتوحة من كشف تقدّر خطر تسرب المياه (Leak-Risk Score) لعقار بالسعودية من 0 إلى 100: كلما ارتفعت الدرجة ارتفع الخطر. النتيجة تقدير بأوزان تحريرية وضعها فريق كشف لعوامل جغرافية ومناخية وهندسية مستوحاة من محتوى الموقع (تحليل تربة المدن في مقالات الركيزة، وجدول مقارنة أنابيب السباكة في الدليل الهندسي)، وليست قياساً أو إحصاءً لحالات فعلية. لا يعتمد الحساب على أي خادم خارجي أو استدعاء شبكي؛ كل شيء يُحسب فوراً داخل متصفحك.

هذه الأداة مؤشر توعوي وهندسي عام لترتيب أولوية الفحص، وليست بديلاً عن فحص فني ميداني فعلي بالكاميرا الحرارية والاستشعار الصوتي. لتأكيد وجود تسرب فعلي، احجز فحصاً ميدانياً من كشف.

كيف يعمل نموذج التقييم؟

يجمع النموذج نقاط خطر من أربعة محاور، لكل محور وزن تحريري تقديري مستوحى من محتوى الموقع:

العامل الجغرافي/المناخي للمدينة: مثال — التربة السبخية عالية الملوحة وارتفاع منسوب المياه الجوفية بالدمام (دليل الدمام)، أو الصخور البازلتية قليلة المسامية بالمدينة المنورة (دليل المدينة المنورة)، أو تربة الهضبة الصخرية الجيرية بالرياض (دليل الرياض).
مادة الأنبوب: مبنية على جدول المقارنة الهندسي (معايير ISO/ASTM، الحرارة التشغيلية، ومقاومة أشعة الشمس) في الدليل الهندسي الشامل لأنابيب السباكة.
عمر المبنى: كلما تقادمت الشبكة الأصلية، ارتفع احتمال تآكل نقاط الوصل — مبدأ هندسي عام متكرر في محتوى الموقع.
عوامل تعرض إضافية: تمديد ظاهر تحت الشمس دون عزل، قرب من مزارع أو شبكات ري (يزيد صعوبة التمييز بين رطوبة الري وتسرب فعلي)، وجود خزان علوي معزول حرارياً (يقلل الخطر).

مجموع النقاط (0–100) يُصنَّف إلى أربع فئات: منخفض (أقل من 25)، متوسط (25–49)، مرتفع (50–74)، حرج (75 فأكثر). التفاصيل الكاملة لكل عامل ووزنه موثّقة كتعليقات مصدرية داخل ملف الوحدة البرمجية hydro-oracle.js.

التجربة التفاعلية المباشرة

جرّب المؤشر الآن — الحساب يتم فوراً داخل متصفحك بدون أي إرسال بيانات. تذكّر: الدرجة الأعلى تعني خطراً أعلى.

المدينة مادة الأنبوب عمر المبنى (بالسنوات)

تمديد ظاهر تحت الشمس بدون عزل قريب من مزارع/شبكة ري خزان علوي معزول حرارياً

وثائق الدالة البرمجية (API Reference)

window.KashfOracle.assess(input) — دالة جافاسكربت نقية (pure function)، محددة، وبلا آثار جانبية أو اتصال شبكي.

المعامل (Parameter)	النوع	مطلوب	الوصف
`city`	string	نعم	مفتاح المدينة: riyadh, jeddah, dammam, khobar, madinah, makkah, tabuk, taif, khamis-mushait, buraydah, other
`pipeMaterial`	string	نعم	مفتاح المادة: ppr, pex, upvc, copper, multilayer
`buildingAgeYears`	number	نعم	عمر المبنى بالسنوات (0 فأكثر)
`exposedToSun`	boolean	لا	هل يوجد تمديد ظاهر تحت الشمس دون عزل؟
`nearFarmsOrIrrigation`	boolean	لا	هل العقار قريب من مزارع أو شبكات ري؟
`insulatedTank`	boolean	لا	هل الخزان العلوي معزول حرارياً؟

مثال استدعاء (Request)

KashfOracle.assess({
  city: "riyadh",
  pipeMaterial: "ppr",
  buildingAgeYears: 12,
  exposedToSun: true,
  nearFarmsOrIrrigation: false,
  insulatedTank: true
});

شكل الاستجابة (Response)

{
  "score": 42,
  "classification": "moderate",
  "classificationAr": "متوسط",
  "city": "riyadh",
  "cityNameAr": "الرياض",
  "pipeMaterial": "ppr",
  "pipeMaterialAr": "PPR (المواسير الحرارية)",
  "factors": [ { "label": "...", "points": 18, "reason": "..." }, ... ],
  "version": "1.0.0"
}

widget عقاري قابل للتضمين

لمواقع الإعلانات العقارية الراغبة بعرض مؤشر مخاطر التسرب المائي على صفحة أي عقار، يوفّر كشف بطاقة مصغّرة جاهزة للتضمين عبر iframe — تعمل بالكامل داخل المتصفح دون أي خادم خلفي، وتحمل شارة كشف ورابطاً لـ kashf.com.sa.

⭳ معاينة الـ widget مباشرة

كود التضمين (Embed Code)

<iframe
  src="https://kashf.com.sa/embed/hydro-safety-widget.html?city=jeddah&pipeMaterial=upvc&buildingAgeYears=15"
  width="320" height="220" style="border:0;border-radius:14px;overflow:hidden;"
  loading="lazy" title="مؤشر مخاطر التسرب المائي — كشف"></iframe>

معاملات الرابط (query string) اختيارية بنفس أسماء معاملات KashfOracle.assess()؛ عند تركها فارغة يعرض الـ widget نموذجاً تفاعلياً مصغّراً بدل نتيجة جاهزة.