V0.1 基础版

本文档用于收口 V0.1 阶段。V0.1 的目标不是把所有生态能力一次性做完，而是交付一套可以稳定启动、可以二次开发、可以继续扩展的框架基础版。

版本号：0.1.0

发布目标

V0.1 应满足：

• 开发者可以快速启动应用。
• 基础 Web API、统一响应、异常处理、Validation、TraceId 可用。
• 数据库、Redis、缓存、配置、多语言、鉴权、核心后台基础能力可用。
• 文档能说明项目怎么启动、怎么配置、怎么测试、怎么扩展。
• 后续模块可以在不破坏基础架构的前提下继续演进。

当前验收状态

截至 2026-05-24，V0.1 基础版已通过当前本地发布验收：

检查项	状态	说明
应用聚合测试	通过	./mvnw -pl spring-open-application -am test -DskipITs -DskipFrontend
文档站点构建	通过	./mvnw -pl spring-open-views/spring-open-view-docs package -DskipTests -DskipITs -Dbuild.skip.views=false
空白格式检查	通过	git diff --check
文档入口	通过	README、中文首页、版本发布页、VitePress 侧边栏已同步

结论：V0.1 基础版已发布，后续开发重心转入 V0.2 / V0.3。

GitHub Release：SpringOpen v0.1.0

V0.1 必须包含

能力	模块	验收标准
Core	spring-open-starter-common	统一返回、异常、分页、TraceId 可用
Toolkit	spring-open-starter-toolkit	纯 Java 基础工具可用
Web	spring-open-starter-webmvc	Result<T> JSON 响应体、统一异常、Validation、多语言错误可用
Config	spring-open-starter-config	本地配置、数据库配置、缓存和兜底读取链路可用
Data	spring-open-starter-database	MyBatis-Plus、分页、乐观锁、审计字段、逻辑删除可用
Redis	spring-open-starter-data-redis	RedisManager、RedissonManager、TTL、基础锁、Topic 可用
Cache	spring-open-starter-cache	Redis、memory、file store 可用，lite 模式不依赖 Redis
I18n	spring-open-starter-i18n	资源文件、数据库文案、Validation 和业务消息 key 可用
Auth	spring-open-starter-auth	Sa-Token、JWT、Redis 登录态、多端会话基础能力可用
Core Admin	spring-open-core-iam、spring-open-core-config、spring-open-core-dict、spring-open-core-template、spring-open-core-i18n、spring-open-core-audit	用户、角色、权限、菜单、配置、字典、模板、多语言和日志等基础后台能力可用
Application	spring-open-application	能装配核心 starter 和核心运行时模块并通过测试
Docs	docs/、views/docs	文档站点能构建并导出到 public/docs

V0.1 可带但不阻塞

以下能力已经推进较多，但不作为 V0.1 发布阻塞项。它们可以随 V0.1 一起出现，也可以继续按后续阶段增强：

• Queue
• Scheduler
• Event
• Pipeline
• Mail
• SMS
• Notification
• Storage
• WebSocket
• Payment
• Web3
• Open Platform
• Samples

判断原则：这些模块只要不影响应用启动、核心测试和基础文档，就不阻塞 V0.1。

启动验收

Docker 基础环境

docker compose -f docker/docker-compose.yml up -d

默认启动 MySQL 和 Redis。PostgreSQL 作为可选 profile：

docker compose -f docker/docker-compose.yml --profile postgres up -d postgres redis

应用启动

./mvnw -pl spring-open-application spring-boot:run

默认端口：

8000

基础访问：

GET http://localhost:8000/api
GET http://localhost:8000/swagger-ui.html

Lite 模式

该历史版本保留了 lite 模式，用于不依赖外部 MySQL 和 Redis 的单进程体验；当前主线不推荐把它作为普通开发路径：

SPRING_PROFILES_ACTIVE=lite ./mvnw -pl spring-open-application spring-boot:run

lite 模式使用 H2 文件数据库、file cache、memory queue 和 memory scheduler，只适合作为历史兼容、隔离诊断或极少数单进程验证，不作为当前普通开发建议。

测试验收

V0.1 发布前至少执行：

./mvnw -pl spring-open-application -am test -DskipITs -DskipFrontend

文档构建：

./mvnw -pl spring-open-views/spring-open-view-docs package -DskipTests -DskipITs -Dbuild.skip.views=false

格式检查：

git diff --check

如果改动涉及单个 starter，应额外执行对应模块测试：

./mvnw -pl spring-open-starters/<starter-name> -am test -DskipITs -DskipFrontend

文档验收

V0.1 发布前，以下文档必须保持可读、可查、可复制：

• 快速开始
• 配置说明
• 部署
• 测试
• 架构总览
• 工程约定
• Starter 体系
• Web 规范
• 数据库
• 配置中心
• 统一身份
• 核心模块治理
• 功能模块

新增功能、配置、API、数据库表或运行方式变化时，必须同步更新对应文档。

发布前检查清单

• [x] 工作区没有无关改动。
• [x] spring-open-application 测试通过。
• [x] 文档站点构建通过。
• [x] git diff --check 通过。
• [x] README 的当前状态和文档入口没有过期。
• [x] docs/zh-CN/index.md 能引导新开发者找到快速开始、配置、测试和模块文档。
• [x] .ai/progress.md、.ai/todo.md 和 .ai/plan.md 已记录最新状态。
• [x] 已知不阻塞事项已经放入后续计划，不混在 V0.1 基础版发布边界里。

V0.1 之后

V0.1 发布后，建议继续按阶段推进：

1. V0.2：异步运行时，重点是 Queue、Scheduler、Event、Storage、Logging。
2. V0.3：业务基础设施，重点是 Mail、SMS、Notification、WebSocket、Rate Limit。
3. V0.4：生态能力，重点是 Payment、Web3、Open Platform、OAuth、Observability。
4. V1.0：稳定 API、兼容矩阵、Maven 发布、完整文档、完整样板和变更日志。