flair bar es — 開発参加ガイド
flair bar es（札幌のバー）の会員管理アプリです。
顧客向けアプリ・管理画面を1つのリポジトリで管理しています。
参加前の準備
1. 必要なツールをインストール
2. SSH鍵をGitHubに登録（初回のみ）
# SSH鍵があるか確認
ls ~/.ssh/*.pub
# なければ作成
ssh-keygen -t ed25519 -C "あなたのメールアドレス"
# 公開鍵を表示してコピー
cat ~/.ssh/id_ed25519.pub
コピーした鍵を → https://github.com/settings/ssh/new に貼り付けて登録。
登録確認：
ssh -T [email protected]
# → "Hi xxx! You've successfully authenticated..." と表示されればOK
セットアップ
3. リポジトリをクローン
git clone [email protected]:ltinfluence1023-arch/es-members-app.git
cd es-members-app
4. 依存関係をインストール
pnpm install
5. 環境変数を設定
cp .env.example .env.local
.env.local を開いて、チームの共有チャンネルから取得した実際の値を入力してください。
⚠️ .env.local は絶対にコミットしないでください。gitignoreで除外済みです。
6. 開発サーバーを起動
pnpm dev
→ http://localhost:3000 をブラウザで開く
Claude Code での開発
Claude Code をインストール（未インストールの場合）
npm install -g @anthropic-ai/claude-code
プロジェクトで Claude を起動
cd es-members-app
claude
AGENTS.md がプロジェクト規約として自動的に読み込まれ、チーム全員のClaudeが同じルールで動きます。
開発の流れ
毎回の作業手順
# 1. 最新のコードを取得
git checkout main
git pull origin main
# 2. 作業ブランチを作成
git checkout -b feature/作業内容の名前
# 例: feature/add-coupon-filter
# 3. 開発（Claude に作業を依頼しながら進める）
claude
# 4. 変更をコミット
git add <変更したファイル>
git commit -m "feat: ○○機能を追加"
# 5. GitHubにpush
git push origin feature/作業内容の名前
# 6. GitHub上でPull Requestを作成
# → https://github.com/ltinfluence1023-arch/es-members-app
コミットメッセージの形式
feat: 機能追加
fix: バグ修正
style: デザイン変更
refactor: リファクタ
docs: ドキュメント変更
ブランチのルール
| ブランチ | 用途 |
|---|
main | 本番（直接pushしない） |
feature/xxx | 機能追加 |
fix/xxx | バグ修正 |
プロジェクト構成
es-members-app/
├── app/
│ ├── (admin)/admin/ # 管理画面
│ ├── (customer)/ # 顧客向け画面
│ ├── api/ # APIルート
│ └── globals.css # デザインテーマ
├── components/
│ ├── admin/ # 管理画面コンポーネント
│ ├── customer/ # 顧客向けコンポーネント
│ └── ui/ # 共通UIパーツ
├── lib/
│ ├── supabase/ # DBクライアント
│ ├── types/ # 型定義
│ └── utils/ # 共通ユーティリティ
└── docs/
├── HANDOVER.md # 詳細な仕様書
├── setup/ # 新規環境セットアップ（全スキーマ一括SQL）
└── migrations/ # DBマイグレーション履歴
よくある作業
ビルド確認
pnpm build
本番デプロイ（担当者のみ）
pnpm build && vercel --prod --yes
困ったとき
