Skip to content

定时通知 ​

系统提供账单导入定时提醒,支持多渠道推送,并记录发送日志。

调度 ​

  • NotificationSchedulingConfig 开启 @EnableScheduling。
  • NotificationScheduler 每分钟检查一次(初始延迟 30 秒):对每个启用的通知配置判断「当前时间是否已到达触发点」(依据周期、提醒时间与星期/日期),到达且存在启用渠道时向所有渠道发送提醒,并更新 last_sent_at。
  • 默认提醒周期为每月 1 日 09:00。
  • 首次启用时会将 last_sent_at 置为当前,避免启用后立即补发历史提醒。

渠道 ​

NotificationChannelType 定义支持的渠道:

渠道说明
EMAIL邮箱 SMTP(如 QQ 邮箱),动态构建 JavaMailSenderImpl,默认 smtp.qq.com:465 + SSL
SERVERCHANServer 酱 Turbo,推送到个人微信,校验返回 code == 0
FEISHU飞书自定义机器人 Webhook,post 富文本(标题保留为卡片标题、正文按行分段),可选加签(timestamp + HMAC-SHA256),校验 code / StatusCode

发送器采用工厂模式:NotificationSender 接口 + NotificationSenderFactory 按类型分发,AbstractHttpNotificationSender 封装 JSON/表单 POST。

配置与日志 ​

  • t_notification_config:启用开关、周期、每月日期、每周星期、提醒时间、最近发送时间。
  • t_notification_channel:类型、名称、启用、配置 JSON(SMTP 账号、Server 酱 SendKey 或飞书 webhookUrl / secret)。邮箱密码与飞书密钥留空表示不修改,返回时脱敏,NotificationChannelVO 以 hasPassword / hasSecret 标记是否已配置。
  • t_notification_log:每次发送的结果(成功/失败、渠道类型、说明),面板展示最近 20 条。

接口 ​

NotificationController 提供:配置读写、渠道增删改查与测试、立即发送、发送日志查询。

通知内容 ​

提醒正文会提示导入新账单,并附带 AppConfig.notificationUrl 配置的链接地址(通常指向账单导入页)。

相关文档 ​

基于 Spring Boot 3 + Vue 3 的个人汇账