4. O código-fonte completo e as ferramentas usadas

Objetivo deste post

Publicamos o código-fonte usado na web de palavras cruzadas. O código só é carregado quando você abre um arquivo.

Ferramentas usadas

• Next.js 15, React 19, TypeScript: lobby, sala de jogo, APIs
• node:sqlite: armazenamento das grades e dos registros de entradas
• gemma4 no Ollama: projeto da grade e escrita das pistas. Como é chamado por uma API compatível com a OpenAI, pode ser trocado por outro modelo.
• RSS do Google Notícias e API da Wikipédia em coreano: manchetes de atualidades e palavras aleatórias
• Ranking de frequência do coreano do OpenSubtitles: níveis das palavras

Estrutura de pastas

• lib/puzzle.ts: configuração de dificuldade, transformação da grade em lista de pistas, verificação dos critérios
• lib/gridFill.ts: validação e correção da grade, grades desenhadas de antemão, preenchimento de palavras, posicionador que encaixa palavras
• lib/dynamicBank.ts: projeto da grade pela IA, escrita das pistas pela IA, palavras de notícias e da wiki
• lib/words.ts, freqRanks.ts: banco de palavras e ranking de frequência
• lib/db.ts: banco de registros de partidas, salvamento parcial, limpeza de grades vazias
• app/page.tsx, app/play/page.tsx: lobby e sala de jogo
• app/api: APIs de grade nova e de salvar, listar e retomar registros
• components/CrosswordBoard.tsx: desenho da grade
• scripts/text-agent.ts, ai-pipeline-test.ts: ferramentas que testam em texto o gerador e o processo da IA

Para rodar, copie .env.local.example para .env.local e coloque o endereço do modelo. Sem modelo, as grades são criadas só com o banco de palavras e as palavras da wiki. O banco de registros de partidas, os scripts de anúncios e de implantação e o monitor do servidor não foram incluídos.

Código-fonte completo