4. 전체 소스 코드와 사용한 도구

이 글의 목적

십자말풀이 웹에 쓴 소스 코드를 공개합니다. 파일을 펼칠 때만 코드를 불러옵니다.

사용한 도구

• Next.js 15, React 19, TypeScript: 대기실, 게임방, API
• node:sqlite: 판과 입력 기보 저장
• Ollama의 gemma4: 판 설계와 문제 작성. OpenAI 호환 API로 부르므로 다른 모델로 바꿀 수 있습니다.
• 구글 뉴스 RSS, 한국어 위키백과 API: 시사 헤드라인과 무작위 단어
• OpenSubtitles 한국어 빈도 순위: 단어 등급

폴더 구성

• lib/puzzle.ts: 난이도 설정, 판을 문제 목록으로 바꾸기, 기준 검사
• lib/gridFill.ts: 판 검증·보정, 미리 그린 판, 단어 채우기, 단어 연결형 배치기
• lib/dynamicBank.ts: AI 판 설계, AI 문제 작성, 뉴스·위키 단어
• lib/words.ts, freqRanks.ts: 단어 은행과 빈도 순위
• lib/db.ts: 기보 DB, 중간 저장, 빈 판 정리
• app/page.tsx, app/play/page.tsx: 대기실과 게임방
• app/api: 새 판, 기보 저장·목록·이어 풀기 API
• components/CrosswordBoard.tsx: 판 그리기
• scripts/text-agent.ts, ai-pipeline-test.ts: 생성기와 AI 과정을 글자로 시험하는 도구

실행할 때는 .env.local.example을 .env.local로 복사해 모델 주소를 넣습니다. 모델이 없으면 단어 은행과 위키 단어만으로 판을 만듭니다. 기보 DB, 광고·배포 스크립트, 서버 감시기는 싣지 않았습니다.

전체 소스