pitchfast/backlog/tasks/task-14 - Send-approved-outreach-through-Stalwart-SMTP.md

id, title, status, assignee, created_date, labels, dependencies, references, priority, ordinal

id	title	status	assignee	created_date	labels	dependencies	references	priority	ordinal
TASK-14	Send approved outreach through Stalwart SMTP	To Do		2026-06-03 19:14	mvp email smtp	TASK-13	PRD.md	high	14000

Description

Implement approved email sending through the self-hosted Stalwart mail server using SMTP/SMTPS and Nodemailer. The system must never send automatically before manual approval and must log recipient, subject, audit link, status, and errors in Convex.

Acceptance Criteria

• #1 Nodemailer is configured for Stalwart SMTP/SMTPS using environment or Convex secrets
• #2 E-Mail freigeben und senden sends only the currently approved/editable email draft to the visible recipient
• #3 A final send action shows recipient, subject, sender, and audit link before sending
• #4 Convex records sent timestamp, recipient, subject, audit link, SMTP result, and any error details
• #5 SMTP failures keep the lead in a retryable review state and do not mark the lead as contacted

Implementation Plan

1. Add SMTP transport configuration from secrets.
2. Add server-side send function that accepts only approved outreach IDs.
3. Add final confirmation UI with recipient, subject, sender, and audit link.
4. Store SMTP success/error outcomes and update lead/outreach status.
5. Test success and failure paths with safe non-production recipients before real use.