이메일 설정

설치 및 설정

어떤 단계를 시작하기 전에 시작하기 전에 및 터미널 기본 사항을 읽어보세요. 이 지침에서는 VS Code에서 전체 supastack 단일 저장소를 열었다고 가정합니다. 해당 루트 package.json은 저장소 루트를 표시합니다. pnpm 명령에서 작업 영역 패키지는 앱 또는 공유 코드 폴더입니다. 제품에서 작업공간은 팀의 데이터 컨테이너이자 보안 경계입니다. corepack pnpm --filter ... 명령이 해당 루트에서 실행되는 동안 monorepo에서 하나의 패키지를 선택합니다. 동기화된 모바일 또는 데스크톱 폴더만 열었다면 웹 백엔드, Docker 설정 또는 루트 스크립트가 포함되지 않습니다. 이 모노 저장소 또는 연결 가능한 호스팅 서버에서 백엔드를 실행하고 플랫폼 폴더의 자체 스크립트를 사용하세요. 환경 변수는 로컬 .env 파일이나 호스팅 대시보드에 저장된 명명된 설정입니다. 관련 앱을 변경한 후 다시 시작하고, NEXT_PUBLIC_ 및 EXPO_PUBLIC_ 값에서 서버 비밀을 유지하세요.

1. apps/web/.env.local를 열고 개발용으로 EMAIL_PROVIDER=local를 설정합니다. EMAIL_FROM는 템플릿에서 사용되는 발신자 레이블입니다.

2. corepack pnpm --filter @supastack/web dev를 사용하여 리포지토리 루트에서 웹 앱을 시작하고 테스트 주소를 사용하여 로그인 또는 초대 흐름을 한 번 트리거합니다. 예상: 앱은 실제 공급자에게 연락하지 않고 로컬 이메일 결과를 기록합니다. 발신자 도메인이 확인되고 테스트 수신자가 제한된 후에만 재전송, SES 또는 기타 서비스를 연결하세요.

EMAIL_PROVIDER=local는 결정론적 전달을 로컬로 유지합니다. 구성된 프로덕션 제공의 경우 재전송 또는 SES 어댑터를 검토하고 해당 서버 자격 증명을 제공하십시오. EMAIL_FROM는 선택한 제공업체에서 확인된 신원과 일치해야 합니다.

• AWS SDK 또는 IAM SMTP로 Amazon SES 설정

EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# Production adapter configuration is listed in .env.example:
# RESEND_API_KEY=  POSTMARK_SERVER_TOKEN=  SENDGRID_API_KEY=  BREVO_API_KEY=
# MAILGUN_API_KEY=  MAILGUN_DOMAIN=  MAILGUN_REGION=us

복사 명령

설명을 따라 명령이 실행되는 폴더를 확인하세요. 두 개의 터미널에 레이블이 지정되어 있으면 두 개의 터미널 창을 열고 두 번째 명령을 사용하는 동안 첫 번째 명령을 계속 실행하세요.

corepack pnpm --filter @supastack/web dev

구현 워크플로

인증 및 완료 메시지는 트랜잭션 이메일 경계를 사용합니다. 아웃리치 플로는 소비 제품에 속하며 분리되어 있습니다. 이 경로를 리뷰되지 않은 대량 메시징 서브시스템으로 재사용하지 마세요.

전송을 생성과 별도로 기록하세요. 모델 결과가 이용 가능한 동안 완료 메시지가 실패할 수 있습니다. 복구는 같은 결과를 재생성하는 대신 전송 상태를 검사해야 합니다.

검증 및 문제 해결

로컬 이메일이 나타나지 않으면 EMAIL_PROVIDER가 apps/web/.env.local에 설정되어 있는지 확인하고 웹을 다시 시작하세요. 실제 공급자가 메시지를 거부하는 경우 EMAIL_FROM가 확인된 발신자와 일치하는지 확인하고 공급자의 배달 기록을 검사합니다. 생성된 AI 답변은 후속 이메일이 실패하더라도 성공할 수 있습니다. AI task를 다시 실행하기 전에 배송을 확인하십시오.

전용 테스트 환경에서 수신자 제한, 발신자 신원, 프로바이더 오류를 검증하세요. 로컬 어댑터 결과는 실제 이메일 전송의 증거가 아닙니다. 옵트인 스모크 경로는 REAL_SMOKE_EMAIL_ALLOWED_DOMAIN으로 수신자를 제한합니다.