V0.4 生态能力
本文档用于收口 V0.4 阶段。V0.4 的目标是把支付、Web3、开放平台、外部身份和观测能力整理成可持续演进的生态层，让框架既能支撑常规企业应用，也能支撑开放接口、链上能力、第三方登录和生产运维。
版本号：0.4.0
发布状态：已发布。
GitHub Release：https://github.com/spring-open/spring-open/releases/tag/v0.4.0
发布目标
V0.4 应满足：
- Payment 能提供稳定 facade、服务商 driver、订单/流水/回调日志和后台运维闭环。
- Web3 能提供常规只读能力、钱包签名、链上交易查询、Token 查询、价格查询、批量转账、资金归集和链上支付结算边界。
- Open Platform 能提供版本化开放 API、应用密钥、签名、防重放、scope、限流和调用日志。
- IAM 外部身份能覆盖 GitHub、Google、Telegram、OIDC 和国内常见第三方登录 Provider 的第一阶段接入。
- Observability 至少明确当前 Logging、TraceId、Actuator、Micrometer 和后续指标链路边界。
- 文档能说明生态能力怎么接入、怎么配置、怎么运维，以及哪些能力默认关闭或需要外部凭证。
当前状态
截至 2026-05-24，V0.4 已具备生态能力第一阶段，并已完成发布前验证。
| 能力 | 状态 | 说明 |
|---|---|---|
| Payment | 基本完成 | 已有独立 starter、mock/log driver、微信、支付宝、京东、QQ 钱包、银联、PayPal、YunGouOS、Web3 payment、订单/流水/回调日志、补偿和对账 |
| Web3 | 基本完成 | 已有 EVM 钱包验签、EIP-712、RPC 故障切换、余额、交易、回执、确认数、事件日志、Token/NFT、DEX 只读、价格、批量转账、资金归集和支付结算审计 |
| Open Platform | 第一阶段完成 | 已有应用、密钥、scope、签名、防重放、限流、调用日志和 Web3 v1 开放 API |
| OAuth / IAM 外部身份 | 第一阶段完成 | 已接入 GitHub、Google、Telegram、OIDC 和 JustAuth 常见 Provider 边界 |
| Observability | 第一阶段完成 | 已新增 Observability starter，基于 Actuator 提供 health、info、metrics 和框架 info/health 扩展；外部观测平台继续后置 |
V0.4 必须包含
| 能力 | 模块 | 验收标准 |
|---|---|---|
| Payment | spring-open-starter-payment、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit | 常见支付 provider、订单/流水/回调日志、补偿、对账和文档可用 |
| Web3 | spring-open-starter-web3、spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit | 常规只读 API、签名校验、Token/NFT、价格、批量转账、资金归集、事件扫描和文档可用 |
| Open Platform | spring-open-module-open-platform | 应用密钥、签名、防重放、scope、限流、调用日志和 Web3 v1 开放 API 可用 |
| OAuth / IAM | spring-open-core-iam、spring-open-core-config、spring-open-core-notification、spring-open-core-audit | 外部身份 Provider 元数据、授权跳转、回调登录、账号绑定边界和文档可用 |
| Observability | spring-open-starter-logging、spring-open-starter-observability、spring-open-application | 当前日志、TraceId、Actuator 健康检查、应用信息、基础指标和后续观测边界清晰，必要配置和文档可查 |
| Docs | docs/ | Payment、Web3、Open Platform、IAM、Logging / Observability 相关文档可读、可查、可复制 |
V0.4 不阻塞项
以下能力可以继续推进，但不作为 V0.4 发布阻塞项：
- Stripe 独立可选支付扩展包。
- 企业级 SSO Server、Passkey、完整 OAuth2 Authorization Server。
- Web3 DEX Swap、创建池子、加池子、减池子、Safe 多签深度集成。
- Open Platform 付费计费、套餐、账单、开发者门户和 SDK 发布。
- 完整 OpenTelemetry、分布式链路追踪、日志聚合平台和 Prometheus / Grafana 模板。
发布前检查清单
- [x] 工作区没有无关改动。
- [x]
spring-open-application测试通过。 - [x] Payment / Web3 / Open Platform / OAuth / Logging / Observability 相关定向测试通过。
- [x] 文档站点构建通过。
- [x]
git diff --check通过。 - [x]
docs/zh-CN/payment.md、web3.md、open-platform.md、iam.md、logging.md、observability.md与当前代码一致。 - [x]
.ai/progress.md、.ai/todo.md和.ai/plan.md已记录最新状态。
V0.4 之后
V0.4 发布后，建议继续推进：
- V0.5：AI Native 能力，重点是知识库、RAG、AI 任务、开放平台计费和 Agent 友好接口。
- V0.6：运维与部署增强，重点是观测、安装向导、配置安全、生产部署样板和升级策略。
- V1.0：稳定 API、兼容基线、Maven 发布、完整文档、完整样板和变更日志。