منصوبے کے بارے میں

tarkov-data-overlay، tarkov.dev API کے لیے ڈیٹا کی تصحیح اور اضافوں کا ایک کمیونٹی کے زیرِ انتظام اوورلے ہے۔ اس کا مقصد یہ ہے کہ گیم اپ ڈیٹس اکثر ڈیٹا اپ ڈیٹس سے تیز ہوتی ہیں، لہذا یہ پروجیکٹ دو طریقوں سے اس خلا کو پُر کرتا ہے: ٹاسک لیولز یا میپ کی ضروریات جیسی غلط اقدار کو درست کرنا، اور ان ڈیٹا اقسام کو شامل کرنا جو اپ اسٹریم API میں موجود نہیں ہیں، جیسے کہ گیم ایڈیشنز۔ استعمال یہ اوورلے ایک JSON فائل کے طور پر شائع کیا جاتا ہے اور jsDelivr CDN سے حاصل کیا جاتا ہے۔ صارفین اسے tarkov.dev کے جوابات کے ساتھ ضم (merge) کرتے ہیں۔ README میں مشورہ دیا گیا ہے کہ پروڈکشن کے لیے ایک immutable ریلیز ٹیگ یا کمٹ کو پن کیا جائے، کیونکہ برانچ URL ریپوزٹری کی بدلتی ہوئی حالت کو ٹریک کرتا ہے؛ اس میں موجود ڈائجسٹ ڈیٹا کی خرابی یا پرانے ہونے کا پتہ لگا سکتا ہے لیکن CDN جواب کی اصلیت ثابت نہیں کرتا۔ انٹیگریشن کی تفصیلات ایک انٹیگریشن گائیڈ میں موجود ہیں، جس میں ٹاسک کی دستیابی، ان لاک اسٹیٹ ٹریکنگ اور کاؤنٹر ڈیٹا کنٹریکٹ کے لیے علیحدہ دستاویزات ہیں۔ تصدیق شدہ پروگریس بیسڈ کاؤنٹرز اور واضح نامعلوم نتائج کے لیے evaluateTaskProgression ہیلپر کا حوالہ دیا گیا ہے۔ مانیٹر ایک ہوسٹڈ مانیٹر دستیاب ہے، اور اسی مانیٹر کو npm اسکرپٹ کے ذریعے مقامی طور پر بھی چلایا جا سکتا ہے۔ یہ ڈیفالٹ طور پر صرف پڑھنے (read-only) کے لیے ہے۔ مقامی "Update overlay" ایکشن کے لیے ری بلڈ ٹوکن کے ساتھ واضح رضامندی کی ضرورت ہوتی ہے، اور ری بلڈز کے لیے ہمیشہ Authorization Bearer ہیڈر میں ایک غیر خالی ٹوکن پاس کرنا ضروری ہے۔ سرور ڈیفالٹ طور پر لوپ بیک سے جڑتا ہے؛ کسی اور جگہ بائنڈنگ کی سفارش صرف ایک قابلِ اعتماد ریورس پراکسی یا نیٹ ورک باؤنڈری کے پیچھے کی جاتی ہے۔ جب HTTPS ایک قابلِ اعتماد پراکسی کے ذریعے ختم ہوتا ہے، تو ایک علیحدہ فلیگ ری بلڈز کو فعال کرتا ہے، اور اس موڈ میں فی کلائنٹ ایونٹ اسٹریم کوٹہ پہلے درست X-Forwarded-For ایڈریس کا استعمال کرتا ہے، لہذا پراکسی کو اس ہیڈر کو اوور رائٹ کرنا چاہیے۔ ری بلڈز ڈیفالٹ اوورلے آؤٹ پٹ پاتھ کو نشانہ بناتے ہیں؛ کسٹم مقامی اور HTTP(S) اوورلے اہداف صرف پڑھنے کے لیے رہتے ہیں۔ دیکھ بھال (Maintenance) ایک check-overrides کمانڈ تمام اوور رائڈز کا موجودہ API ڈیٹا کے ساتھ موازنہ کرتی ہے اور رپورٹ کرتی ہے کہ کن کی اب بھی ضرورت ہے، کن تصحیحات کو اپ اسٹریم میں درست کر دیا گیا ہے اور انہیں ہٹایا جا سکتا ہے، کون سے ٹاسک API سے غائب ہو گئے ہیں، اور اپ اسٹریم ڈیٹا کوالٹی میں کہاں گراوٹ آئی ہے۔ رپورٹنگ ڈیفالٹ ہے؛ تین آپشنل گیٹس ناکامی کے رویے کو کنٹرول کرتے ہیں، جن میں سخت عدم مطابقت کی جانچ، اس پرانے ڈیٹا کے لیے الگ الگ ایگزٹ کوڈز ہیں جو اب اپ اسٹریم فراہم کر رہا ہے (یہ گیٹ CI میں چلایا جاتا ہے)، اور اپ اسٹریم ریگریشنز کے لیے۔ اپ اسٹریم گیٹ کو جان بوجھ کر CI سے خارج رکھا گیا ہے کیونکہ ایسے مسائل tarkov.dev ڈیٹا سے پیدا ہوتے ہیں اور انہیں اس ریپوزٹری سے دور نہیں کیا جا سکتا۔ مقامی ویلیڈیشن، ٹائپ چیکنگ اور ٹیسٹ علیحدہ npm اسکرپٹس کے ذریعے چلائے جاتے ہیں۔ گورننس اور تعاون تعاون اور ٹریاج گائیڈز فراہم کی گئی ہیں۔ پروجیکٹ اپنی تعریف کمیونٹی کے زیرِ انتظام اور بہترین کوشش (best-effort) کے طور پر کرتا ہے، تصحیحات کے لیے ویکی لنکس یا اسکرین شاٹس جیسے ثبوت طلب کرتا ہے، خود کو tarkov.dev کے متبادل کے بجائے ڈیٹا کے خلا کے دوران ایک پل کے طور پر پیش کرتا ہے، اور Git کے ذریعے ایک شفاف تاریخ رکھتا ہے۔ لائسنس کی شرائط ریپوزٹری کی LICENSE فائل میں موجود ہیں۔