2.5 KiB
公司邮箱与邮件模板
用户已指定公司邮箱 SMTP/IMAP;模板必须先解析预览,在 Web 确认后生效。
流程
服务接入维护多个邮箱,各自配置 SMTP、IMAP、TLS、登录账号和授权密码、模板发件人白名单。密码加密,状态持久化到部署机 SQLite。检查连接只验证 SMTP/IMAP,不发送邮件。后台每分钟检查启用邮箱;手动检查同样复用去重游标。首次及 UIDVALIDITY 变化只扫描近 7 天,普通邮件保持原状,不标记已读。
主题 [模板][产品线]发信标题 导入指定产品线;[模板]发信标题 导入默认模板。只接受完整标记、直接发送而非回复/转发、单一授权发件人、投递到本邮箱的邮件。主题去除指令标记,MIME 解码得到正文和附件。HTML 消毒、阻断远程资源,CID 图片本地化;保留原始 EML。每封上限 10 MB,每轮最多 50 封,逐 UID 提交游标,失败可重试且不重复导入。
模板导入为待确认版本,展示标题、范围、正文、图片、附件、来源;管理员可以修改标题、范围和纯文本正文、确认或忽略。确认按相同邮箱和范围归档旧版,保留历史。确认使用导入时的活动版本进行冲突检查,避免多人或旧邮件覆盖新版本。正文调整将切换到纯文本并保留附件。无 AI 自动推断产品线或收件人,模板邮件里的 To/Cc 不会变成业务收件群组。
保留现有产品线群组;旧模板草稿一次性迁入待确认列表。发送接口只使用已确认版本,变量为明确的 {{产品线}}、{{订单号}}、{{日期}}、{{订单列表}},不执行表达式。提供明确点击的发送测试到本邮箱,发送前落库,不自动重试不确定结果。订单批量发送仍由后续业务规则接入。
实现
采用 Nodemailer(SMTP)、ImapFlow(IMAP)、MailParser(MIME)、sanitize-html。独立 MailStore/ MailService/ mail API,接入现有认证、同源保护、管理员配置权限和服务启动停止。密钥复用现有 DPAPI/AES-GCM vault 编解码,邮箱和原文内容独立数据库。定时器不重入;邮箱配置修改后检查/收信结果不得写入新版本配置。
验证
先写失败测试覆盖 MIME、附件、HTML、授权、去重、确认冲突、密文、重启游标、SMTP 本地实际传输、API 权限。全量回归后部署正式服务,并通过浏览器验证邮箱表单、模板列表及预览操作。真实公司邮箱连接需要用户在网页填写参数后验证。