主题
邮件账号与模版
SYS-MAIL-01 | 模块
system| 配置发信邮箱与邮件模版,让系统能发出正式通知与验证码。
1. 使用角色与场景
角色:管理员
- 配置企业邮箱 SMTP 并测试发信
- 维护「密码重置」邮件模版
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/mail-account/create | system:mail-account:create | 创建邮箱账号 | MailAccountController#L33 |
| PUT | /system/mail-account/update | system:mail-account:update | 修改邮箱账号 | MailAccountController#L40 |
| DELETE | /system/mail-account/delete | system:mail-account:delete | 删除邮箱账号 | MailAccountController#L48 |
| DELETE | /system/mail-account/delete-list | system:mail-account:delete | 批量删除邮箱账号 | MailAccountController#L57 |
| GET | /system/mail-account/get | system:mail-account:query | 获得邮箱账号 | MailAccountController#L66 |
| GET | /system/mail-account/page | system: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/create | system:mail-template:create | 创建邮件模版 | MailTemplateController#L34 |
| PUT | /system/mail-template/update | system:mail-template:update | 修改邮件模版 | MailTemplateController#L41 |
| DELETE | /system/mail-template/delete | system:mail-template:delete | 删除邮件模版 | MailTemplateController#L49 |
| DELETE | /system/mail-template/delete-list | system:mail-template:delete | 批量删除邮件模版 | MailTemplateController#L58 |
| GET | /system/mail-template/get | system:mail-template:query | 获得邮件模版 | MailTemplateController#L67 |
| GET | /system/mail-template/page | system: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-mail | system:mail-template:send-mail | 发送短信 | MailTemplateController#L92 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/mail/MailAccountController.java#L33 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/mail/MailTemplateController.java#L34 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/mail/MailAccountDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/mail/MailTemplateDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_mail_account | MailAccountDO |
system_mail_template | MailTemplateDO |
5. 机制与配置
- 账号区分 SMTP/SSL 配置;发送时按模版编码渲染
- 邮件发送记录摘要落库便于排查
6. 常见问题与排查
- SMTP 端口与 SSL 组合错误是最常见发信失败原因
7. 关联
- 需求原件:01-07-消息通知
- 相关卡片:SYS-MAIL-02