इस प्रोजेक्ट के बारे में

Gwageo Explorer एक Next.js वेब एप्लिकेशन है जो जोसियन राजवंश के सरकारी परीक्षा उत्तीर्ण रिकॉर्ड्स को मूल स्थान (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 पर चलता है। बिना DB के जांचने के लिए DATA_SOURCE=mock npm run dev का उपयोग करें, और npm run typecheck, lint, build और npm run audit:release के माध्यम से सत्यापन किया जा सकता है। रिपॉजिटरी में आर्किटेक्चर, परिनियोजन गाइड, डेटा लाइसेंस और तीसरे पक्ष के नोटिस दस्तावेज़ शामिल हैं। लाइसेंस के अनुसार, एप्लिकेशन कोड MIT है, लेकिन मानचित्र टाइल्स और तीसरे पक्ष के डेटा अपने मूल लाइसेंस और एट्रिब्यूशन शर्तों को बनाए रखते हैं और उन्हें MIT के तहत पुन: लाइसेंस नहीं दिया गया है। जिन स्थानों के आधिकारिक आधार और अनुमत लाइसेंस की पुष्टि नहीं हुई है, उन्हें केवल समीक्षा स्थिति में संग्रहीत और प्रदर्शित किया जाता है। मूल स्थान के अनुसार प्रसिद्ध व्यक्तियों का डेटा विकिपीडिया के इन्फोबॉक्स से 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 है। रिपॉजिटरी में वितरण हस्ताक्षर कुंजी शामिल नहीं है, इसलिए GitHub Release APK एक unsigned बिल्ड है; सामान्य इंस्टॉलेशन या स्टोर वितरण के लिए एक अलग keystore हस्ताक्षर की आवश्यकता होती है।