SpringOpen
受众：开发者 摘要：中文文档首页。快速入口 / 前端视图 / 业务模块 / Starter 索引。
春晓 - 春启开源，晓见生机。
SpringOpen 是一个孵化中的 Spring Boot 增强框架，目标是在 Java 应用中提供接近 Laravel 的开发体验：底层继续保留 Spring Boot 类似 Symfony 的成熟工程能力，包括 IoC、自动配置、Web、事务、配置、Actuator 和生产级基础设施；上层则由 SpringOpen 承担 Laravel-like 应用框架角色，把模块边界、Starter 接入、Facade / Manager / Provider、register() / boot() 生命周期、配置中心、菜单权限和开发者文档约束统一起来，在保持 Spring 生态稳定性、类型安全和生产能力的基础上，提供更清晰的约定、更简洁的 Facade API、可切换的 Provider 扩展模型、Starter 优先的集成方式，以及对开发者和 AI Agent 都友好的文档体系，整体坚持“简洁易用、灵活扩展、生产稳定”的设计原则。
快速开始
| 入口 | 内容 |
|---|---|
| 快速开始 | 环境要求、启动方式和目录说明 |
| 配置说明 | .env、application.yml、运行目录和常用配置 |
| 功能模块 | 按能力查找 Starter、业务模块和生态能力 |
| 模块地图 | 四层结构、"新代码放哪儿"决策图、引擎↔控制台配对与扩展路径 |
| Laravel 对齐说明 | Laravel 常见开发体验在 SpringOpen 中的对应关系和非目标边界 |
| Provider 扩展模型 | Facade -> Manager -> Resolver -> Provider SPI |
| 版本发布 | 版本目标、能力边界和发布检查 |
| 升级指南 | 升级前检查、迁移、回滚和发布后验证 |
| 变更日志 | 各版本关键变化摘要 |
| 生产部署样板 | Docker、Compose、Nginx 和上线 smoke 的可复制部署流程 |
| API 文档 | Swagger UI、OpenAPI 元数据和鉴权说明 |
| API 兼容策略 | 路由版本、兼容变更、破坏性变更和发布检查 |
| CLI / Codegen | Devtools CLI 总入口、项目内省命令、迁移源码巡检和 CRUD 全链路预览 |
| 安全与依赖基线 | 上线安全检查、受控依赖和依赖树复核 |
| 容量规划与性能基线 | 本地性能 smoke、容量记录口径和生产压测注意事项 |
| 外部 Provider 验收清单 | 真实支付、Web3、AI、直播、广告等外部 Provider 的上线验收口径 |
| 使用声明 | 研究学习用途、合法授权边界和责任说明 |
前端视图
本地默认端口为 8000；Docker / Nginx 预览通常从外层 8080 进入。五端入口保持固定路径：
| 路径 | 端 | 说明 |
|---|---|---|
/admin/ | Admin | 后台管理端 |
/app/ | App | uni-app H5 用户端；小程序 / App 使用对应平台构建产物 |
/pc/ | PC | Nuxt PC 用户端 |
/install/ | Install | 企业安装向导；安装完成后按配置锁定或回到产品入口 |
/docs/ | Docs | VitePress 文档站 |
| 入口 | 内容 |
|---|---|
| 跨端 UI 规范 | Admin、App、PC、Install、Docs 五端面向国内用户习惯的界面规范和验收口径 |
| Admin 后台管理端 | 登录、注册、找回密码、账号设置、CMS / Blog / Forum / Mall 管理、IAM、配置中心、通知、文件、日志审计、调度、队列、Storage 和开放平台 |
| App 移动端 | 首页、搜索、社区、博客、论坛、商城、购物车、订单、支付、售后、消息、聊天、通知、个人中心、Web3 钱包和设置 |
| PC 电脑端 | 门户首页、账号登录注册、帮助与反馈、用户中心、CMS、Blog、Forum、Mall、购物车、结算、订单、支付结果、售后和个人主页 |
业务模块
| 模块 | 内容 |
|---|---|
| 核心模块治理 | 核心 owning module 边界、System 语义使用规则和治理验证 |
| 内容管理 | 页面、公告、轮播图、导航、内容块、专题和广告位 |
| 博客 | 文章、分类、标签、评论、审核记录、作者内容和内容互动 |
| 论坛 | 板块、主题、回复、举报、处理记录、互动状态和基础版规 |
| 商城 | 商品、购物车、地址、订单、支付同步、评价和售后申请 |
| 卡券 | 通用卡券模板、发放、锁定和核销底座 |
| 自营广告 | 广告位、广告素材、素材审核和后续广告投放能力 |
| 统一搜索 | 聚合 CMS、Blog、Forum、Mall 等公开内容搜索、热词和建议 |
| AI | AI 模型供应商平台、AI 模型网关、AI 模型调用底座、AI 任务和 AI Agent 接入 |
| 短链接 | 短链接管理、公开解析和浏览器跳转 |
| 活码 | 动态二维码目标管理、公开解析和扫码跳转 |
| 开放平台 | 第三方应用、签名、防重放、scope、调用日志和开放 API |
| 企业安装 | 安装状态、安装令牌、环境预检、根路径接管和安装向导 |
Starter 入口
组合专题
| 入口 | 内容 |
|---|---|
| 钩子 / 管道 / 责任链 专题 | 三种同步执行模型的选型、推荐场景、注解语法糖、手动 Facade 调用和组合使用 |
更多业务场景和生态能力统一查看 功能模块，首页不重复展开模块说明。
推荐阅读顺序
- 快速开始
- 配置说明
- 架构总览
- 模块地图
- Laravel 对齐说明
- Provider 扩展模型
- 工程约定
- 功能模块
- 版本发布
- 升级指南
- 变更日志
- 生产部署样板
- API 文档
- API 兼容策略
- 安全与依赖基线
- 外部 Provider 验收清单
框架总览
