Mahjong Score Drill

リーチ麻雀の点数計算を練習するためのWebアプリケーションです。

技術スタック (Tech Stack)

このプロジェクトは以下の最新技術スタックで構築されています：

• Framework: Next.js 16 (App Router)
• Language: TypeScript 5.9+
• UI Architecture:
  • React 19
  • Tailwind CSS v4
• State Management: Zustand
• Mahjong Libraries:
  • @pai-forge/mahjong-react-ui - 用于显示麻雀牌和和牌的轻量级 UI 库
  • @pai-forge/riichi-mahjong - リーチ麻雀のルール・計算ロジック

Deployment

Environment Variables

Variable Name	Description	Required
NEXT_PUBLIC_GA_MEASUREMENT_ID	Google Analytics 4 Measurement ID (e.g. G-XXXXXXXXXX). GA script will only be loaded if this variable is set.	No (Production Only)

開発環境のセットアップ (Getting Started)

前提条件 (Prerequisites)

• Node.js 24.x 以上
• pnpm (Corepack または npm 経由でインストール)

インストール (Installation)

pnpm install

開発サーバーの起動 (Development)

pnpm run dev

ブラウザで http://localhost:3000 を開いて確認してください。

ビルド (Build)

pnpm run build

プロジェクト構成 (Project Structure)

詳細なアーキテクチャについては docs/architecture.md を参照してください。

src/
├── app/                          # Next.js App Router
│   ├── (home)/                   # ホーム画面
│   ├── drill/                    # ドリル画面
│   └── _components/              # 共通コンポーネント
└── lib/                          # 共有ロジック (麻雀計算、ユーティリティ等)