NexmaxAcademy — Japanese IT Pathway 新アプリ
カンボジアのIT専攻学生（日本語学習歴1年・N5〜N3挑戦）が、日本のIT企業で働くための知識と日本語を、リアルな現場の追体験で学ぶeラーニングアプリ。
旧アプリ tomy1031/nextmake_onbording のリニューアル版。設計思想・カリキュラム・移行計画は docs/design/ を参照。
技術スタック
- Next.js (App Router) + TypeScript + Tailwind CSS
- デプロイ先は Cloudflare Workers（OpenNext 経由。2026-08-03 に Vercel から移行）
- DB・認証は Supabase（Google ログイン）。Gemini 呼び出しはサーバプロキシ経由
- コンテンツは zod スキーマ準拠の JSON（
content/）。学習エンジンとコンテンツを分離する（docs/design/03 §1）
開発
Node は .nvmrc に合わせる（Node 22）。
npm install
cp .env.example .env.local # 環境変数を用意（実値は各自）
npm run dev # 開発サーバ http://localhost:3000
npm run lint # ESLint（品質）
npm run format # Prettier で整形
npm run typecheck # tsc --noEmit
npm run lint:content # コンテンツ検収（スキーマ＋禁止語＋ふりがな覆い 他）
npm run lint:secrets # 秘密情報混入検査（secretlint）
npm test # 単体テスト（Vitest）
npm run measure:readability # 文長・漢字密度レポート
コミット時に pre-commit フック（husky + lint-staged）が整形と検収を自動実行します。
Google ログインの設定（Supabase）
- Supabase プロジェクトを作成し、
.env.local に NEXT_PUBLIC_SUPABASE_URL と NEXT_PUBLIC_SUPABASE_ANON_KEY を設定
- Google Cloud Console で OAuth クライアントを作成し、リダイレクトURIに
https://<プロジェクトID>.supabase.co/auth/v1/callback を登録
- Supabase ダッシュボード → Authentication → Providers → Google を有効化し、クライアントID/シークレットを入力
- アプリ側のコールバックは
/auth/callback（実装済み）。Redirect URLs は https://<host>/** 形式で登録する（docs/deploy.md §0.3）
ログインが最初の画面です（ログインするまで学習画面は開けません）。
デプロイ（Cloudflare Workers）
| 環境 | URL | 載るもの | いつ更新されるか |
|---|
| 本番 | https://academy.nexmax.workers.dev | main | 火・水・金 17:05 ICT に自動（授業は 17:30）。緊急は手動 |
| STG | https://staging-academy.nexmax.workers.dev | integration | integration へマージするたび自動 |
| ブランチ用 | https://<ブランチ名>-academy.nexmax.workers.dev | 作業ブランチ | npm run cf:branch |
作業ブランチは integration へ PR する。STG で確かめたものが、授業の前に本番へ昇格する。
手順・環境変数・踏みやすい罠は docs/deploy.md §0 を参照。
キャラクター画像（ネクマックス）
ナビゲーターのネクマックスは Codex の image-gen-2 で生成します（手描きSVG禁止）。
正典 public/img/characters/nexmax/reference.png を参照入力にして、
docs/skills/codex_image_generation.md の手順でバリアントを生成してください。
ドキュメント
| ファイル | 内容 |
|---|
AGENTS.md | AIエージェント向けの規律（CLAUDE.md / .gemini からも参照される単一ソース） |
docs/design/01_理解設計ガイド.md | 教材設計の13原則・アンチパターン・制作レシピ（教材を書く前に必読） |
docs/design/02_拡張カリキュラム設計書.md | 「ネクストメイク1年目」12モジュールのカリキュラム計画 |
docs/design/03_リニューアル設計方針.md | アーキテクチャ・DB要件・検収パイプライン・移行手順 |
docs/design/04_ビジュアルテーマ.md | ビジュアル・文言トーン・ネクマックスの規律（UIに触る前に必読） |
docs/design/09_Cloudflare移行実行計画.md | Vercel → Cloudflare Workers 移行の計画と制約 |
docs/design/review_rubric.md | 検収ルーブリック（証拠必須） |
docs/deploy.md | デプロイ／環境構成（Cloudflare Workers・Supabase 共有の運用） |
docs/システム構成とレート制限.html | 天井マップ（構成図と、無料枠がどの作業にどう効くか。ブラウザで開く） |
docs/constraints.md | ユーザーが伝えた制約・好みの永続台帳（作業前に必読） |
docs/codex-backend.md | 生成バックエンド（Codex／Gemini）の構成 |
