Configura l'email

Installazione e configurazione

Prima di qualsiasi passaggio, leggere Prima di iniziare e Nozioni di base sui terminali. Queste istruzioni presuppongono che tu abbia aperto l'intero supastack monorepo in VS Code; la sua radice package.json contrassegna la radice del repository. Nei comandi pnpm, un pacchetto dell'area di lavoro è un'app o una cartella di codice condiviso; nel prodotto, uno spazio di lavoro è il contenitore dei dati di un team e il limite di sicurezza. corepack pnpm --filter ... seleziona un pacchetto dal monorepo mentre i comandi vengono eseguiti dalla sua radice. Se hai aperto solo una cartella mobile o desktop sincronizzata, non contiene il backend Web, la configurazione di Docker o gli script root: esegui il backend da questo monorepo o da un server ospitato raggiungibile e utilizza gli script della cartella della piattaforma. Una variabile di ambiente è un'impostazione denominata memorizzata in un file .env locale o nel dashboard dell'hosting; riavvia l'app pertinente dopo averla modificata e mantieni i segreti del server fuori dai valori NEXT_PUBLIC_ e EXPO_PUBLIC_.

1. Aprire apps/web/.env.local e impostare EMAIL_PROVIDER=local per lo sviluppo; EMAIL_FROM è l'etichetta del mittente utilizzata dai modelli.

2. Avviare l'app Web dalla root del repository con corepack pnpm --filter @supastack/web dev e attivare un flusso di accesso o invito con un indirizzo di prova. Previsto: l'app registra un esito email locale senza contattare un fornitore reale. Connetti Resend, SES o un altro servizio solo dopo che il dominio del mittente è stato verificato e i destinatari del test sono stati limitati.

EMAIL_PROVIDER=local mantiene la consegna deterministica locale. Per la consegna di produzione configurata, rivedere l'adattatore Resend o SES e fornire le credenziali del server. EMAIL_FROM deve corrispondere all'identità verificata con il provider selezionato.

• Configurare Amazon SES con SDK AWS o IAM SMTP

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

Comandi da copiare

Segui i commenti per vedere in quale cartella viene eseguito un comando. Se due terminali sono etichettati, apri due finestre di terminale e mantieni il primo comando in esecuzione mentre usi il secondo.

corepack pnpm --filter @supastack/web dev

Flusso di implementazione

I messaggi di auth e completamento usano la frontiera dell'email transazionale. I flussi di outreach appartengono al prodotto consumatore e restano separati. Non riutilizzare mai questo percorso come sottosistema di messaggistica di massa non revisionato.

Registra la consegna separatamente dalla generazione. Un risultato del modello può essere disponibile mentre il suo messaggio di completamento fallisce. Il ripristino dovrebbe ispezionare lo stato di consegna invece di rigenerare lo stesso risultato.

Verifica e risoluzione dei problemi

Se non viene visualizzata alcuna e-mail locale, verificare che EMAIL_PROVIDER sia impostato in apps/web/.env.local e riavviare Web. Se un fornitore reale rifiuta un messaggio, conferma che EMAIL_FROM corrisponde a un mittente verificato e controlla il record di consegna del fornitore. Una risposta AI generata può avere successo anche quando la sua email di follow-up fallisce; controllare la consegna prima di utilizzare nuovamente lo AI task.

Verifica restrizioni dei destinatari, identità del mittente ed errori del provider in un ambiente di test dedicato. Un risultato dell'adattatore locale non è evidenza di consegna email reale. Il percorso di smoke opt-in restringe i destinatari tramite REAL_SMOKE_EMAIL_ALLOWED_DOMAIN.