这个项目能做什么

과거탐색기(Gwageo Explorer)是一款基于 Next.js 的 Web 应用程序，用于按本贯、人物和王代探索朝鲜时代的科举合格记录。根据 README，该应用基于韩国学中央研究院的公开数据，提供 84,525 条记录、2,976 个本贯组合，以及人物关系和本贯位置信息。 主要功能包括：本贯与姓氏搜索及详情页、合格记录及考试种类/王代/排名的探索、人物详情与关系网络、韩半岛全境本贯发源地与居住地地图、按位置划分的调查状态及官方依据链接、基于 NVIDIA NIM 的 AI 摘要（可选功能），以及响应式 Web 和 Capacitor Android 应用。 技术架构方面，Web 框架采用 Next.js 16.3.1 (App Router, Turbopack) 处理 SSR、动态路由和 API Route Handler；UI 使用 React 19.2 和 TypeScript 5，样式采用 Tailwind CSS 4 和 CSS Token，过渡动画使用 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。由于仓库不包含发布签名密钥，GitHub Release 的 APK 为 unsigned 构建，常规安装或商店发布需要单独的 keystore 签名。