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

Ultros ایک اوپن سورس ویب ایپلی کیشن ہے جو Final Fantasy XIV کے لیے لائیو مارکیٹ بورڈ اینالیٹکس فراہم کرتی ہے۔ یہ ultros.app پر ہوسٹ ہے اور ہر ڈیٹا سینٹر کا احاطہ کرتی ہے، جس میں ایپ کے اندر ایک مدد کا سیکشن ہے جو ہر فیچر کی وضاحت کرتا ہے۔ یہ کیا پیش کرتا ہے - Flip Finder: ڈیٹا سینٹر کے ہر ورلڈ کو ان اشیاء کے لیے اسکین کرتا ہے جنہیں سستے میں خرید کر ہوم ورلڈ پر دوبارہ بیچا جا سکتا ہے، جس میں روزانہ منافع، فروخت کی رفتار، ڈرفٹ اور کانفیڈنس اسکورنگ دکھائی جاتی ہے۔ - Item pages: لائیو cross-world لسٹنگز، فروخت کی تاریخ کے چارٹس، ایک outlier-filtered "real price"، اور قابل فروخت اشیاء کے لیے وینڈر/ایکسچینج ذریعہ کی معلومات۔ - Gil بنانے کی سرگرمیوں کے لیے تجزیہ کار: ریسیپی کرافٹنگ منافع (اجزاء کی لاگت بمقابلہ فروخت کی قیمت، subcraft recursion کے ساتھ)، levequest ٹرن-انز، retainer ventures، scrip خرچ، وینڈر ری سیل اور Free Company کرافٹنگ۔ - Market Trends: 24 گھنٹے کے موورز، کیٹیگری ہیٹ اور ہر ورلڈ کے لیے بڑھتی/گرتی ہوئی اشیاء۔ - Currency Exchange: tomestones، scrips، seals اور دیگر ان-گیم کرنسیوں کے ساتھ خریدنے کے لیے قابل فروخت اشیاء۔ - Lists: سستی ترین لسٹنگ تلاش کے ساتھ شیئر کے قابل شاپنگ لسٹس۔ - Retainer tracking: اپنی لسٹنگز کی نگرانی کریں اور undercut ہونے پر نوٹیفکیشن حاصل کریں۔ - Price alerts: Discord DM یا webhook کے ذریعے فراہم کردہ فی-آئٹم قیمت کی دہلیز۔ - Discord bot: سرور کے اندر مارکیٹ تلاش اور undercut الرٹس۔ اس پروجیکٹ کو اس کے مصنف نے ایک شوق کے طور پر ایک شخص کی جانب سے تفریح کے لیے بنایا گیا ہے۔ یہ ہوسٹنگ کے اخراجات پورے کرنے کے لیے اختیاری اشتہارات چلاتا ہے؛ اشتہارات کو سیٹنگز میں غیر فعال کیا جا سکتا ہے اور کہا گیا ہے کہ ad blockers کام کرتے ہیں۔ یہ کیسے بنایا گیا ہے اس کا اسٹیک مکمل طور پر Rust ہے: بیک اینڈ ویب فریم ورک کے لیے Axum، فل اسٹیک ویب فرنٹ اینڈ کے لیے Leptos، ڈیٹا بیس تک رسائی کے لیے SeaORM، اور Discord bot کے لیے Serenity۔ مارکیٹ ڈیٹا لائیو Universalis API (HTTP اور WebSocket) سے آتا ہے۔ ریپوزٹری مختلف crates میں تقسیم ہے جس میں مین `ultros` بیک اینڈ، `ultros-frontend` جس میں `ultros-app` اور WASM `ultros-client` شامل ہیں، `ultros-db`، `ultros-api-types`، ایک `universalis` ریپر، گیم ڈیٹا جنریشن crates (`xiv-gen`، `xiv-gen-db`، `game-data-pack`، `icon-extract`) اور ایک `migration` ٹول شامل ہے۔ اسے خود چلانا ترقی کے لیے ضروریات میں ایک nightly Rust toolchain، `data/` کے تحت گیم ڈیٹا پیکس کے لیے Git LFS، ایک چلتا ہوا Postgres انسٹنس، اور cargo-leptos شامل ہیں۔ Docker کے ذریعے مقامی Postgres شروع کیا جا سکتا ہے، اور `.env.example` پر مبنی ایک `.env` فائل Discord OAuth کریڈنشلز، کوکی انکرپشن کی، ڈیٹا بیس URL، پورٹ اور لاگ سیٹنگز فراہم کرتی ہے۔ ایپ پہلی بار بوٹ ہونے پر ڈیٹا بیس مائیگریشنز لاگو کرتی ہے اور Universalis سے ورلڈ/ریجن ڈیٹا حاصل کرتی ہے۔ گیم ڈیٹا (آئٹم اور ریسیپی ٹیبلز پلس آئٹم آئیکونز) پہلے سے تیار شدہ پیکس کے طور پر فراہم کیا جاتا ہے جنہیں Git LFS کے ذریعے ٹریک کیا جاتا ہے اور کمپائل ٹائم پر ایمبیڈ کیا جاتا ہے؛ ایک `game-data-pack` ٹول انہیں کمیونٹی ffxiv-datamining CSV ریپوزٹریز سے، اور آئیکونز کے لیے، مقامی FFXIV انسٹالیشن کی SqPack فائلوں سے دوبارہ تیار کرتا ہے، جس میں ورژن پن کرنے، آئیکونز چھوڑنے یا غیر معیاری گیم پاتھ کی نشاندہی کرنے کے اختیارات موجود ہیں۔ Issues، pull requests یا پروجیکٹ کے Discord سرور کے ذریعے تعاون خوش آمدید ہے۔ پروجیکٹ MIT لائسنس کے تحت ہے اور اس کے README میں ذکر ہے کہ کوڈ بیس کچھ جگہوں پر بے ترتیب ہو سکتا ہے۔