V0.7 前端视图与可预览闭环

V0.7 的目标是在 V0.6 后端上线能力收口之后，把框架推进到“能启动、能联调、能预览、能让开发者继续二开”的阶段。

版本号：0.7.0

发布状态：已发布。正式版本、Maven revision、Git tag 和 GitHub Release 统一为 0.7.0。

阶段定位

V0.7 是“前端视图 + 可预览闭环”版本：

Admin 后台管理、App 移动端、PC 电脑端、Install 安装端和 Docs 文档站进入主线。
后端 CMS、Blog、Forum、Mall、Search、IAM、Config、Open Platform、AI、Money、Member Points、Install 等能力具备可直接体验的 UI 入口。
默认应用装配、Docker / IDEA 本地启动、Liquibase 初始化基线、TraceId 排障、会员积分运营闭环完成发布前收口。
继续保持外部 Provider、真实支付密钥、真实链上收款、真实 AI 上游等成本或安全敏感能力显式 opt-in。

视图目录

前端源码统一收敛在根目录 views/：

text

views/
├── docs/        # VitePress 文档站
├── install/     # 企业安装 Vue3 单页向导
├── admin/       # 后台管理 Vue3 界面
├── app/         # 用户端 uni-app，多端覆盖 H5 / 小程序 / App
└── pc/          # PC 电脑端用户视图，Nuxt 4 + Vue 3 + TypeScript

对应 Maven 构建模块：

text

spring-open-views/
├── spring-open-view-docs/
├── spring-open-view-install/
├── spring-open-view-admin/
├── spring-open-view-app/
└── spring-open-view-pc/

构建产物导出到 public/ 下的对应目录，方便 Nginx 或静态服务部署：

源码目录	构建模块	产物
`views/docs`	`spring-open-view-docs`	`public/docs`
`views/install`	`spring-open-view-install`	`public/install`
`views/admin`	`spring-open-view-admin`	`public/admin`
`views/app`	`spring-open-view-app`	H5 导出到 `public/app`，小程序 / App 按 uni-app 平台目录输出
`views/pc`	`spring-open-view-pc`	`public/pc`

已完成范围

范围	当前交付
Admin 后台	登录、布局、动态菜单、系统管理 / 业务模块两级顶层信息架构、基础配置、用户权限、支付资金、任务管理、消息协作、Web3 管理、安装部署、内容社区、商城交易、支付结算、营销增长、开放平台、AI 平台和协作表单等运营入口已进入主线
App 移动端	首页、搜索、社区、商城、购物车、订单、支付、售后、消息、聊天、通知、个人中心、钱包、Web3、会员积分和多语言体验已接入真实 API
PC 用户端	门户、账号、用户中心、CMS、Blog、Forum、Mall、购物车、结算、订单、支付结果、售后、开放平台控制台和会员积分入口已接入
Install 安装端	安装状态、令牌校验、环境预检、数据库、Redis、Storage、管理员创建和安装锁定进入发布前可用链路
Docs 文档站	正式文档、版本说明、配置、部署、模块说明、API 兼容策略和 Pagefind 索引可构建
默认启动	应用默认装配保留完整框架预览能力，成本 / 安全敏感外部能力继续显式开启
会员积分	基于 Money 积分账户完成用户概览、签到、任务、流水、商城奖励 / 冲正、Admin 规则、手动调整和过期扫描
TraceId 排障	5xx 前端提示、响应头兼容、日志检索、异步任务和 Outbox 透传按当前 contract 收口
Liquibase	初始化基线按模块依赖顺序和 schema / seed 分离规则维护，迁移检查通过

运行入口

V0.7 需要保持以下入口可用：

端	路径	构建产物
Admin	`/admin/`	`public/admin`
App H5	`/app/`	`public/app`
PC	`/pc/`	`public/pc`
Install	`/install/`	`public/install`
Docs	`/docs/`	`public/docs`

常用环境变量以配置说明和生产部署样板为准。发布候选至少覆盖 APP_NAME、APP_PORT、APP_SECRET、APP_STORAGE_DIR、APP_PUBLIC_DIR、LOG_FILE_NAME、SPRING_PROFILES_ACTIVE、数据库、Redis 和安装开关 / 安装令牌；JWT、AI、Open Platform、支付、Web3 等能力可继续使用专用密钥覆盖 spring.application.secret 兜底。

发布验证

2026-06-18 本地正式发布验证结果：

验证	命令	结果
后端全量 reactor	`./mvnw test -DskipITs -DskipFrontend -Dsurefire.failIfNoSpecifiedTests=false`	通过
Admin 类型检查	`pnpm -C views/admin typecheck`	通过
PC 类型检查	`pnpm -C views/pc typecheck`	通过
App H5 构建	`pnpm -C views/app build:h5`	通过
Docs Maven 构建	`./mvnw -pl spring-open-views/spring-open-view-docs package -DskipTests -DskipITs -Dbuild.skip.views=false`	通过
项目脚本检查	`./.ai/scripts/check all`	通过
Diff 空白检查	`git diff --check`	通过

当前仓库不启用 GitHub Actions CI workflow。V0.7 正式发布以本地验证闭环和维护者确认为准。

验收标准

项目	标准
简洁易用	开发者 clone 后可按文档使用 Docker / IDEA / Maven 启动，常用能力有默认值，外部敏感能力按需配置
灵活扩展	前后端按 Admin / App / PC / Install / Docs 分层，后端按 starter / core / module 边界扩展，业务联动优先 contract / SPI / 事件
生产稳定	迁移检查、默认装配、TraceId、资金 / 积分幂等、通知 / 聊天 / WebSocket、文档构建和全量测试有验证记录
管理后台	能登录并管理核心后台资源，菜单结构按业务域组织
用户端	App 和 PC 能覆盖账号、内容、商城、支付、消息、会员积分和用户中心基础体验
构建	Maven、Admin typecheck、PC typecheck、App H5 build、Docs export 和 `.ai/scripts/check all` 均可执行
文档	版本说明、配置、部署、模块和二次开发说明保持当前 contract，不保留过期开发流水

不阻塞项

以下能力不阻塞 V0.7：

完整商业化 SaaS 控制台。
所有业务模块高保真页面。
复杂低代码页面设计器。
所有小程序 / App 平台兼容细节。
PC 端和 App 端所有复杂业务深度运营能力。
企业安装模块完整生产执行流程；V1.0 前必须完成。

发布确认

V0.7 发布确认：

工作区无无关改动。
本地发布验证命令已跑通，无无关脏文件混入。
文档站可访问，版本号、发布说明和 changelog 与最终发布版本一致。
Maven revision、版本说明、Git tag 和 GitHub Release 标题统一到 0.7.0。

V0.7 之后

V0.7 发布后进入 V0.8，重点做全栈联调、真实环境 smoke、WebSocket / 通知 / Open Platform / AI Gateway / 支付与资金链路的生产化复验、企业安装生产执行流程和可选增强能力确认。

V0.7 前端视图与可预览闭环 ​

阶段定位 ​

视图目录 ​

已完成范围 ​

运行入口 ​

发布验证 ​

验收标准 ​

不阻塞项 ​

发布确认 ​

V0.7 之后 ​