Skip to content

邮件账号与模版 ​

SYS-MAIL-01 | 模块 system | 配置发信邮箱与邮件模版,让系统能发出正式通知与验证码。

1. 使用角色与场景 ​

角色:管理员

  • 配置企业邮箱 SMTP 并测试发信
  • 维护「密码重置」邮件模版

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/mail-account/createsystem:mail-account:create创建邮箱账号MailAccountController#L33
PUT/system/mail-account/updatesystem:mail-account:update修改邮箱账号MailAccountController#L40
DELETE/system/mail-account/deletesystem:mail-account:delete删除邮箱账号MailAccountController#L48
DELETE/system/mail-account/delete-listsystem:mail-account:delete批量删除邮箱账号MailAccountController#L57
GET/system/mail-account/getsystem:mail-account:query获得邮箱账号MailAccountController#L66
GET/system/mail-account/pagesystem:mail-account:query获得邮箱账号分页MailAccountController#L75
GET/system/mail-account/list-all-simple—获得邮箱账号精简列表MailAccountController#L83
GET/system/mail-account/simple-list—获得邮箱账号精简列表MailAccountController#L83
POST/system/mail-template/createsystem:mail-template:create创建邮件模版MailTemplateController#L34
PUT/system/mail-template/updatesystem:mail-template:update修改邮件模版MailTemplateController#L41
DELETE/system/mail-template/deletesystem:mail-template:delete删除邮件模版MailTemplateController#L49
DELETE/system/mail-template/delete-listsystem:mail-template:delete批量删除邮件模版MailTemplateController#L58
GET/system/mail-template/getsystem:mail-template:query获得邮件模版MailTemplateController#L67
GET/system/mail-template/pagesystem:mail-template:query获得邮件模版分页MailTemplateController#L76
GET/system/mail-template/list-all-simple—获得邮件模版精简列表MailTemplateController#L84
GET/system/mail-template/simple-list—获得邮件模版精简列表MailTemplateController#L84
POST/system/mail-template/send-mailsystem:mail-template:send-mail发送短信MailTemplateController#L92

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/mail/MailAccountController.java#L33
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/mail/MailTemplateController.java#L34
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/mail/MailAccountDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/mail/MailTemplateDO.java

4. 数据表 ​

表DO
system_mail_accountMailAccountDO
system_mail_templateMailTemplateDO

5. 机制与配置 ​

  • 账号区分 SMTP/SSL 配置;发送时按模版编码渲染
  • 邮件发送记录摘要落库便于排查

6. 常见问题与排查 ​

  • SMTP 端口与 SSL 组合错误是最常见发信失败原因

7. 关联 ​