V0.3 业务基础设施

本文档用于收口 V0.3 阶段。V0.3 的目标是把邮件、短信、通知、WebSocket 和限流整理成可直接服务业务系统的基础设施，让常见业务消息、验证码、实时推送、防刷和通知运维具备稳定闭环。

版本号：0.3.0

发布状态：已发布。

GitHub Release：https://github.com/spring-open/spring-open/releases/tag/v0.3.0

发布目标

V0.3 应满足：

• Mail、SMS、Notification、WebSocket、Rate Limit 能作为稳定基础能力使用。
• 邮件、短信、站内信、Webhook、WebSocket 实时推送和失败重试边界清晰。
• 登录、短信验证码、开放平台和普通接口限流能复用同一 Rate Limit 底座。
• WebSocket 支持用户、游客、设备、分组、房间和多实例消息分发。
• 文档能说明每个业务基础设施模块怎么配置、怎么使用、怎么运维。
• 已完成能力保持默认可用，外部服务商凭证类能力默认不发起真实外部调用。

当前状态

截至 2026-05-24，V0.3 已具备较多基础能力：

能力	状态	说明
Mail	基本完成	已支持 log、memory、smtp mailer，支持本地配置和数据库配置覆盖，文档包含 QQ、Gmail、网易邮箱示例
SMS	基本完成	已支持 log、memory、短信宝和基于 sms4j 的常见短信服务商 driver，验证码发送建议走 Notification 运维闭环
Notification	基本完成	已支持 log、memory、database、websocket、mail、sms、webhook 通道，具备发送日志、失败重试、站内信、附件和阅读回执
WebSocket	基本完成	已支持单实例、多实例、用户/游客、设备、分组、房间、排除当前连接发送和聊天室样板
Rate Limit	基本完成	已支持 memory、redis store，登录、短信验证码、开放平台和声明式普通接口限流

V0.3 必须包含

能力	模块	验收标准
Mail	spring-open-starter-mail	本地开发默认 log，可切换 SMTP，文档包含常见邮箱配置和数据库配置说明
SMS	spring-open-starter-sms	常见短信服务商 driver 可配置，验证码链路可复用 Notification 发送日志和失败重试
Notification	spring-open-starter-notification、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit	站内信、发送日志、失败重试、模板渲染、Webhook provider 和后台发送入口可用
WebSocket	spring-open-starter-websocket、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit	用户、游客、设备、分组、房间、多实例分发和正式聊天体验可用
Rate Limit	spring-open-starter-rate-limit、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit、spring-open-module-open-platform	登录、短信验证码、开放平台和声明式接口限流可用
Docs	docs/	Mail、SMS、Notification、WebSocket、Rate Limit 相关文档可读、可查、可复制

V0.3 不阻塞项

以下能力可以继续推进，但不作为 V0.3 发布阻塞项：

• Mail 专业服务商 SDK，例如 SendGrid、Mailgun、AWS SES、阿里云邮件推送。
• SMS 更多厂商特殊能力，例如上行短信、状态回执、国际短信复杂模板。
• Notification 复杂用户订阅偏好、通知聚合、免打扰策略和多语言模板后台高级编辑。
• WebSocket 完整业务 IM 协议、消息持久化、离线消息和端到端加密。
• Rate Limit 滑动窗口、令牌桶、网关级统一限流和风控画像联动。

发布前检查清单

• [x] 工作区没有无关改动。
• [x] spring-open-application 测试通过。
• [x] Mail / SMS / Notification / WebSocket / Rate Limit 相关定向测试通过。
• [x] 文档站点构建通过。
• [x] git diff --check 通过。
• [x] docs/zh-CN/mail.md、sms.md、notification.md、websocket.md、rate-limit.md 与当前代码一致。
• [x] .ai/progress.md、.ai/todo.md 和 .ai/plan.md 已记录最新状态。

V0.3 之后

V0.3 发布后，建议继续推进：

1. V0.4：生态能力，重点是 Payment、Web3、Open Platform、OAuth、Observability。
2. V0.5：AI Native 能力，重点是知识库、RAG、AI 任务、开放平台计费和 Agent 友好接口。
3. V1.0：稳定 API、兼容基线、Maven 发布、完整文档、完整样板和变更日志。