Pular para o conteúdo
supastack
Explorar a documentação

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 /pt/docs/modules/email.md (or send Accept: text/markdown).

Email transacional

Entrega para auth e fluxos de produto.

Leia sua primeira mensagem local e ative a entrega

E-mail transacional significa uma mensagem acionada por uma ação do aplicativo, como um código de login ou resultado de uma tarefa. Com o servidor Web em execução, mantenha EMAIL_PROVIDER=local em apps/web/.env.local. Conclua a configuração do banco de dados, solicite um código de login em /auth, abra /mail-preview e inspecione a mensagem mais recente. Uma mensagem local que aparece aqui não é um e-mail entregue em sua caixa de entrada externa.

Para enviar mensagens reais, escolha um provedor de e-mail, crie sua conta, verifique um domínio que você controla e siga seu guia dedicado. Coloque a chave API nomeada e o endereço do remetente em apps/web/.env.local, salve e reinicie o servidor Web. Solicite um novo código de login e verifique o registro de entrega do provedor e a caixa de entrada de destino, incluindo spam. A verificação do domínio e a aprovação do remetente podem levar algum tempo.

Se a mensagem falhar, inspecione o erro de entrega e a verificação do remetente antes de solicitar repetidamente. A rota /mail-preview é somente de desenvolvimento e retorna 404 em produção. Mantenha o alcance de marketing separado desse remetente transacional para que uma campanha de boletim informativo não interrompa o e-mail de verificação de conta.

Mantém a entrega transacional separada

O módulo de email trata mensagens transacionais de produto, incluindo auth e avisos de conclusão de tarefas. A divulgação pertence ao próprio fluxo do produto consumidor e deve permanecer separada deste caminho transacional.

Configura o adaptador de entrega

Usa o adaptador local para testes deterministas. Configura o adaptador de produção escolhido e as suas credenciais de servidor antes de ativar a entrega externa. Nunca coloques segredos do fornecedor de email na configuração de cliente ou em logs.

Regista a entrega independentemente

Um resultado gerado e o seu email de conclusão têm resultados separados. Inspeciona os registos de entrega antes de afirmar que uma mensagem foi enviada. Testa uma entrega falhada sem a tratar como uma geração falhada nem submeter trabalho de modelo duplicado.

Perguntas frequentes

14 perguntas

O que é o supastack?

O supastack é uma base modular para construir produtos SaaS com IA. Reúne a infraestrutura comum para que possas concentrar-te nas funcionalidades próprias do teu produto.

Suporta web e mobile?

Sim. O supastack inclui apps Next.js e Expo como pontos de partida para experiências web e mobile.

Que autenticação está incluída?

O Better Auth cobre email/palavra-passe, OTP e login social. Os workspaces pessoais são aprovisionados com a conta para que os registos fiquem delimitados desde o primeiro dia.

Como é suportada a IA?

O supastack inclui IA multi-fornecedor configurável, registo de utilização, orçamentos e suporte encriptado de chaves próprias (BYOK).

Como são geridas as subscrições?

Para produtos construídos sobre o kit, a faturação Stripe, as subscrições e as permissões formam a base do acesso pago. Os segredos de fornecedor ficam no servidor.

Onde vive o código próprio do meu produto?

As funcionalidades próprias do produto ficam num codebase separado, enquanto o produto configura e integra os módulos base do supastack.

Como funciona o preço do supastack?

O kit é uma compra única com atualizações vitalícias: Uma framework por 249 $ (preço de lançamento temporário — 100 $ de desconto sobre o preço normal de 349 $) ou Todas as frameworks (Next.js, iOS, Android) por 499 $ (preço de lançamento temporário — 100 $ de desconto sobre o preço normal de 599 $), mais 75 $ por lugar de programador adicional. Sem subscrição do kit. O checkout neste site entrega a tua chave de licença por email, com acesso ao repo por convite GitHub.

Como é que os workspaces delimitam os meus dados?

Os registos do utilizador são delimitados por workspaceId. Identidade, permissões, utilização de IA, eventos de faturação e entradas de auditoria ficam dentro do limite do workspace pessoal.

Como funcionam os jobs em segundo plano?

O Trigger.dev é o runtime de jobs explícito. O contrato JobRunner só promete enqueue, status e cancel — a semântica de workflow permanece específica e explícita do Trigger.dev.

Como difere o email da divulgação?

O email transacional cobre fluxos de produto como avisos de conclusão de tarefas. A divulgação fria e as campanhas pertencem ao próprio produto, fora do módulo de email deste kit.

Como funcionam as compras no aplicativo móvel?

O aplicativo móvel inclui compras nativas e restauração via RevenueCat, com acesso verificado pelo servidor. Configure as contas das lojas e conclua os testes em dispositivos antes de publicar. A cobrança web permanece separada.

Onde residem as chaves dos fornecedores de IA?

As credenciais BYOK são encriptadas e ficam no servidor. As chaves são higienizadas nos logs; a utilização e os orçamentos ficam visíveis ao nível do workspace.

Quais métodos de pagamento o checkout aceita?

O checkout hospedado na Stripe aceita cartões e também pode oferecer Alipay e WeChat Pay quando essas carteiras estiverem ativadas na conta Stripe — útil para compradores na China. As autorizações de carteira são confirmadas de forma assíncrona, então a página da licença é atualizada assim que o pagamento é liquidado.

Posso solicitar um reembolso?

Depois de obter acesso ao repositório, o supastack é seu para sempre, portanto não pode ser reembolsado. Mas fique tranquilo: você recebe o código-fonte completo com atualizações vitalícias para criar e lançar produtos ilimitados para você ou seus clientes. Você apenas não pode revender o código nem redistribuir o repositório como starter kit ou modelo.

PT
Tema