V0.8 全栈联调

本文档记录 V0.8 的发布目标、验收结果和后续边界。V0.8 的目标是在 V0.7 前端视图、默认装配和可预览闭环基础上，完成前后端深度联调、真实环境 smoke、生产化复验和可选增强能力验证。

版本号：0.8.0

发布状态：已发布。Git tag 和 Release 版本号统一为 v0.8.0。

阶段定位

V0.8 是“全栈可用性确认与生产化复验版”：

• 前后端功能联调测试确认无误。
• 后台管理、views/app 和 views/pc 与后端 API 全链路打通。
• 对默认装配模块、Docker / IDEA 启动、外部依赖、真实 Provider 和可选外部流水线做复验。
• 对 WebSocket、通知、Open Platform、AI Gateway、支付与资金链路做多实例、异常边界和 smoke 验证。
• 按真实常规 App / SaaS 应用需求继续做功能查漏补缺。
• 明确哪些能力默认内置，哪些作为可选增强功能。

任务拆分与当前口径

阶段	任务	说明
1	全栈接口联调	后台管理、views/app、views/pc 调用后端 API，修正字段、权限、分页、错误码和状态语义
2	鉴权与权限联调	登录、刷新、退出、在线用户、角色菜单、按钮权限、数据权限全链路验证
3	真实环境 smoke	复验 Docker、IDEA、默认装配、安装向导、文档站和真实外部依赖边界
4	多实例与异常边界	复验 WebSocket、通知、Open Platform、AI Gateway、支付与资金链路的多实例、重放、失败和补偿行为
5	可选增强能力整理	梳理支付、Web3、开放平台、AI、通知、存储、短信、邮件等增强能力的启用方式和示例
6	端到端测试	设计关键用户路径，完成 API、后台、用户端 H5、PC 端和多端应用烟雾测试
7	性能与安全基础检查	检查限流、跨域、安全头、XSS/输入输出边界、日志脱敏、慢请求和基础压测
8	文档与发布收口	更新使用手册、部署手册、联调清单和版本发布说明

截至 0.8.0 正式发布，以上任务不再作为活跃开发清单长期挂起；已完成的本地 contract、Admin / App / PC 入口、mock / smoke 和 runbook 以 Git 历史、.ai/progress.md、模块记忆和当前发布门禁为准。真实外部 Provider、真实链、真实支付、真实直播、广告平台和 Maven Central 凭据仍只作为部署 / 发布外部验收条件，不伪装成本地完成项。

聊天体验复验

V0.7 已经把 Conversation / Chat / WebSocket 的用户端入口接入主线。V0.8 不再把“迁移到 App”作为新增任务，而是复验开发者拿到用户端后能否稳定体验真实聊天链路。

基础功能：

能力	要求
游客聊天	未登录用户可填写昵称进入公共房间，服务端标识为游客
用户聊天	登录用户通过 token 建立连接，服务端标识为用户
群聊	支持默认房间、加入房间、退出房间、房间消息
私聊	支持按用户发送、离线提示和发送状态
多端连接	同一用户多设备在线时，支持排除当前连接或向全部设备发送
重连	断线自动重连、心跳、连接状态提示
消息展示	文本消息、系统消息、时间分隔、发送中 / 成功 / 失败状态

建议扩展方向：

• 历史消息和分页加载。
• 未读数和已读回执。
• 输入中状态。
• 图片 / 文件消息，复用 Storage。
• 消息撤回。
• 黑名单、举报、禁言和房间管理。
• Notification 联动，把重要聊天事件转为站内信或推送。
• 后续移动端系统通知或厂商推送。

常规应用必备基础模块

V0.8 重点评估并补齐这些“真实项目常见但容易遗漏”的能力：

模块	说明
用户资料	头像、昵称、联系方式、绑定身份、账户安全
消息中心	站内信、未读数、阅读回执、通知偏好
文件中心	公共文件、私有文件、受控下载、图片预览
系统公告	公告发布、展示、阅读状态
操作反馈	用户反馈、问题上报、后台处理
协议与隐私	用户协议、隐私政策、版本记录
设备与会话	登录设备、在线会话、踢人下线
基础设置	站点信息、Logo、备案、联系方式、第三方配置

可选增强能力

以下能力不要求所有项目默认使用，但要提供清晰启用方式：

• 支付与退款。
• Web3 钱包、链上查询和 Web3 支付。
• 开放平台 AK/SK、scope、限流和调用日志。
• AI Knowledge / AI Task。
• 邮件、短信、Webhook、站内信通知。
• 对象存储、私有文件和临时访问。
• 多语言和第三方翻译。

验收标准

项目	标准
后台管理	核心页面和后端 API 联调通过
用户端 App	登录、个人中心、通知、文件、聊天等基础链路在真实环境复验通过
PC 端	至少首页、登录和用户中心核心链路可用；PC 端优先级低于用户端 App
uni-app	至少 H5 链路可运行，小程序/App 构建路径明确
权限	菜单、按钮、数据权限前后端一致
常规模块	常规应用必备基础模块有明确实现或文档边界
可选增强	启用方式、配置、样板和文档清晰
测试	后端聚合测试、前端构建、docs 构建和关键烟雾测试通过

不阻塞项

以下能力不阻塞 V0.8：

• 全量业务系统。
• 会员付费和余额系统。
• 商业 SaaS 计费闭环完整 UI。
• 大规模压测和容量规划。
• 企业级 SSO 全场景适配。
• 原生 App 上架流程。

发布前检查清单

• [x] 工作区没有无关改动。
• [x] 常规应用基础模块完成实现或明确文档边界。
• [x] 可选增强能力启用文档完整。
• [x] 真实外部 Provider 按 外部 Provider 验收清单 区分本地 contract 与真实验收状态。
• [x] 后端应用聚合测试通过。
• [x] Admin / PC 类型检查和 App H5 构建通过。
• [x] 文档站点构建通过。
• [x] ./scripts/release checklist --version 0.8.0、./scripts/release dry-run --version 0.8.0 --since v0.7.0、./scripts/release api-compat --previous-version 0.7.0、./scripts/release migration-freeze 和 ./scripts/release install-smoke 可生成本地检查清单、发布说明草稿、公共 jar API 兼容检查命令、Liquibase freeze 快照报告和企业安装向导复验报告。
• [x] ./.ai/scripts/check all 通过。
• [x] git diff --check 通过。
• [x] .ai/progress.md、.ai/todo.md 和 .ai/plan.md 已记录最新状态。

真实外部 Provider、AI B2B2C 外部打款、真实链、真实支付、真实直播、广告平台和 Maven Central 发布凭据仍需按对应 runbook 单独归档真实证据；本地发布不把这些外部验收伪装为已完成。

发布确认

V0.8 发布确认：

• Maven revision、版本说明和发布草稿统一到 0.8.0。
• 本地发布门禁已通过；v0.8.0 tag、远程分支 / tag 和 GitHub Release 由维护者在发布动作中创建。
• 当前仓库不启用远端 CI workflow；正式发布以本地验证闭环和维护者确认为准。
• 真实外部 Provider、真实链、真实支付、直播、广告、Maven Central 发布凭据等验收记录必须按 runbook 单独归档，不能用本地 mock / contract smoke 替代。

迁移基线复验

2026-07-06 重发 V0.8 前复验 Liquibase 基线：

• ./.ai/scripts/check migrations 通过。
• ./scripts/release migration-freeze --output target/release-v0.8.0-migration-freeze.md 重新生成基线报告。
• 主迁移文件 105 个，测试迁移文件 2 个，主 changeSet 1543 个。
• 兼容标记 0 个，未发现 preConditions、MARK_RAN、validCheckSum、runOnChange 或 runAlways 残留。
• 迁移文件维持当前 0000_00_00_*_create_tables.xml / *_seed_data.xml 基线顺序；真实外部升级路径仍按发布 runbook 单独验证。

V0.8 之后

V0.8 发布后进入 V0.9，重点复验并深化用户端商业闭环、真实支付 / 退款联动、内容运营体验、外部 Provider 和运营报表。