Communitygithub.com

Pranith-Jain/dfir-threat-intel-platform

快速搭建完整等待列表:邮箱捕获、去重检测、通过Resend发送确认邮件、Supabase数据存储、管理员视图查看注册,以及可选的推荐追踪。适用于产品发布、建立受众或设置早期访问门槛。

dfir-threat-intel-platform 是什么?

该技能能够为您的 Next.js 项目快速搭建一个完整的等待列表系统,覆盖从邮箱收集、冗余检测、确认邮件发送到管理员后台的全流程。它首先会检测项目中的技术栈(如 Supabase、Prisma、Resend 等),然后通过与用户交互询问所需字段(仅邮箱、邮箱+姓名、还是额外备注)、是否开启推荐追踪、以及是否使用 Resend 发送确认邮件等配置选项。接着自动生成对应的数据库 Schema(支持 Supabase/原始 SQL、Prisma),创建注册 API 路由(包含邮箱规范化、防重复、推荐码生成与计数、确认邮件触发等逻辑),提供可复用的 React 前端表单组件(包含推荐码自动读取、提交状态反馈),以及一个通过 `x-admin-secret` 头认证的简易管理 API 路由。该技能极大地节省了手动搭建此类基础功能的时间,并推荐在 Supabase、Prisma、Resend 等平台上使用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pranith-Jain/dfir-threat-intel-platform/tree/HEAD/.agents/skills/waitlist

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

搭建完整的等待列表——邮箱捕获、存储、确认邮件和管理员视图。先读取项目,适配现有技术栈。

第一步:检测项目

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 中
[ ] 表单在提交期间禁用输入
[ ] 成功状态显示排名和推荐链接

相关技能