gwageo_explorer

O Gwageo Explorer é uma aplicação web Next.js para explorar registros de aprovação nos exames do período Joseon por bon-gwan (origem do clã), pessoa e reinado. De acordo com o README, baseia-se em dados abertos do Academy of Korean Studies, fornecendo 84.525 registros, 2.976 combinações de bon-gwan, relações entre pessoas e informações de localização de clãs. As principais funcionalidades incluem busca de bon-gwan e sobrenomes com páginas detalhadas, exploração de registros de aprovação por tipo de exame, reinado e classificação, detalhes de pessoas e redes de relacionamento, um mapa de locais de origem e residência de clãs em toda a península coreana, status de investigação por localização com links para evidências oficiais, resumos de IA baseados em NVIDIA NIM (funcionalidade opcional), web responsiva e um aplicativo Android via Capacitor. A composição técnica utiliza Next.js 16.3.1 (App Router, Turbopack) como framework web para processar SSR, rotas dinâmicas e API Route Handlers. A UI utiliza React 19.2 e TypeScript 5, com Tailwind CSS 4 e tokens CSS para estilização, e anime.js 4 para animações de transição. A camada de dados utiliza Prisma 7.9 com SQLite e better-sqlite3 para consultar registros de exames e dados de investigação de clãs. O mapa visualiza as origens e residências dos clãs usando tiles compatíveis com OpenStreetMap e projeção Web Mercator. Os resumos de IA utilizam a API compatível com OpenAI do NVIDIA NIM, com streaming via SSE através de um proxy de servidor. Para dispositivos móveis, utiliza Capacitor 6, Android SDK 36 e JDK 17 para o app WebView com.spear.gwageo. A validação de qualidade é feita com ESLint 9, tsc --noEmit e Gradle. A execução segue a sequência npm install, npm run db:push, npm run db:seed e npm run dev, com o servidor local operando em http://localhost:3000. Para verificação sem banco de dados, utiliza-se DATA_SOURCE=mock npm run dev, e a validação pode ser feita via npm run typecheck, lint, build e npm run audit:release. O repositório inclui arquitetura, guia de implantação, licenças de dados e avisos de terceiros. A licença do código da aplicação é MIT, mas os tiles do mapa e dados de terceiros mantêm suas licenças e condições de atribuição originais, não sendo relicenciados como MIT. Locais sem evidências oficiais ou licenças permitidas são armazenados e exibidos apenas como status de revisão. Os dados de celebridades por clã foram gerados via script com 4.549 pessoas de 367 clãs a partir de infoboxes da Wikipédia (CC BY-SA 4.0); a versão mesclada do Namuwiki (6.341 pessoas) é mantida apenas localmente e não é distribuída devido às condições CC BY-NC-SA. O lançamento para Android é compilado com Gradle assembleRelease após configurar o JDK 17 e o Android SDK, resultando no arquivo android/app/build/outputs/apk/release/app-release-unsigned.apk. Como a chave de assinatura de distribuição não está incluída no repositório, o APK do GitHub Release é um build não assinado (unsigned), exigindo uma assinatura de keystore separada para instalação geral ou distribuição em lojas.