搭建完整的等待列表——邮箱捕获、存储、确认邮件和管理员视图。先读取项目,适配现有技术栈。
第一步:检测项目
cat package.json | grep -E "next|supabase|prisma|drizzle|resend"
检查项:
- 数据库:Supabase / Prisma / Drizzle / 原生 Postgres?
- 邮件:是否已安装 Resend?
- 认证:是否有认证提供者?(管理员视图需要)
- 现有等待列表表? 在 schema 文件中搜索
waitlist
第二步:询问用户
我将为 [产品名称] 搭建等待列表。
快速决策:
1. 您想收集哪些信息?
a) 仅邮箱(默认——转化率最高)
b) 邮箱 + 姓名
c) 邮箱 + 姓名 + “你在做什么?”(可选字段)
2. 是否开启推荐追踪?
a) 否——简单列表
b) 是——每个注册用户获得唯一推荐链接,记录推荐人数
3. 是否发送确认邮件?
a) 是——通过 Resend 发送“您已在列表中”邮件(默认)
b) 否
4. 您有 Resend 和已验证的发送域名吗?(有 / 需要设置)
第三步:数据库 Schema
根据检测到的数据库进行适配。创建 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())
}
第四步:注册 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 || '用户',
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);
}
第五步:确认邮件
// 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>
`,
});
}
第六步:注册表单组件
// 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} />;
}
第七步:管理员视图
简单的路由,需要密钥头——等待列表管理员不需要完整的认证:
// 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: '未授权' }, { 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 中
[ ] 表单在提交期间禁用输入
[ ] 成功状态显示排名和推荐链接