공유 Resend 포트폴리오
하나의 Resend 계정과 검증된 도메인을 통해 여러 제품에 이메일을 구현합니다. 모든 앱을 동일한 제품처럼 보이지 않게 하면서 솔로 개발자 또는 소규모 포트폴리오가 무료 티어를 사용할 수 있도록 최적화합니다.
핵심 모델
인프라는 공유하되, 제품 정체성은 공유하지 않습니다:
하나의 Resend 계정
└── 기존에 검증된 발신자 도메인
├── 제품 A 발신자 식별
├── 제품 B 발신자 식별
└── 제품 C 발신자 식별
각 앱은 다음을 독자적으로 유지합니다:
- 발신자 표시 이름
- 수신자 받은편지함
- Reply-To 라우팅
- 제목 규칙
- 브랜드화된 HTML 및 일반 텍스트 템플릿
- 배포 환경 변수
- 전송 로그 및 실패 처리
모든 앱은 계정 수준의 무료 티어 할당량과 검증된 도메인 평판을 공유합니다.
포트폴리오 발견
구현 전:
- 대상 앱과 Resend 설정이 작동 중인 형제 앱을 검사합니다.
- 정식 Resend 계정과 이미 검증된 도메인을 식별합니다.
- 제품 표시 이름, 공유 발신자 사서함, 내부 수신자, 지원 Reply-To 받은편지함, 예상 이메일 유형을 확인합니다.
- 대상 배포 환경에 이미 Resend API 키가 있는지 확인합니다.
- 기존 계정이 명시된 요구 사항을 충족할 수 없는 경우가 아니라면 사용자에게 다른 계정을 만들거나, 다른 도메인을 검증하거나, 요금제를 구매하도록 요청하지 마십시오.
계정 및 키 전략
동일한 Resend 계정과 검증된 도메인을 재사용합니다. 계정이 허용하는 경우 배포된 앱마다 별도의 API 키를 사용하는 것이 좋습니다. 이렇게 하면 하나의 계정과 할당량을 유지하면서 키 유출 또는 교체의 영향을 제한할 수 있습니다. 별도의 키를 사용할 수 없거나 사용자가 명시적으로 그 트레이드오프를 선호하는 경우에만 동일한 키를 재사용합니다.
비밀을 다른 저장소의 소스 제어로 복사하지 마십시오. 선택한 키를 각 배포 환경의 비밀 환경 변수에 직접 추가합니다.
제품별 구성
실용적인 경우 서버 전용 변수와 제품별 이름을 사용합니다. 해당 값을 사용자의 기존 Resend 계정, 검증된 발신자 구성 및 의도된 제품 받은편지함에서 확인하여 가져옵니다. 예제 식별을 구현에 복사하지 마십시오.
| 변수 역할 | 목적 |
|---|---|
| Resend API 키 | 서버 측 제공자 호출을 인증합니다 |
| 제품 발신자 식별 | 현재 제품의 표시 이름과 기존 검증된 도메인의 주소를 결합합니다 |
| 제품 연락처 수신자 | 이 제품의 내부 알림을 수신합니다 |
| 제품 회신 주소 | 연락처 수신자와 다른 경우 사용자 대상 메시지에 대한 회신을 수신합니다 |
표시되는 표시 이름은 제품 정체성을 제공하고, 기존 검증된 주소는 전송 가능성을 제공합니다. API 키에 NEXT_PUBLIC_ 또는 이에 상응하는 클라이언트 노출 변수를 절대 사용하지 마십시오.
문의 양식 라우팅
두 개의 개별 메시지를 전송합니다:
내부 알림
보낸 사람: 구성된 제품 발신자 식별
받는 사람: 구성된 내부 제품 받은편지함
Reply-To: 방문자가 제출한 검증된 주소
방문자 확인
보낸 사람: 구성된 제품 발신자 식별
받는 사람: 방문자가 제출한 검증된 주소
Reply-To: 구성된 내부 제품 받은편지함
방문자와 내부 받은편지함을 하나의 수신자 목록에 넣지 마십시오. 별도의 메시지는 주소 노출을 방지하고 서로 다른 콘텐츠를 허용합니다.
내부 알림을 기본 전송으로 취급합니다. Resend가 이를 수락하고 메시지 ID를 반환한 후에만 양식 성공을 반환합니다. 그 후 방문자 확인을 시도하고, 실패 시 기본 문의가 손실되었다고 주장하지 않고 실패를 기록합니다.
브랜드 격리
제공자 모듈 패턴을 재사용 가능하게 유지하면서 각 제품에 대해 고유한 템플릿 셸을 만듭니다. 다음을 사용자 정의합니다:
- 제품 이름 및 설명자
- 색상, 타이포그래피 및 헤더 처리
- 이메일 미리보기 텍스트
- 제목 및 어조
- 바닥글 소유권, 지원 주소 및 응답 기대치
테이블 레이아웃, 인라인 CSS, 600~640px 콘텐츠 너비, 이스케이프된 사용자 값 및 일반 텍스트 버전을 사용합니다. 발신자 인프라가 공유된다는 이유만으로 다른 제품의 시각적 정체성을 재사용하지 마십시오.
공유 무료 티어 보호
- 기억된 숫자에 의존하지 않고 현재 Resend 무료 티어 제한을 확인합니다.
- 모든 앱이 동일한 계정 할당량을 소비한다는 점을 기억합니다.
- 필요한 트랜잭션 메시지만 전송하고 중복 알림을 피합니다.
- 공개 양식에 대해 스팸 방지 제어(유효성 검사, 길이 제한, 허니팟, 적절한 속도 제한)를 유지합니다.
- 중복을 보낼 수 있는 재시도 루프를 피합니다. 작업 흐름에 의미 있는 재시도 위험이 있는 경우 지속성 또는 멱등성을 사용합니다.
- 비밀 또는 불필요한 개인 데이터를 기록하지 않고 제공자 거부 및 할당량 오류를 모니터링합니다.
- 측정된 볼륨, 격리, 규정 준수 또는 평판 요구 사항이 정당화되는 경우에만 다른 계정 또는 유료 요금제로 전환합니다.
안정적인 구현
- 올바른 작업 공간에 공식
resend패키지를 설치합니다. - 제공자 호출을 서버 전용 모듈에 유지합니다.
result.data?.id를 확인하고result.error가 없는지 확인합니다.- SDK 및 네트워크 예외를 포착합니다.
replyTo를 명시적으로 설정합니다.- 이메일이 구성되지 않은 경우
503을 반환하고 기본 전송이 실패한 경우502를 반환합니다. - UI에 직접 이메일, 전화 또는 메시지 대체 수단을 유지합니다.
- 로그 전용 처리를 성공적인 전송으로 보고하지 마십시오.
검증
- 재사용된 Resend 계정에서 공유 도메인이 검증되었는지 확인합니다.
- 제품별 보낸 사람(From), 받는 사람(To) 및 회신(Reply-To) 값을 확인합니다.
- 내부 전송을 테스트한 다음 방문자 확인, 양방향 회신을 테스트합니다.
- 유효성 검사, 허니팟, 누락된 키, 제공자 거부 및 대체 경로를 테스트합니다.
- 저장소 고유의 타입 검사, 린트, 테스트 및 빌드 명령을 실행합니다.
- 배포 환경에 API 키와 제품 변수가 포함되어 있는지 확인합니다.
- 실제 제출이 작동한다고 주장하기 전에 한 번의 실제 제출을 수행합니다.