완전한 대기자 명단(이메일 캡처, 저장소, 확인 이메일, 관리자 보기)을 구축합니다. 먼저 프로젝트를 읽고 기존 스택에 연결합니다.
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에 있음
[ ] 제출 중 양식 입력 비활성화
[ ] 성공 상태에 위치 및 추천 링크 표시