完全なウェイティングリストをスキャフォールドします — メール取得、ストレージ、確認メール、管理者ビュー。まずプロジェクトを読み取り、既存のスタックに配線します。
フェーズ1: プロジェクトの検出
cat package.json | grep -E "next|supabase|prisma|drizzle|resend"
確認:
- データベース: Supabase / Prisma / Drizzle / 生のPostgres?
- メール: Resendは既にインストール済み?
- 認証: 何か認証プロバイダはある? (管理者ビューに必要)
- 既存のウェイティングリストテーブル? スキーマファイルで
waitlistを検索
フェーズ2: ユーザーへの質問
[製品名] のウェイティングリストをスキャフォールドします。
簡単な決定:
1. どの情報を収集しますか?
a) メールのみ (デフォルト — 最も高いコンバージョン率)
b) メール + 名前
c) メール + 名前 + 「何を構築していますか?」 (任意フィールド)
2. 紹介トラッキングは?
a) いいえ — シンプルなリスト
b) はい — 各サインアップに固有の紹介リンク、紹介数を追跡
3. 確認メールは?
a) はい — Resend経由で「リストに登録されました」メールを送信 (デフォルト)
b) いいえ
4. Resendと検証済み送信ドメインはありますか? (はい / 設定が必要)
フェーズ3: データベーススキーマ
検出されたデータベースに適応します。waitlist テーブルを作成:
Supabase / 生SQL:
create table public.waitlist (
id uuid primary key default gen_random_uuid(),
email text not null unique,
name text,
note text, -- 任意の「何を構築していますか?」フィールド
referral_code text unique, -- 共有可能なコード (紹介が有効な場合)
referred_by text references public.waitlist(referral_code), -- 誰が紹介したか
referral_count integer default 0, -- 紹介した人数
position integer, -- キュー内の位置 (トリガーで設定)
confirmed_at timestamptz, -- null = 未確認
created_at timestamptz default now()
);
-- 挿入時に位置を自動インクリメント
create or replace function set_waitlist_position()
returns trigger as $$
begin
new.position = (select coalesce(max(position), 0) + 1 from public.waitlist);
return new;
end;
$$ language plpgsql;
create trigger waitlist_position_trigger
before insert on public.waitlist
for each row execute function set_waitlist_position();
紹介トラッキングが不要な場合は、referral_code, referred_by, referral_count を削除します。
Prisma:
model Waitlist {
id String @id @default(cuid())
email String @unique
name String?
note String?
referralCode String? @unique
referredBy String?
referralCount Int @default(0)
position Int
confirmedAt DateTime?
createdAt DateTime @default(now())
}
フェーズ4: サインアップAPIルート
// app/api/waitlist/route.ts
import { NextResponse } from 'next/server';
export async function POST(req: Request) {
const { email, name, note, referredBy } = await req.json();
// メールを検証
if (!email || !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) {
return NextResponse.json({ error: '有効なメールアドレスが必要です' }, { status: 400 });
}
// 正規化
const normalizedEmail = email.toLowerCase().trim();
// 重複をチェック
const existing = await db.query.waitlist.findFirst({
where: eq(waitlist.email, normalizedEmail),
});
if (existing) {
// 成功を返す — スパマーにどのメールが登録済みかを教えない
return NextResponse.json({
success: true,
position: existing.position,
alreadyRegistered: true,
});
}
// 紹介コードを生成 (有効な場合)
const referralCode = generateReferralCode(normalizedEmail); // 例: メールハッシュの最初の8文字
// 挿入
const entry = await db
.insert(waitlistTable)
.values({
email: normalizedEmail,
name: name?.trim() || null,
note: note?.trim() || null,
referralCode,
referredBy: referredBy || null,
})
.returning();
// 紹介者のカウントを増やす
if (referredBy) {
await db
.update(waitlistTable)
.set({ referralCount: sql`referral_count + 1` })
.where(eq(waitlistTable.referralCode, referredBy));
}
// 確認メールを送信 (Resendが設定されている場合)
if (process.env.RESEND_API_KEY) {
await sendWaitlistConfirmation({
email: normalizedEmail,
name: name || 'there',
position: entry[0].position,
referralCode,
});
}
return NextResponse.json({
success: true,
position: entry[0].position,
referralCode,
});
}
function generateReferralCode(email: string): string {
const { createHash } = require('crypto');
return createHash('sha256').update(email).digest('hex').slice(0, 8);
}
フェーズ5: 確認メール
// lib/emails/waitlist-confirmation.ts
import { Resend } from 'resend';
const resend = new Resend(process.env.RESEND_API_KEY);
export async function sendWaitlistConfirmation({
email,
name,
position,
referralCode,
}: {
email: string;
name: string;
position: number;
referralCode?: string;
}) {
const referralUrl = referralCode ? `${process.env.NEXT_PUBLIC_APP_URL}/?ref=${referralCode}` : null;
await resend.emails.send({
from: `[製品名] <[email protected]>`,
to: email,
subject: `あなたはリストの #${position} 番目です`,
html: `
<div style="font-family: sans-serif; max-width: 520px; margin: 0 auto; padding: 40px 20px; color: #111;">
<p>こんにちは ${name} さん、</p>
<p>あなたはウェイティングリストの <strong>#${position}</strong> 番目です。順番が来ましたらご連絡します。</p>
${
referralUrl
? `
<p style="margin-top: 24px;">
リストを上がるには、あなたのリンクを共有してください:<br>
<a href="${referralUrl}" style="color: #000; font-weight: bold;">${referralUrl}</a>
</p>
`
: ''
}
<p style="color: #666; font-size: 13px; margin-top: 40px;">— [あなたの名前]</p>
</div>
`,
});
}
フェーズ6: サインアップフォームコンポーネント
// components/waitlist-form.tsx
'use client';
import { useState } from 'react';
export function WaitlistForm({ referralCode }: { referralCode?: string }) {
const [email, setEmail] = useState('');
const [state, setState] = useState<'idle' | 'loading' | 'success' | 'error'>('idle');
const [position, setPosition] = useState<number | null>(null);
const [userReferralCode, setUserReferralCode] = useState<string | null>(null);
async function handleSubmit(e: React.FormEvent) {
e.preventDefault();
setState('loading');
const res = await fetch('/api/waitlist', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email, referredBy: referralCode }),
});
const data = await res.json();
if (data.success) {
setState('success');
setPosition(data.position);
setUserReferralCode(data.referralCode);
} else {
setState('error');
}
}
if (state === 'success') {
return (
<div>
<p>あなたは #{position} 番目です。</p>
{userReferralCode && (
<p>
順位を上げるにはあなたのリンクを共有してください: <code>{`${window.location.origin}/?ref=${userReferralCode}`}</code>
</p>
)}
</div>
);
}
return (
<form onSubmit={handleSubmit}>
<input
type="email"
value={email}
onChange={(e) => setEmail(e.target.value)}
placeholder="[email protected]"
required
disabled={state === 'loading'}
/>
<button type="submit" disabled={state === 'loading'}>
{state === 'loading' ? '参加中...' : 'ウェイティングリストに参加'}
</button>
{state === 'error' && <p>問題が発生しました。もう一度お試しください。</p>}
</form>
);
}
URLパラメータから紹介コードを読み取るページ:
// app/page.tsx
export default function Page({ searchParams }: { searchParams: { ref?: string } }) {
return <WaitlistForm referralCode={searchParams.ref} />;
}
フェーズ7: 管理者ビュー
シークレットヘッダーを必要とするシンプルなルート — ウェイティングリスト管理者に完全な認証は不要:
// app/api/admin/waitlist/route.ts
export async function GET(req: Request) {
if (req.headers.get('x-admin-secret') !== process.env.ADMIN_SECRET) {
return Response.json({ error: 'Unauthorized' }, { status: 401 });
}
const signups = await db.select().from(waitlistTable).orderBy(asc(waitlistTable.position));
return Response.json({
total: signups.length,
signups,
});
}
取得: curl -H "x-admin-secret: $ADMIN_SECRET" https://yoursite.com/api/admin/waitlist
確認
[ ] 重複メールは alreadyRegistered: true で成功を返す (エラーなし、漏洩なし)
[ ] メールは保存前に小文字に正規化される
[ ] 位置が正しくインクリメントされる — 最初のサインアップは #1
[ ] 確認メールが受信箱に届き、スパムフォルダには入らない
[ ] URL内の紹介コード (?ref=) がキャプチャされ、サインアップ時に保存される
[ ] 紹介者のカウントが、紹介されたサインアップが完了したときにインクリメントされる
[ ] 管理者ルートは x-admin-secret ヘッダーを必要とする
[ ] ADMIN_SECRET と RESEND_API_KEY が .env.example にある
[ ] フォームは送信中に入力を無効化する
[ ] 成功状態は位置と紹介リンクを表示する