docs(GOV-009): 封存 GOV-009 与 GOV-010 架构基线

2026-08-17 16:27:37 +08:00
parent 4971077d3b
commit 9e85809096
23 changed files with 220 additions and 23 deletions
@@ -3,7 +3,7 @@
 - 功能编号：GOV-010
 - 总结版本：0.1
 - 日期：2026-08-13
- 发布状态：未发布，开发与 Review 已完成
+- 发布状态：已随 `v0.0.8` 发布

 ## 原始开发需求

@@ -47,7 +47,7 @@
 - AI Provider 延期到独立功能设计，届时兼容 OpenAI API 协议；本次没有预留虚假实现或前端密钥。
 - 当前页面接入真实健康或市场概览 API 将随对应页面功能实施；本次不为了展示请求层而增加无产品价值调用。
 - 后端新业务模块会在实际出现职责时遵循按需分层；现有健康模块未迁移，避免没有业务收益的结构调整。
- GOV-010 保持 `unreleased`，不创建版本标签；发布仍受 GOV-009 架构复核和用户确认约束。
+- GOV-009 的实际架构复核已于 2026-08-17 获得用户确认；GOV-010 随同归入 `v0.0.8`。市场概览、AI Provider、用户体系及订阅能力仍按独立功能推进，不因本次治理发布视为已实现。

 ## 关键提交

@@ -60,8 +60,9 @@
 | `d2c1863` | `feat(GOV-010): 建立前端 API 分域边界` | 已推送 `origin/main` |
 | `e992edc` | `fix(GOV-010): 修复 Swagger 传递依赖漏洞` | 已推送 `origin/main` |
 | `f178fb4` | `feat(GOV-010): 完成开发质量与架构治理` | 已推送 `origin/main` |
+| `a398bc4` | `docs(GOV-010): 更新最终 GitNexus 基线` | 已推送 `origin/main` |

-每个阶段提交后均核对本地 `HEAD` 与 Gitea `refs/heads/main`；最终治理提交 `f178fb4` 已完成该核对。本收尾文档提交会在推送后继续核对远程 SHA。
+每个阶段提交后均核对本地 `HEAD` 与 Gitea `refs/heads/main`；最终 GitNexus 基线提交 `a398bc4` 已推送。本次发布封存提交与 `v0.0.8` 标签继续按规范分别推送并核对远程 SHA。

 ## 验证证据

@@ -16,3 +16,7 @@
 MEDIUM 还反映了项目边界验证流的变化：该工具增加了 Axios、fetch、业务 URL 和统一 request 的 AST 规则。它只在开发/发布门禁运行，不进入 API、Scheduler、Worker 或浏览器生产请求路径。

 未检测到计划外的 RocketMQ 消息消费者、MySQL/Redis 数据访问、Schema 迁移或三进程运行流变化。GitNexus 对 Markdown 文档以章节符号记录，不能替代人工阅读，因此同步修改结论在 `comparison.md` 和 Review 中重复核对。
+
+## v0.0.8 发布封存检测
+
+2026-08-17 再次执行 `npx gitnexus detect-changes --repo a-share-analysis`：22 个已索引文档/版本文件、55 个文档符号、0 条受影响执行流，风险 LOW。本次只把已完成治理归入 `v0.0.8`；Axios、OpenAPI、HTTP 字段、MySQL、Redis、RocketMQ、API、Scheduler、Worker 和源码部署均无运行时同步变化。
@@ -1,7 +1,7 @@
 id: GOV-010
 name: 开发质量与前后端架构规范
 slug: development-quality-architecture
-status: reviewing
+status: released
 owner: project
 created_at: 2026-08-13
 prd: prd.md
@@ -12,4 +12,8 @@ test_plan: test-plan.md
 development_summary: development-summary.md
 gitnexus_before: gitnexus/before.md
 gitnexus_impact: gitnexus/impact-plan.md
-release: unreleased
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+release: v0.0.8
@@ -41,3 +41,10 @@
 - 桌面截图：`screenshots/iterations/app-shell-desktop-1440x900-61f85e5.png`，实际浏览器 DOM 视口 1440×900。
 - 移动截图：`screenshots/iterations/app-shell-mobile-61f85e5.png`，实际浏览器 DOM 视口 390×844。
 - 两个视口均有可见 `main` 和页面标题，无横向溢出；浏览器错误/警告日志为空。截图只证明本次请求基础设施迁移没有造成外壳回归，不代表市场概览 UI 已实现。
+
+## v0.0.8 发布封存验证（2026-08-17）
+
+- GOV-009 与 GOV-010 完成门禁均通过；`pnpm verify:release` 以 Node.js 22.22.0、pnpm 10.25.0 完整通过。
+- 最终计数为治理 10、MySQL 2、环境 10、Schema 28、契约 3、边界 16、部署 6、Web 11、Server 30、API 预检 2、Playwright 4，全部通过且无失败。
+- Web 与 API/Scheduler/Worker 构建、源码产物、systemd/Nginx 一致性均通过；本次仅改变发布文档和状态，不改变 Axios、OpenAPI 或后端运行行为。
+- 安全边界与 2026-08-13 Review 一致：不访问生产配置或数据库，不输出凭据，不写入 Redis/MySQL，不启用 RocketMQ 收发。
@@ -1,7 +1,7 @@
-# GOV-010 未发布变更说明
+# GOV-010 发布说明

- 状态：验证中，未发布
- 日期：2026-08-13
+- 状态：已随 `v0.0.8` 发布
+- 发布日期：2026-08-17

 ## 新增

@@ -52,3 +52,12 @@
 ## 最终结论

 最终结论：passed
+
+## v0.0.8 发布封存复核
+
+- 复核日期：2026-08-17
+- 本次只把已完成并通过 Review 的 GOV-010 归入 `v0.0.8`，没有修改 Axios 请求行为、OpenAPI 契约、后端分层代码或依赖版本。
+- 安全与性能结论没有变化：错误脱敏、有限超时、无自动重试、传递依赖修复和包体证据继续有效；本次文档状态变化不引入运行时资源开销。
+- GitNexus 影响仅为发布追溯文档；HTTP/OpenAPI、MySQL、Redis、RocketMQ、API、Scheduler、Worker 和部署无需同步修改。
+
+最终结论：passed
@@ -25,7 +25,7 @@

 ## 不符合项与处置

-初审发现 Review 最终结论校验允许“passed”出现在正文中间，已按测试先行修复为最后非空行校验；没有遗留不符合项。历史已发布档案未改写；GOV-010 保持 `unreleased`。
+初审发现 Review 最终结论校验允许“passed”出现在正文中间，已按测试先行修复为最后非空行校验；没有遗留不符合项。历史已发布档案未改写；在本次审查时 GOV-010 保持 `unreleased`。

 ## 安全、性能与架构检查

@@ -38,3 +38,11 @@
 ## 最终结论

 最终结论：passed
+
+## v0.0.8 发布封存复核
+
+- GOV-009 架构确认门禁已于 2026-08-17 满足，GOV-010 的 `released/v0.0.8` 状态与开发总结、发布说明和 CHANGELOG 一致。
+- 原 Review 中 `unreleased` 是确认前的真实历史状态；本节记录后续发布决定，不反向改写当时审查事实。
+- 最终完成门禁、全量源码发布验证、GitNexus 变更检测、中文提交、Gitea 分支推送和精确标签推送按发布流程重新执行。
+
+最终结论：passed