Direct Email Send

Roadmap project documentation for Direct Email Send — sending orders to suppliers directly from Arda instead of exporting and attaching by hand.

Outcome

Phase 1 (PDEV-970) shipped to main:

• PO cover-email composer — an editable rich-text cover note with the generated purchase-order PDF attached. To / Cc / From recipient fields with vendor-email typeahead, an editable subject, and a “Powered by Arda” signature.
• BFF send route — /api/arda/email/send-po sanitizes the cover markup and forwards it with the attachment to the email-job endpoint. Unprovisioned tenants get a restricted-mode fallback (Copy / “Open in email”).
• Structured Deliver-to / Vendor Details on the order sheet, backed by the business-affiliate and tenant data layer, with a top-level Preview and a “Send via email” split-menu footer.
• Design-system foundation — the shared direct-send building blocks (recipient fields, composer body, TokenChip, MultiSelectTypeaheadInput, AddressFieldset) delivered in @arda-cards/design-system 6.1.0.

Documents

• Purchase Order UI — the composer UI and mock.
• Shared Components Audit — inventory of the reusable direct-send pieces.

Follow-on work

Tracked separately, outside this project’s shipped scope:

• Email Order harmonization (PDEV-1019) — the Email Order flow adopts the same shared composer; documented in the Harmonization Plan (its own documentation PR).
• OrderSheet arbitrary line (PDEV-1245) — add a line not already in the order queue.
• Bounced-email handling (PDEV-1240) — store and surface send failures, notify the sender.
• TokenChip / PostalAddress DS refactor (PDEV-1252) — design-review follow-ups from the shared-component work.