IPA Quiz
IPA 情報処理技術者試験（IP / SG / FE / AP / ST / SA / PM / NW / DB / ES / SC / SM / AU）
全区分の公開過去問を無料で学べる、教育貢献型 AI ネイティブ学習プラットフォームです。
- ゼロ遷移の四択クイズ UI（タップ→即座に色変化＋解説スライドイン）
- AI コパイロット常駐（用語解説・選択肢分析・類題・誤答分析）
- 全試験区分を 1 アプリに統合
フェーズ 1（MVP）の対象は「応用情報技術者(AP) 午前」。以降、順次拡張予定。
技術スタック
- Next.js 16 (App Router) + React 19 + TypeScript strict
- Tailwind CSS v4 + 自作の shadcn ベース UI primitives
- Google Gemini API（
lib/ai/provider.ts の抽象レイヤ経由）
- 学習履歴は
localStorage（将来 Supabase に移行可能な抽象層）
- pnpm / ESLint / Zod / tsx / react-markdown / lucide-react / radix-ui
セットアップ
pnpm install
cp .env.example .env.local
# GEMINI_API_KEY を入れるか、空のまま起動して mock フォールバックで開発
pnpm dev
開発サーバは http://localhost:3000 で起動します。
GEMINI_API_KEY が空でも、AI コパイロットは lib/ai/providers/mock.ts のモックレスポンスで動作します。クイズ UI・レート制限などの挙動はキーなしでフル確認できます。
環境変数
| 変数 | 役割 | デフォルト |
|---|
GEMINI_API_KEY | Gemini API キー | （空でモック動作） |
ANTHROPIC_API_KEY | Anthropic API キー（スタブ用） | — |
DATABASE_URL | DB 接続文字列（フェーズ 2〜） | — |
NEXTAUTH_SECRET | NextAuth シークレット（フェーズ 2〜） | — |
NEXTAUTH_URL | アプリ公開 URL | — |
NEXT_PUBLIC_POSTHOG_KEY | PostHog プロジェクト API キー | — |
NEXT_PUBLIC_POSTHOG_HOST | PostHog ホスト | https://us.i.posthog.com |
NEXT_PUBLIC_SENTRY_DSN | Sentry DSN | — |
NEXT_PUBLIC_AMAZON_ASSOCIATE_TAG | 任意のAmazon紹介タグ。閉鎖済み safeaisite22-22 は無効化され通常商品リンクになる | — |
NEXT_PUBLIC_RAKUTEN_AFFILIATE_ID | 楽天アフィリエイト ID | — |
ADMIN_BASIC_USER | 管理画面 Basic 認証ユーザー | — |
ADMIN_BASIC_PASS | 管理画面 Basic 認証パスワード | — |
SLACK_WEBHOOK_URL | cron ジョブ通知用 Webhook | — |
LLM_PROVIDER | プロバイダ選択 | gemini |
GEMINI_MODEL_FREE | 無料ユーザー向けモデル | gemini-2.5-flash-lite |
GEMINI_MODEL_PREMIUM | プレミアム向けモデル | gemini-2.5-flash |
GEMINI_MODEL_GRADING | 午後記述・論述 AI 採点のモデル | gemini-2.5-flash |
FREE_DAILY_LIMIT | 無料枠の 1 日回数 | 30 |
PREMIUM_MINUTE_LIMIT | プレミアムの 1 分ソフトリミット | 10 |
価格・回数・モデル変更は CLAUDE.md の「承認必須事項」扱いです。
スクリプト
pnpm dev # 開発サーバ起動
pnpm build # 本番ビルド
pnpm typecheck # TypeScript 型チェック
pnpm lint # ESLint
pnpm fetch:pdfs # IPA 公式 PDF をローカルへダウンロード
pnpm parse:pdfs # PDF → JSON 変換
pnpm validate:questions # 問題データを zod で検証
pnpm tag:topics # Gemini でトピックタグを自動付与
デプロイ（Vercel）
npm i -g vercel
vercel link # 初回のみ
vercel env add GEMINI_API_KEY # production / preview / development で設定
vercel # preview deploy
vercel --prod # production deploy
監視
| エンドポイント | 用途 |
|---|
/api/health | ヘルスチェック（Vercel / UptimeRobot 監視用） |
| PostHog | ページビュー・クイズ操作イベント |
| Sentry | フロント/サーバーエラー収集 |
ディレクトリ構造
app/
api/copilot/ AI コパイロット ストリーミング API
api/health/ ヘルスチェック
(home) page.tsx モード選択ホーム
quiz/ クイズプレイヤー
modes/year,topic 年度別・分野別一覧
about/ IPA出典・著作権ページ
components/
quiz/ QuestionCard / ChoiceButton / ExplanationCard / QuizPlayer
copilot/ CopilotPanel + モバイルボトムシート
ui/ Button / Card / Dialog / Switch / Badge / Markdown
lib/
ai/ provider.ts + providers/{gemini,claude,openai,mock}.ts
questions/ types / load / filter
storage/ localStorage 履歴・プレミアム・レート制限
rate-limit/ IP ベースのサーバー側レート制限
data/
questions/ap/ AP 問題データ
scripts/ fetch / parse / validate / topic-tagger
ライセンス / 出典
- 問題文・選択肢・模範解答は IPA 情報処理技術者試験の公開過去問を原典とし、各問に原典 PDF リンクを付与しています。
- IPA は過去問の使用について許諾不要・使用料不要と公式に明示しています。詳細は
/about ページを参照してください。
- 解説本文・UI・タグ付け・AI 応答などは本サイト独自の著作物です。
貢献
現在は個人開発。Issue / PR は後日解放予定。
