Skip to content

v2.0.0

Choose a tag to compare

@Zoroaaa Zoroaaa released this 04 Nov 06:33

Added - 邮件通知系统

核心功能

  • 注册邮箱验证(6位验证码)

    • 新用户注册后自动发送6位数字验证码邮件
    • 验证码有效期10分钟
    • 首个注册用户(管理员)自动验证
    • 未验证用户显示提示横幅
    • API: POST /api/auth/verify-code, POST /api/auth/resend-verification
  • 密码重置流程(6位验证码)

    • 忘记密码发送6位验证码邮件
    • 验证码有效期10分钟
    • 防邮箱枚举攻击(无论邮箱是否存在都返回200)
    • API: POST /api/auth/forgot-password, POST /api/auth/reset-password
  • 邮箱更换功能(6位验证码)

    • 更换邮箱需要验证新邮箱
    • 发送6位验证码到新邮箱
    • 验证码有效期10分钟
    • 旧邮箱收到更换成功通知
    • API: POST /api/auth/change-email, POST /api/auth/verify-code
  • 邮件偏好设置

    • 用户可自定义邮件通知偏好
    • 支持5种通知类型:@提及、分享接收、配额警告、AI完成、系统通知
    • 所有邮件发送都检查用户偏好
    • API: GET /api/auth/email-preferences, PUT /api/auth/email-preferences
  • 管理面板邮件配置

    • Resend API 配置界面
    • 发件人地址和名称设置
    • 发送测试邮件功能
    • 群发系统公告(支持按角色筛选)
    • API: GET/PUT /api/admin/email/config, POST /api/admin/email/test, POST /api/admin/email/broadcast

安全增强

  • JWT失效机制

    • 密码修改后自动更新 passwordChangedAt
    • 密码重置后自动更新 passwordChangedAt
    • 登录时检查JWT是否失效
    • 失效后自动清除会话并要求重新登录
  • 验证码安全

    • 6位随机数字验证码
    • 验证码一次性使用机制
    • 验证码10分钟有效期
    • 重发验证码限流(1分钟1次)
    • 验证码明文存储(短有效期,无需哈希)
  • 邮件模板

    • 3套精美邮件模板(注册验证/密码重置/更换邮箱)
    • 不同验证类型使用不同配色方案
    • 响应式设计,移动端友好

数据库变更

  • 新增迁移文件 0018_email.sql
    • 新增 email_tokens 表(存储6位验证码)
      • code 字段存储验证码(明文,10分钟有效期)
      • 支持3种类型:verify_email、reset_password、change_email
    • users 表新增 email_verified 字段
    • users 表新增 email_preferences 字段
    • users 表新增 password_changed_at 字段

前端页面

  • 新增/更新页面

    • VerifyEmail.tsx - 邮箱验证码输入页(6位验证码输入框)
    • ForgotPassword.tsx - 忘记密码页面(发送验证码)
    • ResetPassword.tsx - 重置密码页面(验证码+新密码)
    • EmailConfig.tsx - 管理面板邮件配置页面
  • 新增组件

    • EmailVerificationBanner.tsx - 未验证用户提示横幅
    • EmailPreferencesForm - 邮件偏好设置表单
    • EmailChangeForm - 更换邮箱表单
  • 功能集成

    • 登录页面添加"忘记密码"链接
    • 设置页面新增"邮箱设置"选项卡
    • 管理面板新增"邮件配置"选项卡
    • MainLayout 集成验证提示横幅

邮件模板

  • 5个精美邮件模板
    • 验证邮箱模板(紫色渐变主题)
    • 重置密码模板(粉红渐变主题)
    • 更换邮箱确认模板(蓝色渐变主题)
    • 密码变更通知模板
    • 系统通知模板

环境变量变更

  • PUBLIC_URL 从必填改为可选
    • 不再用于邮件验证链接
    • 仅用于文件直接访问链接生成

Changed

  • 邮件通知控制

    • 所有邮件发送都检查用户偏好设置
    • 密码修改通知映射到 system 偏好
    • 重置密码成功通知映射到 system 偏好
    • 邮箱更换成功通知映射到 system 偏好
  • 审计日志

    • 新增审计类型:admin.email_config_update
    • 新增审计类型:admin.email_test
    • 新增审计类型:admin.email_broadcast

Improved

  • 用户体验

    • 邮箱验证状态清晰展示
    • 邮件发送结果实时反馈
    • 密码强度实时指示
    • 验证链接过期友好提示
  • 安全性

    • 所有安全相关邮件不受偏好设置影响
    • 密码变更后强制重新登录
    • 防止邮箱枚举攻击

Fixed

  • 修复密码修改后未更新 passwordChangedAt 的问题
  • 修复邮件链接使用localhost的问题
  • 修复重置密码成功通知未检查邮件偏好的问题
  • 修复邮箱更换成功通知未检查邮件偏好的问题

Technical Details

  • 技术栈

    • Resend API(邮件服务)
    • Cloudflare KV(配置存储)
    • Cloudflare D1(Token存储)
    • SHA-256(Token哈希)
  • 性能优化

    • 邮件配置KV缓存
    • Token哈希索引优化
    • 邮件模板预编译
  • 代码质量

    • TypeScript严格模式
    • 完整的类型定义
    • 错误处理完善
    • 代码注释清晰