一肢入魂(isshi-nyukon)
宅建(宅地建物取引士試験)の学習ゲーム。4択を当てるゲームではなく、
全部の肢に理由をつけて決着をつけるゲームです。判定(○×) → 誤り箇所タップ →
理由選択 の3段階でスコアリングし、勘の正解では点が伸びません。通勤中などにスマホで、
1セッション5〜10分を想定しています。
本アプリは宅建試験の非公式・個人利用の学習ツールです。問題は条文・判例に基づく
自作で、過去問の転載ではありません。
技術構成
- Next.js(App Router)+ TypeScript + React
- 永続化は localStorage のみ(
lib/storage.ts の StorageAdapter 経由)。
DB・認証・サーバーAPIは使いません。環境変数なしで動作します。
- スタイリングはデザイントークンベース(
lib/tokens.ts / app/globals.css)。
Webフォント不使用(日本語システムフォントのみ)。
- パッケージマネージャは pnpm。
設計の詳細は CLAUDE.md と docs/design-v1.md を参照してください。
ローカル開発
pnpm install # 依存インストール
pnpm dev # 開発サーバ起動(http://localhost:3000)
pnpm build # 本番ビルド
pnpm start # 本番ビルドの起動
pnpm lint # Lint
pnpm test # ユニットテスト(scoring / srs / storage ほか)
Vercel へのデプロイ
完全静的 + クライアント(localStorage)のみで、DB・環境変数は不要のため、
Vercel にそのままデプロイできます。
- GitHub 等のリポジトリを Vercel の New Project → Import Git Repository で取り込む。
- フレームワークは Next.js として自動検出される。パッケージマネージャも
pnpm-lock.yaml から pnpm が自動選択されるため、ビルド設定の変更は不要
(Build Command / Output Directory はデフォルトのまま)。
- 環境変数の設定は不要。任意で OGP の絶対URLを固定したい場合のみ、
NEXT_PUBLIC_SITE_URL(例: https://<your-app>.vercel.app)を設定する。
未設定でも Vercel が注入する VERCEL_URL にフォールバックする。
- Deploy を押すと公開URLが発行される。以降は push で自動デプロイ。
公開URLを持つこと自体は Neon(DB)移行のトリガーではありません。成績データは
引き続き各端末の localStorage に保存されます(方針: issue #50)。
ライセンス・著作権
個人開発・個人利用のプロジェクトです。問題の肢は過去問の「論点」だけを借りた自作で、
丸写しではありません。詳細は CLAUDE.md の「著作権対応」を参照してください。
