gwageo_explorer

過거탐색기(Gwageo Explorer)は、朝鮮時代の科挙合格記録を本貫・人物・王代別に探索するNext.jsウェブアプリケーションです。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で再許諾しないと明記されています。公式根拠と許容ライセンスが確認されていない位置は、検討状態としてのみ保存・表示します。本貫別の有名人データは、ウィキペディアの本貫文書infoboxの主要人物4,549名・367本貫(CC BY-SA 4.0)をスクリプトで生成し、ナムウィキ統合版(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署名が必要です。