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

Gwageo Explorer ایک Next.js ویب ایپلی کیشن ہے جو 조선 (Joseon) دور کے سرکاری امتحانی کامیابی کے ریکارڈز کو خاندان (Bon-gwan)، شخص اور بادشاہ کے دور کے لحاظ سے تلاش کرنے کی سہولت فراہم کرتی ہے۔ README کے مطابق، یہ کورین اسٹڈیز کے مرکزی تحقیقی ادارے کے عوامی ڈیٹا پر مبنی ہے، جس میں 84,525 ریکارڈز، 2,976 خاندانی 조합، اشخاص کے درمیان تعلقات اور خاندانوں کی لوکیشن کی معلومات شامل ہیں۔ اس کے اہم افعال میں خاندان اور خاندانی نام کی تلاش، تفصیلی صفحات، کامیابی کے ریکارڈز، امتحان کی اقسام، بادشاہ کا دور اور رینکنگ کی تلاش، اشخاص کی تفصیلات اور تعلقات کا نیٹ ورک، کوریائی جزیرہ نما پر خاندانوں کے آغاز اور رہائش کے مقامات کا نقشہ، لوکیشن کے لحاظ سے تحقیقاتی صورتحال اور سرکاری حوالہ جات کے لنکس، NVIDIA NIM پر مبنی AI خلاصہ (اختیاری فیچر)، ریسپانسیو ویب اور Capacitor Android ایپ شامل ہیں۔ تکنیکی ساخت میں ویب فریم ورک کے طور پر Next.js 16.3.1 (App Router, Turbopack) کا استعمال کیا گیا ہے تاکہ SSR، ڈائنامک روٹس اور API Route Handler کو سنبھالا جا سکے۔ UI کے لیے React 19.2 اور TypeScript 5، اسٹائلنگ کے لیے Tailwind CSS 4 اور CSS ٹوکنز، اور ٹرانزیشن موشن کے لیے anime.js 4 استعمال کیے گئے ہیں۔ ڈیٹا لیئر میں Prisma 7.9 اور SQLite، better-sqlite3 کا مجموعہ ہے جو امتحانی ریکارڈز اور خاندانی تحقیقاتی ڈیٹا تک رسائی فراہم کرتا ہے۔ نقشے کے لیے OpenStreetMap ہم آہنگ ٹائلز اور Web Mercator پروجیکشن کا استعمال کیا گیا ہے۔ AI خلاصہ NVIDIA NIM کے OpenAI ہم آہنگ API اور SSE کے ذریعے سرور پراکسی کے ذریعے اسٹریم کیا جاتا ہے۔ موبائل کے لیے Capacitor 6، Android SDK 36 اور JDK 17 پر مبنی com.spear.gwageo WebView ایپ تیار کی گئی ہے۔ کوالٹی کی تصدیق کے لیے ESLint 9، tsc --noEmit اور Gradle استعمال کیے گئے ہیں۔ اسے چلانے کے لیے npm install، npm run db:push، npm run db:seed اور npm run dev کی ترتیب پر عمل کیا جاتا ہے، اور لوکل سرور http://localhost:3000 پر چلتا ہے۔ ڈیٹا بیس کے بغیر چیک کرنے کے لیے DATA_SOURCE=mock npm run dev استعمال کیا جا سکتا ہے، اور npm run typecheck·lint·build اور npm run audit:release کے ذریعے تصدیق کی جا سکتی ہے۔ ریپوزٹری میں آرکیٹیکچر، تعیناتی گائیڈ، ڈیٹا لائسنس اور تیسرے فریق کے نوٹس شامل ہیں۔ لائسنس کے مطابق، ایپلی کیشن کوڈ MIT ہے، لیکن میپ ٹائلز اور تیسرے فریق کا ڈیٹا اپنے اصل لائسنس اور منسوب شرائط کو برقرار رکھتے ہیں اور انہیں MIT کے تحت دوبارہ لائسنس نہیں کیا گیا ہے۔ وہ مقامات جن کے سرکاری حوالے یا لائسنس کی تصدیق نہیں ہوئی، انہیں صرف 'ریویو' حالت میں محفوظ اور ظاہر کیا جاتا ہے۔ مشہور شخصیات کا ڈیٹا ویکیپیڈیا کے infobox سے 4,549 افراد اور 367 خاندانوں (CC BY-SA 4.0) کے لیے اسکرپٹ کے ذریعے بنایا گیا ہے، جبکہ Namuwiki کا ورژن (6,341 افراد) CC BY-NC-SA شرائط کی وجہ سے صرف لوکل استعمال کے لیے ہے اور اسے تقسیم نہیں کیا جائے گا۔ Android ریلیز کے لیے JDK 17 اور Android SDK سیٹ کرنے کے بعد Gradle assembleRelease کے ذریعے بلڈ کیا جاتا ہے، جس کا آؤٹ پٹ android/app/build/outputs/apk/release/app-release-unsigned.apk ہے۔ چونکہ ریپوزٹری میں سائننگ کی (signing key) شامل نہیں ہے، اس لیے GitHub Release APK ایک unsigned بلڈ ہے، اور عام انسٹالیشن یا اسٹور کے لیے علیحدہ keystore سائننگ کی ضرورت ہوگی۔