管理邮件模板与发信人
适用对象：具有邮件模板编辑权限的人员；系统邮件设置与发信账号由超级管理员维护。
开始前准备
模板编辑需要邮件模板权限，默认发信和身份设置仅限超级管理员。先选对业务，再核对字段和变量；不要以自定义模板替代系统事件。
按步骤操作
图中使用虚构演示资料；正式操作请替换为真实业务信息。带标号的图片用红色数字标出当前步骤关注的位置，点击图片可查看原尺寸大图。
1. 先定位正确业务模板
邮件模板按业务分组及子类型组织，找到订单、注册或其他对应事件，核对启用状态。不要把人工定向通知模板拿来替代订单补发。
图中标记：1 业务模板列表。
2. 分别维护中英文和变量
打开编辑，核对名称、说明、主题、正文与受控变量。变量从页面目录选择，发信身份按模板要求配置；保存后从业务实际投递记录确认。
3. 核对系统邮件设置
超级管理员配置默认发信及受控账号。这里管理发信邮箱、显示名及回复地址，不编辑SMTP主机或密码；系统默认设置与模板绑定分开核对。
从配置保存核对到真实业务通知
先保存并重新打开默认发信设置或受控身份，再保存对应模板的绑定、启用、中英文主题及正文；需要调整分类时先维护分组与子类型，再把模板分配到对应位置。停用或删除分类前处理已有模板关联，不把分组移动当成改变发送规则。设置校验失败时先处理错误，刷新核对原值，不能认为表单选择已经生效。
| 要核对的通知 | 从哪里触发并查询结果 |
|---|---|
| 注册验证、重发、邮箱变更、欢迎及账号初始密码 | 由实际账号操作触发，核对相应收件人和语言；没有前台自助入口的密码重置不据模板存在补造页面 |
| 订单提交、状态、资料修正、交寄 | 分别从订单处理、资料修正、运单检查同一订单；附件由该业务生成或带入 |
| 寄存提交和寄存状态 | 核对同一寄存人、质粒或批次及对应单笔／批量模板 |
| 心愿单、邮箱分享、月报 | 从原业务查询同一收件人的授权／批次／月报投递记录，按各自规则补发 |
| 联系咨询与人工通知 | 咨询发给平台接收方；人工通知在用户列表逐收件人核对 |
改变全局模板通常用于之后的实际业务消费，已冻结的通知正文、语言、收件人或发信身份按各自业务快照保留。缺变量、禁用模板、身份不可用先修配置；SMTP接受、送达、已读分开，未知结果不自动重发。不用发送一封人工测试信替代所有业务通知的核对。
字段与状态说明
| 字段／信息 | 是否填写或选择 | 含义与规则 | 示例／核对方法 |
|---|---|---|---|
| 模板标识 | 新建必填、已有只读 | 唯一，只含字母数字、下划线或短横线，最长255字符；用于匹配模板 | 不要修改系统模板用途 |
| 发送方式 | 模板类型信息 | 业务事件通知或人工用户通知，分组调整不改变触发业务 | 见下方模板清单 |
| 业务分组／子类型 | 编辑选择 | 先选分组，再选该分组子类型 | 新建子类型后再分配模板 |
| 中英文模板名称／说明 | 描述信息 | 名称最多255字符；帮助管理者识别，不是邮件主题 | 面向维护者清楚描述用途 |
| 中英文主题 | 两种语言均必填 | 每种最多255字符，支持该模板受控变量 | 不能只填一种语言 |
| 中英文正文 | 两种语言均必填 | 富文本保存为HTML；不支持直接粘贴Markdown语法 | 使用编辑器及插入变量 |
| 发信人 | 可选绑定 | 选已启用发信身份；未绑定时按系统默认规则 | 不是SMTP服务器或密码 |
| 启用状态 | 必选 | 停用后业务不会按此模板正常发信，不能靠历史成功推断当前可用 | 正式停用前确认业务影响 |
| 变量 | 受控目录 | 只用本模板列出的变量，人工模板仅限四个变量 | 见下方变量目录 |
| 分组／子类型名称与排序 | 分类维护 | 中英文名称必填且≤255字符；排序整数0—9999；删除／转移先处理关联 | 是管理导航，不代表新增触发事件 |
当前模板编辑器没有通用的“默认附件上传”字段。 通知附件由具体业务（如发货确认、资料修正快照等）按规则带入；不要在模板页寻找不存在的附件管理。系统邮件设置当前维护默认发件地址、显示名称、回复地址及发信身份，SMTP主机、端口和密码由部署配置负责，不是这里的可编辑字段。
分组和发送方式怎样区分
初始分类包含账户与认证、站点通知、订单、质粒寄存、心愿单、自定义；子类型包含验证、欢迎、密码、通知、提交、状态及自定义。平台可调整分类名称和归属，查找时也可对照模板标识。
“业务事件通知”由对应业务提供对象、变量和发送时机；“人工用户通知”由管理员在用户列表选择收件人后发送。移动分组或新建一个相似名称的模板，不会自动增加一个业务触发点。
当前系统模板清单（20种用途）
下表覆盖当前代码提供的标准用途，模板标识与后台“模板标识”对应。平台可新增人工模板或调整分类，因此实际名称、分组和可用变量仍应以该条当前模板为准；分类名称不是触发规则。旧兼容模板不作为新增业务默认选择。
表格较宽，可在表格内左右滚动查看完整标识和变量；不要截取变量名的一部分来使用。
| 模板标识 | 用途 | 触发入口 | 可用变量 |
|---|---|---|---|
email_verification_on_register | 注册后验证邮箱 | 用户注册 | name、verification_url |
email_verification_on_resend | 重新发送验证邮件 | 用户请求重发验证 | name、verification_url |
email_verification_on_email_change | 修改邮箱后的验证 | 用户变更邮箱 | name、verification_url |
user_registered | 邮箱验证成功欢迎信 | 用户完成验证 | name、profile_url |
new_user_password | 后台创建账号初始密码 | 后台创建用户／成员 | app_name、generated_password、login_url |
password_reset | 密码重置 | 用户请求重置 | name、reset_url |
contact_received | 联系表单通知 | 前台联系表单提交，发给站点接收方 | name、email、message、app_name |
order_requested | 订单提交成功 | 申请提交成功 | name、order_number、order_url |
order_status_changed_single | 单个订单状态变更 | 单笔状态业务 | name、status、orders_list、pi_name、pi_email、recipient_scientist_name、tracking_number、tracking_section |
order_status_changed_batch | 批量订单状态变更 | 批量状态业务 | name、status、orders_list |
order_info_correction_required | 订单待资料修正 | 保存本轮资料修正 | name、status、orders_list、info_correction_reason |
order_shipment | 订单交寄通知 | 确认交寄后的通知任务 | name、order_number、plasmid_list、tracking_number、mta_section |
deposition_submitted_single | 单个寄存提交 | 单个寄存成功 | name、batch_id、deposits_url |
deposition_submitted_batch | 批量寄存提交 | 批量寄存成功 | name、batch_id、deposits_url |
deposition_status_changed_single | 单个寄存状态变更 | 单笔寄存状态业务 | name、status、depositions_list |
deposition_status_changed_batch | 批量寄存状态变更 | 批量寄存状态业务 | name、status、depositions_list |
plasmid_wishlist_ready | 心愿单开放通知 | 管理员创建通知批次 | name、plasmids_list、wishlists_url、status |
plasmid_email_shared | 指定邮箱分享通知 | 保存邮箱授权并通知 | sharing_name、plasmid_name、plasmid_code、share_url、received_url |
lab_plasmid_monthly_report | PI月报 | 按月生成／投递的月报业务 | name、lab_name、month、request_count、order_count、plasmid_count、dispatch_count、dispatch_plasmid_count、plasmids_list、sources_list、coverage_note、dashboard_url、settings_url、generated_at |
manual_user_notification | 人工用户通知 | 用户列表选择后主动发送 | name、email、notice_title、notice_content |
登录OTP验证码邮件使用认证服务的固定通知内容，不属于这20种可编辑模板；不要寻找可编辑的“login_otp模板”或把验证码变量加进普通模板。
变量怎么填
插入变量后会得到如 {{ name }} 的占位符；它不是要手工替换成某个人的姓名。业务事件在运行时提供相应值。先在可用变量菜单选择，再核对实际业务预览。
| 变量／变量组 | 含义与限制 |
|---|---|
| name／email | 当前收件人姓名及邮箱，由业务或定向发送逐人提供 |
| notice_title／notice_content | 人工通知标题和内容；用户列表发送时手工输入，只允许这两项人工业务文本及name、email |
| verification_url／reset_url／login_url／profile_url | 验证、重置、登录、资料链接；只能在相应模板使用，不能复制真实验证令牌作示例 |
| order_number／order_url／orders_list | 订单编号、链接、受控渲染的订单清单 |
| pi_name／pi_email／recipient_scientist_name | 单笔订单关联的PI及实际收件科学家，不等同登录管理员 |
| status／info_correction_reason | 相应业务状态及单订单修正原因；多单原因以清单逐项核对 |
| tracking_number／tracking_section | 运单号及有运单时的可显示段落；没有时不要补造单号 |
| plasmid_list／plasmids_list／depositions_list | 三种不同名字：交寄材料、心愿单／月报材料汇总、寄存记录；不可因近似就互换 |
| batch_id／deposits_url／wishlists_url | 寄存批次及对应入口、心愿单入口 |
| sharing_name／plasmid_name／plasmid_code／share_url／received_url | 分享人、材料与接收入口；入口不替代邮箱访问授权 |
| lab_name／month／request_count／order_count／plasmid_count | 月报实验室、月份、申请次数、订单数和质粒种数 |
| dispatch_count／dispatch_plasmid_count／sources_list／coverage_note | 月报交寄统计、来源摘要及历史日期覆盖提示 |
| dashboard_url／settings_url／generated_at | 月报明细链接、本人偏好链接、快照生成时间 |
| app_name／generated_password／message／mta_section | 网站名称、初始密码、联系表单内容、业务MTA提示；仅各自模板使用 |
列表型变量可能是业务已生成的富文本片段，不自行填入脚本或其他HTML。人工模板只允许name、email、notice_title、notice_content；不能将订单变量放进人工模板后期望平台自动查找订单。代码或模板已升级的场景，先以当前变量菜单及实际预览核对。
系统默认与受控发信身份
| 字段 | 是否必填 | 用途 |
|---|---|---|
| 默认发件邮箱／默认发件名称 | 必填 | 邮箱格式有效、每项最长255字符，决定发件身份 |
| 回复地址 | 可选 | 有效邮箱，填写后用户回复进入此地址 |
| 发信身份名称 | 新增必填 | 维护者识别用标签，不是SMTP用户名 |
| 发信身份邮箱／显示名称 | 新增必填 | 真实被SMTP服务允许的发件身份 |
| 身份回复地址／启用状态／默认身份 | 按需 | 模板只能绑定启用身份，默认身份与模板绑定分别核对 |
更换Office 365发件地址前，须由邮件维护者核实SMTP账号拥有相应Send As权限；填写一个任意邮箱不会自动取得代发资格。SMTP连接参数由部署维护，不能把这页误写成SMTP凭据管理。
完成后检查
分类、发信身份及中英文内容保存正确；预览变量无缺项，再从真实业务查看实际通知与结果。
常见问题与处理
模板页为什么找不到SMTP密码或附件上传？
当前页管理模板内容和受控发信身份，没有通用默认附件上传；SMTP连接参数由部署维护。业务附件在对应通知规则中提供。
改了模板，补发为什么还是旧正文？
部分业务冻结本轮正文和附件，补发复用原快照；从对应业务核查，不用人工通知模板冒充补发。
正文、变量或发件地址导致失败怎么办？
中英文主题正文都要填，正文用富文本HTML而非Markdown。变量只能来自本模板目录；更换Office 365发件地址须具备Send As权限。