عن المشروع

tarkov-data-overlay هي طبقة بيانات يديرها المجتمع لتصحيح وإضافة البيانات الخاصة بـ tarkov.dev API. والدافع المعلن هو أن تحديثات اللعبة قد تسبق تحديثات البيانات، لذا يسد المشروع هذه الفجوة بطريقتين: إصلاح القيم غير الصحيحة مثل مستويات المهام أو متطلبات الخريطة، وإضافة أنواع بيانات لا يوفرها الـ API الأساسي، مثل إصدارات اللعبة. الاستخدام تُنشر الطبقة كملف JSON ويتم جلبها من CDN الخاص بـ jsDelivr. يقوم المستخدمون بدمجها مع استجابات tarkov.dev. وينصح ملف README بتثبيت علامة إصدار غير قابلة للتغيير أو commit للاستخدام في بيئة الإنتاج، لأن رابط الفرع يتتبع حالة المستودع المتغيرة؛ ويمكن للملخص المدمج اكتشاف البيانات التالفة أو القديمة ولكنه لا يثبت صحة استجابة CDN. تتوفر تفاصيل التكامل في دليل التكامل، مع وثائق منفصلة تغطي توفر المهام وتتبع حالة فتح القفل وعقد بيانات العداد؛ كما تمت الإشارة إلى مساعد evaluateTaskProgression للعدادات القائمة على التقدم الموثق والنتائج غير المعروفة الصريحة. المراقبة تتوفر لوحة مراقبة مستضافة، ويمكن تشغيل نفس المراقبة محلياً عبر نص npm. تكون لوحة المراقبة للقراءة فقط بشكل افتراضي. يتطلب إجراء "تحديث الطبقة" محلياً موافقة صريحة باستخدام رمز إعادة بناء (rebuild token)، وتتطلب عمليات إعادة البناء دائماً رمزاً غير فارغ يتم تمريره في ترويسة Authorization Bearer. يرتبط الخادم بـ loopback افتراضياً؛ ويوصى بالارتباط في مكان آخر فقط خلف وكيل عكسي (reverse proxy) موثوق أو حدود شبكة. عندما يتم إنهاء HTTPS بواسطة وكيل موثوق، تتيح علامة منفصلة عمليات إعادة البناء، وفي هذا الوضع، تستخدم حصص تدفق الأحداث لكل عميل أول عنوان X-Forwarded-For صالح، لذا يجب على الوكيل إعادة كتابة هذه الترويسة. تستهدف عمليات إعادة البناء مسار مخرجات الطبقة الافتراضي؛ بينما تظل أهداف الطبقة المحلية وHTTP(S) المخصصة للقراءة فقط. الصيانة يقوم أمر check-overrides بمقارنة جميع التجاوزات مع بيانات API الحالية ويبلغ عن التجاوزات التي لا تزال مطلوبة، والتصحيحات التي تم إصلاحها في الـ API الأساسي ويمكن إزالتها، والمهام التي اختفت من الـ API، وتراجعات جودة البيانات الأساسية. التقارير هي الوضع الافتراضي؛ وتتحكم ثلاث بوابات اختيارية في سلوك الفشل، مع رموز خروج متميزة لفحوصات عدم الاتساق الصارمة، والبيانات القديمة التي يوفرها الـ API الأساسي الآن (البوابة التي تعمل في CI)، وتراجعات الـ API الأساسي. تم استبعاد بوابة الـ API الأساسي عمداً من CI لأن هذه المشكلات تنشأ في بيانات tarkov.dev ولا يمكن حلها من هذا المستودع. يتم تشغيل التحقق المحلي وفحص الأنواع والاختبارات من خلال نصوص npm منفصلة. الحوكمة والمساهمة تتوفر أدلة للمساهمة والفرز. يصف المشروع نفسه بأنه يُدار من قبل المجتمع وبأفضل جهد ممكن، ويتطلب أدلة مثل روابط الويكي أو لقطات شاشة للتصحيحات، ويقدم نفسه كجسر أثناء فجوات البيانات بدلاً من أن يكون بديلاً لـ tarkov.dev، ويحتفظ بسجل شفاف عبر Git. شروط الترخيص موجودة في ملف LICENSE بالمستودع.