콘텐츠로 건너뛰기
supastack
문서 둘러보기
모바일Expo

For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ko/docs/modules/email-configuration.md (or send Accept: text/markdown).

이메일 프로바이더 구성

트랜잭션 전송을 구성하고 독립적인 결과를 검증하세요.

이 가이드에 대해 질문하기
다음에서 열기

설치 및 설정

어떤 단계를 시작하기 전에 시작하기 전에 및 터미널 기본 사항을 읽어보세요. 이 지침에서는 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는 선택한 제공업체에서 확인된 신원과 일치해야 합니다.

EMAIL_PROVIDER=local
EMAIL_FROM=supastack <[email protected]>
# Production adapter configuration is listed in .env.example.

복사 명령

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

corepack pnpm --filter @supastack/web dev

구현 워크플로

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

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

검증 및 문제 해결

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

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

자주 묻는 질문

질문 14개

supastack이란 무엇인가요?

supastack은 AI SaaS 제품을 구축하기 위한 모듈식 기반입니다. 공통 인프라를 모아두어 제품 고유의 기능에 집중할 수 있습니다.

웹과 모바일을 지원하나요?

네. supastack에는 웹과 모바일 경험의 출발점으로 Next.js 앱과 Expo 앱이 포함되어 있습니다.

어떤 인증이 포함되어 있나요?

Better Auth가 이메일/비밀번호, OTP, 소셜 로그인을 커버합니다. 개인 워크스페이스는 계정과 함께 프로비저닝되어 첫날부터 레코드가 경계 안에 유지됩니다.

AI는 어떻게 지원되나요?

supastack에는 구성 가능한 멀티 프로바이더 AI, 사용량 추적, 예산, 암호화된 자체 키(BYOK) 지원이 포함되어 있습니다.

구독은 어떻게 관리되나요?

이 키트 위에 구축된 제품에서는 Stripe 결제, 구독, 권한이 유료 액세스의 기반을 형성합니다. 프로바이더 시크릿은 서버 측에 유지됩니다.

제품 고유 코드는 어디에 두나요?

제품 고유 기능은 별도의 코드베이스에 두고, 제품이 supastack 기본 모듈을 구성하고 통합합니다.

supastack 가격은 어떻게 되나요?

키트는 평생 업데이트가 포함된 일회성 구매입니다: 단일 프레임워크 $249(기간 한정 출시 가격 — 정가 $349에서 $100 할인) 또는 모든 프레임워크(Next.js, iOS, Android) $499(기간 한정 출시 가격 — 정가 $599에서 $100 할인), 추가 개발자 시트당 $75. 키트 구독은 없습니다. 이 사이트의 체크아웃은 라이선스 키를 이메일로 전달하고 GitHub 초대로 리포지토리 액세스를 제공합니다.

워크스페이스는 내 데이터를 어떻게 경계 짓나요?

사용자 레코드는 workspaceId로 범위가 지정됩니다. 신원, 권한, AI 사용량, 결제 이벤트, 감사 항목은 개인 워크스페이스 경계 안에 유지됩니다.

백그라운드 작업은 어떻게 작동하나요?

Trigger.dev가 명시적인 작업 런타임입니다. JobRunner 계약은 enqueue, status, cancel만 약속하며 — 워크플로 의미는 Trigger.dev 고유이고 명시적입니다.

이메일과 아웃리치는 어떻게 다른가요?

트랜잭션 이메일은 작업 완료 알림 같은 제품 워크플로를 커버합니다. 콜드 아웃리치와 캠페인은 제품 자체에 속하며 이 키트의 이메일 모듈 밖입니다.

모바일 구매는 어떻게 작동하나요?

모바일은 RevenueCat 네이티브 구매와 복원을 지원하며 서버에서 접근 권한을 검증합니다. 출시 전에 스토어 계정을 설정하고 기기 테스트를 완료하세요. 웹 결제는 별도로 관리합니다.

AI 프로바이더 키는 어디에 있나요?

BYOK 자격 증명은 암호화되어 서버 측에 유지됩니다. 키는 로그에서 삭제되며, 사용량과 예산은 워크스페이스 수준에서 확인할 수 있습니다.

체크아웃에서 어떤 결제 수단을 지원하나요?

Stripe 호스팅 체크아웃은 카드를 받으며, Stripe 계정에서 지갑을 활성화하면 Alipay와 WeChat Pay도 제공할 수 있습니다 — 중국 구매자에게 유용합니다. 지갑 승인은 비동기로 확정되므로 결제가 완료되는 즉시 라이선스 페이지가 갱신됩니다.

환불을 받을 수 있나요?

저장소 접근 권한을 얻은 후에는 supastack이 영구적으로 귀하의 소유가 되므로 환불이 불가능합니다. 하지만 안심하세요. 평생 업데이트가 포함된 전체 소스 코드를 받아 자신이나 고객을 위한 제품을 무제한으로 구축하고 출시할 수 있습니다. 단, 코드를 재판매하거나 저장소를 스타터 키트 또는 템플릿으로 재배포할 수는 없습니다.

KO
테마