Repository navigation
v2.0.0
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严格模式
- 完整的类型定义
- 错误处理完善
- 代码注释清晰