প্রকল্প সম্পর্কে

Gwageo Explorer হলো একটি Next.js ওয়েব অ্যাপ্লিকেশন যা জোসন রাজবংশের সরকারি পরীক্ষার সাফল্যের রেকর্ডগুলো বংশীয় মূল স্থান (Bon-gwan), ব্যক্তি এবং রাজবংশের শাসনকাল অনুযায়ী অনুসন্ধান করতে পারে। README অনুযায়ী, এটি কোরিয়ান স্টাডিজ ইনস্টিটিউটের উন্মুক্ত ডেটার উপর ভিত্তি করে ৮৪,৫২৫টি রেকর্ড, ২,৯৭৬টি Bon-gwan সংমিশ্রণ, ব্যক্তিত্বের সম্পর্ক এবং Bon-gwan অবস্থানের তথ্য প্রদান করে। এর প্রধান বৈশিষ্ট্যগুলোর মধ্যে রয়েছে Bon-gwan এবং বংশনাম অনুসন্ধান ও বিস্তারিত পৃষ্ঠা, সাফল্যের রেকর্ড এবং পরীক্ষার ধরন, শাসনকাল ও র‍্যাঙ্ক অনুসন্ধান, ব্যক্তিত্বের বিস্তারিত এবং সম্পর্ক নেটওয়ার্ক, কোরীয় উপদ্বীপের সমস্ত Bon-gwan এর উৎপত্তি ও বাসস্থানের মানচিত্র, অবস্থানভিত্তিক তদন্তের অবস্থা এবং অফিসিয়াল প্রমাণের লিঙ্ক, 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 এর সংমিশ্রণে পরীক্ষার রেকর্ড এবং Bon-gwan তদন্তের ডেটা কুয়েরি করা হয়। মানচিত্রের জন্য OpenStreetMap সামঞ্জস্যপূর্ণ টাইল এবং Web Mercator প্রজেকশন ব্যবহার করে Bon-gwan এর উৎপত্তি ও বাসস্থান দৃশ্যমান করা হয়েছে। 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-তে পুনঃলাইসেন্স করা হয় না। যেসব অবস্থানের অফিসিয়াল প্রমাণ এবং অনুমোদিত লাইসেন্স নিশ্চিত করা যায়নি, সেগুলো শুধুমাত্র পর্যালোচনা অবস্থায় সংরক্ষণ ও প্রদর্শন করা হয়। Bon-gwan ভিত্তিক বিখ্যাত ব্যক্তিদের ডেটা উইকিপিডিয়ার Bon-gwan ডকুমেন্টের infobox থেকে ৪,৫৪৯ জন ব্যক্তি এবং ৩৬৭টি Bon-gwan (CC BY-SA 4.0) স্ক্রিপ্টের মাধ্যমে তৈরি করা হয়েছে। Namuwiki-র মার্জ করা সংস্করণ (৬,৩৪১ জন) CC BY-NC-SA শর্তের কারণে শুধুমাত্র লোকাল ব্যবহারের জন্য রাখা হয়েছে এবং এটি বিতরণ করা হয় না। Android রিলিজের জন্য JDK 17 এবং Android SDK সেটআপ করার পর Gradle assembleRelease দিয়ে বিল্ড করা হয় এবং আউটপুট android/app/build/outputs/apk/release/app-release-unsigned.apk হিসেবে পাওয়া যায়। রিপোজিটরিতে ডেপ্লয়মেন্ট সাইনিং কি অন্তর্ভুক্ত না থাকায় GitHub Release APK-টি একটি unsigned বিল্ড, এবং সাধারণ ইনস্টলেশন বা স্টোর ডেপ্লয়মেন্টের জন্য আলাদা keystore সাইনিং প্রয়োজন।