Communitygithub.com

Pranith-Jain/dfir-threat-intel-platform

완전한 대기자 명단을 구축합니다. 이메일 캡처, 중복 감지, Resend를 통한 확인 이메일, Supabase 저장소, 관리자 보기, 선택적 추천 추적 기능을 제공합니다. 제품 출시, 잠재 고객 확보, 또는 얼리 액세스 게이트가 필요할 때 사용하세요.

dfir-threat-intel-platform란 무엇인가요?

이 스킬은 완전한 기능을 갖춘 대기자 명단 시스템을 Next.js 프로젝트 내에 신속하게 구축할 수 있도록 도와줍니다. 개발자는 이 스킬을 사용하여 이메일 캡처, 중복 감지, 확인 이메일 전송, 관리자 대시보드 및 선택적 추천 추적 기능을 몇 분 안에 추가할 수 있습니다. 주요 지원 플랫폼으로는 Supabase, Prisma, Drizzle, Resend가 있으며, 프로젝트의 기존 스택을 자동으로 감지하여 적응합니다. 이 스킬은 또한 프로젝트 구조를 읽고, 필요한 데이터베이스 스키마와 API 라우트를 생성하며, 사용자와 상호 작용하여 수집할 정보의 종류와 추천 추적 활성화 여부를 결정합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Pranith-Jain/dfir-threat-intel-platform/tree/HEAD/.agents/skills/waitlist

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

완전한 대기자 명단(이메일 캡처, 저장소, 확인 이메일, 관리자 보기)을 구축합니다. 먼저 프로젝트를 읽고 기존 스택에 연결합니다.

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에 있음
[ ] 제출 중 양식 입력 비활성화
[ ] 성공 상태에 위치 및 추천 링크 표시

관련 스킬