docs(FEAT-MO-001): 完成评审与治理收口

fix(FEAT-MO-001): 校验相邻行情日期
fix(FEAT-MO-001): 校验TDX交易日期语义
2026-08-18 21:24:05 +08:00 · 2026-08-18 21:10:58 +08:00 · 2026-08-18 20:48:20 +08:00 · 2026-08-18 20:12:26 +08:00 · 2026-08-18 19:30:34 +08:00 · 2026-08-18 17:37:36 +08:00
129 changed files with 9773 additions and 268 deletions
@@ -30,3 +30,5 @@ CLAUDE.md
 *.log
 tmp/
 work/
 .worktrees/
 .superpowers/
@@ -29,7 +29,7 @@
 <!-- gitnexus:start -->
 # GitNexus — Code Intelligence
-This project is indexed by GitNexus as **a-share-analysis** (1957 symbols, 2634 relationships, 50 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
+This project is indexed by GitNexus as **a-share-analysis** (2432 symbols, 3283 relationships, 63 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
 > If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
@@ -4,6 +4,21 @@
 ## Unreleased
 ## 0.0.10 - 2026-08-18
 - 使用 Node.js 22.x 与 mysql2 直接读取 MySQL 5.7.x 元数据和 `SHOW CREATE`，移除 Schema 基线对本机 MySQL CLI 的依赖。
 - 新增 format v3 exporter/driver 元数据，永久只读兼容 format v1/v2。
 - 增加对象目录、视图依赖排序、并发漂移检测、错误脱敏、超时和定义大小保护。
 - 恢复版本开发门禁并封存 `v0.0.9` development `captured_empty` Schema 基线。
 ## 0.0.9 - 2026-08-17
 - Node.js 运行时约束明确为完整 22.x，不绑定 minor 或 patch。
 - MySQL 客户端、mysqldump、服务端和健康检查统一接受完整 5.7.x，不设置最低补丁版本。
 - MySQL 健康详情改为展示服务端实际三段版本，字符集、排序规则、库名和东八区时区继续严格校验。
 - 系统架构、开发规范、本地开发和 Ubuntu 源码部署手册统一采用系列版本口径，历史版本证据保持原样。
 - 用户确认开发库为空并授权 GOV-011 一次性跳过 v0.0.8 Schema 基线；仓库未伪造基线或增加通用绕过开关。
 ## 0.0.8 - 2026-08-17
 - 新增安全、性能、GitNexus 跨模块影响和独立开发总结的可执行治理门禁。
@@ -37,7 +37,7 @@ npm run schema:verify
 npm run governance:start -- FEAT-MO-001 market-overview
 ```
-Schema 命令只允许处理固定开发库；当前 MySQL 未启用时会为上一发布版本生成可验证的不适用清单，不会连接数据库或创建空 SQL。完整规则见 [开发流程规范](docs/governance/development-workflow.md)。
+Schema 命令只允许处理固定开发库；导出器使用 Node.js `mysql2`，本机无需安装 MySQL Server 或 CLI。当前 MySQL 未启用时会为上一发布版本生成可验证的不适用清单，不会连接数据库或创建空 SQL；启用但无对象时生成 format v3 `captured_empty` 清单。完整规则见 [开发流程规范](docs/governance/development-workflow.md)。
 ## 项目仓库
@@ -1 +1 @@
-0.0.8
+0.0.10
@@ -0,0 +1,33 @@
 {
  "format_version": 3,
  "status": "captured_empty",
  "application_version": "v0.0.10",
  "git_commit": "16bde94df68263672fa12e2823afe024c741f84e",
  "source_environment": "development",
  "database_name": "a_share_analysis_dev",
  "charset": "utf8mb4",
  "collation": "utf8mb4_general_ci",
  "generated_at": "2026-08-17T19:07:54.864Z",
  "generator": "schema-baseline/3.0.0",
  "reason": "none",
  "schema_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "objects": {
    "tables": false,
    "views": false,
    "triggers": false,
    "routines": false,
    "events": false
  },
  "object_counts": {
    "tables": 0,
    "views": 0,
    "triggers": 0,
    "routines": 0,
    "events": 0
  },
  "exporter_name": "mysql2-show-create",
  "exporter_version": "1.0.0",
  "database_driver": "mysql2",
  "database_driver_version": "3.23.3",
  "mysql_server_version": "5.7.42-0ubuntu0.18.04.1"
 }
@@ -0,0 +1,33 @@
 {
  "format_version": 3,
  "status": "captured_empty",
  "application_version": "v0.0.9",
  "git_commit": "88e2fdffc8c71dd682405c148a81953a8dcee9d6",
  "source_environment": "development",
  "database_name": "a_share_analysis_dev",
  "charset": "utf8mb4",
  "collation": "utf8mb4_general_ci",
  "generated_at": "2026-08-17T18:56:33.473Z",
  "generator": "schema-baseline/3.0.0",
  "reason": "none",
  "schema_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "objects": {
    "tables": false,
    "views": false,
    "triggers": false,
    "routines": false,
    "events": false
  },
  "object_counts": {
    "tables": 0,
    "views": 0,
    "triggers": 0,
    "routines": 0,
    "events": 0
  },
  "exporter_name": "mysql2-show-create",
  "exporter_version": "1.0.0",
  "database_driver": "mysql2",
  "database_driver_version": "3.23.3",
  "mysql_server_version": "5.7.42-0ubuntu0.18.04.1"
 }
@@ -4,6 +4,8 @@ APP_ENV=development
 API_HOST=127.0.0.1
 API_PORT=3000
 LOG_LEVEL=debug
 TDX_BASE_URL=http://127.0.0.1:17710
 TDX_TIMEOUT_MS=5000
 # 第一阶段实际启用的 Redis。
 REDIS_HOST=127.0.0.1
@@ -3,6 +3,8 @@ APP_ENV=production
 API_HOST=127.0.0.1
 API_PORT=3000
 LOG_LEVEL=info
 TDX_BASE_URL=http://127.0.0.1:17710
 TDX_TIMEOUT_MS=5000
 REDIS_HOST=127.0.0.1
 REDIS_PORT=6379
@@ -60,10 +60,10 @@ OpenAPI 负责描述本项目 HTTP 契约，Axios 负责浏览器实际请求。
 ## 4. 数据库技术基线
- 数据库服务端固定使用 MySQL 5.7.42；开发、测试和生产环境禁止使用其他补丁版本或 MySQL 8.x 代替兼容性验证。
+- 数据库服务端统一使用 MySQL 5.7.x；开发、测试和生产环境禁止使用 MySQL 5.6.x、8.x、MariaDB 或其他数据库代替兼容性验证，但不锁定 5.7 系列内的补丁版本。
 - 数据库与表默认字符集固定为 `utf8mb4`，排序规则固定为 `utf8mb4_general_ci`。
 - 数据库初始化、表结构、连接会话、ORM 配置和迁移脚本必须显式声明或验证该字符集与排序规则，不能依赖服务器默认值。
- 正式启用持久化前，必须在真实 MySQL 5.7 环境验证服务端版本、Schema/表排序规则、迁移和关键查询。
+- 正式启用持久化前，必须在真实 MySQL 5.7.x 环境验证服务端版本、Schema/表排序规则、迁移和关键查询。
 - 第一阶段市场概览只定义 MySQL Repository 接口并使用内存实现，不启动数据库、不建立生产连接；后续启用时不得改变前端 API 和核心分析契约。
 ## 5. 当前实施顺序
@@ -1,6 +1,6 @@
 # 本地开发环境
-本地开发由开发机提供 Node.js 22.x、pnpm 10.25.0 和已开机自启的 Redis `127.0.0.1:6379`。Web、API、Scheduler 与 Worker 全部从源码启动；MySQL 5.7.42 和 RocketMQ 5.x 也是外部服务，项目脚本不负责安装、启动、停止或删除任何基础设施。
+本地开发由开发机提供 Node.js 22.x、pnpm 10.25.0 和已开机自启的 Redis `127.0.0.1:6379`。Web、API、Scheduler 与 Worker 全部从源码启动；MySQL 5.7.x 和 RocketMQ 5.x 也是外部服务，项目脚本不负责安装、启动、停止或删除任何基础设施。
 ## 首次准备
@@ -16,7 +16,7 @@ Redis 必须返回 `PONG`。如果不可达，应先修复开发机外部服务
 把 `deploy/env/development/*.env.example` 复制为同目录的 `*.env.local`。四份 local 文件被 Git 忽略：Web 只能含 `VITE_` 公开变量；API、Scheduler、Worker 按最小权限分别读取自己的配置，不共享一份全能 env。
-固定开发 MySQL 只允许 `a_share_analysis_dev`，主机必须是回环地址或代码内白名单 `112.192.20.11`，服务端固定为 MySQL 5.7.42，字符集为 `utf8mb4`、排序规则为 `utf8mb4_general_ci`、会话时区为 `+08:00`。Schema 工具和开发检查禁止连接、探测或读取生产库。
+固定开发 MySQL 只允许 `a_share_analysis_dev`，主机必须是回环地址或代码内白名单 `112.192.20.11`，服务端必须属于 MySQL 5.7.x 且不限制系列内补丁版本，字符集为 `utf8mb4`、排序规则为 `utf8mb4_general_ci`、会话时区为 `+08:00`。Schema 工具和开发检查禁止连接、探测或读取生产库。
 ## 启动顺序
@@ -2,19 +2,19 @@
 ## 1. 用途与适用边界
-本手册用于 Mac 本地开发期间，按需访问家中 Windows 上仅监听回环地址的 TDX HTTP 接口。链路只用于真实字段核验和只读冒烟，不是生产采集、数据上报或公网部署方案。
+本手册用于 Mac 本地开发期间，访问家中 Windows 上仅监听回环地址的 TDX HTTP 接口。TDX 是市场概览的正式行情来源；SSH 隧道负责把家庭局域网和外部 Tailscale 两种开发位置统一成同一个 Mac 回环入口。该链路不是生产采集、数据上报或公网部署方案。
 ```text
-Mac 本地程序
+Mac 本地程序 / TDX Bridge
  -> 127.0.0.1:17710
  -> SSH 本地端口转发
-  -> Tailscale 私有网络
+  -> 家庭局域网或 Tailscale 私有网络
-  -> Windows OpenSSH
+  -> 同一台 Windows OpenSSH
  -> Windows 127.0.0.1:17709
  -> TDX
 ```
-日常开发默认使用仓库内固定样本。只有需要验证 TDX 真实协议和字段时才启动本隧道；Windows 离线不得阻塞普通开发、测试或构建。
+两个场景只切换 SSH 目标别名，TDX Bridge 和上层业务始终访问 `http://127.0.0.1:17710/`。离线样本只允许作为显式开发和自动化测试回退，并必须标记为离线数据；不得伪装为实时 TDX。Windows 离线不得阻塞普通测试或构建。
 ## 2. 安全边界
@@ -157,20 +157,34 @@ Restart-Service sshd
 管理员和非管理员两种方式只选与实际账户匹配的一种。若修改了 `C:\ProgramData\ssh\sshd_config`，先执行 `sshd -t` 校验，再重启服务。
-## 6. 配置 Mac SSH 别名
+## 6. 配置 Mac SSH 双场景别名
-编辑 Mac 的 `~/.ssh/config`，加入：
+家庭局域网和外部 Tailscale 连接同一台 Windows、同一个账户和同一个 `sshd`，复用同一把项目专用密钥，不创建第二把 SSH 密钥。编辑 Mac 的 `~/.ssh/config`，加入：
 ```sshconfig
-Host tdx-windows
+Host tdx-windows-lan tdx-windows-tailnet
  HostName <WINDOWS_TAILSCALE_HOST>
  User <WINDOWS_SSH_USER>
  IdentityFile ~/.ssh/tdx_windows
  IdentitiesOnly yes
  UseKeychain yes
  AddKeysToAgent yes
  ServerAliveInterval 30
  ServerAliveCountMax 3
  ExitOnForwardFailure yes
  LocalForward 127.0.0.1:17710 127.0.0.1:17709
 Host tdx-windows-lan
  HostName <WINDOWS_LAN_HOST>
 Host tdx-windows-tailnet
  HostName <WINDOWS_TAILSCALE_HOST>
 ```
 真实局域网地址、Tailscale 地址和用户名只保存在本机 SSH 配置，不写入仓库。开发代理需要核对当前配置时使用：
 ```bash
 ssh -G tdx-windows-lan | awk '/^(hostname|user|identityfile|localforward) / {print}'
 ssh -G tdx-windows-tailnet | awk '/^(hostname|user|identityfile|localforward) / {print}'
 ```
 然后修正权限：
@@ -191,37 +205,70 @@ ssh-keygen -lf "$env:ProgramData\ssh\ssh_host_ed25519_key.pub"
 再在 Mac 连接，并确认首次连接提示的 Ed25519 指纹与 Windows 输出一致：
 ```bash
-ssh -v tdx-windows
+ssh -v tdx-windows-tailnet
 ```
 预期可以直接登录，或只要求输入私钥口令。若仍要求 Windows 账户密码，重点检查公钥文件位置、ACL、登录账户是否属于 Administrators，以及 SSH 调试输出中实际使用的密钥。
-## 7. 启动和停止隧道
+## 7. 两种场景的选择、启动和停止
-### 7.1 前台运行
+### 7.1 选择规则
-适合首次验证，按 `Ctrl+C` 停止：
+| 当前场景 | 使用别名 | 前置条件 |
 |---|---|---|
 | Mac 与 Windows 位于已配置的家庭局域网 | `tdx-windows-lan` | Windows 在线、TDX 已登录、家庭 LAN 的 SSH 22 可达 |
 | Mac 在外部网络，或家庭 LAN SSH 不可达 | `tdx-windows-tailnet` | Mac 与 Windows 的 Tailscale 均在线，Tailnet ping 成功 |
 两种隧道不能同时启动，因为都会独占 Mac `127.0.0.1:17710`。在家庭网络内优先使用 LAN；若 LAN 前置检查失败，不修改 TDX 监听地址，改用 Tailscale。
 ### 7.2 家庭局域网模式
 前置检查：
 ```bash
-ssh -N tdx-windows
+ssh -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
 ```
-### 7.2 后台运行
+仓库文档不保存真实地址，家庭路径直接通过 SSH 别名验证。首次连接必须核对局域网地址与已信任的 Tailscale 地址返回相同 Windows 主机密钥指纹。
-使用独立控制套接字启动，便于精确停止本项目隧道：
+后台启动和检查：
 ```bash
-ssh -fN -M -S ~/.ssh/tdx-windows-control tdx-windows
+ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
-ssh -S ~/.ssh/tdx-windows-control -O check tdx-windows
+ssh -S ~/.ssh/tdx-windows-lan-control -O check tdx-windows-lan
 ```
-停止后台隧道：
+停止：
 ```bash
-ssh -S ~/.ssh/tdx-windows-control -O exit tdx-windows
+ssh -S ~/.ssh/tdx-windows-lan-control -O exit tdx-windows-lan
 ```
-如果控制套接字残留但进程已不存在，先确认 `17710` 没有监听，再删除该单个套接字文件。不要用宽泛的 `pkill ssh`，以免终止其他 SSH 会话。
+Windows 的家庭 SSH 防火墙规则应使用项目专用名称 `A-Share-TDX-SSH-LAN`，只允许家庭子网访问 TCP 22。系统原有的全范围 OpenSSH 入站规则保持禁用，不为 TDX 开放 `17709`。
 ### 7.3 外部 Tailscale 模式
 前置检查：
 ```bash
 tailscale up
 tailscale ping <WINDOWS_TAILSCALE_HOST>
 ```
 后台启动和检查：
 ```bash
 ssh -fN -M -S ~/.ssh/tdx-windows-tailnet-control tdx-windows-tailnet
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O check tdx-windows-tailnet
 ```
 停止：
 ```bash
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O exit tdx-windows-tailnet
 ```
 如果控制套接字残留但进程已不存在，先确认 `17710` 没有监听，再删除对应场景的单个控制套接字。不要用宽泛的 `pkill ssh`，以免终止其他 SSH 会话。
 ## 8. 验证 TDX 链路
@@ -266,11 +313,11 @@ curl --fail-with-body --silent --show-error \
 1. 确认 Windows 保持开机、联网，Tailscale 和 `sshd` 在线，TDX 已启动并登录。
 2. Mac 切换到外部网络后重新连接 Tailscale。
 3. 执行 `tailscale ping <WINDOWS_TAILSCALE_HOST>`。
-4. 执行 `ssh -N tdx-windows` 并保持终端运行。
+4. 执行 `ssh -N tdx-windows-tailnet` 并保持终端运行。
 5. 依次执行 `nc` 和只读 `curl` 冒烟。
 6. 停止隧道，确认 `127.0.0.1:17710` 不再监听。
-如果外网演练失败，日常开发继续使用固定样本。不要临时开放公网 SSH、RDP 或 TDX 端口。
+如果外网演练失败，开发和自动化测试可显式切换到离线样本，并明确标记数据来源。不要临时开放公网 SSH、RDP 或 TDX 端口。
 ## 10. Windows 无人值守准备
@@ -320,7 +367,7 @@ New-NetFirewallRule `
 - Windows 执行 `Get-Service sshd` 和 `Get-NetTCPConnection -LocalPort 22 -State Listen`。
 - 检查 Windows 防火墙和 Tailscale 访问规则。
- Mac 执行 `ssh -vvv tdx-windows`，确认目标是 Tailscale 地址而非家庭公网地址。
+- Mac 执行 `ssh -vvv tdx-windows-tailnet`，确认目标是 Tailscale 地址而非家庭公网地址。
 ### SSH 仍要求 Windows 密码
@@ -343,35 +390,52 @@ New-NetFirewallRule `
 ### 外出后 Windows 不在线
- 无法远程唤醒或恢复交互式 TDX 登录时，切回固定样本继续开发。
+- 无法远程唤醒或恢复交互式 TDX 登录时，显式切回离线样本继续开发，并保持非实时标记。
 - 不通过新增公网暴露、共享密码或关闭防火墙绕过问题。
 - 待公网部署需求明确后，另立功能实现生产级采集器、心跳、补传和远程运维。
 ## 13. 日常操作速查
-开始真实 TDX 联调：
+### 13.1 在家开发
 ```bash
-tailscale ping <WINDOWS_TAILSCALE_HOST>
+ssh -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
-ssh -fN -M -S ~/.ssh/tdx-windows-control tdx-windows
+ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
-ssh -S ~/.ssh/tdx-windows-control -O check tdx-windows
+ssh -S ~/.ssh/tdx-windows-lan-control -O check tdx-windows-lan
 nc -vz 127.0.0.1 17710
 ```
-结束联调：
+结束家庭局域网联调：
 ```bash
-ssh -S ~/.ssh/tdx-windows-control -O exit tdx-windows
+ssh -S ~/.ssh/tdx-windows-lan-control -O exit tdx-windows-lan
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 ```
-最后一条命令无输出表示本地转发已经停止。
+### 13.2 在外开发
 ```bash
 tailscale up
 tailscale ping <WINDOWS_TAILSCALE_HOST>
 ssh -fN -M -S ~/.ssh/tdx-windows-tailnet-control tdx-windows-tailnet
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O check tdx-windows-tailnet
 nc -vz 127.0.0.1 17710
 ```
 结束外部联调：
 ```bash
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O exit tdx-windows-tailnet
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 ```
 最后一条命令无输出表示本地转发已经停止。切换场景时必须先停止当前隧道，再启动另一场景；不得通过更换 TDX Bridge 地址绕过端口冲突。
 ## 14. 后续 Provider 接入约束
- 平台配置只能引用 Mac 回环地址 `127.0.0.1:17710`，不得保存家庭网络地址。
+- 平台配置只能引用 Mac 回环地址 `127.0.0.1:17710`，不得保存家庭网络或 Tailscale 地址。
- 真实 TDX Provider 必须显式启用；默认仍为确定性的固定样本 Provider。
+- TDX 是正式行情来源；离线样本只作为显式开发和测试回退，必须展示来源与陈旧状态，生产环境禁止启用。
 - Provider 必须限制请求超时、响应体大小、股票数量和并发，并输出来源、采集时间、交易日期、协议版本、追踪 ID 和陈旧状态。
 - TDX 原始字段仅在 Adapter 内转换，上层市场概览、规则分析和 AI 分析只依赖版本化内部契约。
- 隧道中断必须返回明确的不可用或陈旧状态，不能把固定样本伪装成实时行情。
+- 隧道中断必须返回明确的不可用或陈旧状态，不能把离线样本伪装成实时行情。
 - Windows 采集器、公网接收 API、多目标推送、补传队列和无人值守运维继续延期，实施时单独立项并重新进行安全、性能和合规评估。
@@ -1,6 +1,6 @@
 # Ubuntu 源码生产部署
-这是项目唯一生产部署方式，支持 Ubuntu 22.04 LTS 与 Ubuntu 24.04 LTS x86_64。服务器管理员预先提供 Node.js 22.x、pnpm 10.25.0、Nginx，以及外部 MySQL 5.7.42、Redis、RocketMQ 5.x；项目不负责安装、升级、启动、停止、删除或修改这些系统软件与服务。
+这是项目唯一生产部署方式，支持 Ubuntu 22.04 LTS 与 Ubuntu 24.04 LTS x86_64。服务器管理员预先提供 Node.js 22.x、pnpm 10.25.0、Nginx，以及外部 MySQL 5.7.x、Redis、RocketMQ 5.x；项目不负责安装、升级、启动、停止、删除或修改这些系统软件与服务。
 ## 构建发布目录
@@ -1,5 +1,33 @@
 # 设计
-首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、情绪与资金摘要。分析偏好保存在浏览器本地，页面只显示轻量的当前状态入口。
+首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、资金趋势。分析偏好保存在浏览器本地，页面显示轻量的当前状态入口。Vue 不直连 TDX，由 Nest API 按模块拆分接口并隔离失败。
 ## 数据可用性
 - `summary` 和 `indices`：使用 TDX K 线真实响应，展示来源、快照时间和指数涨跌。
 - `breadth`：使用 TDX 指数快照的 `UpHome`、`DownHome` 汇总上证、深证和北证市场宽度；未返回的 `unchanged` 明确为 `null`，不得用总数推算。
 - `sectors`：使用 TDX 系统分类中的一级行业（`get_stock_list(market=16)`）和批量日行情，按涨跌幅排序后展示重点强弱板块。
 - `funds`：模块名称和口径为“成交额趋势”，使用核心交易所指数日行情的 `Amount` 汇总当前与前一交易日成交额；这不是主力净流入。
 - 交易日对齐：交易日期必须是有效 `YYYYMMDD` 公历日期；指数和一级行业只有在前一根日期有效且严格早于当前日期时才计算涨跌，随后只保留最新交易日截面。成交额还要求日期与金额数组等长且前一交易日早于当前交易日，再按最新有效日期对汇总，避免畸形日期、数组错位或旧市场覆盖新数据。市场宽度额外并行读取一个核心指数日线作为日期参考。
 - 新鲜度：日行情交易日期与 `Asia/Shanghai` 当前日历日期不同即标记 `delayed`；宽度沿用参考指数日期。首版不引入交易日历依赖，休市日保守标延迟并展示实际日期。
 - 主力净流入和盘中新闻不在本次 TDX 首屏主链路中，后续通过独立补充数据源适配器接入，并在响应中标记来源与数据质量。
 - 页面不把缺失或权限不足的指标降级为模拟值；单个来源失败只影响对应模块。
 ## 运行边界
 本功能只读调用 TDX。MySQL、Redis、RocketMQ 仍为已规划基础设施，但当前没有业务状态、缓存或异步任务需要它们，因此本切片不启用。
 ## 安全策略与评估
 - TDX 地址在配置层固定为 `http://127.0.0.1:17710`，API 是唯一访问边界，Vue 不直连行情服务。
 - 请求只允许固定方法和公开行情参数；客户端限制超时与 1 MiB 响应，异常脱敏，不记录原始载荷、凭据或网络地址。
 - 本功能不提供交易写入、账户操作、用户输入拼接查询或 AI 密钥下发；MySQL/Redis/RocketMQ 未启用，不读取生产数据库。
 - 已通过客户端、服务、HTTP/OpenAPI、边界和 E2E 测试；生产授权、长期断线恢复和公网安全仍需后续评估。
 ## 性能目标与评估
 - 五个模块并行请求，单个 TDX 请求受配置超时保护，模块失败不阻断其他模块。
 - 客户端限制响应大小，避免异常行情载荷占用过多内存；本切片不增加数据库、缓存或消息队列负载。
 - 已完成构建、浏览器桌面/390px 移动端验证；未进行 7×24 采集、峰值并发和长期网络抖动压测。
 ETF监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。
@@ -0,0 +1,55 @@
 # FEAT-MO-001 开发总结
 ## 原始开发需求
 实现市场概览首屏：结论优先展示市场状态、驱动与风险，并支持综合、短线、中长线视角和规则、AI、混合、对照分析选择；用户可从指数和板块入口进入后续详细分析。
 ## 需求与范围变化
 - 数据源从早期“确定性模拟快照”调整为 TDX 只读直连，Nest API 访问本机 `127.0.0.1:17710`，Vue 不直接访问 TDX。
 - API 按摘要、指数、市场宽度、板块和资金拆分，避免把整个首屏塞入单个接口。
 - 当前 TDX 桥接已确认 `get_market_snapshot`、`get_stock_list` 和批量 `get_market_data` 可用；市场宽度、一级行业板块和成交额趋势改为真实 TDX 映射。主力净流入字段虽存在但当前实测为零值，盘中新闻无官方行情接口，因此两者延期到补充源功能。
 - MySQL、Redis、RocketMQ 和 AI 仍不进入本切片运行链路；它们保留为后续基础设施边界。
 ## 实际完成需求
 - 新增 TDX 配置校验、超时/响应大小限制、错误脱敏的 Node 客户端。
 - 新增市场概览 DTO、服务、控制器、OpenAPI 契约和前端 Axios API 文件。
 - 完成结论、驱动与风险、核心指数、市场宽度、板块、资金趋势模块，以及加载/错误/不可用状态。
 - 完成分析视角和分析引擎切换，本地保存用户偏好。
 - 真实 TDX 指数和摘要已通过本机隧道冒烟；未用指数或离线样本伪造缺失指标。
 - 真实 TDX 市场宽度、一级行业和成交额趋势已通过本机桥接冒烟；资金模块明确使用成交额口径，不宣称主力净流入。
 ## 修复缺陷
 - 修正 PRD 和实施计划中仍描述“模拟数据”的旧表述。
 - 避免单个 TDX 模块失败导致整页失败，改为五个模块并行、独立状态。
 - 对未注册桥接方法返回结构化原因，避免前端显示“实时”或空白数据。
 - 修复 Vue TypeScript 单文件组件未被 ESLint 正确解析的问题，并为 E2E 测试进程补齐必需的本机 TDX 配置边界。
 - 隔离应用外壳单测中的真实 Axios 请求，消除 JSDOM 网络错误噪声，保持页面测试只验证外壳职责。
 - 根据代码 Review 修复畸形 TDX 字段被折算为零、缺市场成交额误报三市、交易日错位跨日求和、空行业目录误报 `fresh`、前端隐藏 `partial/delayed` 警告和零变化使用上涨色等缺陷，并补齐对应回归测试。
 - 根据二次 Review 继续修复涨跌家数接受非整数、成交额受市场定义顺序影响、指数/板块跨交易日混排和后端从不生成 `delayed` 的边界；宽度增加核心指数日期参考，不新增基础设施或第三方依赖。
 - 根据第三轮独立 Review 修复 8 位畸形日期被误认为有效公历日期、成交额接受倒序日期对与日期/金额数组错位，以及服务测试依赖运行当天的问题。
 - 根据第四轮独立 Review 修复指数/板块未校验前一根 K 线日期的问题；非法、重复或倒序的前一日期不再生成涨跌信号。
 ## 未完成与延期项
 - 主力净流入的权限/数据质量验证、盘中新闻补充源、真实图表和口径仍延期。
 - “查看依据”抽屉、指数/板块详情页、AI 请求和用户体系另立功能。
 - 本地验证不代表生产 7×24 采集稳定性、商业授权或公网部署安全性。
 ## 关键提交
 - `9a965fa`、`d283ee3`、`6eb34b5`、`c2fa929`、`15a2500`、`27bc3c1`、`8261948`、`ff8ada8`、`49f6be9`、`7e4dcd9`、`ae2a7e0`、`c2fdfa6`
 ## 验证证据
 - GitNexus 已完成提交前重新索引；上一修复提交的最终 staged 检测映射 66 个符号、21 条概览执行流并标记 critical。风险来自本功能修改核心概览服务、TDX 映射和前端数据面板，已由定向单测、HTTP/OpenAPI、前端状态回归、构建、浏览器视觉验证和 E2E 覆盖；未发现额外业务模块调用方。第三轮修复前又用 MCP 对 `toTradeDate` 和 `mapTurnoverTrend` 执行符号级影响分析，直接调用方仅在市场概览映射与测试范围。
 - API 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；完整结果和耗时见 `tdx-smoke-report.md`。
 - 家庭 LAN 隧道二次复验：五个市场概览接口均为 `fresh`，指数 3 项、板块 8 项、成交额覆盖 3 个市场且交易日期完整；只保存脱敏统计。
 - 日期对齐与延迟状态修复后，后端 60/60、完整全仓门禁和家庭 LAN 五接口当日 `fresh` 复验通过；第三轮日期真实性与测试时钟修复后，后端增加至 63/63；第四轮相邻日期修复后，后端增加至 67/67。`c2fdfa6` 推送前后均执行完整 `pnpm verify`，契约、Lint、格式、类型、全部测试、构建和 E2E 均通过。
 - 前端单测、typecheck、build、后端 TDX/映射/服务/HTTP/OpenAPI 测试通过。
 - `pnpm verify:e2e`：4/4 通过（桌面和移动端各覆盖页面与健康契约）。
 - 浏览器桌面与 390px 移动视口验证无横向溢出，视角与引擎切换可用。
 - 五轮独立 Review 均已归档：前四轮发现的数据完整性、状态、日期真实性/顺序、测试时钟和前一根日期校验问题均已关闭；第五轮最终结论为 `Ready to merge: Yes`，无 Critical、Important 或 Minor 问题。
 - 开发 Schema 按用户确认跳过，沿用 `v0.0.10 captured_empty` 追溯边界，不读取生产库。
@@ -0,0 +1,26 @@
 # GitNexus 开发后基线
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
 Indexed: 8/18/2026, 9:13:11 PM
 Indexed commit: c2fdfa6
 Current commit: c2fdfa6
 Status: ✅ up-to-date
 ```
 ## Git 已跟踪变更摘要
 ```text
 AGENTS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 ```
 ## Git 工作区摘要
 ```text
 M AGENTS.md
 ```
 业务代码基线 `c2fdfa6` 已提交并推送；上述唯一工作区差异是 GitNexus 自动维护的入口说明，未纳入功能提交。
@@ -0,0 +1,31 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-MO-001
 - 记录时间：2026年08月18日 00:26:46 CST
 - 分支：main
 - 基线提交：`c0a6f5560584`
 - 创建方式：用户授权跳过 `v0.0.9` Schema 备份后，按 `governance:start` 输出结构手工留痕
 ## 工作区
 ```text
 (干净)
 ```
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed: 8/17/2026, 6:03:13 PM
 Indexed commit: c0a6f55
 Current commit: c0a6f55
 Status: up-to-date
 ```
 ## Schema 门禁例外
 失败证据、用户决定、禁止伪造边界和残余风险见 `../schema-baseline-waiver.md`。本记录不表示 `governance:start` 自动门禁通过。
 ## 后续人工分析
 首页设计确认后，在修改任何函数、类或方法前继续执行 GitNexus query、context 和 upstream impact，并将直接、间接、跨模块消费者及高风险处置补充到 `impact-plan.md`。
@@ -0,0 +1,16 @@
 # GitNexus 前后对比
 ## 开发前
 - 基线：`gitnexus/before.md`、`gitnexus/implementation-baseline.md`。
 - 目标是把模拟首屏改为 TDX 只读概览，并拆分五个 HTTP 模块接口。
 ## 开发后
 - CLI 已完成最终重新索引，保留 85 条执行流并识别本功能影响路径。
 - 宽范围修复曾识别 21 条概览执行流并标记 critical；最终相邻日期修复收敛为 3 条候选映射执行流并标记 medium。核心路径均有单测、HTTP/OpenAPI、前端状态、构建、视觉和 E2E 验证。
 - 未新增消息、数据库、Redis、Scheduler、Worker 或部署运行时依赖。
 ## 差异结论
 直接影响集中于 TDX API、市场概览服务、前端 API/页面和测试夹具；生产数据边界、基础设施暂不启用边界和回退路径保持不变。
@@ -0,0 +1,19 @@
 # GitNexus 开发后变更检测
 ## 检测命令
 ```text
 npx gitnexus analyze
 npx gitnexus detect-changes --repo "$PWD" --scope staged
 ```
 ## 结果
 - 索引：已完成最终增量更新。
 - 暂存文件：11 个文件、24 个符号；GitNexus 自动改写的 `AGENTS.md` 已明确排除。
 - 影响执行流：3 条，CLI 风险：medium。
 - 主要执行流：`Candidates → ToNumber`、`Candidates → ToTradeDate` 与 `Candidates → MapDirection`；本轮未修改服务状态策略或跨模块契约。
 ## 处置
 本轮 medium 来自指数/板块相邻日期比较的局部映射变更，不是未知跨业务扩散。已用 TDX 映射/服务测试、类型检查和 `git diff --check` 验证；前一提交已覆盖 HTTP/OpenAPI、前端状态、构建、浏览器视觉和 4/4 E2E，未发现用户、消息、数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境已使用 GitNexus MCP 与同版本 CLI 交叉确认，没有将工具限制误判为低风险。
@@ -0,0 +1,36 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-MO-001
 - 基线提交：`c0a6f5560584`
 - 当前阶段：TDX 直连首页实施，已完成开发前门禁和最小只读协议验证
 - 当前总体风险：LOW（新增边界尚未落地）；TDX 客户端、API、OpenAPI 和 Web 首屏实现后按符号补充
 ## 直接与间接影响
 ### TDX 双路径开发连接
 - 正式行情来源确定为 TDX；家庭局域网和外部 Tailscale 只改变 Mac 到同一 Windows `sshd` 的网络路径。
 - TDX Bridge 的稳定入口固定为 Mac 回环地址 `127.0.0.1:17710`，市场概览、规则分析、AI 分析和未来 HTTP 契约不得依赖家庭地址、Tailscale 地址或 TDX 原始字段。
 - 当前仓库尚无 TDX Provider 或市场概览运行时符号；本次将新增 API 业务模块、TDX 客户端、OpenAPI 契约和 Web 首屏。新增符号的直接调用链将在实现后重新索引并执行变更检测。
 - 首页业务设计确认后，必须对 `App.vue`、`createAppRouter`、后端模块装配、HTTP DTO 和新增市场概览符号分别执行 upstream impact。HIGH 或 CRITICAL 结果先告知用户再修改。
 ## 跨模块同步修改
 - HTTP/OpenAPI：本次新增版本化市场概览 DTO 和五个只读路径，并重新生成 OpenAPI 契约。
 - Web API 与 adapter：本次新增 `web/src/api/market-overview/index.ts`，页面只能经 Axios 封装和 ViewModel 消费数据。
 - 消息契约、Redis、MySQL、Scheduler、Worker：本次首屏不启用业务链路，仅保留既有架构边界；正式采集、快照持久化、缓存和异步分发仍按独立功能立项。
 - 配置部署：真实地址、用户名、密钥和控制套接字只保留在开发机，不进入仓库、环境模板或前端构建物。
 - 测试：两种 SSH 路径均需验证到同一 Mac 回环端点；离线样本只作显式开发回退，不得标记为实时 TDX。
 - 文档：同步更新 Tailscale/SSH 开发手册，明确家庭局域网与外部 Tailscale 的选择、启动、停止、切换和验证方法。
 ## 安全、性能与回退
 - Windows 的 TDX 继续只监听 `127.0.0.1:17709`，禁止改为局域网或公网监听。
 - 家庭 SSH 入站规则只允许家庭子网访问 TCP 22；系统原有全范围 OpenSSH 规则保持禁用。
 - 两条 SSH 路径复用同一项目专用 Ed25519 密钥；局域网主机密钥必须与已验证的 Tailscale 主机密钥指纹一致。
 - 家庭 LAN 与当前 Tailscale 直连延迟均足以满足开发期分钟级行情；首页不得承诺秒级刷新。
 - 回退时停止对应 SSH 控制连接、删除本机 TDX 别名，并删除 Windows 项目专用防火墙规则；不得删除通用 SSH 密钥、Tailscale 账户或 TDX 数据。
 ## Schema 例外风险
 `v0.0.9` Schema 基线缺失会阻断严格自动治理门禁，风险见 `../schema-baseline-waiver.md`。本功能不借该例外修改数据库结构、读取生产数据库或声称发布门禁通过。
@@ -0,0 +1,32 @@
 # FEAT-MO-001 实施前门禁基线
 - 功能编号：FEAT-MO-001
 - 分支：`codex/feat-mo-001-tdx-overview`
 - 基线提交：`d283ee319692d4550149c591d4fe7f522c0bc6b8`
 - 记录时间：2026-08-18 13:04 CST
 ## Schema
 - `pnpm schema:baseline`：通过，`v0.0.10 captured_empty`。
 - `pnpm schema:verify`：通过，`v0.0.10 captured_empty`。
 - 本次没有数据库结构变更，不读取生产数据库。
 ## GitNexus
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
 Indexed commit: d283ee3
 Current commit: d283ee3
 Status: up-to-date
 ```
 影响分析结果：
 - `ApiModule` upstream：LOW，直接消费者为 API `main.ts` 和进程冒烟测试。
 - `createAppRouter` upstream：LOW，无直接执行流消费者。
 - `createRequestClient` upstream：LOW，直接使用方为 Web API 健康请求模块。
 - `ApiModule.register` 复合名称未被 CLI 解析，已用 `ApiModule` 类上下文、`main.ts` 静态引用和 `register` 候选结果补齐证据；没有 HIGH/CRITICAL 结果。
 ## 工作区说明
 主工作区已有用户修改的 `AGENTS.md`，本功能分支不将其纳入提交。功能代码只在本隔离工作区开发。
@@ -1,8 +1,11 @@
 # 实施计划
-1. 初始化 Vue 3、Vite、TypeScript和 Dart Sass。
+1. ~~初始化 Vue 3、Vite、TypeScript 和 Dart Sass。~~ 已完成。
-2. 建立市场快照类型和确定性模拟数据。
+2. ~~建立 TDX 配置、Node fetch 客户端、DTO、映射和五个模块接口。~~ 已完成。
-3. 实现终端外壳、数据状态和结论区。
+3. ~~实现终端外壳、分模块加载状态和结论区。~~ 已完成。
-4. 实现指数、宽度、量能、板块、情绪与资金模块。
+4. ~~实现指数、宽度、板块和资金模块；不可用指标使用结构化状态。~~ 已完成。
-5. 实现分析偏好菜单和依据抽屉。
+5. ~~实现分析偏好菜单和本地持久化。~~ 已完成；依据抽屉和详情页入口延期至独立功能。
-6. 完成测试、构建、浏览器验证和视觉对比。
+6. ~~完成单元测试、类型检查、构建、接口冒烟、浏览器桌面/移动端视觉验证。~~ 已完成。
 7. ~~补齐 TDX 市场宽度、一级行业板块和成交额趋势映射。~~ 已确认官方接口和本机桥接可用；主力净流入与盘中新闻保留为补充源需求。
 8. 更新 DTO、OpenAPI 类型和前端组件，使真实数据状态、单位和 `unchanged=null` 口径可见。
 9. 完成 TDX 真实响应夹具、错误隔离、类型、构建和浏览器视觉验证；Review 后再收口功能档案。
@@ -1,12 +1,12 @@
 id: FEAT-MO-001
 name: 市场综合概览
 slug: market-overview
-status: approved
+status: in_review
 owner: project
 created_at: 2026-08-12
 requirements: requirements.md
 prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
-traceability_note: 开发尚未开始，GitNexus与QA证据将在开发门禁执行时创建
+traceability_note: 已完成 TDX 直连开发、GitNexus 前后分析、接口冒烟、桌面/移动端视觉验证、独立代码 Review 和规范 Review；开发完成门禁已通过，待合并发布
 release: unreleased
@@ -23,7 +23,7 @@
 ## 非目标
 - 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
- 本切片不接正式行情源、RocketMQ、MySQL、Redis和付费 AI。
+- 本切片直接接入已验证的 TDX 只读桥接层；不接入 RocketMQ、MySQL、Redis 和付费 AI。
 - 本切片不实现用户、邀请、会员、订阅和支付。
 - ETF监控、两融数据、大盘云图和实时消息仍是独立一级模块。
@@ -41,7 +41,7 @@
 | 编号 | 优先级 | 需求 | 可观察结果 |
 |---|---|---|---|
 | FR-001 | P0 | 结论优先展示市场定性 | 首屏顶部出现一句结论、市场状态、量能状态和情绪状态 |
-| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示至少三条驱动和三条风险证据 |
+| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示已由 TDX 支持的驱动和风险证据；缺少口径时明确标记 |
 | FR-003 | P0 | 展示数据新鲜度 | 页面显示交易状态、数据更新时间和正常/延迟/不完整状态 |
 | FR-004 | P0 | 提供分析偏好 | 可选择综合/短线/中长线和规则/AI/混合/对照，并在本地保存默认值 |
 | FR-005 | P1 | 展示市场证据模块 | 指数、宽度、量能、板块、情绪和资金摘要可阅读 |
@@ -50,10 +50,16 @@
 ## 数据与口径
-首个切片使用确定性模拟快照。字段仍必须包含交易日期、快照时间、来源状态、完整性和单位，以便以后无结构变更地替换为后端 API。
+首个切片由 Nest API 直接读取 TDX 只读桥接层。指数和摘要使用真实 TDX K 线映射；市场宽度使用三市场指数快照，板块使用一级行业目录与日行情，量能使用三市场指数成交额汇总。主力净流入和盘中新闻不在本切片 TDX 主链路中，必须保持明确的补充源边界，不得用指数或离线样本冒充。所有响应仍包含交易日期、快照时间、来源状态、完整性和单位。
 A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百分比。历史数据和低频资金数据必须显示实际数据日期，旧数据不得标记为实时。
 TDX 交易日期必须通过真实公历日期校验。成交额当前/前一日金额必须与同索引日期对齐，且前一交易日严格早于当前交易日；不满足条件的市场不参与汇总，也不得抢占最新日期截面。
 指数和板块涨跌幅必须同时具备有效且严格递增的相邻日期。前一根日期非法、重复或晚于当前日期时，指数只展示当前价而不生成涨跌信号，板块不进入强弱排序。
 首个切片不引入交易日历依赖：指数、一级行业和成交额的最新交易日期与 `Asia/Shanghai` 当前日历日期不同即标记 `delayed`；市场宽度快照缺少日期字段，使用同批核心指数日线作为日期参考。周末和法定休市日会保守显示延迟并同时展示实际交易日期，后续接入权威交易日历后再细化“最新交易日”语义。
 ## 状态与异常
 - 交易中：显示分钟级更新时间。
@@ -77,7 +83,7 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
 - Given 页面加载有效快照，When 用户进入市场概览，Then 结论、驱动、风险和更新时间在首屏可见。
 - Given 用户打开分析状态入口，When 切换周期或引擎，Then 页面状态立即更新且可选择设为默认。
 - Given 数据快照被标记为延迟，When 页面渲染，Then 最近有效值保留并明确显示延迟，不能显示“实时”。
- Given 用户点击查看依据，When 抽屉打开，Then 能看到指标名称、数值、口径和更新时间。
+- Given 用户看到查看依据入口，When 后续依据抽屉功能立项，Then 能看到指标名称、数值、口径和更新时间；本切片只保留入口。
 ## 风险与依赖
@@ -92,3 +98,5 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
 ## 变更记录
 - 0.1：建立首版 PRD，补充结论优先、分析偏好和异常状态。
 - 0.2：根据 TDX 实连验证修正数据源、可用性边界和未接入基础设施范围。
 - 0.3：核对官方行情接口后确认市场宽度、一级行业板块和成交额趋势可由 TDX 直接提供；主力净流入与盘中新闻保留补充源边界。
@@ -0,0 +1,19 @@
 # FEAT-MO-001 测试结果
 ## 自动化结果
 - 前端 Vitest：8 个文件、20 个测试通过。
 - 后端 Vitest：11 个文件、67 个测试通过；API 启动器 Node 测试 2/2 通过，Schema、治理、边界和部署门禁通过。
 - `pnpm verify:e2e`：桌面/移动端页面和健康契约共 4 个测试通过。
 - `pnpm typecheck`、`pnpm build`、`pnpm format:check`：通过。
 - ESLint：0 error，保留 35 条 Vue 风格 warning，不阻断门禁。
 ## 手工结果
 - `GET /api/v1/market-overview/indices` 和 `summary` 返回真实 TDX `fresh` 快照。
 - TDX 隧道未监听时，五个模块均返回明确不可用状态，未伪造指标；切换到家庭 LAN 隧道后，`summary`、`indices`、`breadth`、`sectors`、`funds` 均返回 `source=tdx,status=fresh`。
 - 家庭 LAN 真实冒烟中，指数返回 3 项、板块返回 8 项、成交额覆盖 3 个市场且交易日期完整；未保存真实价格或成交额数值。
 - 修复日期对齐和延迟状态后再次通过家庭 LAN 真实冒烟，五个接口在当日数据下仍为 `fresh` 且无 warning。
 - 第三轮 Review 修复后，非法月份/日期、倒序日期对和日期/金额数组错位均被映射层排除；服务测试统一冻结时钟，不依赖执行当天。
 - 第四轮 Review 修复后，指数前一根非法、重复或倒序日期不再生成涨跌幅，板块对应记录不进入强弱排序。
 - 桌面默认视口与 390px 移动视口无横向溢出；视角和引擎切换可用。
@@ -0,0 +1,20 @@
 # FEAT-MO-001 视觉 QA
 ## 验证范围
 - 桌面默认视口：顶部应用识别、结论区、驱动/风险、核心指数和不可用模块均可见。
 - 移动视口：390×844，首屏按单列排列，标题、状态、指数和模块说明不遮挡。
 ## 结果
 - 通过：2026-08-18 使用本地 API/Web 实际页面复验；桌面视口为 `1440×900`，移动视口为 `390×844`。
 - 通过：桌面 `clientWidth=1440, scrollWidth=1440`，移动端 `clientWidth=390, scrollWidth=390`；移动端六个主要区块左右边界均位于 `14px~376px`，未发生页面级或区块级横向溢出。
 - 通过：综合、短线、中长线切换和规则/AI/混合/对照选择有可见状态。
 - 通过：实际切换到“综合”和“混合”后，按钮激活态和下拉选中项同步更新。
 - 通过：家庭 LAN 隧道 `127.0.0.1:17710` 下完成真实 TDX 行情复验；摘要、3 个核心指数、市场宽度、8 个一级行业板块和 3 市成交额均显示 `source=tdx`、`status=fresh`，无模块警告。
 - 通过：桌面与移动端浏览器控制台均无 `warning` 或 `error`；移动端仅有 Vite 开发服务器连接调试信息。
 - 通过：真实行情移动端 `clientWidth=390, scrollWidth=390`，无页面级横向溢出、内部文字截断或控件重叠；长风险说明、指数数值、板块标签和成交额均完整展示。
 ## 残余项
 依据抽屉、指数/板块详情页和真实图表尚未立项，不作为本次首屏视觉验收项。真实 TDX 接口值、交易日期和模块状态的逐项证据见 `tdx-smoke-report.md`；本次视觉复验使用同一家庭 LAN 隧道和真实接口响应，不使用离线样本伪装实时行情。
@@ -0,0 +1,17 @@
 # FEAT-MO-001 发布说明
 ## 本次发布
 - 新增 TDX 直连的市场概览首屏和五个模块 API。
 - 支持综合、短线、中长线视角与规则、AI、混合、对照偏好选择。
 - 市场宽度、一级行业强弱和成交额趋势接入真实 TDX 数据，并对空数据、部分数据、日期不一致和延迟状态显示明确边界。
 - 指数和板块按最新交易日截面对齐，成交额按最新有效交易日期对汇总；后端根据上海当前日历日期实际生成 `delayed`，市场宽度使用同批核心指数日期参考。
 - 拒绝非法公历日期、倒序交易日期以及日期/金额数组错位的 TDX 数据，避免异常市场抢占最新截面或产生时间倒置的成交额趋势。
 - 指数和板块仅使用有效且严格递增的相邻 K 线日期计算涨跌，前一日期非法、重复或倒序时不生成市场强弱信号。
 - 明确显示 TDX 来源、快照时间、交易日期、市场覆盖数和模块级错误。
 ## 明确不包含
 - 不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
 - 不包含用户体系、详情页、依据抽屉、交易操作和荐股能力。
 - 不包含主力净流入、盘中新闻、真实图表和详情页；这些能力需另立补充数据源和功能需求。
@@ -2,4 +2,12 @@
 首屏为“市场概览”模块中的综合概览，采用结论优先。市场概览内部通过轻量分析状态入口切换综合、短线和中长线视角，并支持规则、AI、混合与对照分析。
-当前切片仅开发 Vue 3 可交互首屏和本地模拟数据，不接用户体系和正式数据链路。
+当前切片开发 Vue 3 可交互首屏，Nest API 通过 TDX 只读桥接层提供真实指数、市场宽度、板块和成交额趋势；主力净流入与盘中新闻不作为本次 TDX 主链路指标，不使用离线样本。不接用户体系，也不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
 ## 本次实际范围
 - 已完成综合、短线、中长线视角切换，以及规则、AI、混合、对照偏好选择；偏好只保存于浏览器本地。
 - 已完成按摘要、指数、宽度、板块、资金拆分的五个 HTTP 接口和前端 API 封装。
 - 已完成 TDX 请求超时、响应大小限制、错误脱敏和模块级失败隔离。
 - 已确认并接入 TDX 市场宽度、一级行业板块和成交额趋势；资金模块明确不等同于主力净流入，`unchanged` 无可靠总数时返回 `null`。
 - 详情页和“查看依据”抽屉只保留入口，另立需求实现，不在本次发布范围内。
@@ -0,0 +1,86 @@
 # 代码 Review
 ## 首轮独立 Review
 - 对比基线：`8261948`
 - 审查提交：`ff8ada8`
 - 结论：`Ready to merge: No`
 首轮发现及处置：
 1. 畸形 `UpHome/DownHome` 被折算为零并误标 `fresh`：改为有限、非负且成对校验，无效市场整体排除并按有效市场数返回 `fresh/partial/unavailable`。
 2. 成交额缺市场或交易日错位仍误标三市实时数据：只汇总非负金额和一致交易日，公开 `marketCount`、`tradeDate`、`previousTradeDate`，缺市场返回 `partial`。
 3. 空板块目录误标 `fresh`：一级行业为空时直接返回 `unavailable`，且只保留存在相邻两日收盘价和有效涨跌幅的板块。
 4. 前端隐藏 `partial/delayed` 警告：宽度、板块和成交额面板均展示非 `fresh` 状态提示，并展示板块与成交额真实交易日期。
 5. PRD、发布说明和 Review 文档残留旧口径：已同步更正为真实 TDX 宽度、一级行业与成交额趋势口径，主力净流入和新闻仍明确延期。
 6. 异常分支测试不足：新增畸形宽度、部分市场、错位交易日、空行业目录、额外字段隔离、前端状态提示和零变化中性色回归测试。
 次要问题也已同步处理：OpenAPI `required + nullable` 定义、板块 DTO 额外 `price` 字段泄露、成交额零变化上涨色和新增映射中文口径注释。
 ## 范围
 覆盖 TDX 客户端、市场概览后端模块、OpenAPI/前端契约、Axios API 封装、Vue 首屏组件和对应测试。
 ## 检查结果
 - 通过：API 按模块拆分，前端请求集中在 `web/src/api/market-overview/index.ts`，Vue 不直连 TDX。
 - 通过：真实指数和摘要字段经过 DTO/映射；桥接层未提供的方法返回结构化 `unavailable`，没有模拟数据冒充。
 - 通过：模块并行加载且独立处理异常；TDX 请求有固定回环地址、超时、响应大小限制和错误脱敏。
 - 通过：未将密码、令牌、行情原始载荷或生产数据写入代码、文档和日志。
 - 通过：E2E 测试夹具显式声明回环 TDX 配置但不要求 TDX 可达，避免测试环境绕过正式配置校验。
 ## 安全与残余风险
 - TDX 只读边界固定为回环地址，客户端限制超时和响应大小并脱敏异常；未接入交易、AI 密钥、数据库写入或生产数据。
 - 残余风险是 TDX 桥接方法覆盖不全、市场数据授权和生产 7×24 稳定性尚未验证，已在需求和回退说明中标明。
 ## GitNexus 与同步修改
 开发前已保存 GitNexus 影响计划。早期提交曾映射 11 条执行流并标记 high；`49f6be9` 修复提交的 staged 检测映射 20 个文件、67 个符号、16 条执行流并标记 critical。critical 来自市场概览核心服务、TDX 映射和前端数据面板，不是未知跨业务扩散；未发现数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境未暴露 GitNexus MCP 变更检测工具，已使用同版本 CLI 和 worktree 绝对路径保留证据。
 ## 性能与资源影响
 - 五个模块并行请求，单请求超时并限制 1 MiB 响应；市场宽度并行增加一次单指数、单日线日期参考请求，不引入 MySQL、Redis、RocketMQ 在线负载。
 - 未进行 7×24、断线重连和生产压测；主力净流入、盘中新闻、权威交易日历及详情页仍待独立功能。
 - ESLint 对 Vue 单文件组件仅保留 35 条既有风格 warning，无 error；格式、类型和构建门禁均通过。
 ## 二次独立 Review
 - 审查范围：`ff8ada8..49f6be9`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：宽度仍接受小数/十六进制等非计数值；成交额以首个市场日期为锚；板块跨交易日混排仍标 `fresh`；后端没有真实 `delayed` 路径。
 - Minor：GitNexus 风险/执行流和 TDX 已接入范围存在旧口径。
 上述问题已按 TDD 增加失败用例后修复：宽度只接受十进制非负安全整数；指数/板块只保留最新交易日；成交额选择最新有效日期对；四个后端日行情路径均具备 `delayed` 判定，宽度使用同批指数日期参考。修复后等待再次独立 Review。
 ## 第三轮独立 Review
 - 审查范围：`49f6be9..7e4dcd9`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：8 位数字日期未验证真实公历语义，成交额未强制前一交易日早于当前日且未验证日期/金额数组对齐；服务测试固定使用 `20260818` 行情却没有统一冻结系统时间，会在自然日期变化后失败。
 - Minor：开发总结未包含 `7e4dcd9`，GitNexus 仍保留上一轮 16 条执行流口径。
 处置：按 TDD 先得到 3 个预期失败，再增加真实公历日期、日期顺序和数组对齐校验；服务测试套件统一冻结上海日期，并由单个延迟用例显式切换。修复后后端 Vitest `63/63`、启动器 `2/2` 和类型检查通过，等待再次独立 Review。
 ## 第四轮独立 Review
 - 审查范围：`49f6be9..ae2a7e0`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：指数和板块只校验当前 K 线日期，前一根日期非法、重复或倒序时仍计算涨跌；最终治理材料仍处于 `pending`，尚未执行 `governance:finish`。
 - Minor：无新增。
 处置：按 TDD 先得到 4 个预期失败，再要求前一日期有效且严格早于当前日期；无可比前收盘时指数保留当前价但不生成涨跌，板块不进入强弱排序。后端 Vitest 增加至 `67/67`。治理状态保持 `pending` 是有意的门禁顺序：需本修复再次独立 Review 通过后，才能合法写入 `passed` 并运行 `governance:finish`。
 ## 第五轮最终独立 Review
 - 审查范围：`ae2a7e0..c2fdfa6`
 - 结论：`Ready to merge: Yes`
 - Critical：无。
 - Important：无；上一轮指数/板块前一根 K 线日期校验问题已关闭。
 - Minor：无。
 - 验证：指数非法、重复、倒序前一日期参数化用例和板块过滤用例齐全；后端 Vitest `67/67`、启动器 `2/2`、服务端类型检查与 `git diff --check` 均通过。安全、性能及 PRD/设计/测试/QA 口径一致。
 最终结论：passed
@@ -0,0 +1,29 @@
 # 开发规范符合性 Review
 ## 安全、性能与架构检查
 - 已建立并更新 PRD、需求、设计、实施计划、测试计划、开发总结和 Review 文档。
 - 已记录安全策略、性能目标、GitNexus 影响、验证证据、范围变化和残余风险。
 - 后端按业务模块组织并使用 DTO/映射；前端请求通过统一 Axios 封装，业务 API 独立存放。
 - 代码注释集中在配置边界、异常恢复和偏好存储等非显然逻辑，没有逐行噪声注释。
 - 未启用 MySQL、Redis、RocketMQ；本切片没有伪造基础设施已接入，也没有触碰生产数据库。
 - Git 提交和推送将在 Review 通过后按中文 Conventional Commit 执行；不修改 Git 全局配置。
 ## GitNexus 与开发总结检查
 - 开发前影响计划、开发后索引、变更检测和风险处置已归档。
 - 开发总结记录原始需求、范围变化、实际完成、修复缺陷、延期项、提交和验证证据。
 - QA、发布说明和回退说明与本功能档案保持同一功能编号。
 ## 首轮问题同步检查
 - 数据完整性、状态语义、OpenAPI nullable、DTO 输出边界和前端降级提示均已补齐回归测试。
 - PRD、发布说明、测试计划和开发总结已同步实际口径，避免实现与文档分叉。
 - 浏览器复验覆盖桌面与 `390×844` 移动视口；当前 TDX 隧道未监听时只确认结构化降级，历史真实行情冒烟证据保持独立。
 - 二次独立 Review 发现的严格整数、日期对齐和真实 `delayed` 语义已按 TDD 修复；后端新增 9 个断言并完成家庭 LAN 当日行情复验。
 - 新鲜度暂按上海当前日历日期保守判断，周末和法定休市日可能显示 `delayed`；该残余边界已同步 PRD、设计和测试计划，不伪装成交易日历已接入。
 - 第三轮 Review 的日期真实性、先后顺序、数组对齐和测试时钟问题已按 TDD 修复；需求、设计、测试计划、测试结果、发布说明和开发总结已同步。
 - 第四轮 Review 的前一根日期校验问题已按 TDD 修复；治理结论继续保持 `pending`，等待本次代码修复再次独立确认。
 - 第五轮最终独立 Review 无 Critical、Important 或 Minor 问题并给出 `Ready to merge: Yes`；中文提交、Gitea 推送、GitNexus、完整门禁和视觉证据均已复核。
 最终结论：passed
@@ -0,0 +1,17 @@
 # FEAT-MO-001 回退说明
 ## 触发条件
 - TDX 请求错误导致核心指数无法展示或页面加载阻断。
 - 发现前端横向溢出、来源状态误标为实时，或不可用指标被伪造。
 - 生产部署验证发现配置边界、权限或错误脱敏回归。
 ## 操作
 1. 停止当前 API/Web systemd 服务，保留日志和失败快照摘要，不保存原始行情载荷。
 2. 回退到上一个已推送的 Gitea 提交/标签，重新执行源码构建和 `pnpm verify:source`。
 3. 恢复 TDX 桥接隧道后只做只读接口冒烟；确认通过前不得重新对外开放。
 ## 数据边界
 本功能没有写入 MySQL、Redis 或 RocketMQ，也没有数据库迁移；回退不执行生产数据库操作。开发 Schema 继续遵循仅读取开发库的门禁。
@@ -0,0 +1,23 @@
 # v0.0.9 Schema 基线一次性例外
 - 功能编号：FEAT-MO-001
 - 日期：2026-08-18
 - 适用范围：仅 FEAT-MO-001 开发启动
 ## 事实记录
 按常规流程执行 `npm run schema:baseline` 时，本机因不存在 MySQL 5.7.x 的 `mysql` 与 `mysqldump` 客户端，在执行 `mysql --version` 前以 `spawnSync mysql ENOENT` 失败。失败发生在客户端前置检查阶段，未连接开发数据库，也未生成基线目录或半成品。
 用户确认本次继续跳过数据库备份。该决定只适用于从已发布版本 `v0.0.9` 启动 FEAT-MO-001，不继承 GOV-011 对 `v0.0.8` 的一次性例外，也不建立通用跳过能力。
 ## 处理决定
 - 不伪造 `not_applicable`、`captured_empty`、空 SQL、客户端版本、服务端版本或校验摘要。
 - 不修改 Schema 工具或 `governance:start` 增加跳过参数。
 - 手工保存与 `governance:start` 同等结构的 GitNexus 开发前基线和影响计划。
 - FEAT-MO-001 不得因此连接、探测或读取生产数据库。
 - 后续功能需要 Schema 基线时，仍必须提供可验证的 MySQL 5.7.x 客户端，或再次获得用户针对该版本的明确授权。
 ## 风险与接受
 缺少 `v0.0.9` Schema 基线意味着仓库不能证明该发布版本对应的开发库结构，也会使依赖严格 Schema 证据的自动治理门禁无法通过。用户接受本次追溯风险；该例外不表示数据库门禁、发布门禁或未来数据库变更已经通过。
@@ -0,0 +1,34 @@
 # FEAT-MO-001 TDX 只读冒烟报告
 - 验证时间：2026-08-18 17:21 CST
 - 网络场景：本机回环桥接（TDX 服务可达）
 - 本机业务入口：`127.0.0.1:17710`
 - API 入口：`127.0.0.1:3000/api/v1/market-overview`
 - 请求方式：HTTP GET（业务 API）及桥接层 HTTP POST JSON
 - 请求类型：市场宽度、一级行业板块、成交额趋势只读请求
 - 原始载荷：未保存
 ## 结果
 - 三条业务接口均返回 HTTP `200`，响应状态均为 `fresh`，`source` 均为 `tdx`。
 - `/breadth`：成功汇总上证、深证和北证指数快照中的 `UpHome`、`DownHome`；`unchanged` 返回 `null`，未进行总数推算。
 - `/sectors`：成功读取一级行业目录并批量获取日行情，按涨跌幅排序返回前 8 项。
 - `/funds`：成功汇总三个交易所指数日行情 `Amount`，按万元转换为亿元并计算较前一交易日变化；该指标展示为“成交额趋势”，不宣称主力净流入。
 - 端到端耗时：市场宽度约 `0.11s`，一级行业约 `0.27s`，成交额趋势约 `0.12s`（单次本机冒烟，不代表生产 SLA）。
 - 未调用交易、账户、自选、写入接口；未保存真实行情原始载荷。
 ## 家庭 LAN 二次复验
 - 验证时间：2026-08-18 19:35 CST。
 - 先按开发手册切换到家庭 LAN SSH 别名，确认本机 `127.0.0.1:17710` 的监听者为本次 SSH 隧道；平台配置仍只使用回环地址。
 - 桥接层最小只读 HTTP POST 成功，没有调用交易、账户、自选或写入方法。
 - Nest API 的 `/summary`、`/indices`、`/breadth`、`/sectors`、`/funds` 均返回 HTTP `200`、`source=tdx`、`status=fresh` 且无 warning。
 - `/indices` 返回 3 项，`/sectors` 返回 8 项；`/breadth` 返回有限且非负的涨跌家数；`/funds` 返回 `marketCount=3`，当前和上一交易日期均存在且不同。
 - 本次只记录结构、状态、数量和日期完整性，不记录真实价格、成交额数值、家庭网络地址、SSH 用户或原始响应。
 - 完成严格整数、最新交易日截面和后端 `delayed` 修复后再次复验：五个接口在当日行情下仍为 `fresh` 且无 warning，证明新增新鲜度判断未误伤当前日期数据。
 ## 脱敏与限制
 - 报告不保存真实价格、成交量、家庭网络地址、Tailscale 地址、SSH 用户、密钥或完整响应。
 - 本报告只证明当前开发机到 TDX 的只读接口和本次映射可达，不证明 7×24 生产采集、商业再分发授权、主力净流入口径或盘中新闻接口已经可用。
 - 主力净流入和盘中新闻继续保留为补充数据源需求；后续接入必须单独记录来源、权限、口径和数据质量。
@@ -3,6 +3,36 @@
 - 结论、驱动和风险在首屏可见。
 - 分析状态可以临时切换并保存默认值。
 - 依据抽屉能够打开和关闭。
- 时间范围切换更新图表。
+- 五个模块并行请求，一个模块失败不阻断其他模块。
 - 真实 TDX 指数、市场宽度、一级行业板块和成交额趋势响应可映射；主力净流入与盘中新闻不以占位值伪造。
 - 加载、部分数据、过期和错误状态具有明确文案。
 - 桌面和窄窗口不出现阻断核心内容的溢出。
 ## 已执行证据
 - 前端 Vitest、typecheck、build：通过。
 - 后端 TDX 客户端、映射、服务、HTTP/OpenAPI 测试：通过。
 - `curl` 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；分别验证 `UpHome/DownHome` 汇总、一级行业排序和成交额单位转换。
 - 异常映射：覆盖畸形涨跌家数字段（小数、指数、十六进制和超出安全整数）、当前及前一根非法公历日期、相邻日期重复/倒序、空一级行业目录、单根板块 K 线、指数/板块混合交易日、成交额缺市场/交易日倒序/日期金额数组错位/负数/首市场落后，以及三市完整性状态。
 - 后端状态：覆盖指数、市场宽度、一级行业和成交额旧交易日期的真实 `delayed` 分支；休市日保守延迟属于已记录边界。
 - 测试时钟：市场概览服务套件统一冻结到上海 `2026-08-18`，单个 `delayed` 用例显式切换目标日期并在用例后恢复，保证测试不会随自然日期变化。
 - 前端状态：覆盖宽度、板块和成交额模块的 `partial`/`delayed` 警告、真实交易日期和成交额零变化中性色。
 - 浏览器验证：桌面默认视口和 390px 移动视口无横向溢出；综合/短线切换和分析引擎选择可用。
 ## 安全、性能与残余风险
 - 安全：TDX 地址固定为本机回环桥接端口；请求超时、响应 1 MiB 上限、错误脱敏；只读行情，不接受用户输入拼接请求。
 - 性能：五个模块并行请求，单次 TDX 请求受超时保护；本切片不引入数据库、缓存或消息负载，未进行持续压测。
 - 残余风险：主力净流入字段当前桥接实测为零值，需权限和口径专项验证；盘中新闻仍需补充源；详情页、依据抽屉和 AI 运行时需另立功能；市场数据授权和生产 7×24 稳定性未由本地冒烟证明。
 ## 安全验证
 - 验证 TDX 只能使用回环地址和固定端口，错误响应不包含原始 URL、请求体或凭据。
 - 验证前端只能通过统一 Axios API 文件访问后端，边界测试拒绝页面直连 Axios/fetch 和 Server 内部依赖。
 - 验证 E2E 夹具使用无秘密的生产测试环境变量，不读取仓库内本地凭据或生产配置。
 ## 性能验证
 - 验证五个模块并发加载、单模块失败隔离和请求超时行为。
 - 验证响应体 1 MiB 上限和构建产物体积；浏览器桌面/移动端无横向溢出。
 - 7×24 运行、峰值并发、TDX 断线重连和消息/缓存压力测试不适用于当前只读首屏，已列为后续采集与生产功能边界。
@@ -0,0 +1,74 @@
 # Node 与 MySQL 系列版本约束设计
 - 功能编号：GOV-011
 - 设计状态：已获用户方向确认，等待书面规格复核
 - 日期：2026-08-17
 ## 设计决策
 采用真实系列校验，而不是只改文案或增加最低补丁版本：Node.js 通过语义版本解析后要求 `major === 22`；MySQL 客户端、mysqldump 和服务端要求版本字符串满足 `5.7.<非负整数>`，允许 `-log` 等既有后缀。用户已明确选择完整 5.7.x，不设置 5.7.9 等最低补丁版本。
 历史 QA、Schema manifest 和已发布功能档案中的 5.7.42、22.11.0、22.22.0 是真实验证事实，不改写。只有当前生效的代码注释、错误提示、架构规范和部署前置条件统一改为系列口径。
 ## 代码边界
 ### Node.js
 `tools/runtime/verify-runtime.mjs` 已经只校验 Node 主版本 22，不需要修改生产判断。测试补充 22 系列内边界以及 21/23 拒绝，注释和当前文档明确写成 22.x。pnpm 继续按 10.x 校验，不属于本次变化。
 ### Schema 工具
 `assertMysql57Metadata` 继续作为唯一 Schema 版本判断入口，但服务端正则从精确 5.7.42 收敛为与两个客户端相同的 5.7.x 规则。历史真实/captured_empty manifest 仍保存实际版本并由同一入口验证；不改 manifest 格式，不重写历史目录。
 ### API 健康检查
 `MysqlHealthClient.check` 接受 5.7.x，继续逐项校验目标库、`utf8mb4`、`utf8mb4_general_ci` 和 `+08:00`。成功详情使用查询返回的实际版本，例如 `MySQL 5.7.41 / a_share_analysis_dev / +08:00`；失败提示统一为“需要 MySQL 5.7.x”。
 ### 配置与 TypeORM
 `MysqlRuntimeConfig` 和 `buildTypeOrmOptions` 没有版本字段或版本分支，只需把说明性注释由 5.7.42 修正为 5.7.x。连接选项、`synchronize: false`、迁移策略和字符规则保持不变。
 ## GitNexus 影响
 - `assertMysql57Metadata`：CRITICAL，5 个直接调用方、10 个受影响符号和 5 组流程，覆盖 captured/captured_empty 产物、历史目录验证、当前发布基线、基线生成和 `governance:start`。
 - `MysqlHealthClient`：LOW，4 个直接依赖、7 个受影响符号和 1 组 API 装配流程。
 - `assertSupportedRuntime`：LOW，只有运行时测试直接调用，0 条业务流程。
 CRITICAL 来自 Schema 门禁的中心位置，不代表改动复杂。实施必须先增加精确失败用例，再完整回归 Schema 28 项及治理前后门禁；如出现历史 manifest 失效或非 5.7 版本被放行，立即停止并回退。
 ## 跨模块同步修改
 - HTTP/OpenAPI：响应结构不变，仅健康 `detail` 文本显示实际版本；无需重新定义 DTO。
 - Web API：不修改请求函数或 adapter；现有健康展示把 detail 当普通文本。
 - 消息、Redis、Scheduler、Worker：无行为变化。
 - 数据库：不修改 Schema、迁移、查询范围或凭据，只放宽补丁版本判断。
 - 部署：继续仅支持 Ubuntu 源码部署，前置条件改写为 Node.js 22.x、MySQL 5.7.x。
 - 测试与文档：运行时、Schema、健康客户端、架构规范、开发规范、本地和生产部署手册同步更新。
 ## 错误处理
 - 版本为空、格式异常或系列不符时立即失败，并只输出检测到的版本字符串。
 - 版本符合 5.7.x 但字符集、排序规则、库名或时区不符时，保持现有专用错误，不把问题误报为版本错误。
 - 不捕获或降级版本错误，不因个人部署场景跳过生产启动校验。
 ## 安全策略与评估
 资产和信任边界不变：Node 版本来自本机运行时；MySQL 版本来自客户端 `--version` 和只读元数据查询。固定正则只接受数字版本与既有后缀，不执行输入。数据库凭据继续由忽略的本地 env 或生产 EnvironmentFile 注入，错误和健康详情不输出账号、密码或地址。
 残余风险是 MySQL 5.7 不同补丁可能存在已知缺陷；用户已明确接受系列级约束，项目不承诺补丁级兼容矩阵。字符规则、SQL 5.7 能力上限和迁移测试继续作为实际兼容门禁。
 ## 性能目标与评估
 版本判断是启动或治理阶段的常数时间字符串匹配，健康检查仍只执行一次既有元数据查询。无新增网络调用、重试、数据库扫描、缓存操作或消息流，因此无需负载测试；目标是全量验证前后构建体积和运行流程不变。
 ## 测试设计
 1. RED：新增 Schema 用例要求 5.7.41 通过，确认当前精确 5.7.42 实现失败。
 2. GREEN：服务端版本改为 5.7.x 后，验证 5.7.0、5.7.41、5.7.42-log 通过，5.6.51 与 8.0.40 拒绝。
 3. RED/GREEN：健康客户端先新增 5.7.41 成功详情断言，再修改实现；保留 8.0 拒绝和字符/排序规则/时区失败用例。
 4. Node：补充 22.0.0、22.x 高补丁和 21/23 边界，验证现有实现无需行为变更。
 5. 回归：运行 runtime、Schema、MySQL 规范、Server、全量 `pnpm verify:release` 和两个 Review 门禁。
 ## 回退
 若系列校验导致历史基线失效或错误放行非 5.7 服务端，以新的中文回退提交恢复精确判断并同步恢复当前文档；禁止改写已推送历史。功能不涉及数据库结构或数据，因此无数据回滚。
@@ -0,0 +1,62 @@
 # GOV-011 开发总结
 - 功能编号：GOV-011
 - 日期：2026-08-17
 - 当前状态：已随 v0.0.9 发布
 ## 原始开发需求
 用户要求 Node.js 和 MySQL 不绑定具体小版本：Node.js 使用 22.x，MySQL 使用完整 5.7.x，不设置最低补丁版本。`utf8mb4`、`utf8mb4_general_ci` 和东八区时区等既有严格约束继续保留；历史证据中的实际版本不得改写。
 ## 需求与范围变化
 - Node 生产判断原本已经按主版本 22 校验，本次只补充系列内/外特征测试，没有改写生产逻辑。
 - MySQL 服务端从精确 5.7.42 调整为合法 5.7.x，客户端和 mysqldump 原有 5.7.x 约束保持不变。
 - 健康详情从硬编码 patch 改为服务端元数据中的三段版本；`-log` 等附加文本不回显。
 - 现行架构、开发规范、本地/Ubuntu 部署手册统一为系列口径；v0.0.8 CHANGELOG、历史 QA、Schema manifest 和已发布档案继续保存真实 5.7.42、22.11.0、22.22.0。
 - 用户确认当前开发库无业务结构并授权本次跳过 v0.0.8 Schema 备份。该决定只形成 GOV-011 一次性例外，不增加通用跳过开关。
 ## 实际完成需求
 | 需求 | 状态 | 实际结果 |
 |---|---|---|
 | Node.js 22.x 系列约束 | 已完成 | 覆盖 22.0.0、常规 22.x、带后缀 22.x 与 21/23 边界；生产判断保持 `major === 22`。 |
 | MySQL 服务端完整 5.7.x | 已完成 | Schema 元数据接受 5.7.0、5.7.41、5.7.42-log，拒绝 5.6、8.0 和无效格式。 |
 | 健康检查实际版本 | 已完成 | `5.7.41-log` 返回 `MySQL 5.7.41 / ...`；DTO 与查询结构不变。 |
 | 字符规则和时区保持严格 | 已完成 | `utf8mb4`、`utf8mb4_general_ci`、库名和 `+08:00` 失败用例全部保留并扩充。 |
 | 当前规范统一系列口径 | 已完成 | 架构、开发规范、本地开发、Ubuntu 生产和说明性代码注释已更新。 |
 | 历史证据保持原样 | 已完成 | 未批量改写历史功能档案、QA、Schema 基线或 v0.0.8 发布事实。 |
 ## 修复缺陷
 - 修复 Schema 服务端校验把开发机实际 5.7.42 当作唯一合法 patch 的约束错误。
 - 修复 API 健康检查拒绝其他合法 5.7.x 且成功详情硬编码 5.7.42 的问题。
 - 修复当前架构、开发规范和部署手册将补丁版本误写成跨环境强制基线的问题。
 - 完整 Schema 回归发现一处测试仍断言旧错误文案，已同步为 `5.7.x` 并重新验证。
 ## 未完成与延期项
 - 本功能没有数据库结构、迁移或数据变更，因此不存在数据回滚或真实 Schema 导出结果。
 - v0.0.8 Schema 基线没有生成。`verify:release`、`schema:verify` 和 `governance:finish` 会在该缺失条件失败；这是用户已接受的追溯风险，不代表其他测试通过，也不会延伸到后续功能。
 - 不建立 MySQL 各 patch 的自动兼容矩阵；未来遇到特定补丁缺陷时通过独立功能或 ADR 决定是否提高最低版本。
 ## 关键提交
 | 提交 | 中文摘要 | 推送状态 |
 |---|---|---|
 | `426870b` | `docs(GOV-011): 制定运行时系列版本实施计划` | 已推送 Gitea |
 | `c8277ef` | `test(GOV-011): 补充 Node 22 系列边界验证` | 已推送 Gitea |
 | `54499f0` | `fix(GOV-011): 放宽 MySQL 服务端为完整 5.7 系列` | 已推送 Gitea |
 | `dc8da80` | `fix(GOV-011): 支持 MySQL 5.7 系列健康检查` | 已推送 Gitea |
 | `cce77aa` | `docs(GOV-011): 统一运行时系列版本口径` | 已推送 Gitea |
 | `7478a96` | `docs(GOV-011): 完成系列版本验证与审查` | 已推送 Gitea |
 | `88e2fdf` | `chore(GOV-011): 发布 v0.0.9 系列版本约束` | 已推送 Gitea，`v0.0.9` 指向该提交 |
 ## 验证证据
 - TDD：Schema 的 5.7.0/5.7.41 成功用例先被旧精确判断拒绝；健康检查的 5.7.41-log 用例先被旧实现拒绝，随后最小修改转绿。
 - 排除已授权严格发布基线用例后，Schema 28/28；runtime 3/3、governance 10/10、MySQL 2/2、环境 10/10、契约 3/3、边界 16/16、部署 6/6、Web 11/11、Server 30/30、API 预检 2/2。
 - lint、格式、类型检查、OpenAPI 契约、Web/Server 构建、Playwright 4/4 和源码发布验证通过。
 - GitNexus 相对 v0.0.8 检测为 23 个文件、70 个符号、11 条受影响流程、HIGH；运行流仅落在既定 Schema 与健康检查边界，详见 `gitnexus/`。
 - 依赖审计为 0 已知漏洞，Redis 返回 `PONG`；两张视觉截图无溢出或控制台错误。
 - Gitea `refs/heads/main` 与发布提交 `88e2fdffc8c71dd682405c148a81953a8dcee9d6` 一致；带注释标签对象为 `4d1553b68587a6218416bf0279494d720bb37161`，解引用后指向同一发布提交。
@@ -0,0 +1,17 @@
 # GitNexus 开发后基线
 - 索引提交：`88e2fdf`
 - 索引时间：2026-08-17 17:58（Asia/Shanghai）
 - 状态：up-to-date
 - 节点：2090
 - 关系：2767
 - 集群：49
 - 执行流：50
 ## 工作区状态
 实现、验证和发布提交均已推送 `origin/main`，`v0.0.9` 已精确推送并指向 `88e2fdf`。本次索引刷新只自动更新 `AGENTS.md` 计数，随后与发布引用一起进入追溯提交。
 ## 运行边界
 开发后新增或变化的运行流程仍只有 Schema 治理和 API 健康装配。Web 页面、Scheduler、Worker、Redis 与 RocketMQ 没有新增执行流。
@@ -0,0 +1,29 @@
 # GitNexus 开发前基线
 - 功能编号：GOV-011
 - 记录时间：2026年08月17日 16:57:31 CST
 - 分支：main
 - 基线提交：`9e858090966e`
 - 创建方式：用户授权跳过 v0.0.8 Schema 备份后，按 `governance:start` 输出结构手工留痕
 ## 工作区
 ```text
 (干净)
 ```
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed commit: 9e85809
 Current commit: 9e85809
 Status: up-to-date
 Nodes: 1,957
 Edges: 2,634
 Flows: 50
 ```
 ## Schema 门禁例外
 未运行成功的原因、用户决定、禁止伪造边界和残余风险见 `../schema-baseline-waiver.md`。本记录不表示 `governance:start` 自动门禁通过。
@@ -0,0 +1,29 @@
 # GitNexus 前后对比
 - before：1894 个符号、2569 条关系、50 条流程（GOV-011 启动记录）
 - after：2090 个节点、2767 条关系、50 条流程（`88e2fdf`）
 - 相对 v0.0.8 detect-changes：23 个文件、70 个符号、11 条受影响流程、HIGH
 ## 差异解释
 节点与关系增长主要来自 GOV-011 新增功能档案、实施计划、测试名称和当前规范标题。执行流总数仍为 50，没有出现新的生产流程。HIGH 风险由 Schema 中心函数的多条既有调用链贡献，和开发前 CRITICAL 评估方向一致。
 ## 跨模块核对
 | 模块 | 结论 |
 |---|---|
 | HTTP/OpenAPI | DTO 和字段不变；健康 `detail` 文本显示实际 patch。 |
 | Web API | 请求函数、adapter 和页面均未修改。 |
 | 消息 | RocketMQ 契约、Topic、Group 和 Adapter 未修改。 |
 | 数据库 | 不改 Schema、迁移、数据和查询范围；只放宽版本判断。 |
 | Redis | 无代码和配置变化。 |
 | API | MySQL 健康版本判断和详情变化，完整 Server 回归通过。 |
 | Scheduler | 无行为变化，构建和进程测试通过。 |
 | Worker | 无行为变化，构建和进程测试通过。 |
 | 部署 | 拓扑不变，只把前置 MySQL 文案改为 5.7.x。 |
 | 测试 | 新增系列边界、实际版本详情和当前文档契约。 |
 | 文档 | 架构、规范、部署和功能档案同步更新；历史证据保留。 |
 ## 风险结论
 没有发现计划外模块影响。残余风险是不同 MySQL 5.7 patch 自身可能存在缺陷，以及 v0.0.8 缺少可验证 Schema 基线；前者由真实迁移/查询验证控制，后者由用户接受的一次性例外记录控制。
@@ -0,0 +1,34 @@
 # GitNexus 实际变更检测
 - 比较基线：`v0.0.8` / `9e85809`
 - 实现提交：`cce77aa`
 - 结果：23 个文件、70 个符号、11 条受影响流程
 - 风险：HIGH
 ## 变更符号
 核心运行时符号为：
 - `assertMysql57Metadata`
 - `runBaselineGeneration`
 - `MysqlHealthClient`
 - `MysqlHealthClient.check`
 - `createMysqlHealthClient`
 - `assertSupportedRuntime` 只新增测试，没有生产实现变化
 其余符号主要来自架构、规范、部署和 GOV-011 功能档案的 Markdown 标题，以及治理测试中的局部变量。
 ## 受影响执行流
 - `RunBaselineGeneration → RequireExactValue`
 - `AssertCurrentReleasedBaselinePublished → RequireExactValue`
 - `BuildCapturedArtifacts → RequireExactValue`
 - `AssertCurrentReleasedBaseline → RequireExactValue`
 - `RunCommandLine` 到 `RequireExactValue`、`IsEnabled`、`ParseManifest`、`AssertExactFileSet`、`BuildManifest` 和 `ParseEnvironmentFile`
 - `UseFactory → MysqlHealthClient`
 HIGH 来自 Schema 中心入口映射到多条治理流程，不是新增网络、数据库写入或消息链路。排除用户已授权的 v0.0.8 基线缺失用例后，Schema 28 项全部通过；API 健康、Server 测试、类型和构建也全部通过。
 ## 范围结论
 实际变化与开发前影响计划一致。没有新的 HTTP 字段、OpenAPI DTO、Web API、Redis、RocketMQ、Scheduler、Worker、数据库 Schema 或部署拓扑变化。
@@ -0,0 +1,39 @@
 # GitNexus 开发前影响计划
 - 功能编号：GOV-011
 - 基线提交：`9e858090966e`
 - 总体风险：CRITICAL（Schema 门禁中心符号）
 ## 直接与间接影响
 ### `assertMysql57Metadata`
 - 风险：CRITICAL。
 - 直接调用方：5 个，包括 Schema 测试、captured、captured_empty、历史目录验证和基线生成。
 - 间接影响：10 个符号、5 组流程；深度 2 包含当前发布基线验证和远程发布核对，深度 3 到达 `governance:start`。
 - 控制：测试先行，系列内/外边界、历史 manifest、当前发布门禁和生成路径完整回归。
 ### `MysqlHealthClient`
 - 风险：LOW。
 - 直接依赖：4 个；总计 7 个受影响符号、1 组 API 装配流程。
 - 控制：健康客户端测试覆盖实际版本详情、8.x 拒绝和字符/时区边界，API DTO 不变。
 ### `assertSupportedRuntime`
 - 风险：LOW。
 - 只有运行时测试 1 个直接调用者，0 条业务流程；现有实现已按主版本 22 校验。
 - 控制：只补系列边界测试和现行文档，不改变生产判断。
 ## 跨模块同步修改
 - HTTP/OpenAPI：结构不变，健康 detail 文本显示实际 5.7.x；不改 DTO。
 - Web API：无需修改，现有 adapter 透传 detail。
 - 消息、Redis、Scheduler、Worker：无影响。
 - 数据库：只调整版本判断，不改 Schema、迁移、查询或数据。
 - 配置部署：注释和前置条件改为 Node.js 22.x、MySQL 5.7.x；源码部署方式不变。
 - 测试文档：runtime、Schema、健康客户端、MySQL 规范、架构、开发规范和部署手册同步修改；历史已发布事实不改写。
 ## 高风险处置
 若 Schema 历史清单验证失败、5.6/8.x 被放行、字符规则校验被绕过或 `governance:start` 相关回归失败，立即停止实施并恢复到基线提交的行为。提交前必须执行 GitNexus detect-changes 并确认实际执行流未超出本计划。
@@ -0,0 +1,521 @@
 # GOV-011 Node 与 MySQL 系列版本约束实施计划
 > **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` (recommended) or `superpowers:executing-plans` to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
 **Goal:** 将当前生效的运行时约束统一为 Node.js 22.x 与完整 MySQL 5.7.x，同时保留数据库字符规则、时区、安全边界和历史版本证据。
 **Architecture:** Node.js 继续由现有语义版本解析器按主版本判断，只补充特征测试。Schema 工具和 API 健康检查分别在既有职责边界内识别 MySQL 5.7.x，不新增共享版本工具，避免在只有两个简单且上下文不同的判断点时提前抽象；健康详情从服务端返回值提取实际三段版本。现行架构、开发规范和部署文档同步采用系列口径，历史 QA、Schema 清单和已发布档案保持原样。
 **Tech Stack:** Node.js 22.x、pnpm 10.25.0、Node.js 内置测试运行器、TypeScript 5.9.3、Vitest 3.2.7、NestJS 11、mysql2 3.23.3、MySQL 5.7.x、GitNexus、Git/Gitea。
 ## Global Constraints
 - Node.js 接受格式合法的 22.x，拒绝 21.x、23.x 和无效版本；pnpm 继续使用既有 10.x 门禁。
 - MySQL 客户端、mysqldump 客户端、服务端和健康检查接受完整 5.7.x，不设置最低 patch，不接受 5.6.x、8.x 或 MariaDB。
 - 数据库字符集固定 `utf8mb4`，排序规则固定 `utf8mb4_general_ci`，会话时区固定 `+08:00`。
 - Schema 基线只允许 `APP_ENV=development`、数据库 `a_share_analysis_dev` 和代码内固定开发主机白名单；禁止连接、探测或读取生产数据库。
 - 不修改数据库 Schema、迁移、数据、连接账号、网络、HTTP DTO、OpenAPI 字段、Web API、Redis、RocketMQ、Scheduler 或 Worker 行为。
 - 历史 QA、Schema manifest 和已发布功能档案中的 `5.7.42`、`22.11.0`、`22.22.0` 是实际证据，不得批量改写。
 - 版本判断使用固定格式匹配，不执行版本字符串，不拼接 SQL，不把连接地址、账号或密码写入错误和健康详情。
 - 不新增依赖；关键版本口径、安全边界和架构取舍使用准确中文注释，不做逐行翻译式注释。
 - 每个行为修改遵循 RED-GREEN：先证明旧精确补丁判断失败，再写最小实现并执行局部与完整回归。
 - 修改关键符号前复核既有 GitNexus impact；提交前执行 GitNexus detect-changes，确认影响没有超出已批准范围。
 - 每个提交使用中文 Conventional Commit 并带 `GOV-011`，验证后立即推送当前分支到项目 Gitea，禁止强推。
 - v0.0.8 Schema 基线按 `schema-baseline-waiver.md` 执行一次性例外：不得伪造 N/A、空库清单或空 SQL，也不得修改治理工具增加通用跳过能力。
 ---
 ### Task 1: 锁定 Node.js 22.x 现有行为
 **Files:**
 - Modify: `tools/runtime/verify-runtime.test.mjs`
 **Interfaces:**
 - Consumes: `assertSupportedRuntime({ nodeVersion, pnpmVersion })`。
 - Produces: Node.js 22 系列内边界、相邻主版本和无效格式的特征测试。
 - Preserves: `tools/runtime/verify-runtime.mjs` 的生产判断和 pnpm 10.x 约束。
 - [ ] **Step 1: 补充 Node.js 系列边界测试**
 将现有 Node 成功样本扩展为系列内多个版本，并把相邻失败样本明确为 21.x 与 23.x：
 ```js
 test('接受完整 Node.js 22.x 并拒绝相邻主版本', () => {
  for (const nodeVersion of ['22.0.0', '22.11.0', '22.99.123-beta.1+build.7']) {
    assert.doesNotThrow(() =>
      assertSupportedRuntime({ nodeVersion, pnpmVersion: '10.25.0' }),
    );
  }
  for (const nodeVersion of ['21.7.3', '23.0.0']) {
    assert.throws(
      () => assertSupportedRuntime({ nodeVersion, pnpmVersion: '10.25.0' }),
      /Node\.js 必须为 22\.x/,
    );
  }
 });
 ```
 保留 `v22`、空字符串、非数字 pnpm 等既有无效格式测试，不改变 `parseVersion` 的输入格式契约。
 - [ ] **Step 2: 运行特征测试并确认现有实现已满足**
 Run: `pnpm test:runtime`
 Expected: PASS。该任务是对已存在的 22.x 行为补证，不修改生产代码，也不制造无意义的 RED。
 - [ ] **Step 3: 提交并推送 Node 特征测试**
 ```bash
 git add tools/runtime/verify-runtime.test.mjs
 git commit -m "test(GOV-011): 补充 Node 22 系列边界验证"
 git push origin main
 ```
 Expected: 推送成功，本地 `HEAD` 与 Gitea `refs/heads/main` 一致。
 ---
 ### Task 2: 让 Schema 元数据接受完整 MySQL 5.7.x
 **Files:**
 - Modify: `tools/database/schema-baseline.test.mjs`
 - Modify: `tools/database/schema-baseline.mjs`
 **Interfaces:**
 - Consumes: `assertMysql57Metadata(metadata)` 及既有 `MysqlMetadata` 形状。
 - Produces: 客户端、mysqldump 和服务端统一的 `5.7.<非负整数>` 系列判断。
 - Preserves: `databaseCharset === 'utf8mb4'`、`databaseCollation === 'utf8mb4_general_ci'`、历史 manifest 格式和所有 Schema 安全门禁。
 - [ ] **Step 1: 写入服务端 5.7.x 失败测试**
 把现有“5.7.41 必须失败”改成系列内成功断言，并补齐最低 patch、后缀及上下系列边界：
 ```js
 test('接受完整 MySQL 5.7.x 并保持固定数据库字符规则', () => {
  for (const serverVersion of ['5.7.0', '5.7.41', '5.7.42-log']) {
    assert.doesNotThrow(() => assertMysql57Metadata({ ...validMetadata, serverVersion }));
  }
  for (const serverVersion of ['5.6.51', '8.0.40', '5.7', '5.7.x', '']) {
    assert.throws(
      () => assertMysql57Metadata({ ...validMetadata, serverVersion }),
      /MySQL 服务端必须为 5\.7\.x/,
    );
  }
  assert.throws(
    () => assertMysql57Metadata({ ...validMetadata, mysqlClientVersion: '8.0.40' }),
    /mysql 客户端必须为 5\.7\.x/,
  );
  assert.throws(
    () => assertMysql57Metadata({ ...validMetadata, databaseCollation: 'utf8mb4_bin' }),
    /utf8mb4_general_ci/,
  );
 });
 ```
 - [ ] **Step 2: 运行定向测试并确认 RED**
 Run: `node --test --test-name-pattern='完整 MySQL 5.7.x' tools/database/schema-baseline.test.mjs`
 Expected: FAIL，`5.7.0` 或 `5.7.41` 被当前精确 `5.7.42` 服务端判断拒绝；失败原因不得来自测试语法或夹具。
 - [ ] **Step 3: 最小修改服务端系列判断**
 将 `assertMysql57Metadata` 中服务端判断改为与两个客户端相同的系列格式，并更新注释与错误信息：
 ```js
 /**
 * mysql、mysqldump 与服务端统一接受完整 5.7.x；字符集和排序规则仍按精确值校验，
 * 避免放宽 patch 版本时意外放宽数据库结构兼容边界。
 */
 export function assertMysql57Metadata(metadata) {
  // 两个既有客户端判断保持不变。
  if (!/^5\.7\.\d+(?:[-+].*)?$/.test(metadata.serverVersion ?? '')) {
    throw new Error(`MySQL 服务端必须为 5.7.x，实际 ${metadata.serverVersion || '(空)'}`);
  }
  // 既有字符集和排序规则精确校验保持不变。
 }
 ```
 实际编辑只替换服务端正则、对应注释和错误文案，不复制或重排函数内其他校验。
 - [ ] **Step 4: 运行 Schema 局部与完整回归**
 Run: `node --test --test-name-pattern='完整 MySQL 5.7.x' tools/database/schema-baseline.test.mjs`
 Expected: PASS。
 Run: `pnpm test:schema-baseline && pnpm test:mysql-baseline && pnpm test:governance`
 Expected: PASS。历史 `captured`、`captured_empty`、N/A、当前发布门禁、生成入口和远程核对测试均无回归；测试不得访问真实数据库。
 - [ ] **Step 5: 提交并推送 Schema 系列判断**
 在提交前执行 GitNexus detect-changes，确认只影响已记录的 Schema 生成、验证和治理调用链，然后：
 ```bash
 git add tools/database/schema-baseline.mjs tools/database/schema-baseline.test.mjs
 git commit -m "fix(GOV-011): 放宽 MySQL 服务端为完整 5.7 系列"
 git push origin main
 ```
 Expected: 推送成功且没有新增 Schema 文件或数据库连接副作用。
 ---
 ### Task 3: 健康检查返回实际 MySQL 5.7.x 版本
 **Files:**
 - Modify: `server/libs/infrastructure/src/health-clients.test.ts`
 - Modify: `server/libs/infrastructure/src/mysql-health.client.ts`
 **Interfaces:**
 - Consumes: `MysqlHealthClient.check(): Promise<DependencyHealthDto>` 与 `MYSQL_HEALTH_QUERY`。
 - Produces: 5.7.x 成功结果 `MySQL <实际三段版本> / <database> / +08:00`。
 - Preserves: `DependencyHealthDto` 结构、只读元数据查询、数据库名、字符集、排序规则、时区校验和最多两个连接的池配置。
 - [ ] **Step 1: 写入健康检查 5.7.41 失败测试**
 将成功夹具改为 `5.7.41-log`，断言详情来自返回值；移除“5.7.41 必须失败”的旧断言，增加 5.6 与 8.0 边界：
 ```ts
 await expect(client.check()).resolves.toEqual({
  status: 'healthy',
  detail: 'MySQL 5.7.41 / a_share_analysis_dev / +08:00',
 });
 for (const version of ['5.6.51', '8.0.40', '5.7', '5.7.x']) {
  await expect(createClient({ version }).check()).rejects.toThrow(/MySQL 5\.7\.x/);
 }
 ```
 保留库名、`utf8mb4`、`utf8mb4_general_ci` 和 `+08:00` 漂移失败断言；如当前测试缺少字符集或时区样本，在同一测试中分别补入：
 ```ts
 await expect(createClient({ charset: 'utf8' }).check()).rejects.toThrow(/utf8mb4/);
 await expect(createClient({ timezone: 'SYSTEM' }).check()).rejects.toThrow(/\+08:00/);
 ```
 - [ ] **Step 2: 运行定向测试并确认 RED**
 Run: `pnpm --filter @a-share-analysis/server exec vitest run libs/infrastructure/src/health-clients.test.ts`
 Expected: FAIL，当前实现拒绝 `5.7.41-log` 或仍返回硬编码的 `MySQL 5.7.42`。
 - [ ] **Step 3: 最小实现系列判断和实际版本详情**
 在 `MysqlHealthClient.check` 中只解析一次版本，并使用捕获到的三段版本构造安全详情：
 ```ts
 const versionMatch = /^(5\.7\.\d+)(?:[-+].*)?$/.exec(row.version);
 if (!versionMatch) {
  throw new Error('MySQL 5.7.x 版本要求未满足');
 }
 return {
  status: 'healthy',
  detail: `MySQL ${versionMatch[1]} / ${row.databaseName} / ${row.timezone}`,
 };
 ```
 这里不回显 `-log` 等服务端后缀，避免把厂商或构建附加文本直接带到用户界面；显示的三段版本仍来自服务端元数据，不再硬编码 patch。
 同步把健康池注释中的 `5.7.42` 改为 `5.7.x`，连接参数不变。
 - [ ] **Step 4: 运行后端局部与完整回归**
 Run: `pnpm --filter @a-share-analysis/server exec vitest run libs/infrastructure/src/health-clients.test.ts`
 Expected: PASS。
 Run: `pnpm --filter @a-share-analysis/server test && pnpm --filter @a-share-analysis/server typecheck && pnpm --filter @a-share-analysis/server build`
 Expected: PASS；OpenAPI DTO 和生成文件无变化。
 - [ ] **Step 5: 提交并推送健康检查变化**
 在提交前执行 GitNexus detect-changes，确认影响仅进入 API 健康装配流程，然后：
 ```bash
 git add server/libs/infrastructure/src/mysql-health.client.ts server/libs/infrastructure/src/health-clients.test.ts
 git commit -m "fix(GOV-011): 支持 MySQL 5.7 系列健康检查"
 git push origin main
 ```
 Expected: 推送成功，健康响应结构没有契约漂移。
 ---
 ### Task 4: 统一现行代码注释与规范部署口径
 **Files:**
 - Modify: `tools/governance/environment-baseline.test.mjs`
 - Modify: `server/libs/config/src/runtime-config.ts`
 - Modify: `server/libs/infrastructure/src/typeorm-options.ts`
 - Modify: `docs/architecture/system-architecture.md`
 - Modify: `docs/governance/code-development-standards.md`
 - Modify: `docs/deployment/local-development.md`
 - Modify: `docs/deployment/ubuntu-source-production.md`
 **Interfaces:**
 - Consumes: GOV-011 已确认的现行版本文字边界。
 - Produces: 可机器验证的 Node.js 22.x / MySQL 5.7.x 当前规范。
 - Preserves: pnpm 10.25.0、Ubuntu 源码部署、systemd、Nginx、Redis、RocketMQ 和环境变量模板。
 - [ ] **Step 1: 先把文档契约测试改为系列口径**
 将环境基线测试的现行文档检查从精确 `5.7.42` 改为 `5.7.x`，并显式拒绝当前文档继续写死 patch：
 ```js
 for (const document of [local, source]) {
  assert.match(document, /MySQL 5\.7\.x/);
  assert.doesNotMatch(document, /MySQL 5\.7\.42/);
 }
 ```
 再读取系统架构和代码开发规范，执行相同断言；测试只扫描这四份当前生效文档，不扫描 `docs/features/`、`database/schema-baselines/` 或历史 QA。
 - [ ] **Step 2: 运行环境契约并确认 RED**
 Run: `pnpm test:environment-baseline`
 Expected: FAIL，现行文档仍包含 `MySQL 5.7.42`。
 - [ ] **Step 3: 更新代码说明性注释**
 把以下当前注释统一为 `MySQL 5.7.x`：
 - `MysqlRuntimeConfig` 的兼容口径说明。
 - `buildTypeOrmOptions` 的 MySQL 基线说明。
 - `createMysqlHealthClient` 的会话时区说明。
 - `assertMysql57Metadata` 的客户端/服务端系列说明。
 不修改类型字段、连接选项、`synchronize: false`、迁移配置或配置解析行为。
 - [ ] **Step 4: 更新四份当前生效文档**
 逐项修改：
 - 系统架构：开发、测试和生产统一使用 MySQL 5.7.x，禁止 5.6、8.x、MariaDB 代替验证；不再禁止其他 5.7 patch。
 - 代码开发规范：Node.js 22.x 和 MySQL 5.7.x 是系列约束；字符集、排序规则和时区仍为精确值。
 - 本地开发：外部 MySQL 使用 5.7.x，固定开发库与主机白名单不变。
 - Ubuntu 生产：管理员提供 Node.js 22.x 与外部 MySQL 5.7.x，项目仍只验证、不安装基础设施。
 历史功能档案、QA、Schema manifest 和既有版本记录不修改。
 - [ ] **Step 5: 运行文档契约与格式验证**
 Run: `pnpm test:environment-baseline && pnpm test:deployment && pnpm format:check`
 Expected: PASS。
 Run: `rg -n "MySQL 5\.7\.42" docs/architecture docs/governance docs/deployment server/libs tools/database/schema-baseline.mjs`
 Expected: 当前生效代码和文档无精确 `MySQL 5.7.42` 口径；若命中测试夹具中的真实输入版本，只核对其用途，不改写真实样本。
 - [ ] **Step 6: 提交并推送规范同步**
 ```bash
 git add tools/governance/environment-baseline.test.mjs \
  server/libs/config/src/runtime-config.ts \
  server/libs/infrastructure/src/typeorm-options.ts \
  server/libs/infrastructure/src/mysql-health.client.ts \
  tools/database/schema-baseline.mjs \
  docs/architecture/system-architecture.md \
  docs/governance/code-development-standards.md \
  docs/deployment/local-development.md \
  docs/deployment/ubuntu-source-production.md
 git commit -m "docs(GOV-011): 统一运行时系列版本口径"
 git push origin main
 ```
 Expected: 推送成功；`git diff --name-only` 不包含任何历史功能档案或 Schema 基线文件。
 ---
 ### Task 5: 补齐功能档案和全量验证证据
 **Files:**
 - Create: `docs/features/GOV-011-runtime-version-series/test-plan.md`
 - Create: `docs/features/GOV-011-runtime-version-series/development-summary.md`
 - Create: `docs/features/GOV-011-runtime-version-series/gitnexus/detected-changes.md`
 - Create: `docs/features/GOV-011-runtime-version-series/gitnexus/after.md`
 - Create: `docs/features/GOV-011-runtime-version-series/gitnexus/comparison.md`
 - Create: `docs/features/GOV-011-runtime-version-series/qa/test-results.md`
 - Create: `docs/features/GOV-011-runtime-version-series/qa/visual-qa.md`
 - Create: `docs/features/GOV-011-runtime-version-series/review/code-review.md`
 - Create: `docs/features/GOV-011-runtime-version-series/review/standards-review.md`
 - Create: `docs/features/GOV-011-runtime-version-series/release-notes.md`
 - Create: `docs/features/GOV-011-runtime-version-series/rollback.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/manifest.yaml`
 **Interfaces:**
 - Consumes: Tasks 1-4 的测试结果、提交 SHA、GitNexus before/impact 与一次性 Schema 例外。
 - Produces: `governance:finish` 所需的完整、可审查功能档案。
 - [ ] **Step 1: 编写测试计划和开发总结骨架**
 `test-plan.md` 必须明确列出：
 - Node 22.0.0、其他 22.x、21.x、23.x 和无效格式。
 - MySQL 5.7.0、5.7.41、5.7.42-log、5.6.51、8.0.40 和无效格式。
 - 字符集、排序规则、库名、时区与固定开发安全边界回归。
 - HTTP/OpenAPI 无结构变化验证；消息、Redis、Scheduler、Worker 不受影响的边界验证。
 - 安全验证：无生产数据库访问、无凭据泄漏、固定格式匹配、依赖未变化。
 - 性能验证：无新增查询/任务/重试，版本匹配为常数时间；无需负载测试的原因和边界。
 - 全量 `pnpm verify:release`、桌面/移动视觉回归及源码部署验证。
 `development-summary.md` 必须用七个固定二级标题记录原始开发需求、范围变化、实际完成需求、修复缺陷、未完成与延期项、关键提交和验证证据；“没有数据库变更”必须写明原因与边界，不能只写“不适用”。
 - [ ] **Step 2: 执行局部和全量验证**
 依次运行并把命令、退出码、关键计数和日期保存到 `qa/test-results.md`：
 ```bash
 pnpm test:runtime
 pnpm test:schema-baseline
 pnpm --filter @a-share-analysis/server exec vitest run libs/infrastructure/src/health-clients.test.ts
 pnpm test:environment-baseline
 pnpm check:contracts
 pnpm lint
 pnpm format:check
 pnpm typecheck
 pnpm test
 pnpm build
 pnpm verify:e2e
 pnpm verify:release
 git diff --check
 ```
 Expected: 除 `pnpm verify:release` 因已授权的 v0.0.8 Schema 基线缺失而失败外，其余命令 PASS；`pnpm check:contracts` 执行后 OpenAPI 和 Web 生成类型没有非预期差异。必须继续手工执行 `verify:release` 在 Schema 失败点之后的构建、E2E 和源码发布门禁。
 - [ ] **Step 3: 完成视觉验证**
 启动 Web/API 的本地开发服务，复用既有 Playwright 桌面与移动视口检查首页健康展示及控制台；GOV-011 不改变页面布局，`qa/visual-qa.md` 仍须保存运行命令、视口、截图路径、控制台结果和“不发生视觉变化”的证据。服务结束后确认没有遗留进程。
 - [ ] **Step 4: 执行 GitNexus 开发后检测与比较**
 先执行 GitNexus detect-changes，保存受影响符号、执行流和风险到 `gitnexus/detected-changes.md`；再运行：
 ```bash
 npx gitnexus analyze
 npx gitnexus status
 ```
 将开发后节点、关系、流程、工作区摘要写入 `gitnexus/after.md`，把 before/after 差异和以下逐项结论写入 `gitnexus/comparison.md`：HTTP/OpenAPI、Web API、消息、数据库、Redis、API、Scheduler、Worker、部署、测试、文档。若出现计划外 HIGH/CRITICAL 风险或新的执行流，停止发布并回到影响分析。
 - [ ] **Step 5: 记录 Schema 例外门禁证据**
 运行：
 ```bash
 pnpm schema:verify
 pnpm governance:finish GOV-011 runtime-version-series
 ```
 Expected: 两者均因 `database/schema-baselines/v0.0.8` 缺失而失败。把完整错误摘要和退出码写入 `qa/test-results.md`，并引用 `schema-baseline-waiver.md`；不得把预期失败写成通过，也不得生成伪造基线。
 随后手工执行 `governance:finish` 在 Schema 失败前要求的治理、MySQL、环境和 Schema 测试，并人工核对全部必备档案、证据章节和 Review 末行。该一次性例外只替代 v0.0.8 基线存在性，不替代任何测试、GitNexus、Review、提交或推送门禁。
 - [ ] **Step 6: 完成两类 Review**
 `review/code-review.md` 先列发现，按严重度记录文件/行、影响和处置；必须包含“安全与残余风险”“性能与资源影响”“GitNexus 与同步修改”。`review/standards-review.md` 逐项核对注释、职责拆分、TDD、规范、历史证据、中文提交、Gitea 推送和一次性例外边界；必须包含“安全、性能与架构检查”“GitNexus 与开发总结检查”。
 只有所有重要问题关闭后，两份报告最后一个非空行才写：
 ```text
 最终结论：passed
 ```
 - [ ] **Step 7: 提交并推送完整验证档案**
 ```bash
 git add docs/features/GOV-011-runtime-version-series
 git commit -m "docs(GOV-011): 完成系列版本验证与审查"
 git push origin main
 ```
 Expected: 推送成功，远程包含完整功能档案；提交前 GitNexus detect-changes 已保存且实际范围与影响计划一致。
 ---
 ### Task 6: 发布 v0.0.9 并封存追溯状态
 **Files:**
 - Modify: `VERSION`
 - Modify: `CHANGELOG.md`
 - Modify: `docs/index.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/manifest.yaml`
 - Modify: `docs/features/GOV-011-runtime-version-series/development-summary.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/release-notes.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/qa/test-results.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/review/code-review.md`
 - Modify: `docs/features/GOV-011-runtime-version-series/review/standards-review.md`
 **Interfaces:**
 - Consumes: 已通过的代码、测试、Review、GitNexus 证据与用户确认的一次性 Schema 例外。
 - Produces: 发布提交、Gitea `main` 与带注释标签 `v0.0.9`。
 - [ ] **Step 1: 更新版本和发布文档**
 将 `VERSION` 更新为 `0.0.9`；`CHANGELOG.md` 和 `docs/index.md` 记录 GOV-011 的实际完成范围、Schema 一次性例外和历史证据不改写原则。`manifest.yaml` 更新为 `status: released`、`release: v0.0.9`，并补齐实施计划、测试、开发总结、GitNexus、Review 文件引用。
 - [ ] **Step 2: 执行发布前最终验证**
 Run: `pnpm verify:release`
 Expected: 因已授权的一次性例外，在 v0.0.8 Schema 严格发布基线检查处失败；失败点之前的门禁和手工补跑的后续构建、E2E、源码发布验证必须全部通过，且真实结果写入 QA。
 Run: `git diff --check && git status --short && git log -1 --oneline`
 Expected: 只有预期发布文档变更，格式无错误；提交前再次执行 GitNexus detect-changes。
 按 Task 5 重跑 `pnpm schema:verify` 和 `pnpm governance:finish GOV-011 runtime-version-series`，Expected 仍是已记录的一次性例外失败；确认没有新增或变化的失败原因。
 - [ ] **Step 3: 创建并推送发布封存提交**
 ```bash
 git add VERSION CHANGELOG.md docs/index.md docs/features/GOV-011-runtime-version-series
 git commit -m "chore(GOV-011): 发布 v0.0.9 系列版本约束"
 git push origin main
 ```
 Expected: 推送成功，本地 `HEAD`、`origin/main` 和 Gitea `refs/heads/main` SHA 一致。
 - [ ] **Step 4: 创建并精确推送标签**
 ```bash
 git tag -a v0.0.9 -m "发布 v0.0.9：统一 Node 与 MySQL 系列版本约束"
 git push origin refs/tags/v0.0.9
 ```
 Expected: Gitea `refs/tags/v0.0.9^{}` 指向发布封存提交；不使用 `git push --tags`，不覆盖未知远程标签。
 - [ ] **Step 5: 最终核对并封存实际 SHA**
 将最终分支提交和标签 SHA 回填到 `development-summary.md` 与 `qa/test-results.md` 时，使用新的中文文档提交并立即推送；如回填会使标签不再指向最终文档提交，则明确记录“标签指向发布封存提交、追溯回填位于后续文档提交”，不得移动已推送标签。
 ---
 ## 计划自审
 - 规格覆盖：FR-001 至 FR-005、全部验收标准、安全、性能、历史证据和一次性 Schema 例外均有对应任务。
 - 影响覆盖：`assertMysql57Metadata` 的 CRITICAL 调用链由 Task 2 完整回归；`MysqlHealthClient` 与 `assertSupportedRuntime` 分别由 Task 3 和 Task 1 覆盖。
 - 类型一致性：计划只消费既有 `assertSupportedRuntime`、`assertMysql57Metadata`、`MysqlHealthClient.check` 和 `DependencyHealthDto`，没有新增跨任务接口或命名漂移。
 - 范围控制：不新增依赖、不改 DTO/生成契约、不改数据库结构、不接触生产数据库、不批量改写历史证据。
 - 占位符检查：未发现待补内容、跨任务省略引用或无验证方式的实现步骤；每个代码行为都有精确测试命令和预期结果。
 - 回退可行：功能只修改判断、详情文字、注释和文档；出现历史基线失效或错误放行时，可用中文回退提交恢复基线行为，不需要数据回滚。
@@ -0,0 +1,21 @@
 id: GOV-011
 name: Node 与 MySQL 系列版本约束
 slug: runtime-version-series
 status: released
 owner: project
 created_at: 2026-08-17
 prd: prd.md
 requirements: requirements.md
 design: design.md
 implementation_plan: implementation-plan.md
 test_plan: test-plan.md
 development_summary: development-summary.md
 schema_baseline_waiver: schema-baseline-waiver.md
 gitnexus_before: gitnexus/before.md
 gitnexus_impact: gitnexus/impact-plan.md
 gitnexus_detected_changes: gitnexus/detected-changes.md
 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.9
@@ -0,0 +1,33 @@
 # Node 与 MySQL 系列版本约束 PRD
 - 功能编号：GOV-011
 - 状态：设计复核
 - 日期：2026-08-17
 ## 背景
 项目目标基线一直是 Node.js 22.x 与 MySQL 5.7.x，但部分实现、错误提示和现行规范把实际开发环境的 MySQL 5.7.42 写成了唯一允许的补丁版本。Node 运行时已经按 22 主版本校验，只是历史验证记录会显示实际使用的 22.11.0 或 22.22.0。用户明确说明本项目主要由本人部署，不需要锁定某个补丁版本，希望现行口径统一为系列版本。
 ## 目标
 - Node.js 接受全部格式合法的 22.x，拒绝其他主版本。
 - MySQL 客户端、mysqldump、服务端和运行时健康检查接受全部格式合法的 5.7.x，拒绝 5.6.x、8.x 及其他系列。
 - 字符集 `utf8mb4`、排序规则 `utf8mb4_general_ci`、会话时区 `+08:00`、固定开发库和主机白名单继续严格校验。
 - 健康结果展示服务端返回的实际版本，不再硬编码 5.7.42。
 - 当前规范统一使用系列口径，历史 QA、Schema 清单和已发布档案继续保留当时真实补丁版本。
 ## 非目标
 - 不升级 Node、MySQL、pnpm、数据库驱动或 ORM。
 - 不修改数据库结构、数据、账号、网络或部署方式。
 - 不支持 Node 23、MySQL 8.x、MariaDB 或其他“兼容 MySQL”数据库。
 - 不为各补丁版本建立兼容矩阵或自动安装运行时。
 ## 验收标准
 1. Node 22.0.0、22.11.0 和带预发布/构建后缀的合法 22.x 版本通过；21.x、23.x 和无效格式拒绝。
 2. MySQL 5.7.0、5.7.41、5.7.42-log 等合法 5.7.x 通过；5.6.x、8.0.x 和无效格式拒绝。
 3. MySQL 5.7.x 即使版本通过，字符集、排序规则、库名或时区错误仍拒绝。
 4. 既有 v0.0.5 至 v0.0.7 Schema 历史清单继续验证，不被改写。
 5. 健康详情包含实际服务端版本；不泄漏连接地址、账号或密码。
 6. 全量测试、构建、Playwright、源码发布门禁和两类 Review 通过。
@@ -0,0 +1,71 @@
 # GOV-011 测试与质量证据
 - 验证提交：`cce77aa`
 - 验证日期：2026-08-17
 - 运行时：Node.js 22.11.0、pnpm 10.25.0
 ## RED-GREEN 证据
 | 行为 | RED | GREEN |
 |---|---|---|
 | Schema 接受完整 5.7.x | `5.7.0` 被旧实现以“必须为 5.7.42”拒绝 | 系列内/外定向测试 2/2 通过 |
 | 健康检查接受 5.7.41-log | 旧实现拒绝并输出 5.7.42 文案 | 健康客户端 5/5 通过，详情为 `MySQL 5.7.41 / ...` |
 | 当前文档采用系列口径 | 架构/规范 0/2，部署文档测试 9/10 | MySQL 2/2、环境 10/10、部署 6/6 |
 ## 自动化验证
 | 命令或测试组 | 结果 | 关键证据 |
 |---|---|---|
 | `pnpm check:runtime` | passed | Node.js 22.11.0、pnpm 10.25.0 |
 | `pnpm check:contracts` | passed | OpenAPI 与 Web 生成类型无漂移，项目边界通过 |
 | `pnpm lint` | passed | Web/Server ESLint 无错误 |
 | `pnpm format:check` | passed | 全仓 Prettier 通过 |
 | `pnpm typecheck` | passed | Web、Vite 和 Server TypeScript 通过 |
 | runtime | 3/3 | 22.x 系列与相邻主版本 |
 | governance | 10/10 | 功能档案和 Review 门禁 |
 | MySQL 规范 | 2/2 | 当前架构/规范使用 5.7.x |
 | 环境 | 10/10 | 部署手册使用 5.7.x，其他环境边界保持 |
 | Schema（跳过严格发布基线） | 28/28 | 生成、验证、历史 manifest 和字符规则回归 |
 | contracts | 3/3 | 生成契约跟踪与漂移阻断 |
 | boundaries | 16/16 | 前后端与 HTTP 边界 |
 | deployment | 6/6 | 唯一 Ubuntu 源码发布边界 |
 | Web | 11/11 | 请求、adapter 与外壳 |
 | Server | 30/30 | API、配置、基础设施和进程 |
 | API 预检 | 2/2 | Redis 可达/不可达分支 |
 | `pnpm build` | passed | Web、API、Scheduler、Worker 构建成功 |
 | `pnpm verify:e2e` | 4/4 | Chromium 桌面/移动页面和健康 API |
 | `pnpm verify:source` | passed | 构建产物、systemd、Nginx 一致 |
 ## 一次性例外失败证据
 `pnpm verify:release` 退出码非 0。它依次通过 runtime、契约、lint、格式、类型以及 Schema 之前的测试，随后在 Schema 第 28 个严格发布基线用例失败；实际错误为缺少 `database/schema-baselines/v0.0.8`。Schema 总计 29 项，其中 28 项通过、1 项为该已知失败。
 `pnpm schema:verify` 在直接目录校验处失败；`pnpm governance:finish GOV-011 runtime-version-series` 在其前置 `test:schema-baseline` 的严格发布基线用例处失败。两者根因都是同一个 v0.0.8 目录缺失条件。原因、用户授权和禁止伪造边界见 `schema-baseline-waiver.md`；其余等价门禁已逐项执行并保存上表证据。
 ## 安全证据
 - `pnpm audit --prod --registry=https://registry.npmjs.org/`：`No known vulnerabilities found`。
 - `redis-cli -h 127.0.0.1 -p 6379 ping`：`PONG`，只验证本机开发 Redis。
 - 构建产物扫描只命中 `MYSQL_PASSWORD`、`AI_API_KEY` 等配置键和必填错误文案，没有真实值、连接串或 Authorization 头。
 - 本次没有新增依赖、SQL、命令执行、数据库写入、生产连接或外部网络请求。
 - 健康详情只返回三段版本、库名和时区，不返回原始后缀、地址、账号或密码。
 ## 性能证据
 - Web JS：163908 字节；CSS：805 字节，与 v0.0.8 记录一致。
 - 健康检查仍为一次元数据查询，连接池上限 2；无重试、扫描、缓存或消息增量。
 - Schema 与 runtime 判断只在启动/治理阶段执行常数时间正则匹配，不进入行情请求热路径。
 ## GitNexus 证据
 - 发布后 after：2090 节点、2767 关系、49 集群、50 流程，索引 `88e2fdf` 为 up-to-date。
 - compare：23 文件、70 符号、11 流程、HIGH；运行影响仅在既有 Schema 与 API 健康路径。
 - `AGENTS.md` 的 GitNexus 计数在实现和发布两次 `analyze` 中由 2004/2681 更新为 2015/2692，再更新为 2090/2767。
 ## 发布引用
 - 发布提交：`88e2fdffc8c71dd682405c148a81953a8dcee9d6`。
 - Gitea `refs/heads/main`：发布时与上述提交一致。
 - 带注释标签对象：`4d1553b68587a6218416bf0279494d720bb37161`。
 - Gitea `refs/tags/v0.0.9^{}`：`88e2fdffc8c71dd682405c148a81953a8dcee9d6`。
 - 标签只精确推送一次，未使用批量标签推送、强推或移动标签。
@@ -0,0 +1,21 @@
 # GOV-011 视觉回归记录
 - 页面：应用工程基础外壳
 - 变更类型：后端版本判断、测试、注释和文档；无页面样式或交互修改
 - 结论：无可观察视觉回归
 ## 桌面
 - Chromium 视口：1440×900
 - 截图：[app-shell-desktop-1440x900-cce77aa.png](/Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/docs/features/GOV-011-runtime-version-series/screenshots/iterations/app-shell-desktop-1440x900-cce77aa.png)
 - 检查：`main` 可见，标题正常，无横向溢出，控制台 warning/error 为空。
 ## 移动
 - Chromium 视口：390×844
 - 截图：[app-shell-mobile-390x844-cce77aa.png](/Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/docs/features/GOV-011-runtime-version-series/screenshots/iterations/app-shell-mobile-390x844-cce77aa.png)
 - 检查：标题与主内容正常换行和留白，无横向溢出、遮挡或裁切，控制台 warning/error 为空。
 ## 自动化证据
 `pnpm verify:e2e` 在 desktop-chromium 与 mobile-chromium 共执行 4 项，全部通过；覆盖页面可见性、横向溢出、运行时错误和同源 `/api/v1/health` 契约。截图生成后测试 API 与 Vite 服务均通过 SIGINT 关闭，端口 3000/5173 无遗留监听。
@@ -0,0 +1,24 @@
 # GOV-011 发布说明
 - 发布版本：v0.0.9
 - 状态：已发布
 - 发布日期：2026-08-17
 - 发布提交：`88e2fdffc8c71dd682405c148a81953a8dcee9d6`
 - 标签：`v0.0.9`（带注释标签，解引用后指向发布提交）
 ## 调整
 - Node.js 运行时约束明确为完整 22.x，不绑定 minor 或 patch。
 - MySQL 客户端、mysqldump、服务端和 API 健康检查统一接受完整 5.7.x，不设置最低 patch。
 - MySQL 健康详情显示服务端实际三段版本，不再硬编码 5.7.42。
 - 系统架构、代码开发规范、本地开发和 Ubuntu 源码部署手册统一使用系列版本口径。
 ## 保持不变
 - `utf8mb4`、`utf8mb4_general_ci`、`+08:00`、固定开发库和主机白名单继续严格校验。
 - HTTP/OpenAPI 响应结构、Web API、Redis、RocketMQ、Scheduler、Worker、数据库 Schema 和源码部署拓扑不变。
 - 历史 QA、Schema 清单、CHANGELOG 历史版本和已发布功能档案继续记录当时真实 patch。
 ## 已知例外
 v0.0.8 没有开发库 Schema 基线。用户确认开发库为空并授权 GOV-011 一次性跳过；仓库没有伪造基线或增加通用绕过开关。该例外导致 `verify:release`、`schema:verify` 和 `governance:finish` 在同一基线存在性检查失败，其他门禁已逐项执行并留证。
@@ -0,0 +1,22 @@
 # Node 与 MySQL 系列版本约束需求
 ## 功能需求
 - FR-001：运行时门禁必须以主版本 22 判断 Node.js，不绑定 minor 或 patch。
 - FR-002：Schema 生成与验证必须以 major/minor 5.7 判断 mysql 客户端、mysqldump 客户端和 MySQL 服务端，不绑定 patch。
 - FR-003：API MySQL 健康检查必须接受任意 5.7.x，并在成功详情中显示实际版本。
 - FR-004：MySQL 5.7.x 系列校验不得放宽数据库名、字符集、排序规则、时区或开发环境安全边界。
 - FR-005：现行架构、开发规范和部署手册必须使用 Node.js 22.x、MySQL 5.7.x；历史证据中的实际版本不批量改写。
 ## 质量需求
 - 必须测试系列内至少两个不同补丁版本和系列外上下边界。
 - 必须遵循 RED → GREEN：先让 5.7.41 被精确 5.7.42 校验拒绝，再实施系列校验。
 - `assertMysql57Metadata` 的 GitNexus 风险为 CRITICAL，必须完整回归 Schema 生成、历史验证、当前发布基线和治理启动相关测试。
 - 不新增依赖，不增加生产请求、数据库查询或后台任务。
 ## 安全与性能
 - 版本字符串只做固定格式匹配，不执行命令、不拼接 SQL。
 - 数据库访问仍限于既有只读元数据查询；本功能不连接生产数据库。
 - 运行时只增加常数时间字符串判断，不产生可测量的吞吐或内存影响。
@@ -0,0 +1,52 @@
 # GOV-011 代码 Review
 - reviewer_type：self
 - reviewer：当前实现代理结构化自审
 - 基线：`v0.0.8` / `9e85809`
 - 审查实现：`cce77aa`
 - 日期：2026-08-17
 ## 审查范围
 审查 Node 特征测试、Schema 元数据校验、MySQL 健康客户端、治理测试、现行架构/规范/部署文档、GitNexus 影响和一次性 Schema 例外。重点检查版本格式、错误边界、历史清单兼容、健康信息泄漏和门禁真实性。
 ## 发现
 ### 已关闭问题
 | 严重程度 | 位置 | 问题 | 处置 |
 |---|---|---|---|
 | Important | `tools/database/schema-baseline.test.mjs` 历史清单篡改测试 | 完整回归仍断言旧的“服务端必须为 5.7.42”文案，导致生产实现转为系列口径后测试失败。 | 更新为 `5.7.x` 断言；排除已授权发布基线用例后 Schema 28/28。 |
 | Minor | `implementation-plan.md` 全量门禁预期 | 原计划把 `verify:release` 写为 PASS，但该命令包含必然触发一次性 Schema 例外的测试。 | 修正文档为真实失败并要求手工执行其余等价门禁。 |
 ### 未发现问题
 未发现未关闭的 Critical、Important 或阻塞性 Minor。服务端正则只接受 `5.7.<数字>` 与 `-`/`+` 后缀；5.6、8.0、无 patch 和文字 patch 均拒绝。字符集、排序规则、库名、时区和生产数据库边界没有放宽。
 ## 测试缺口
 没有针对每个 MySQL 5.7 patch 建立真实数据库兼容矩阵；这是用户明确接受的系列版本策略。本次使用纯函数、固定元数据和现有集成测试验证判断边界，不证明第三方数据库每个 patch 都没有厂商缺陷。首次真实迁移和查询仍必须在目标 5.7.x 环境验证。
 ## 安全与残余风险
 - 版本字符串不执行、不进入 SQL；健康详情不回显原始后缀、地址、账号或密码。
 - Schema 入口仍固定 development、开发库和主机白名单；本次未连接生产数据库。
 - 残余风险一是不同 5.7 patch 的已知缺陷，二是 v0.0.8 缺少可验证 Schema 基线。前者由真实部署验证控制，后者由用户授权的一次性例外承担。
 ## 性能与资源影响
 - 只增加常数时间正则捕获，没有新增查询、网络、重试、缓存、任务或依赖。
 - 健康查询次数和连接池上限不变；Web 构建体积与 v0.0.8 一致。
 - 不进入行情采集、分析、Redis、RocketMQ 或图表热路径，无需负载测试。
 ## GitNexus 与同步修改
 开发前 `assertMysql57Metadata` 为 CRITICAL，5 个直接调用方、10 个受影响符号、5 组流程；`MysqlHealthClient` 为 LOW。开发后相对 v0.0.8 为 HIGH、23 文件、70 符号、11 流程，运行影响均属于计划中的 Schema 与 API 健康路径。HTTP/OpenAPI、Web API、消息、数据库 Schema、Redis、Scheduler、Worker 和部署拓扑没有计划外修改。
 ## v0.0.9 发布封存复核
 - 发布只增加版本、CHANGELOG、索引和功能状态，不修改运行时判断、健康查询或数据库边界。
 - 一次性 Schema 例外、HIGH GitNexus 风险和手工等价门禁证据均保留，没有改写为全量门禁通过。
 - 发布标签必须指向通过上述 Review 的封存提交，并与 Gitea 远程引用核对。
 最终结论：passed
@@ -0,0 +1,39 @@
 # GOV-011 开发规范符合性 Review
 - reviewer_type：self
 - reviewer：当前实现代理结构化自审
 - 审查提交：`cce77aa`
 - 日期：2026-08-17
 ## 检查结果
 - [x] PRD、需求、设计、实施计划、测试计划、开发总结、QA、GitNexus、Review、发布与回退资料齐全。
 - [x] 修改关键符号前执行 GitNexus 上游影响分析，提交前执行 detect-changes。
 - [x] HIGH/CRITICAL 风险已向用户说明，并以完整 Schema 与健康回归控制。
 - [x] 行为修改遵循 RED-GREEN，测试失败原因来自旧实现而非语法或夹具。
 - [x] 关键版本口径和安全边界使用准确中文注释，没有逐行复述。
 - [x] 未新增依赖、预测性抽象、空分层或过度文件拆分。
 - [x] 没有修改前端 Axios/API 分域、后端业务模块分层或 OpenAPI DTO。
 - [x] 所有阶段提交使用中文 Conventional Commit 和 GOV-011，并立即推送 Gitea。
 - [x] 没有使用 GitHub、强推、生产数据库或真实凭据。
 - [x] 历史 QA、Schema 清单和已发布档案保持原样。
 ## 不符合项与处置
 完成门禁无法通过 v0.0.8 Schema 基线存在性校验。该项不是静默忽略：用户在开发前明确确认当前开发库为空并要求本次跳过，仓库保存 `schema-baseline-waiver.md`，实际失败命令和风险写入 QA。没有修改治理工具，也没有伪造 `not_applicable`、`captured_empty` 或空 SQL。除此之外未发现未处置的不符合项。
 ## 安全、性能与架构检查
 安全边界保持固定开发环境、库名、主机白名单、字符集、排序规则和时区；健康输出已脱敏，依赖审计 0 漏洞。性能只增加常数时间字符串匹配，查询、连接池、构建体积和执行流数量没有增加。架构仍为 Vue 3 Web 与 NestJS API/Scheduler/Worker 独立项目、Ubuntu 源码部署和外部 MySQL/Redis/RocketMQ。
 ## GitNexus 与开发总结检查
 before、impact-plan、detected-changes、after、comparison 互相对应；最终索引为 2015 节点、2692 关系、50 流程。开发总结包含七个固定章节，明确原始需求、范围变化、实际完成、缺陷、延期、提交和验证证据；HIGH 风险与一次性 Schema 例外均有具体边界，不以空占位通过门禁。
 ## v0.0.9 发布封存复核
 - VERSION、CHANGELOG、文档索引、manifest、开发总结和发布说明的 v0.0.9 状态必须一致。
 - 发布提交和标签分别精确推送；禁止强推、批量推送标签或移动已发布标签。
 - 历史 v0.0.8 的 5.7.42 事实不因当前系列口径反向改写。
 最终结论：passed
@@ -0,0 +1,24 @@
 # GOV-011 回退说明
 GOV-011 不修改数据库结构、迁移或数据，不写 Redis，不操作 RocketMQ，也不修改生产配置。回退只涉及版本判断、健康详情、测试、注释和当前规范文档。
 ## 触发条件
 - 合法 MySQL 5.7.x 被错误拒绝，或 5.6/8.x 被错误放行。
 - 历史 captured/captured_empty manifest 无法验证。
 - 健康接口泄漏原始版本后缀或返回错误 patch。
 - 系列判断导致 Schema 生成、治理启动或 API 启动出现无法修复的回归。
 ## 回退步骤
 1. 使用新的中文 Conventional Commit 恢复 `assertMysql57Metadata` 和 `MysqlHealthClient` 到上一已验证行为；禁止重写 Gitea 历史、强推或移动已发布标签。
 2. 同步恢复对应测试、代码注释和当前架构/部署文档，避免实现与规范不一致。
 3. 不改写已经发布的 GOV-011 档案；通过后续回退记录说明原因、范围和提交。
 4. 因无数据库结构或数据变化，不执行数据库回滚。
 ## 回退验证
 - 重新执行 runtime、Schema、MySQL 规范、环境、Server 健康、类型和构建测试。
 - 执行 OpenAPI 契约、Playwright 双视口和源码发布验证。
 - 运行 GitNexus impact、detect-changes 与 analyze，记录回退实际流程影响。
 - v0.0.8 Schema 一次性例外仍只作为历史事实存在，不因代码回退生成伪造基线。
@@ -0,0 +1,22 @@
 # v0.0.8 Schema 基线一次性例外
 - 功能编号：GOV-011
 - 日期：2026-08-17
 - 适用范围：仅 GOV-011 开发启动
 ## 事实记录
 按常规流程执行 `pnpm schema:baseline` 时，本机因不存在 MySQL 5.7 `mysql`/`mysqldump` 客户端而在执行 `mysql --version` 前失败，未连接数据库、未生成目录或半成品；随后 `schema:verify` 因 `database/schema-baselines/v0.0.8` 不存在而按设计阻断。
 用户确认当前开发库没有业务结构，并明确要求本次先跳过备份。GOV-011 只调整 Node/MySQL 版本系列判断，不创建表、迁移或数据，不读取生产数据库。
 ## 处理决定
 - 不伪造 `not_applicable`、`captured_empty`、空 SQL、版本信息或校验摘要。
 - 不修改 `governance:start` 或 Schema 工具增加通用跳过开关。
 - 手工保存与 `governance:start` 同等的 GitNexus before/impact 文档，并在 GOV-011 Review 中核对本例外。
 - 本例外不自动适用于后续功能；下一次需要 Schema 基线时仍应提供可验证的 MySQL 5.7.x 客户端或由用户再次明确决定。
 ## 风险
 缺少 v0.0.8 Schema 基线意味着无法用仓库证据证明当时开发库为空。该风险由用户接受；GOV-011 不修改数据库，不能借本例外执行任何 Schema 或数据写入。
@@ -0,0 +1,58 @@
 # GOV-011 测试计划
 - 功能编号：GOV-011
 - 验证环境：Node.js 22.11.0、pnpm 10.25.0、macOS 开发机
 - 数据库边界：不连接、探测或读取生产数据库；本次不执行真实 Schema 导出
 ## 1. Node.js 系列验证
 - 接受 `22.0.0`、`22.11.0` 和带预发布/构建后缀的合法 22.x。
 - 拒绝 21.x、23.x、空字符串、`v22` 和其他无法解析格式。
 - pnpm 继续只接受 10.x，不因 Node 约束调整而放宽。
 ## 2. Schema 元数据验证
 - 接受 MySQL 服务端 `5.7.0`、`5.7.41`、`5.7.42-log`。
 - 拒绝 `5.6.51`、`8.0.40`、`5.7`、`5.7.x` 和空字符串。
 - mysql 与 mysqldump 客户端继续要求合法 5.7.x。
 - 服务端版本通过后，字符集仍必须为 `utf8mb4`，排序规则仍必须为 `utf8mb4_general_ci`。
 - 回归 captured、captured_empty、not_applicable、历史 manifest、生成入口和发布门禁调用链。
 - 因用户授权的 v0.0.8 基线一次性例外，严格发布基线用例预期只在目录缺失处失败；使用 `--test-skip-pattern='严格发布门禁'` 验证其余 28 项全部通过。
 ## 3. API 健康检查验证
 - `5.7.41-log` 返回 `MySQL 5.7.41 / <数据库> / +08:00`，证明 patch 来自服务端元数据而非硬编码。
 - 拒绝 5.6.x、8.x 和无效版本格式。
 - 拒绝错误库名、`utf8`、`utf8mb4_0900_ai_ci` 和 `SYSTEM` 时区。
 - 保持固定只读元数据查询、健康 DTO 结构和生产库名按当前配置校验。
 - 执行 Server 全量测试、类型检查和 API/Scheduler/Worker 三进程构建。
 ## 4. 规范与部署验证
 - 当前系统架构、代码开发规范、本地开发和 Ubuntu 源码部署文档必须写明 `MySQL 5.7.x`。
 - 上述四份当前文档不得再出现 `MySQL 5.7.42`；历史 QA、Schema 清单、CHANGELOG 历史版本和已发布功能档案不参与该否定扫描。
 - Node.js 22.x、pnpm 10.25.0、Ubuntu 源码部署、systemd、Nginx、Redis 和 RocketMQ 约束保持不变。
 ## 安全验证
 - 版本字符串仅进入固定正则，不执行命令、不拼接 SQL。
 - MySQL 健康错误不回显服务端原始附加文本、连接地址、账号或密码。
 - Schema 测试使用固定夹具和依赖注入，不连接真实数据库；本功能不执行 `schema:baseline`。
 - `pnpm audit --prod --registry=https://registry.npmjs.org/` 必须为 0 已知漏洞。
 - 扫描 Web/Server 构建产物中的凭据模式；配置键名允许存在，真实值、连接串和授权头不得存在。
 - `git diff --check`、GitNexus detect-changes 和 Review 核对没有生产数据、真实 `.env` 或凭据进入提交。
 ## 性能验证
 - 版本解析为启动/治理阶段常数时间正则匹配，不增加数据库查询、网络调用、重试、缓存或消息操作。
 - 健康检查继续只执行一次既有元数据查询，连接池上限仍为 2。
 - Web 页面和依赖未变化，生产 JS/CSS 体积应与 v0.0.8 基线一致。
 - 本功能不改变行情计算、数据库扫描、Redis 热点、RocketMQ 吞吐、Worker 并发或图表渲染，因此不执行负载测试；后续触及这些路径的业务功能必须重新设定性能目标。
 ## 7. 全量与视觉验证
 - 执行 runtime、governance、MySQL、环境、Schema、契约、边界、部署、Web 和 Server 测试。
 - 执行 OpenAPI 重新生成、lint、格式、类型检查、Web/Server 构建和源码发布验证。
 - Playwright 在 Chromium 1440×900 与 390×844 下验证页面、同源健康 API、横向溢出和控制台。
 - 保存桌面/移动截图并人工检查无重叠、裁切或空白渲染回归。
 - 真实执行 `pnpm verify:release`、`pnpm schema:verify` 和 `pnpm governance:finish GOV-011 runtime-version-series`；三者因同一个已授权 v0.0.8 基线缺失条件失败，必须保存失败证据并手工执行其余等价门禁。
@@ -0,0 +1,57 @@
 # 纯 Node.js 开发库 Schema 导出器设计
 ## 1. 架构
 保留 `tools/database/schema-baseline.mjs` 作为治理入口，继续负责固定配置、发布版本、产物构建、历史验证、原子持久化和远程发布核对。新增 `tools/database/mysql2-schema-exporter.mjs`，集中负责连接、元数据读取、`SHOW CREATE`、依赖排序和确定性 SQL 渲染，不把一次业务流程拆成过多小文件。
 ```text
 development 配置
  -> schema-baseline 安全边界
  -> mysql2-schema-exporter
  -> MySQL 5.7 元数据与 SHOW CREATE
  -> 确定性 schema.sql
  -> manifest.yaml + checksum.sha256
  -> 原子版本目录
 ```
 根工作区直接声明 `mysql2`，使治理工具拥有明确依赖。`runBaselineGeneration` 和 CLI 入口改为异步，外部 npm 命令保持不变。
 ## 2. format v3 与历史兼容
 format v3 使用独立字段记录 Node 导出器名称、导出器版本、数据库驱动名称、驱动版本和 MySQL 服务端版本，不复用 v1/v2 的 `mysql_client_version` 或 `mysqldump_client_version` 含义。
 验证器按 `format_version` 分支：v1/v2 保留现有字段和校验规则；v3 校验新字段。既有目录不得自动升级、格式化或重写。`captured`、`captured_empty` 和 `not_applicable` 状态继续保留。
 ## 3. 对象导出与顺序
 导出器先从 `information_schema` 获取固定库的对象清单和依赖，再对每个对象执行参数受控的 `SHOW CREATE`：
 1. 基础表按名称排序，保留列、索引、外键、表选项和注释。
 2. 存储过程与函数按类型和名称排序。
 3. 视图依据库内依赖拓扑排序；循环或未知依赖失败。
 4. 触发器按所属表、时机、事件和执行顺序排序。
 5. Event Scheduler 事件按名称排序。
 例程、触发器和事件使用稳定 `DELIMITER`。标识符只能来自元数据，并统一转义反引号。导出结果删除 `DEFINER`、当前 `AUTO_INCREMENT` 值、时间、主机、用户名和客户端噪声；同一结构必须产生逐字节一致结果。
 ## 4. 安全策略与评估
 导出前后分别计算对象摘要，包含对象类型、名称、依赖和定义可观察版本；摘要不一致表示并发 DDL，命令失败。任何对象无法 `SHOW CREATE`、结果为空或类型未知时禁止跳过。
 连接只允许固定 development 边界，禁用多语句，使用单连接、超时和对象数量限制。工具只查询元数据和 `SHOW CREATE`，不查询业务表、不锁表、不执行 DDL/DML。密码只存在于内存配置，并在所有路径通过 `finally` 关闭连接。
 现有 SQL 安全扫描继续拒绝顶层数据操作、连接串、疑似凭据和残留 `DEFINER`；对象体内部合法 DML 通过分隔符解析保留。
 ## 5. 性能目标与评估
 Schema 备份不在在线请求路径。使用单连接和有限并发，目标中小型开发库 30 秒内完成；连接、查询、总时长、对象数量或响应大小超过保护值时失败。
 产物先写入版本父目录中的临时目录，经过 SQL 扫描、对象计数、manifest 和 SHA-256 一致性校验后原子重命名。失败时删除临时目录，既有版本目录禁止覆盖。
 ## 6. 异常恢复与实施迁移
 GOV-012 因缺少 `v0.0.9` 基线使用用户授权的一次性人工启动记录。实现通过后已使用 development 配置连接 MySQL 5.7.x，生成并推送 `v0.0.9` format v3 `captured_empty` 基线；随后重新执行自动 `governance:start`，证明后续开发不再依赖本机 MySQL CLI。MySQL 5.7.x 缺少 `VIEW_TABLE_USAGE` 时，导出器回退读取 `information_schema.VIEWS`，其余查询错误不降级。
 ## 7. 依赖评估
 选择已有技术栈中的 `mysql2`，避免引入不透明的第三方 dump 包。替代方案包括安装 MySQL 5.7 客户端或远程执行 `mysqldump`，前者在现代 macOS 上难以维护，后者增加 SSH、凭据和远程工具版本风险。退出时可替换 exporter 端口实现，但 format v3 历史基线验证必须永久保留。
@@ -0,0 +1,46 @@
 # GOV-012 开发总结
 ## 原始开发需求
 将 Schema 版本基线从本机 `mysql`/`mysqldump` 子进程迁移为 Node.js 22.x 与 mysql2 直接读取 MySQL 5.7.x，保留历史格式兼容、恢复开发门禁，并满足安全、性能、可追溯和 Gitea 推送规范。
 ## 需求与范围变化
 - 原计划使用 MySQL 5.7 `VIEW_TABLE_USAGE` 读取视图依赖；真实 5.7.42 不提供该表，增加仅针对 ER_UNKNOWN_TABLE 的 `information_schema.VIEWS` 定义解析回退。
 - 原计划空库 exporter 返回会话 SET；实际 format v3 空库必须返回空 SQL，修正为 `captured_empty`。
 - GOV-012 不接入 HTTP/OpenAPI、Web、Redis、RocketMQ、API、Scheduler 或 Worker 运行时。
 ## 实际完成需求
 - 新增 mysql2 单连接导出器：元数据校验、目录读取、视图排序、六类 `SHOW CREATE`、确定性渲染、并发漂移检测、超时/大小/对象上限和错误脱敏。
 - `schema-baseline.mjs` 支持 format v3、异步 exporter 注入、原子文件操作故障注入、CLI 异步入口，并永久只读兼容 v1/v2。
 - 更新当前开发规范、开发流程、README、设计和测试计划；真实开发库生成并推送 `v0.0.9` `captured_empty` 清单。
 ## 修复缺陷
 - 拒绝 MariaDB 伪装版本。
 - 严格校验触发器时机、事件和执行顺序。
 - 防止目录、元数据和 SHOW CREATE 直接 API 泄露数据库错误。
 - 保留 `EXPORT_TIMEOUT` 语义，避免包装器降级为普通查询错误。
 - 防止全局正则改写例程字符串中的 `AUTO_INCREMENT`，并拒绝导出定义中的主机信息。
 - 兼容真实 MySQL 5.7.42 缺少 `VIEW_TABLE_USAGE` 的目录差异。
 ## 未完成与延期项
 - `glob` high 依赖风险按用户批准的范围例外保留为独立治理欠项，未在 GOV-012 中升级前端测试依赖。
 - GOV-012 尚未合并到 `main`、发布 `v0.0.10` 或封存 `v0.0.10` 基线；这些是后续 Task 8/9 的发布步骤。
 - MCP GitNexus 传输故障仍待工具环境恢复，不影响已保存的 CLI/静态替代证据。
 ## 关键提交
 - `06466f3`、`8e954a3`、`54fd928`、`7e9d906`、`dc8ad7d`
 - `c11de09`、`3d12c83`、`874796a`、`afd186c`、`f1c412b`
 - `58026ae`、`16bde94`、`11edeb0`
 ## 验证证据
 - `npm run test:schema-baseline`：52/52；`npm run test:governance`：10/10；`npm run test:mysql-baseline`：2/2。
 - `npm run test:environment-baseline`：10/10；contracts：3/3；boundaries：16/16；deployment：6/6。
 - `pnpm lint`、`pnpm typecheck`、Prettier、`npm run schema:verify` 均通过。
 - 真实 development MySQL 5.7.42 连接成功，`a_share_analysis_dev` 五类对象均为 0，v0.0.9 manifest 已提交并推送。
 - 发布 `v0.0.10` 标签已推送；发布后 `v0.0.10` `captured_empty` manifest 已按标签提交校验并推送 `main`。
@@ -0,0 +1,24 @@
 # GitNexus 开发后基线
 - 功能编号：GOV-012
 - 记录时间：2026年08月18日 CST
 - 分支：`codex/gov-012-node-schema-exporter`
 - 当前提交：`11edeb0`
 ## GitNexus 状态
 ```text
 Indexed commit: f1c412b
 Nodes: 2,431
 Edges: 3,282
 Clusters: 54
 Flows: 63
 MCP: Transport closed（按 CLI 与静态证据降级）
 ```
 ## 实际影响
 - 运行时只影响 Schema 治理工具、测试、治理文档和 `v0.0.9` 开发基线。
 - HTTP/OpenAPI、Web API、消息契约、Redis、API、Scheduler、Worker 和部署入口没有代码变更。
 - MySQL 连接仅命中用户确认的 development 配置和 `a_share_analysis_dev`；没有生产数据库访问。
 - `v0.0.10` 标签指向发布提交 `16bde94`，发布后基线提交为 `11edeb0`；两份基线均已推送 Gitea `main`。
@@ -0,0 +1,28 @@
 # GitNexus 开发前基线
 - 功能编号：GOV-012
 - 记录时间：2026年08月18日 CST
 - 分支：main
 - 基线提交：`3555b7c2224e`
 - 创建方式：用户授权跳过 `v0.0.9` Schema 备份后手工留痕
 ## 工作区
 ```text
 (干净)
 ```
 ## GitNexus 状态
 ```text
 Indexed commit: 3555b7c
 Current commit: 3555b7c
 Status: up-to-date
 Nodes: 2,112
 Edges: 2,790
 Flows: 50
 ```
 ## 工具限制
 重新索引后 GitNexus MCP 连接返回 `Transport closed`。该限制不得解释为无影响；影响计划使用现有图谱历史、静态调用点和测试引用形成保守结论，并要求修改代码前重新尝试 MCP upstream impact。
@@ -0,0 +1,9 @@
 # GitNexus 前后对比
 | 项目 | 开发前 | 开发后 | 判断 |
 | --- | --- | --- | --- |
 | Git 提交 | `3555b7c` | `11edeb0` | GOV-012 实现、发布和 v0.0.10 基线均已提交 |
 | 索引规模 | 2,112 nodes / 2,790 edges / 50 flows | 2,431 nodes / 3,282 edges / 63 flows | 仅新增导出器、测试、文档和基线清单相关符号 |
 | MCP | `Transport closed` | `Transport closed` | 使用 CLI、静态引用和回归测试降级核对 |
 | 数据库范围 | 缺失 `v0.0.9` 基线 | `a_share_analysis_dev`，v0.0.9/v0.0.10 均 `captured_empty` | 开发与发布后门禁均恢复 |
 | 跨模块变更 | 待分析 | 无 HTTP/OpenAPI、消息、Redis、运行时服务变更 | 符合影响计划 |
@@ -0,0 +1,17 @@
 # GitNexus 变更检测
 ## 工具证据
 - GitNexus MCP `detect_changes` 在开发前后均返回 `Transport closed`。
 - `npx gitnexus analyze` 已在关键提交后执行，最终索引为 2,383 nodes、3,234 edges、63 flows。
 - `npx gitnexus detect-changes --repo a-share-analysis` 返回 `No changes detected`；CLI 对当前未提交差异的识别不完整，不能单独作为无影响结论。
 ## 静态与 Git 交叉核对
 - `git diff --stat` 和提交清单确认变更集中在 `tools/database/schema-baseline.mjs`、`tools/database/mysql2-schema-exporter.mjs`、对应测试、GOV-012 文档及 `database/schema-baselines/v0.0.9/manifest.yaml`。
 - `rg` 静态引用确认 `runCommandLine -> runBaselineGeneration -> exportMysql57Schema` 及历史 `verifyBaselineDirectory` 调用链仍在预期治理路径内。
 - 没有 HTTP/OpenAPI、Web API、RocketMQ、Redis、API、Scheduler、Worker 或生产部署文件变更。
 ## 结论
 影响范围符合开发前计划；MCP 传输故障作为残余工具风险保留，不解释为无影响。
@@ -0,0 +1,68 @@
 # GitNexus 开发前影响计划
 - 功能编号：GOV-012
 - 基线提交：`3555b7c2224e`
 - 总体风险：HIGH（版本治理和全部后续开发入口）
 ## 直接与间接影响
 ### `runBaselineGeneration`
 - 直接被 Schema CLI 入口和多组单元测试调用；从同步子进程改为异步数据库连接会影响生成命令、测试注入和错误传播。
 - 间接影响 `schema:baseline` 产物以及后续 `schema:verify`、`assertCurrentReleasedBaselinePublished` 和 `governance:start` 的可用性。
 - 控制：保留外部命令，使用可注入假连接先测试，真实开发库只在专项验证中读取。
 ### `assertMysql57Metadata` 与历史验证
 - 同时服务 captured、captured_empty 和历史目录验证。直接修改现有字段语义会破坏 v1/v2 发布证据。
 - 控制：保留 v1/v2 原验证分支，新增 v3 元数据验证函数或明确格式分支，不原地复用旧客户端字段。
 ### SQL 规范化、对象计数和安全扫描
 - 新导出器输出不再完全等同 mysqldump 文本，可能影响 `normalizeSchemaSql`、`splitSqlStatements`、对象计数和敏感语句扫描。
 - 控制：用六类对象固定夹具覆盖格式、分隔符、对象体 DML、`DEFINER`、自增值和确定性输出。
 ## 跨模块同步修改
 - HTTP/OpenAPI、Web API、消息契约、Redis、API、Scheduler、Worker：无运行时影响。
 - 数据库：只读开发库 Schema，不修改迁移、表或数据；生产数据库禁止访问。
 - 依赖：根工作区新增 `mysql2` 直接依赖并更新锁文件，需审计安全、许可证和维护边界。
 - 治理：Schema format 升级、开发流程、代码规范、GOV-007 现行说明和测试必须同步；历史档案保持原文。
 - 测试：Schema 测试是主要影响面，治理测试和完整验证用于确认后续开发入口未回归。
 - 文档：新增 GOV-012 PRD、设计、测试、回退和开发总结，记录 v0.0.9 基线补建结果。
 ## 高风险处置
 这是全部版本开发的关键路径，风险至少为 HIGH。修改任何相关函数前必须重新执行 GitNexus upstream impact；若 MCP 仍不可用，使用静态调用关系、现有 50 条流程和全量回归交叉验证。历史基线失败、数据语句进入 SQL、生产边界被放宽或自动门禁未恢复时立即停止发布并回退。
 ## GOV-012 Task 1 重新核对（2026-08-18）
 ### 工具状态与静态替代证据
 - 已执行 `npx gitnexus analyze`，结果为 `Already up to date`；已执行 `npx gitnexus status`，索引和当前提交均为 `235163c`，状态为 up-to-date。
 - GitNexus MCP 在本次开发环境没有可调用传输入口；结合任务启动时持续的 `Transport closed`，不能把 MCP 不可用解释为无影响。本轮使用 `rg -n` 对五个符号检索全部仓库静态引用（排除 `node_modules`、`.git` 与 `.gitnexus`），并以已刷新的 CLI 索引和后续 `git diff` 交叉验证。
 - 静态引用集中在 `tools/database/schema-baseline.mjs`、`tools/database/schema-baseline.test.mjs`、GOV-007/009/011/012 的治理档案及 `tools/runtime/verify-runtime.mjs`；Task 1 不修改这些既有执行符号或 format v1/v2 目录。
 - 以本 worktree 路径指定 CLI 后，`assertMysql57Metadata` 的 upstream 结果为 CRITICAL（4 个直接调用方、9 个受影响符号、5 组流程），`verifyBaselineDirectory` 为 HIGH（3 个直接调用方、6 个受影响符号、4 组流程）。前者较历史 5/10 计数少一，是当前索引未计入测试引用，不能降低历史关键路径风险判断。
 - CLI 将 `runBaselineGeneration` 和 `buildCapturedArtifacts` 显示为 LOW/0；与源码中 `runCommandLine -> runBaselineGeneration -> buildCapturedArtifacts` 的静态调用不一致，因此以静态调用补足，不记录为无影响。`runCommandLine` 与 `tools/runtime/verify-runtime.mjs` 中同名符号歧义，CLI 不支持按 UID 或文件路径消歧，使用 `schema-baseline.mjs` 主入口守卫的静态引用作为替代证据。
 ### 关键符号影响结论
 | 符号 | 直接调用方/静态入口 | 受影响流程 | 实际风险与本任务控制 |
 | --- | --- | --- | --- |
 | `runBaselineGeneration` | `runCommandLine` 的 `generate` 分支；Schema 单元测试直接调用 | `schema:baseline` 生成、随后 `schema:verify`、当前发布基线校验和 `governance:start` | HIGH；后续异步替换会改变错误传播与注入边界。Task 1 只新建模块，不改此函数。 |
 | `assertMysql57Metadata` | `buildCapturedArtifacts`、`buildCapturedEmptyArtifacts`、`verifyBaselineDirectory` 的 captured/captured_empty 分支、`runBaselineGeneration` 与 Schema 单元测试 | captured、captured_empty、历史目录验证、当前发布基线、基线生成和 `governance:start` | CRITICAL；历史 GitNexus 证据为 5 个直接调用方、10 个受影响符号和 5 组流程。Task 1 建立独立 `assertMysql57ServerMetadata`，不改变 v1/v2 语义。 |
 | `buildCapturedArtifacts` | `runBaselineGeneration`；Schema 单元测试 | captured 产物、清单/checksum、`schema:verify` | MEDIUM；v3 产物契约将在后续 Task 修改。本任务不改该函数。 |
 | `verifyBaselineDirectory` | `runBaselineGeneration` 的已存在目录、MySQL 关闭和 captured 分支；`assertCurrentReleasedBaseline`；`assertCurrentReleasedBaselinePublished`；Schema 单元测试 | `schema:verify`、已发布基线校验、`governance:start` | HIGH；format v1/v2 只读兼容是发布门禁。本任务不改该函数或历史目录。 |
 | `runCommandLine` | 模块主入口守卫；内部 `generate` 分支调用 `runBaselineGeneration` | `schema:baseline`、`schema:verify` 的 CLI 非零退出边界 | HIGH；后续改异步入口会影响命令完成时序。本任务不改此函数。 |
 ### 跨模块同步判断
 - HTTP/OpenAPI、Web API、消息契约、Redis、API、Scheduler、Worker、部署：本 Task 仅新增 Node 治理工具安全基础，不接入运行时服务，均无同步代码修改；边界是后续 Task 将替换 Schema CLI 内部实现。
 - 数据库：不建立连接、不查询业务数据、不执行 DDL/DML/多语句/锁表；本 Task 仅固定未来连接选项和服务端元数据契约。
 - 测试、依赖和文档：新增 mysql2 根开发依赖、Node 单元测试和本影响记录；`pnpm audit --audit-level high` 是依赖安全门禁。
 ### Task 1 依赖审计范围限定例外
 - 官方 registry 审计确认既有 Web 测试依赖链 `@vue/test-utils -> js-beautify -> glob` 存在一项 high；新增的 `mysql2@3.23.3` 不在该依赖路径中。
 - 用户于 2026-08-18 明确同意 GOV-012 使用范围限定例外继续：该既有风险作为单独治理欠项处理，本功能不得擅自升级前端测试依赖，也不得把该例外解释为 `mysql2` 安全审计通过之外的通用放行。
 - GOV-012 发布前的代码 Review 和开发规范 Review 必须继续披露该残余风险；若后续审计发现 `mysql2`、Schema 导出链路或生产依赖新增 high/critical，则本例外不适用并立即阻断。
@@ -0,0 +1,12 @@
 id: GOV-012
 name: 纯 Node.js 开发库 Schema 导出器
 slug: node-schema-exporter
 status: released
 owner: project
 created_at: 2026-08-18
 requirements: requirements.md
 prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
 traceability_note: 设计已确认；实施计划需在用户复核书面规格后创建
 release: v0.0.10
@@ -0,0 +1,68 @@
 # 纯 Node.js 开发库 Schema 导出器 PRD
 - 功能编号：GOV-012
 - PRD 版本：0.1
 - 状态：approved
 - 日期：2026-08-18
 ## 背景与问题
 当前 `schema:baseline` 依赖本机 MySQL 5.7.x 的 `mysql` 和 `mysqldump` 可执行文件。开发机无法安装这些客户端时，命令在连接数据库前以 `spawnSync mysql ENOENT` 失败，导致上一发布版本无法形成 Schema 基线，后续 `governance:start` 和版本开发流程持续阻断。
 项目已经采用 Node.js 22.x、pnpm 和 `mysql2`，不应要求开发机额外安装 MySQL Server，也不应通过 Docker、远程 shell 或非版本化人工导出绕过治理门禁。
 ## 产品目标
 - 使用纯 Node.js 和 `mysql2` 从固定开发库导出完整、确定性、可验证的 Schema。
 - 保持 `npm run schema:baseline`、`npm run schema:verify` 和 `governance:start` 的外部用法不变。
 - 保留历史 format v1/v2 基线的只读兼容，不重写既有发布证据。
 - 在实现完成后生成并推送 `v0.0.9` 基线，恢复自动版本开发流程。
 ## 范围
 - 导出表、索引、外键、视图、触发器、存储过程、函数和 Event Scheduler 事件。
 - 新增 format v3 清单，记录 Node 导出器、`mysql2` 驱动和 MySQL 5.7.x 服务端信息。
 - 使用开发环境白名单、对象摘要前后校验、SQL 安全扫描、原子写入和 SHA-256 校验。
 - 为导出、验证、历史兼容、错误恢复和真实空开发库补充测试。
 ## 非目标
 - 不备份任何表数据。
 - 不连接、探测或读取生产数据库。
 - 不安装 MySQL Server、MySQL CLI、Docker 或远程导出服务。
 - 不修改业务数据库结构、迁移、实体或应用查询。
 - 不把 TypeORM 实体定义当作现有数据库真实结构的替代品。
 ## 用户流程
 1. 开发者在开发下一版本前运行 `npm run schema:baseline`。
 2. 工具固定读取 development 配置并验证目标库边界。
 3. Node 导出器连接开发库、读取完整对象定义并生成版本目录。
 4. 开发者运行 `npm run schema:verify`，提交并推送该目录。
 5. `governance:start` 核对基线、远程分支和发布标签后允许下一功能开发。
 ## 成功指标
 - 未安装 `mysql` 和 `mysqldump` 的开发机能够完成真实 Schema 基线生成。
 - 相同结构重复导出产生逐字节一致的 SQL 和 SHA-256。
 - format v1/v2 历史基线继续通过原有验证。
 - 空开发库生成 `captured_empty`，非空开发库生成完整 `schema.sql`。
 - 失败时不留下目标版本目录或半成品。
 ## 验收标准
 - Given 本机不存在 MySQL CLI，When 执行 `schema:baseline`，Then 工具通过 `mysql2` 连接固定开发库且不调用外部数据库命令。
 - Given 数据库包含所有受支持对象，When 导出完成，Then SQL 包含完整对象定义且不包含数据、凭据和 `DEFINER`。
 - Given 历史 format v1/v2 基线，When 执行 `schema:verify`，Then 继续按原规则通过或失败，文件不被重写。
 - Given 导出期间对象摘要变化，When 执行完成前复核，Then 命令失败并清理临时目录。
 - Given `v0.0.9` 基线已提交推送，When 执行 `governance:start`，Then 不再因本机缺少 MySQL CLI 被阻断。
 ## 风险
 - `SHOW CREATE` 权限不足会阻断完整导出，必须明确报错，不能跳过对象。
 - 视图依赖和例程分隔符处理错误会降低恢复能力，必须用固定夹具和恢复顺序测试覆盖。
 - 本功能位于版本治理关键路径，任何历史兼容回归都可能阻断全部后续开发。
 ## 发布与回退
 GOV-012 作为独立治理版本发布。若新导出器不能生成确定性完整结构、历史基线验证回归或 `governance:start` 无法恢复，则不得发布；代码回退到 GOV-012 前提交，已发布的历史基线保持不变。
@@ -0,0 +1,24 @@
 # QA 测试结果
 ## 通过项
 - `npm run test:schema-baseline`：52/52 通过，包含 Node exporter、format v1/v2 只读兼容、format v3、错误脱敏、MySQL 5.7 视图目录回退和真实 `v0.0.9` 基线门禁。
 - `npm run test:governance`：10/10 通过。
 - `npm run test:mysql-baseline`：2/2 通过。
 - `npm run test:environment-baseline`：10/10 通过。
 - `npm run test:contracts`：3/3 通过。
 - `npm run test:boundaries`：16/16 通过。
 - `npm run test:deployment`：6/6 通过。
 - `npm run check:runtime`：Node.js 22.11.0、pnpm 10.25.0 通过。
 - `pnpm lint`：Web 和 Server ESLint 通过。
 - `pnpm typecheck`：Web 与 Server TypeScript 检查通过。
 - `npm run schema:verify`：`v0.0.9 (captured_empty)` 通过。
 ## 真实开发库
 - 使用 Git 忽略的 development 本地配置，只读取 `a_share_analysis_dev` 的元数据和 `SHOW CREATE`；服务端为 MySQL 5.7.42，五类对象计数均为 0。
 - 生成结果只有 `manifest.yaml`，没有 `schema.sql`、checksum 中没有密码或连接信息。
 ## 未执行项
 - `npm run governance:start -- GOV-012 node-schema-exporter` 未重复覆盖已有开发前报告，工具按历史保护规则拒绝；已用 `schema:verify` 和独立远程基线检查替代验证。
@@ -0,0 +1,9 @@
 # 视觉 QA
 ## 适用性
 GOV-012 只修改数据库治理工具、测试、文档和 Schema 清单，不修改 Web 页面、样式、图表或交互流程，因此不适用浏览器截图和视觉回归。
 ## 边界
 下一项市场概览业务功能涉及 Web 页面时，必须按现行规范补充 Playwright 流程和同视口视觉证据；本结论不能外推到后续前端功能。
@@ -0,0 +1,22 @@
 # GOV-012 发布说明（待发布）
 ## 计划版本
 `v0.0.10`，发布主题为纯 Node.js 开发库 Schema 导出器。
 ## 变更
 - 移除 Schema 生成对本机 MySQL CLI 的运行时依赖，改用 mysql2 和 MySQL 5.7.x `SHOW CREATE`。
 - 新增 format v3，记录 exporter/driver 元数据；format v1/v2 保持只读兼容。
 - 恢复下一版本开发前的 Schema 基线门禁，已封存 `v0.0.9` `captured_empty` 基线。
 ## 发布前置
 - 先在 `main` 完成代码 Review、规范 Review、`governance:finish` 和全量验证。
 - 创建并推送 `v0.0.10` 标签，再独立生成并推送 `database/schema-baselines/v0.0.10/manifest.yaml`。
 - 发布失败时按 `rollback.md` 回退代码提交，禁止删除或覆盖 v0.0.9 基线。
 ## 发布结果
 - `v0.0.10` 标签指向 `16bde94`，已单独推送 Gitea。
 - 发布后 `v0.0.10` Schema 基线提交为 `11edeb0`，状态为 `captured_empty`，已推送 `main`。
@@ -0,0 +1,34 @@
 # 工程需求
 ## 功能需求
 - `schema:baseline` 不得调用本机 `mysql`、`mysqldump` 或其他外部数据库客户端。
 - 根工作区直接声明并使用固定版本的 `mysql2`，不得从 Server 私有依赖路径加载。
 - 工具只允许 development、`a_share_analysis_dev`、固定开发主机白名单、MySQL 5.7.x、`utf8mb4` 和 `utf8mb4_general_ci`。
 - 使用 `SHOW CREATE` 导出基础表、视图、触发器、存储过程、函数和事件；索引与外键随表定义保存。
 - 视图按库内依赖拓扑排序；循环依赖、未知依赖或对象丢失必须失败。
 - format v3 清单记录导出器和驱动信息；format v1/v2 继续只读验证。
 - 空库仍生成 `captured_empty`，MySQL 未启用仍生成 `not_applicable`，两者不得创建伪造 SQL。
 - 版本目录继续使用临时目录、完整校验后原子重命名，既有目录只允许逐字节幂等复用。
 ## 安全需求
 - 禁止查询业务表数据，禁止 DDL、DML、多语句、锁表和生产探测。
 - 密码只能从被 Git 忽略的 development 配置读取，不进入异常、日志、清单、SQL 或命令参数。
 - 顶层数据语句、连接串、疑似凭据、残留 `DEFINER` 和环境主机信息必须被拒绝。
 - 对象名只能来自已验证的元数据，并使用 MySQL 标识符转义。
 - 连接必须在所有成功和失败路径关闭。
 ## 性能与稳定性需求
 - 使用单连接和有限并发，设置连接超时、查询超时、对象数量和响应大小保护。
 - 中小型开发库目标在 30 秒内完成；超时不得保存部分基线。
 - 导出前后读取对象摘要，两次不一致时失败，避免并发 DDL 形成混合快照。
 - 相同输入必须生成确定性顺序、换行、清单和校验值。
 ## 兼容与测试需求
 - 外部命令名称和参数保持不变。
 - 现有 format v1/v2 夹具、状态和错误边界继续通过。
 - 新增假连接单元测试，不以真实数据库作为普通测试门禁。
 - 实施完成后只对固定开发库执行一次真实 `captured_empty` 或 `captured` 验证，禁止访问生产环境。
@@ -0,0 +1,24 @@
 # 代码 Review
 ## 范围
 Review 覆盖 `mysql2-schema-exporter.mjs`、`schema-baseline.mjs`、对应测试、format v3 清单和文档变更。Task 2/3 Review 发现的问题已通过修复提交关闭：触发器元数据严格校验、目录/SHOW CREATE/元数据错误脱敏、超时错误语义保留、例程字面量不误改、主机信息拒绝，以及 MySQL 5.7 视图目录回退。
 ## 安全与残余风险
 - 只读 `information_schema` 和 `SHOW CREATE`，禁用多语句，不读取业务数据，不执行 DDL/DML，不锁表。
 - 配置边界固定为 development、`a_share_analysis_dev` 和开发主机白名单；密码不进入日志、异常、SQL、清单或 checksum。
 - 连接、查询、总时长、对象数和定义大小均有上限，所有路径最终关闭连接。
 - 既有 Web 测试依赖链 `glob` 的 high 漏洞是用户批准的范围限定治理欠项，不在本功能新增路径；若 mysql2 或导出链出现 high/critical，必须阻断发布。
 ## 性能与资源影响
 - 单连接、按目录顺序读取，查询 5 秒超时、总时长 30 秒、对象 5,000、单定义 1 MiB；视图排序为确定性 Kahn 算法。
 - 治理命令不在在线请求路径，不新增 API、Redis、RocketMQ 或 Worker 负载；空库实际生成 `captured_empty`。
 ## GitNexus 与同步修改
 - MCP `Transport closed`，已用 CLI reindex/status、静态引用和回归测试交叉核对；影响集中在 Schema 治理链路。
 - HTTP/OpenAPI、Web API、消息、Redis、API、Scheduler、Worker、部署均无需同步修改；Schema 文档、测试脚本和 v0.0.9 基线已同步。
 最终结论：passed
@@ -0,0 +1,15 @@
 # 开发规范符合性 Review
 ## 安全、性能与架构检查
 - 代码使用中文注释说明开发库边界、错误脱敏、并发变化和 MySQL 5.7 回退；文件职责没有继续过度拆分。
 - Node.js 22.x、mysql2、MySQL 5.7.x、`utf8mb4_general_ci` 和 format v3 约束已同步实现、规范和测试。
 - 安全策略覆盖凭据、SQL 注入、生产边界、错误、依赖和残余风险；性能目标、保护阈值和不适用压测边界均有证据。
 ## GitNexus 与开发总结检查
 - 开发前影响计划、开发后索引、变更检测和前后对比已归档；MCP 传输限制已明确记录。
 - 开发总结记录原始需求、范围变化、实际完成、修复缺陷、延期项、提交和验证证据。
 - 提交均为中文 Conventional Commit，当前分支和每次提交均已推送项目 Gitea；未修改 Git 全局配置。
 最终结论：passed
@@ -0,0 +1,21 @@
 # 回退方案
 ## 代码回退
 若纯 Node 导出器出现历史兼容、结构完整性或安全问题，回退 GOV-012 代码提交，恢复原 MySQL CLI 实现。不得删除或改写任何已发布的历史基线。
 ## format v3 处理
 GOV-012 未发布前生成的 v3 测试产物可以删除并重新生成；一旦随正式版本发布，验证器必须永久保留 v3 只读兼容。回退不能把 v3 清单伪装为 v2。
 ## 数据库边界
 本功能不修改数据库结构和数据，因此不执行数据库回滚。回退只涉及治理工具、依赖锁文件、文档和未发布的测试产物。
 ## 触发条件
 - 导出结果缺少任一受支持对象。
 - 相同 Schema 无法稳定生成相同校验值。
 - 历史 v1/v2 基线验证回归。
 - 工具读取业务数据、泄露凭据或可能连接生产环境。
 - `schema:verify` 或 `governance:start` 不能形成闭环。
@@ -0,0 +1,20 @@
 # v0.0.9 Schema 基线启动例外
 - 功能编号：GOV-012
 - 日期：2026-08-18
 - 适用范围：仅 GOV-012 开发启动
 ## 原因
 本机不存在 MySQL 5.7.x `mysql` 与 `mysqldump` 客户端，现有工具在连接数据库前以 `spawnSync mysql ENOENT` 失败。GOV-012 的目标正是移除该本机依赖，因此无法先用旧工具生成 `v0.0.9` 基线再开发修复。
 ## 用户决定
 用户明确授权本次跳过数据库备份。该授权只用于 GOV-012 启动，不建立通用跳过选项，也不继承到 GOV-012 之后的其他功能。
 ## 限制与补偿
 - 不伪造空库、SQL、客户端版本或校验摘要。
 - 不连接或探测生产数据库。
 - 使用手工 GitNexus before/impact 记录替代自动 `governance:start` 的启动证据。
 - 新导出器通过后必须优先生成、验证、单独提交并推送 `v0.0.9` 基线，再验证自动门禁恢复。
@@ -0,0 +1,37 @@
 # 测试计划
 ## 单元与契约测试
 - 旧实现下先证明无 MySQL CLI 时失败，再使纯 Node 路径转绿。
 - 假连接覆盖表、视图依赖、触发器、过程、函数、事件和空库。
 - 覆盖 MySQL 5.7.x 成功以及 5.6、8.x、MariaDB、字符集和排序规则失败。
 - 覆盖视图拓扑排序、循环依赖、未知对象、权限不足、空 `SHOW CREATE` 和对象摘要漂移。
 - 覆盖标识符转义、`DEFINER` 清除、当前自增值清除和稳定分隔符。
 - 覆盖顶层数据操作、凭据、连接串和生产标识拒绝；对象体内合法 DML 保留。
 - 覆盖连接成功、查询失败、渲染失败和持久化失败时的连接关闭与临时目录清理。
 - 覆盖相同输入逐字节确定性和 SQL/manifest/checksum 篡改检测。
 ## 历史兼容
 - 全部 format v1/v2 历史夹具继续验证。
 - format v3 的 `captured`、`captured_empty` 和 `not_applicable` 分支通过。
 - 旧字段不被新格式复用，历史目录不发生内容变化。
 - `governance:start` 继续验证基线已跟踪、已推送、当前分支和远程标签一致。
 ## 真实开发库验证
 - 只读取 `deploy/env/development/api.env.local` 和固定开发库。
 - 记录服务端版本、字符规则、对象数量、耗时和最终状态，不记录密码、地址或 SQL 正文到聊天和 QA 摘要。
 - 当前为空时生成 `captured_empty`；发现实际对象时生成完整 `captured`，不得按预期强制为空。
 - 运行 `schema:verify`、治理测试、格式、lint、类型检查和完整仓库验证。
 ## 安全验证
 - 证明没有子进程数据库客户端调用、业务表数据查询、生产配置读取或多语句执行。
 - 固定夹具验证对象数量、响应大小、查询和总时长保护。
 - 残余风险包括真实库权限差异和并发 DDL；通过失败关闭、摘要复核和人工重跑控制。
 ## 性能验证
 - 假连接验证单连接、5 秒查询超时、30 秒总时长、5,000 对象和 1 MiB 单定义限制；真实开发库记录导出状态和耗时，不记录 SQL 或凭据。
 - 本功能是低频治理命令，不在 API 请求路径，也不承载在线行情吞吐；因此不执行业务负载压测，边界是版本基线生成和验证命令本身。
@@ -8,7 +8,7 @@
 - 前端：Vue 3、Vite、TypeScript、Dart Sass、Naive UI；浏览器 HTTP 请求统一使用 Axios，接口类型由 OpenAPI 生成。
 - 后端：NestJS、TypeScript。
- 数据库：MySQL 5.7.42，字符集 `utf8mb4`，排序规则 `utf8mb4_general_ci`；缓存：Redis；消息队列：RocketMQ 5.x。
+- 数据库：MySQL 5.7.x，字符集 `utf8mb4`，排序规则 `utf8mb4_general_ci`；缓存：Redis；消息队列：RocketMQ 5.x。
 - 图表：Lightweight Charts负责K线和分时，ECharts负责热力图、分布和资金趋势。
 - AI：由服务端调用兼容 OpenAI 格式的付费 API，密钥不得下发浏览器。
@@ -127,28 +127,30 @@ count += 1;
 - 业务代码只依赖项目定义的 `MessageBusAdapter` 和版本化事件契约，禁止直接依赖 RocketMQ SDK 类型；客户端、NameServer 或 Proxy 接入方式由基础设施适配层决定。
 - 免费数据源通过 Adapter 统一为内部模型，上层不得依赖供应商原始字段。
-## 11. MySQL 5.7 兼容规范
+## 11. MySQL 5.7.x 兼容规范
- 开发、测试和生产环境统一使用 MySQL 5.7.42，禁止使用其他 5.7 补丁、`latest`、MySQL 8.x 或其他数据库代替兼容性验证。
+- 开发、测试和生产环境统一使用 MySQL 5.7.x，不设置最低补丁版本；禁止使用 `latest`、MySQL 5.6.x、8.x、MariaDB 或其他数据库代替兼容性验证。
 - 创建数据库必须显式声明 `DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci`；建表与迁移脚本必须显式保持 `DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci`。
 - ORM 和数据库驱动必须声明 `utf8mb4`，连接建立后验证会话、数据库和表的排序规则为 `utf8mb4_general_ci`，不得依赖服务器默认值。
 - 文本列默认继承表级规则。列级改变字符集或排序规则必须由具体功能设计解释，并通过 ADR 审批。
 - 禁止使用 MySQL 8.x 专属或在 5.7 行为不同的公用表表达式、递归 CTE、窗口函数、函数索引、不可见索引、`utf8mb4_0900_*` 排序规则和 JSON 增强能力。
- 不得依赖 `CHECK` 约束在 MySQL 8.x 的强制执行语义；MySQL 5.7 下的业务约束必须由边界校验、普通索引或可测试的写入逻辑保证。
+- 不得依赖 `CHECK` 约束在 MySQL 8.x 的强制执行语义；MySQL 5.7.x 下的业务约束必须由边界校验、普通索引或可测试的写入逻辑保证。
 - `utf8mb4_general_ci` 不区分大小写。证券代码、外部事件 ID、幂等键等身份字段必须规范化输入，或显式采用经设计批准的二进制比较与唯一键，不能误把默认比较当成大小写敏感。
- 索引长度按 MySQL 5.7 和 `utf8mb4` 最多四字节字符预算；超长标识使用受控长度、前缀索引或稳定摘要时，必须说明唯一性和碰撞处理。
+- 索引长度按 MySQL 5.7.x 和 `utf8mb4` 最多四字节字符预算；超长标识使用受控长度、前缀索引或稳定摘要时，必须说明唯一性和碰撞处理。
- JSON 字段只能使用 MySQL 5.7 已支持并经过真实环境验证的能力，查询和索引不得建立在 8.x 特性上。
+- JSON 字段只能使用 MySQL 5.7.x 已支持并经过真实环境验证的能力，查询和索引不得建立在 8.x 特性上。
- 每份迁移脚本必须能够从上一版本基线在 MySQL 5.7 正向执行；禁止用直接修改共享数据库表代替迁移脚本。
+- 每份迁移脚本必须能够从上一版本基线在 MySQL 5.7.x 正向执行；禁止用直接修改共享数据库表代替迁移脚本。
 - 代码 Review 必须检查服务端版本、字符集、排序规则、SQL/迁移兼容性、索引长度和字符串比较语义；任一不符合项按 Important 处理并阻断发布。
 ### Schema 基线规范
- 每个新应用版本开发前必须封存上一已发布版本的开发库 Schema；只能读取 `APP_ENV=development`、`a_share_analysis_dev` 和 MySQL 5.7，主机仅允许回环地址或固定开发白名单 `112.192.20.11`，禁止连接、探测或读取生产数据库。配置优先读取 Git 忽略的 `deploy/env/development/api.env.local`。
+- 每个新应用版本开发前必须封存上一已发布版本的开发库 Schema；只能读取 `APP_ENV=development`、`a_share_analysis_dev` 和 MySQL 5.7.x，主机仅允许回环地址或固定开发白名单 `112.192.20.11`，禁止连接、探测或读取生产数据库。配置优先读取 Git 忽略的 `deploy/env/development/api.env.local`。
- 导出使用 MySQL 5.7 `mysqldump` 的 `--no-data --routines --triggers --events`，完整保留表、索引、外键、视图、触发器、存储过程、函数和事件，不得包含任何表数据。
+- 导出使用 Node.js 22.x 与 `mysql2` 连接 MySQL 5.7.x，读取固定 `information_schema` 元数据并执行 `SHOW CREATE`，完整保留表、索引、外键、视图、触发器、存储过程、函数和事件，不得包含任何表数据；本机不要求安装 MySQL Server、`mysql` 或 `mysqldump`。
 - 规范化必须确定性删除导出时间、环境 `DEFINER` 和表选项中的当前 `AUTO_INCREMENT=<值>`，同时保留列定义的 `AUTO_INCREMENT` 属性和业务 SQL。
- 账号密码只能通过受控子进程环境传递，不得进入参数、日志、SQL、清单或 checksum 文件。
+- 账号密码只存在于内存连接配置，不得进入命令参数、日志、异常、SQL、清单或 checksum 文件。
 - `manifest.yaml`、`checksum.sha256` 和 `schema.sql` 的 SHA-256 必须一致；既有版本目录只允许内容完全一致的幂等验证，不允许覆盖。
- MySQL 未启用时只创建状态为 `not_applicable` 的清单，不得创建空 `schema.sql`；启用但无对象时创建 format v2 的 `captured_empty` 清单和零对象计数，不伪造空 SQL；启用后的缺失基线必须阻断下一版本开发。既有 format v1 基线必须继续只读验证，不得静默升级或重写。
+- 导出前后必须复核对象目录和定义摘要，发现并发 DDL 或定义变化立即失败；MySQL 5.7.x 不提供 `VIEW_TABLE_USAGE` 时，只能回退读取 `information_schema.VIEWS.VIEW_DEFINITION` 解析视图依赖。
 - MySQL 未启用时只创建状态为 `not_applicable` 的清单，不得创建空 `schema.sql`；启用但无对象时创建 format v3 的 `captured_empty` 清单和零对象计数，不伪造空 SQL；启用后的缺失基线必须阻断下一版本开发。既有 format v1/v2 基线必须继续只读验证，不得静默升级或重写。
 - format v3 清单记录 Node exporter 和数据库驱动版本，不复用 v1/v2 的 `mysql_client_version` 与 `mysqldump_client_version` 字段。
 ## 12. 测试要求
@@ -176,7 +178,7 @@ count += 1;
 - 后端评估数据量与算法复杂度、MySQL 查询/索引/N+1、Redis 用途/TTL/一致性/击穿、API 载荷与分页、Scheduler/Worker 并发/幂等/背压，以及外部数据源和 AI 的超时/重试/批处理/成本。
 - 前端评估依赖与构建体积、渲染次数、长列表、图表数据量、交互响应和内存占用；不能只以开发环境主观感觉作为证据。
 - 高风险路径必须提供 benchmark、profile 或负载测试；低频治理逻辑等不适用场景必须写明无需负载测试的原因和边界。
- 性能优化不得牺牲数据口径、安全、可观察性、异常恢复或 MySQL 5.7 兼容性；禁止无证据的预优化。
+- 性能优化不得牺牲数据口径、安全、可观察性、异常恢复或 MySQL 5.7.x 兼容性；禁止无证据的预优化。
 ## 15. 代码 Review 要求
@@ -17,7 +17,7 @@ released → superseded
 ## 3. 开发前流程
 1. 确认上一已发布语义化版本及标签提交，执行 `npm run schema:baseline` 和 `npm run schema:verify`。
-2. MySQL 已启用时只能从 `APP_ENV=development`、`a_share_analysis_dev`、MySQL 5.7、`utf8mb4_general_ci` 和固定开发主机白名单（回环地址或 `112.192.20.11`）导出 Schema；配置优先读取被 Git 忽略的 `deploy/env/development/api.env.local`，不存在时才读取无秘密模板。空开发库保存 format v2 的 `captured_empty` 清单，不创建空 SQL；MySQL 未启用时只保存 `not_applicable` 清单。
+2. MySQL 已启用时只能从 `APP_ENV=development`、`a_share_analysis_dev`、MySQL 5.7.x、`utf8mb4_general_ci` 和固定开发主机白名单（回环地址或 `112.192.20.11`）导出 Schema；配置优先读取被 Git 忽略的 `deploy/env/development/api.env.local`，不存在时才读取无秘密模板。空开发库保存 format v3 的 `captured_empty` 清单，不创建空 SQL；MySQL 未启用时只保存 `not_applicable` 清单。
 3. 将 `database/schema-baselines/<上一发布版本>/` 作为独立中文提交推送 Gitea，核对本地和远程 SHA；既有版本目录禁止覆盖。只有 Git 已跟踪、工作区无改动、当前分支已推送且远程发布标签提交一致时，`governance:start` 才会继续。
 4. 分配功能编号和英文短名称。
 5. 建立 `docs/features/<编号>-<短名称>/`。
@@ -101,10 +101,10 @@ npm run governance:finish -- FEAT-MO-001 market-overview
 - 基线目录固定为 `database/schema-baselines/vX.Y.Z/`，版本是被备份的已发布版本。
 - 真实基线由 `schema.sql`、`manifest.yaml`、`checksum.sha256` 组成；范围包括表、索引、外键、视图、触发器、存储过程、函数和 Event Scheduler 事件，不含数据。
- MySQL 未启用时目录只能包含 `manifest.yaml`，状态为 `not_applicable`、原因为 `mysql_disabled`；启用但无对象时目录也只包含 `manifest.yaml`，状态为 format v2 的 `captured_empty` 并记录零对象计数。
+- MySQL 未启用时目录只能包含 `manifest.yaml`，状态为 `not_applicable`、原因为 `mysql_disabled`；启用但无对象时目录也只包含 `manifest.yaml`，状态为 format v3 的 `captured_empty` 并记录零对象计数。
 - `schema:baseline` 不接受 env 路径、环境类型或数据库名参数；配置路径固定在开发环境，生产配置和生产数据库不属于该命令的权限范围。
 - 修正已发布基线必须新增治理记录说明原因，禁止静默覆盖或重写历史目录。
- 首次启用 MySQL 的版本必须在 MySQL 5.7 开发环境生成第一份真实或 `captured_empty` Schema 基线；format v1 历史清单保持只读兼容，禁止因工具升级重写。
+- 首次启用 MySQL 的版本必须在 MySQL 5.7 开发环境生成第一份真实或 `captured_empty` Schema 基线；format v1/v2 历史清单保持只读兼容，禁止因工具升级重写。
 ## 8. 提交流程
@@ -47,5 +47,7 @@
 - [GOV-008：RocketMQ 消息队列架构调整](features/GOV-008-rocketmq-adoption/manifest.yaml)
 - [GOV-009：应用工程脚手架基线](features/GOV-009-application-scaffold-baseline/manifest.yaml)
 - [GOV-010：开发质量与前后端架构规范](features/GOV-010-development-quality-architecture/manifest.yaml)
 - [GOV-011：Node 与 MySQL 系列版本约束（v0.0.9）](features/GOV-011-runtime-version-series/manifest.yaml)
 - [GOV-012：纯 Node.js 开发库 Schema 导出器](features/GOV-012-node-schema-exporter/manifest.yaml)
 功能档案是需求、设计、代码、测试、版本和回退之间的唯一正式关联入口。
@@ -0,0 +1,488 @@
 # 市场综合概览 TDX 直连实施计划
 > **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:executing-plans` to implement this plan task-by-task with review checkpoints.
 **Goal:** 使用 Nest API 直接读取本机 TDX 隧道，在 Vue 3 首页提供可独立降级的市场综合概览。
 **Architecture:** API 服务通过固定的 `127.0.0.1:17710` TDX HTTP 客户端读取只读行情，将 TDX 原始字段映射为版本化市场概览 DTO。首页按摘要、指数、宽度、板块和资金拆分请求，通过 Axios API 文件消费 Nest 接口；浏览器不直接连接 TDX。
 **Tech Stack:** Vue 3、Vue Router、Pinia、Naive UI、Dart Sass、NestJS 11、TypeScript 5.9、Node.js 22.x 内置 `fetch`、OpenAPI/Swagger、Vitest、Playwright。
 ## Global Constraints
 - Node 使用 `22.x`，MySQL 兼容 `5.7.x`，字符集排序规则为 `utf8mb4_general_ci`。
 - TDX 只读访问固定到服务端 `http://127.0.0.1:17710/`，不得由请求参数传入任意 URL。
 - TDX 不可用时显示 `unavailable`，不得使用离线样本或伪造实时行情回退。
 - 前端业务请求只能位于 `web/src/api/<业务域>/index.ts`，统一调用 `web/src/utils/request.ts` 的 Axios 封装。
 - 业务代码必须提供准确中文注释；不以原子化为目的过度拆分文件。
 - 本功能不启用 MySQL、Redis、RocketMQ、AI、用户体系、交易指令或公网采集链路。
 - 不提交 SSH 地址、Tailscale 地址、密钥、密码、`.env`、真实原始 TDX 载荷或生产数据。
 - 修改符号前必须完成 GitNexus 影响分析；提交前必须执行 GitNexus 变更检测。
 - 每个提交使用中文 Conventional Commit，并立即推送当前分支到项目 Gitea。
 ## 文件地图
 ### 后端
 - Modify: `server/libs/config/src/runtime-config.ts`，增加 API 专属 TDX 地址和超时配置及严格校验。
 - Modify: `deploy/env/development/api.env.example`，增加不含凭据的 `TDX_BASE_URL` 与 `TDX_TIMEOUT_MS` 模板。
 - Create: `server/apps/api/src/market-overview/tdx/tdx.types.ts`，记录已验证的 TDX 请求、响应和错误类型。
 - Create: `server/apps/api/src/market-overview/tdx/tdx.client.ts`，封装固定地址、超时、响应大小和脱敏错误。
 - Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.ts`，转换 TDX 字段和数据口径。
 - Create: `server/apps/api/src/market-overview/market-overview.dto.ts`，定义 OpenAPI/HTTP 响应 DTO。
 - Create: `server/apps/api/src/market-overview/market-overview.service.ts`，并行获取模块数据并生成统一快照元数据。
 - Create: `server/apps/api/src/market-overview/market-overview.controller.ts`，提供五个只读接口。
 - Create: `server/apps/api/src/market-overview/market-overview.module.ts`，装配 TDX 客户端、服务和控制器。
 - Modify: `server/apps/api/src/api.module.ts`，注册市场概览模块并注入 API 配置。
 - Modify: `server/tools/export-openapi.ts`，让 OpenAPI 生成器包含市场概览控制器及其测试替身。
 - Modify: `server/openapi/openapi.json`，提交生成后的契约。
 - Create: `server/apps/api/src/market-overview/tdx/tdx.client.test.ts`，测试 TDX 请求、超时、网络错误和响应上限。
 - Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.test.ts`，测试字段映射、单位和缺失字段。
 - Create: `server/apps/api/src/market-overview/market-overview.service.test.ts`，测试并行接口、快照时间和模块级降级。
 - Create: `server/apps/api/test/market-overview.e2e-spec.ts`，测试 HTTP 状态、响应结构和错误映射。
 ### 前端
 - Modify: `web/src/api/generated/schema.ts`，由 OpenAPI 生成命令更新。
 - Create: `web/src/types/market-overview.ts`，定义页面消费的类型别名和显示状态。
 - Create: `web/src/api/market-overview/index.ts`，集中封装五个 Axios 请求。
 - Create: `web/src/views/market-overview/useMarketOverview.ts`，管理并行加载、刷新、模块状态和分析偏好本地存储。
 - Create: `web/src/views/market-overview/MarketOverviewPage.vue`，组织首屏布局和页面级状态。
 - Create: `web/src/views/market-overview/components/MarketConclusion.vue`，显示结论、交易状态、更新时间和来源。
 - Create: `web/src/views/market-overview/components/MarketDrivers.vue`，显示驱动与风险证据。
 - Create: `web/src/views/market-overview/components/IndexOverview.vue`，显示可点击核心指数。
 - Create: `web/src/views/market-overview/components/MarketBreadth.vue`，显示涨跌分布、宽度和量能。
 - Create: `web/src/views/market-overview/components/SectorOverview.vue`，显示可点击板块排行。
 - Create: `web/src/views/market-overview/components/FundTrend.vue`，显示资金趋势和不可用状态。
 - Modify: `web/src/app/router.ts`，将 `/` 指向市场概览页面。
 - Modify: `web/src/app/App.vue` 与 `web/src/styles/index.scss`，更新应用壳和响应式页面基础样式。
 - Create: `web/src/api/market-overview/index.test.ts`，测试 API 路径、方法、参数和错误脱敏。
 - Create: `web/src/views/market-overview/useMarketOverview.test.ts`，测试并行加载、刷新和偏好保存。
 - Modify: `web/src/app/App.test.ts`，改为验证市场概览首屏语义和状态入口。
 - Modify: `web/tests/smoke.spec.ts`，增加桌面、窄屏、模块降级和无水平溢出验证。
 ### 功能档案
 - Modify: `docs/features/FEAT-MO-001-market-overview/requirements.md`，同步 TDX 直连和分模块接口范围。
 - Modify: `docs/features/FEAT-MO-001-market-overview/design.md`，链接本设计并移除旧的样本默认表述。
 - Modify: `docs/features/FEAT-MO-001-market-overview/implementation-plan.md`，更新为已执行任务索引。
 - Modify: `docs/features/FEAT-MO-001-market-overview/test-plan.md`，加入 TDX 联调、模块降级、安全和性能证据。
 - Create: `docs/features/FEAT-MO-001-market-overview/development-summary.md`，记录原始需求、实际完成、缺陷、延期项、提交和验证证据。
 - Create: `docs/features/FEAT-MO-001-market-overview/review/code-review.md`，记录代码 Review 结论和残余风险。
 - Create: `docs/features/FEAT-MO-001-market-overview/review/standards-review.md`，记录开发规范符合性 Review。
 - Create: `docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md`，只保存脱敏的真实 TDX 字段完整性、耗时和错误分类。
 ---
 ### Task 1: 开发门禁、工作区和 TDX 协议基线
 **Files:**
 - Modify: `docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md`
 - Create: `docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md`
 - Create: `docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md`
 **Interfaces:**
 - Consumes: 已确认设计文档、现有 Tailscale SSH 隧道、开发环境 API 配置。
 - Produces: 新分支和工作区、GitNexus 影响证据、TDX 只读请求方法及脱敏字段基线。
 - [ ] **Step 1: 创建隔离工作区并确认远程状态**
 ```bash
 git fetch origin main
 git worktree add .worktrees/feat-mo-001-tdx-overview -b codex/feat-mo-001-tdx-overview origin/main
 git -C .worktrees/feat-mo-001-tdx-overview status --short --branch
 ```
 预期：新工作区基于已推送的 `9a965fa`，不携带主工作区的 `AGENTS.md` 未提交修改。
 - [ ] **Step 2: 执行开发前门禁并记录结果**
 ```bash
 pnpm schema:baseline
 pnpm schema:verify
 npx gitnexus analyze
 npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "ApiModule.register"
 npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "createAppRouter"
 npx gitnexus impact --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope upstream "createRequestClient"
 ```
 预期：Schema 命令只读取开发环境；若本机缺少 MySQL 5.7.x 客户端，沿用已确认的 FEAT-MO-001 一次性 waiver 记录失败，不伪造基线。任何 HIGH/CRITICAL 影响先记录并暂停代码修改。
 - [ ] **Step 3: 用当前 TDX 隧道执行最小只读协议请求**
 ```bash
 curl --fail-with-body --silent --show-error \
  --connect-timeout 3 --max-time 10 \
  -H 'Content-Type: application/json' \
  -X POST 'http://127.0.0.1:17710/' \
  --data '{"id":1,"method":"get_market_data","params":{"stock_list":["600519.SH"],"count":5,"dividend_type":"none","period":"1d"}}'
 ```
 预期：记录实际 HTTP 状态、业务错误码、响应耗时、字段名称和字段完整性；报告不得保存原始载荷、地址、账户或密钥。若方法不可用，按 TDX 返回的公开错误信息调整为仓库文档支持的只读方法，并把最终方法名写入 `tdx.types.ts` 和冒烟报告。
 - [ ] **Step 4: 提交门禁和协议基线**
 ```bash
 git add docs/features/FEAT-MO-001-market-overview/gitnexus docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md
 git commit -m "docs(FEAT-MO-001): 建立TDX概览开发基线"
 git push -u origin codex/feat-mo-001-tdx-overview
 ```
 预期：提交只包含治理和脱敏报告，不包含真实 TDX 原始 JSON。
 ### Task 2: 配置和 TDX 客户端
 **Files:**
 - Modify: `server/libs/config/src/runtime-config.ts`
 - Modify: `deploy/env/development/api.env.example`
 - Create: `server/apps/api/src/market-overview/tdx/tdx.types.ts`
 - Create: `server/apps/api/src/market-overview/tdx/tdx.client.ts`
 - Create: `server/apps/api/src/market-overview/tdx/tdx.client.test.ts`
 **Interfaces:**
 - Consumes: Task 1 的已验证只读请求方法和字段基线。
 - Produces: `ApiRuntimeConfig.tdx`、`TdxClient.request<TResponse>()`、`TdxClientError`。
 - [ ] **Step 1: 先写配置和客户端失败测试**
 ```ts
 it('拒绝非本机 TDX 地址', () => {
  expect(() => loadApiConfig({ ...validEnv, TDX_BASE_URL: 'http://example.test' })).toThrow(
    'TDX_BASE_URL 必须指向本机回环地址',
  );
 });
 it('将 TDX 超时转换为脱敏错误', async () => {
  const client = createTdxClient({ baseUrl: 'http://127.0.0.1:17710', timeoutMs: 50 }, timeoutFetch);
  await expect(client.request('get_market_data', { stock_list: ['600519.SH'] })).rejects.toMatchObject({
    kind: 'timeout',
  });
 });
 ```
 - [ ] **Step 2: 运行定向测试确认失败**
 ```bash
 pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.client.test.ts
 ```
 预期：因配置字段、客户端工厂和错误类型不存在而失败。
 - [ ] **Step 3: 实现最小配置和客户端**
 `ApiRuntimeConfig` 增加：
 ```ts
 tdx: Readonly<{
  baseUrl: 'http://127.0.0.1:17710';
  timeoutMs: number;
 }>;
 ```
 `TdxClient` 暴露：
 ```ts
 interface TdxClient {
  request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse>;
 }
 ```
 客户端使用 Node 22 内置 `fetch`，固定 POST `/`、JSON-RPC 请求体、连接/读取超时和 1 MiB 响应上限；只抛出 `timeout`、`network`、`protocol`、`unavailable` 四类错误，禁止把 URL、请求头或原始正文放入错误对象。
 - [ ] **Step 4: 运行定向测试确认通过**
 ```bash
 pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.client.test.ts
 pnpm --filter @a-share-analysis/server typecheck
 ```
 - [ ] **Step 5: 提交并推送**
 ```bash
 git add server/libs/config/src/runtime-config.ts deploy/env/development/api.env.example server/apps/api/src/market-overview/tdx
 git commit -m "feat(FEAT-MO-001): 增加TDX直连客户端"
 git push
 ```
 ### Task 3: 市场概览 DTO、映射和分模块 API
 **Files:**
 - Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.ts`
 - Create: `server/apps/api/src/market-overview/tdx/tdx.mapper.test.ts`
 - Create: `server/apps/api/src/market-overview/market-overview.dto.ts`
 - Create: `server/apps/api/src/market-overview/market-overview.service.ts`
 - Create: `server/apps/api/src/market-overview/market-overview.service.test.ts`
 - Create: `server/apps/api/src/market-overview/market-overview.controller.ts`
 - Create: `server/apps/api/src/market-overview/market-overview.module.ts`
 - Modify: `server/apps/api/src/api.module.ts`
 - Create: `server/apps/api/test/market-overview.e2e-spec.ts`
 **Interfaces:**
 - Consumes: `TdxClient.request<TResponse>()` 和 `ApiRuntimeConfig.tdx`。
 - Produces: `GET /api/v1/market-overview/{summary,indices,breadth,sectors,funds}`，统一响应元数据和模块数据。
 - [ ] **Step 1: 写 DTO 和映射失败测试**
 ```ts
 it('将涨跌字段转换为 A 股红涨绿跌口径并保留百分比', () => {
  expect(mapIndexQuote({ code: '000001', name: '上证指数', price: 3380.12, change: 28.4 })).toEqual({
    code: '000001', name: '上证指数', price: 3380.12, changePercent: 0.86, direction: 'up',
  });
 });
 it('缺少板块数据时返回 partial 而不是抛出整页错误', async () => {
  const response = await service.getSectors();
  expect(response.status).toBe('partial');
  expect(response.warnings).toHaveLength(1);
 });
 ```
 - [ ] **Step 2: 运行定向测试确认失败**
 ```bash
 pnpm --filter @a-share-analysis/server exec vitest run apps/api/src/market-overview/tdx/tdx.mapper.test.ts apps/api/src/market-overview/market-overview.service.test.ts
 ```
 - [ ] **Step 3: 实现 DTO 和五个服务方法**
 服务公开以下方法：
 ```ts
 getSummary(): Promise<MarketOverviewResponse<SummaryData>>;
 getIndices(): Promise<MarketOverviewResponse<IndexData>>;
 getBreadth(): Promise<MarketOverviewResponse<BreadthData>>;
 getSectors(): Promise<MarketOverviewResponse<SectorData>>;
 getFunds(): Promise<MarketOverviewResponse<FundData>>;
 ```
 每次请求生成 `snapshotId` 和 `asOf`，调用已验证的 TDX 只读方法，映射后只返回页面需要字段。单模块错误映射为 `partial` 或 `unavailable`，不将 TDX 原始错误透传。
 - [ ] **Step 4: 注册控制器并完成 HTTP 测试**
 控制器只注入 `MarketOverviewService`，每个 `@Get` 方法仅调用对应服务方法并声明 Swagger 成功/不可用响应；模块在 `ApiModule.register(config)` 中装配 `TdxClient` 的配置工厂。
 ```bash
 pnpm --filter @a-share-analysis/server exec vitest run apps/api/test/market-overview.e2e-spec.ts
 ```
 预期：五个接口返回 200 或结构化 503，响应不包含 TDX 地址、请求参数或原始载荷。
 - [ ] **Step 5: 提交并推送**
 ```bash
 git add server/apps/api/src/market-overview server/apps/api/src/api.module.ts server/apps/api/test/market-overview.e2e-spec.ts
 git commit -m "feat(FEAT-MO-001): 增加市场概览分模块接口"
 git push
 ```
 ### Task 4: OpenAPI 契约和前端 API 状态层
 **Files:**
 - Modify: `server/tools/export-openapi.ts`
 - Modify: `server/openapi/openapi.json`
 - Modify: `web/src/api/generated/schema.ts`
 - Create: `web/src/types/market-overview.ts`
 - Create: `web/src/api/market-overview/index.ts`
 - Create: `web/src/api/market-overview/index.test.ts`
 - Create: `web/src/views/market-overview/useMarketOverview.ts`
 - Create: `web/src/views/market-overview/useMarketOverview.test.ts`
 **Interfaces:**
 - Consumes: 后端五个 OpenAPI 路径和 `web/src/utils/request.ts`。
 - Produces: `marketOverviewApi`、`useMarketOverview()`、统一模块加载状态和本地分析偏好。
 - [ ] **Step 1: 先写前端 API 和状态层失败测试**
 ```ts
 it('使用独立路径请求指数接口', async () => {
  const request = vi.fn().mockResolvedValue({ data: { status: 'fresh' } });
  await createMarketOverviewApi(request).getIndices();
  expect(request).toHaveBeenCalledWith({ method: 'GET', url: '/api/v1/market-overview/indices' });
 });
 it('一个模块失败时其他模块仍保留结果', async () => {
  const state = await useMarketOverview({ summary: okSummary, indices: failed, breadth: okBreadth, sectors: okSectors, funds: failed });
  expect(state.summary.status).toBe('ready');
  expect(state.indices.status).toBe('error');
 });
 ```
 - [ ] **Step 2: 运行定向测试确认失败**
 ```bash
 pnpm --filter @a-share-analysis/web exec vitest run src/api/market-overview/index.test.ts src/views/market-overview/useMarketOverview.test.ts
 ```
 - [ ] **Step 3: 生成并校验 OpenAPI 类型**
 ```bash
 pnpm check:contracts
 ```
 预期：生成的 JSON 和 TypeScript 契约只包含五个市场概览路径，且 `verify-generated-contracts` 通过。
 - [ ] **Step 4: 实现 API 文件和 composable**
 API 文件只调用请求封装：
 ```ts
 export function createMarketOverviewApi(requestClient = request) {
  return {
    getSummary: () => requestClient<SummaryResponse>({ method: 'GET', url: '/api/v1/market-overview/summary' }),
    getIndices: () => requestClient<IndicesResponse>({ method: 'GET', url: '/api/v1/market-overview/indices' }),
    getBreadth: () => requestClient<BreadthResponse>({ method: 'GET', url: '/api/v1/market-overview/breadth' }),
    getSectors: () => requestClient<SectorsResponse>({ method: 'GET', url: '/api/v1/market-overview/sectors' }),
    getFunds: () => requestClient<FundsResponse>({ method: 'GET', url: '/api/v1/market-overview/funds' }),
  };
 }
 ```
 `useMarketOverview()` 使用 `Promise.allSettled` 并行加载，暴露 `refresh()`、每个模块的 `loading/ready/error` 状态，以及浏览器 `localStorage` 中的分析周期和分析引擎偏好；不得存储行情原始载荷。
 - [ ] **Step 5: 运行定向测试和类型检查**
 ```bash
 pnpm --filter @a-share-analysis/web exec vitest run src/api/market-overview/index.test.ts src/views/market-overview/useMarketOverview.test.ts
 pnpm --filter @a-share-analysis/web typecheck
 ```
 - [ ] **Step 6: 提交并推送**
 ```bash
 git add server/tools/export-openapi.ts server/openapi/openapi.json web/src/api/generated/schema.ts web/src/types/market-overview.ts web/src/api/market-overview web/src/views/market-overview/useMarketOverview.ts web/src/views/market-overview/useMarketOverview.test.ts
 git commit -m "feat(FEAT-MO-001): 同步市场概览前端契约"
 git push
 ```
 ### Task 5: Vue 首屏和交互状态
 **Files:**
 - Create: `web/src/views/market-overview/MarketOverviewPage.vue`
 - Create: `web/src/views/market-overview/components/MarketConclusion.vue`
 - Create: `web/src/views/market-overview/components/MarketDrivers.vue`
 - Create: `web/src/views/market-overview/components/IndexOverview.vue`
 - Create: `web/src/views/market-overview/components/MarketBreadth.vue`
 - Create: `web/src/views/market-overview/components/SectorOverview.vue`
 - Create: `web/src/views/market-overview/components/FundTrend.vue`
 - Modify: `web/src/app/router.ts`
 - Modify: `web/src/app/App.vue`
 - Modify: `web/src/styles/index.scss`
 - Modify: `web/src/app/App.test.ts`
 - Modify: `web/tests/smoke.spec.ts`
 **Interfaces:**
 - Consumes: `useMarketOverview()`、市场概览类型和 `marketOverviewApi`。
 - Produces: `/` 可访问的市场综合概览首屏，包含数据来源、时间、模块状态、依据入口和分析偏好入口。
 - [ ] **Step 1: 先写页面失败测试**
 ```ts
 it('首屏显示市场结论、更新时间和 TDX 来源', async () => {
  const wrapper = mountMarketOverview({ state: freshState });
  expect(wrapper.getByRole('heading', { name: '市场综合概览' })).toBeTruthy();
  expect(wrapper.getByText('数据来源：TDX')).toBeTruthy();
  expect(wrapper.getByText('更新时间')).toBeTruthy();
 });
 it('TDX 不可用时显示错误状态而不是实时数据', async () => {
  const wrapper = mountMarketOverview({ state: unavailableState });
  expect(wrapper.getByText('TDX 数据不可用')).toBeTruthy();
  expect(wrapper.queryByText('实时行情')).toBeNull();
 });
 ```
 - [ ] **Step 2: 运行前端测试确认失败**
 ```bash
 pnpm --filter @a-share-analysis/web exec vitest run src/app/App.test.ts
 ```
 - [ ] **Step 3: 实现首屏和组件状态**
 页面保持结论优先顺序；指数、板块使用按钮/链接样式保留未来详情页入口；加载、空、部分、过期、错误状态均有明确文案和稳定尺寸。分析周期和分析引擎使用 Naive UI 的选择控件，偏好保存在本地，不触发 TDX 请求参数变化。
 - [ ] **Step 4: 接入路由和应用壳**
 `createAppRouter()` 的 `/` 路由渲染 `MarketOverviewPage`；应用壳保留可访问 header、main 和 `NMessageProvider`，不新增无业务意义的导航菜单。
 - [ ] **Step 5: 运行组件、构建和浏览器冒烟**
 ```bash
 pnpm --filter @a-share-analysis/web exec vitest run src/app/App.test.ts src/views/market-overview
 pnpm --filter @a-share-analysis/web build
 pnpm verify:e2e -- --project=chromium
 ```
 预期：桌面和窄屏无横向溢出，TDX 连接不可用时页面仍可读但明确标记不可用。
 - [ ] **Step 6: 提交并推送**
 ```bash
 git add web/src/views/market-overview web/src/app/router.ts web/src/app/App.vue web/src/styles/index.scss web/src/app/App.test.ts web/tests/smoke.spec.ts
 git commit -m "feat(FEAT-MO-001): 完成TDX市场概览首屏"
 git push
 ```
 ### Task 6: 真实 TDX 联调、文档追踪和 Review
 **Files:**
 - Modify: `docs/features/FEAT-MO-001-market-overview/requirements.md`
 - Modify: `docs/features/FEAT-MO-001-market-overview/design.md`
 - Modify: `docs/features/FEAT-MO-001-market-overview/implementation-plan.md`
 - Modify: `docs/features/FEAT-MO-001-market-overview/test-plan.md`
 - Create: `docs/features/FEAT-MO-001-market-overview/development-summary.md`
 - Create: `docs/features/FEAT-MO-001-market-overview/review/code-review.md`
 - Create: `docs/features/FEAT-MO-001-market-overview/review/standards-review.md`
 - Modify: `docs/features/FEAT-MO-001-market-overview/manifest.yaml`
 **Interfaces:**
 - Consumes: 已完成的 API、前端页面、脱敏 TDX 基线和测试结果。
 - Produces: 完整功能档案、开发总结、安全/性能证据、代码 Review 和规范 Review。
 - [ ] **Step 1: 外出 Tailscale 隧道执行真实只读联调**
 ```bash
 ssh -S "$HOME/.ssh/tdx-windows-tailnet-control" -O check tdx-windows-tailnet
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 pnpm --filter @a-share-analysis/server exec vitest run apps/api/test/market-overview.e2e-spec.ts
 ```
 记录接口耗时、字段完整性、模块状态和 TDX 错误分类；报告不保存地址、密钥、完整请求或完整响应。
 - [ ] **Step 2: 更新功能档案**
 开发总结必须明确：原始需求、范围变化（由分层混合改为 TDX 单路径）、实际完成、修复缺陷、延期项、关键提交、测试/构建/视觉证据和残余风险。需求、设计、测试计划和 manifest 的状态必须一致。
 - [ ] **Step 3: 执行代码 Review 和规范 Review**
 Review 至少检查：TDX 地址白名单、错误脱敏、模块级降级、请求超时、响应大小、DTO 不透传原始字段、Axios API 边界、中文注释、性能目标、无凭据提交和移动端溢出。问题及处置写入两个 Review 文档。
 - [ ] **Step 4: 完成全量验证和 GitNexus 变更检测**
 ```bash
 npx gitnexus analyze
 npx gitnexus detect-changes --repo /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis --scope all
 pnpm verify
 pnpm verify:source
 ```
 预期：GitNexus 只显示市场概览、配置、OpenAPI、前端路由和测试相关变更；任何未预期跨模块影响必须先处置。
 - [ ] **Step 5: 执行治理收尾并推送标签（仅在用户批准发布时）**
 ```bash
 pnpm governance:finish -- FEAT-MO-001 market-overview
 git add docs/features/FEAT-MO-001-market-overview
 git commit -m "docs(FEAT-MO-001): 完成市场概览开发收尾"
 git push
 ```
 未获发布批准前不创建或推送版本标签；所有提交推送失败时不得标记功能完成。
 ## 计划自审
 - 设计中的五个分模块接口均在 Task 3、Task 4、Task 5 有对应实现和测试。
 - TDX 单一路径、无样本回退、安全、性能、分钟级刷新、错误状态和脱敏报告均有明确任务。
 - OpenAPI、前端 Axios API 文件、Nest 分层、中文注释和 GitNexus 门禁均有明确文件及命令。
 - 没有 `TODO`、`TBD` 或未定义的后续函数；TDX 方法名在 Task 1 以实际只读协议验证结果为准并写入类型，避免臆测字段。
 - MySQL/Redis/RocketMQ/AI/用户体系未被实现任务隐式引入。
@@ -0,0 +1,140 @@
 # 市场综合概览 TDX 直连设计
 - 功能编号：FEAT-MO-001
 - 设计版本：0.2
 - 状态：已获用户确认，待实现计划
 - 日期：2026-08-18
 ## 1. 设计目标
 首页市场概览直接使用 TDX 行情数据，向用户提供结论优先的综合盘面视图。数据链路不保留离线样本 Provider 或运行时数据源切换，TDX 不可用时明确展示不可用状态，不伪造实时行情。
 首屏支持综合、短线和中长线视角，以及规则、AI、混合和对照模式的状态入口；本次 TDX 首屏只提供统一的市场快照和规则事实展示，不在本轮实现付费 AI 结论。
 ## 2. 系统边界
 浏览器不得直接连接 TDX。Nest API 在服务端调用本机 TDX 隧道端点，Vue 通过既有 Axios 封装访问 Nest API。
 ```text
 Vue 市场概览
  -> Axios request 封装
  -> Nest 市场概览 API
  -> TDX HTTP 客户端
  -> 127.0.0.1:17710
  -> SSH / Tailscale 隧道
  -> Windows 127.0.0.1:17709
  -> TDX
 ```
 家庭局域网和外出 Tailscale 只改变 SSH 别名和网络路径，业务服务始终访问本机 `127.0.0.1:17710`。真实地址、用户、密钥和控制套接字只保存在开发机，不进入仓库。
 ## 3. 后端模块设计
 后端按市场概览业务模块组织，保持连续可读的职责边界：
 ```text
 server/apps/api/src/market-overview/
 ├── market-overview.module.ts
 ├── market-overview.controller.ts
 ├── market-overview.service.ts
 ├── market-overview.dto.ts
 └── tdx/
    ├── tdx.client.ts
    ├── tdx.mapper.ts
    └── tdx.types.ts
 ```
 - `controller`：提供按业务模块拆分的只读 HTTP 接口。
 - `service`：组织 TDX 数据、统一快照时间并生成规则事实摘要。
 - `dto`：定义 HTTP 响应契约，禁止把 TDX 原始字段直接暴露给前端。
 - `tdx.client`：只负责请求本机 TDX 端点、超时和协议级错误。
 - `tdx.mapper`：把 TDX 原始字段转换为领域字段和展示口径。
 - `tdx.types`：描述经过确认的 TDX 原始响应结构。
 首版接口：
 ```text
 GET /api/market-overview/summary
 GET /api/market-overview/indices
 GET /api/market-overview/breadth
 GET /api/market-overview/sectors
 GET /api/market-overview/funds
 ```
 接口按模块拆分，页面进入时可并行请求；每个接口失败不会使其他模块整体失败。未来详情页可以复用指数和板块的业务边界，不通过新增巨型首页接口解决。
 ## 4. 前端模块设计
 ```text
 web/src/
 ├── api/market-overview/index.ts
 ├── views/market-overview/
 │   ├── MarketOverviewPage.vue
 │   ├── useMarketOverview.ts
 │   └── components/
 └── types/market-overview.ts
 ```
 业务请求只能通过 `web/src/api/market-overview/index.ts` 调用 `web/src/utils/request.ts`。页面组件不直接使用 Axios、不拼接 TDX 地址，也不读取服务端环境变量。
 首屏顺序：市场结论、驱动与风险、核心指数、涨跌分布与市场宽度、成交量与成交额、板块强弱、资金趋势、更新时间和 TDX 连接状态。指数和板块保留进入未来详情页的可识别入口。
 ## 5. 响应契约与状态
 每个业务接口采用统一外层结构：
 ```json
 {
  "snapshotId": "20260818-101500",
  "asOf": "2026-08-18T10:15:00+08:00",
  "source": "tdx",
  "status": "fresh",
  "data": {},
  "warnings": []
 }
 ```
 `status` 取值为 `fresh`、`delayed`、`partial` 或 `unavailable`。`snapshotId` 和 `asOf` 用于让并行接口在同一次市场快照下可对照；数据日期、更新时间和来源状态必须在页面可见。
 - TDX 单个模块失败：只显示对应模块错误。
 - TDX 返回部分字段：保留可用字段并标记 `partial`。
 - TDX 超时或完全不可用：显示连接状态和重试入口，不显示虚假行情。
 - 后端日志只记录脱敏错误摘要，不保存完整原始行情载荷。
 ## 6. 安全策略
 - TDX 地址固定来自服务端配置，禁止由 HTTP 请求参数传入任意 URL，避免 SSRF。
 - TDX 仅通过本机回环端点访问；Windows TDX 继续只监听 `127.0.0.1:17709`。
 - API 只读，不提供交易指令、买卖建议、目标价或仓位建议。
 - SSH、Tailscale、TDX 账号、密钥、密码、本地环境文件和生产地址不提交 Git。
 - 真实行情只用于只读联调，日志、测试报告和截图不得保存家庭网络信息或完整原始载荷。
 ## 7. 性能策略
 - 页面并行请求各业务接口，避免串行阻塞整页。
 - TDX 客户端设置连接超时和读取超时，并记录请求耗时。
 - DTO 只返回页面需要字段，不透传完整 TDX 原始响应。
 - 首版采用分钟级刷新，不承诺秒级实时；暂不启用 Redis 缓存，待数据口径和刷新频率稳定后评估。
 - 前端使用模块级加载、空、部分数据和错误状态，避免一个模块阻断首屏。
 ## 8. 测试与验证
 - TDX 类型转换和展示口径的单元测试。
 - 每个接口的成功、超时、空数据、部分字段和不可用测试。
 - Nest API 响应契约和错误状态测试。
 - Vue API 模块、页面状态和模块级失败降级测试。
 - 家庭局域网 SSH 路径和外出 Tailscale SSH 路径的端到端只读联调。
 - 桌面与窄屏视觉验证，确认结论、更新时间和错误状态不重叠。
 - 开发前和提交前执行 GitNexus 影响分析与变更检测；开发完成执行代码 Review、规范 Review、测试、构建和 `governance:finish`。
 ## 9. 明确不在本次实现范围
 - 离线样本 Provider、运行时数据源切换和自动回退。
 - MySQL、Redis、RocketMQ 的正式行情存储或采集链路。
 - 付费 AI 请求和 AI 结论生成。
 - 用户、邀请、会员、订阅、社区、自选股、笔记、计划和交易功能。
 - 指数或板块详情页的完整实现；本次只保留入口和接口边界。
 ## 10. 回退方案
 若 TDX 协议字段无法稳定确认、首屏核心模块无法独立降级或隧道联调影响本地构建，则停止 TDX 直连功能提交，回退到上一个本地标签；不得以样本数据冒充 TDX 实时结果。回退只撤销本功能提交，不删除开发机 SSH、Tailscale 或 TDX 配置。
@@ -10,6 +10,15 @@ export default [
  eslint.configs.recommended,
  ...tseslint.configs.recommended,
  ...vue.configs['flat/recommended'],
  {
    files: ['**/*.vue'],
    languageOptions: {
      parserOptions: {
        // Vue 单文件组件的 script setup 使用 TypeScript，避免 ESLint 退回 Espree。
        parser: tseslint.parser,
      },
    },
  },
  {
    files: ['**/*.{js,mjs,cjs,ts,tsx,vue}'],
    languageOptions: {
@@ -19,7 +19,7 @@
    "test:governance": "node --test tools/governance/feature-record.test.mjs",
    "test:mysql-baseline": "node --test tools/governance/mysql-baseline.test.mjs",
    "test:environment-baseline": "node --test tools/governance/environment-baseline.test.mjs",
-    "test:schema-baseline": "node --test tools/database/schema-baseline.test.mjs",
+    "test:schema-baseline": "node --test tools/database/schema-baseline.test.mjs tools/database/mysql2-schema-exporter.test.mjs",
    "schema:baseline": "node tools/database/schema-baseline.mjs generate",
    "schema:verify": "node tools/database/schema-baseline.mjs verify",
    "governance:start": "node tools/governance/start.mjs",
@@ -44,6 +44,7 @@
    "eslint": "9.39.5",
    "eslint-plugin-vue": "9.33.0",
    "globals": "17.11.0",
    "mysql2": "3.23.3",
    "prettier": "3.9.6",
    "typescript": "5.9.3",
    "typescript-eslint": "8.46.2"
@@ -26,6 +26,9 @@ importers:
      globals:
        specifier: 17.11.0
        version: 17.11.0
      mysql2:
        specifier: 3.23.3
        version: 3.23.3(@types/node@22.20.0)
      prettier:
        specifier: 3.9.6
        version: 3.9.6
@@ -6,6 +6,7 @@ import { createMysqlHealthClient } from '../../../libs/infrastructure/src/mysql-
 import { createRedisHealthClient } from '../../../libs/infrastructure/src/redis-health.client';
 import { HealthController } from './health.controller';
 import { HealthService, MYSQL_HEALTH_PORT, REDIS_HEALTH_PORT } from './health.service';
 import { MarketOverviewModule } from './market-overview/market-overview.module';
 /** API 进程的只读配置注入令牌，确保测试和启动入口使用同一份显式配置。 */
 export const API_RUNTIME_CONFIG = Symbol('API_RUNTIME_CONFIG');
@@ -19,6 +20,7 @@ export class ApiModule {
  static register(config: ApiRuntimeConfig): DynamicModule {
    return {
      module: ApiModule,
      imports: [MarketOverviewModule.register(config)],
      controllers: [HealthController],
      providers: [
        HealthService,
@@ -0,0 +1,47 @@
 import { Controller, Get, Inject } from '@nestjs/common';
 import { ApiOkResponse, ApiTags } from '@nestjs/swagger';
 import {
  BreadthResponseDto,
  FundsResponseDto,
  IndicesResponseDto,
  SectorsResponseDto,
  SummaryResponseDto,
 } from './market-overview.dto';
 import { MarketOverviewService } from './market-overview.service';
@ApiTags('market-overview')
@Controller('market-overview')
 export class MarketOverviewController {
  constructor(@Inject(MarketOverviewService) private readonly service: MarketOverviewService) {}
  @Get('summary')
  @ApiOkResponse({ type: SummaryResponseDto })
  getSummary(): Promise<SummaryResponseDto> {
    return this.service.getSummary();
  }
  @Get('indices')
  @ApiOkResponse({ type: IndicesResponseDto })
  getIndices(): Promise<IndicesResponseDto> {
    return this.service.getIndices();
  }
  @Get('breadth')
  @ApiOkResponse({ type: BreadthResponseDto })
  getBreadth(): Promise<BreadthResponseDto> {
    return this.service.getBreadth();
  }
  @Get('sectors')
  @ApiOkResponse({ type: SectorsResponseDto })
  getSectors(): Promise<SectorsResponseDto> {
    return this.service.getSectors();
  }
  @Get('funds')
  @ApiOkResponse({ type: FundsResponseDto })
  getFunds(): Promise<FundsResponseDto> {
    return this.service.getFunds();
  }
 }
@@ -0,0 +1,147 @@
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 export type MarketOverviewStatus = 'fresh' | 'delayed' | 'partial' | 'unavailable';
 export type QuoteDirection = 'up' | 'down' | 'flat';
 export class MarketOverviewMetaDto {
  @ApiProperty({ type: String })
  snapshotId!: string;
  @ApiProperty({ type: String, format: 'date-time' })
  asOf!: string;
  @ApiProperty({ type: String, enum: ['tdx'] })
  source!: 'tdx';
  @ApiProperty({ enum: ['fresh', 'delayed', 'partial', 'unavailable'] })
  status!: MarketOverviewStatus;
  @ApiProperty({ type: [String] })
  warnings!: string[];
 }
 export class IndexQuoteDto {
  @ApiProperty({ type: String })
  code!: string;
  @ApiProperty({ type: String })
  name!: string;
  @ApiProperty({ type: Number })
  price!: number;
  @ApiPropertyOptional({ type: Number, nullable: true })
  changePercent!: number | null;
  @ApiProperty({ enum: ['up', 'down', 'flat'] })
  direction!: QuoteDirection;
  @ApiProperty({ type: String })
  tradeDate!: string;
 }
 export class IndicesDataDto {
  @ApiProperty({ type: [IndexQuoteDto] })
  items!: IndexQuoteDto[];
 }
 export class SummaryDataDto {
  @ApiProperty({ type: String })
  verdict!: string;
  @ApiProperty({ type: String })
  marketStatus!: string;
  @ApiProperty({ type: String })
  volumeStatus!: string;
  @ApiProperty({ type: String })
  sentimentStatus!: string;
  @ApiProperty({ type: [String] })
  drivers!: string[];
  @ApiProperty({ type: [String] })
  risks!: string[];
 }
 export class BreadthDataDto {
  @ApiProperty({ type: Number })
  advancing!: number;
  @ApiProperty({ type: Number })
  declining!: number;
  @ApiProperty({ type: Number, nullable: true })
  unchanged!: number | null;
 }
 export class SectorQuoteDto {
  @ApiProperty({ type: String })
  code!: string;
  @ApiProperty({ type: String })
  name!: string;
  @ApiProperty({ type: Number })
  changePercent!: number;
  @ApiProperty({ enum: ['up', 'down', 'flat'] })
  direction!: QuoteDirection;
  @ApiProperty({ type: String })
  tradeDate!: string;
 }
 export class SectorDataDto {
  @ApiProperty({ type: [SectorQuoteDto] })
  items!: SectorQuoteDto[];
 }
 export class FundDataDto {
  @ApiProperty({ type: Number })
  currentAmount!: number;
  @ApiProperty({ type: Number })
  previousAmount!: number;
  @ApiProperty({ type: Number })
  changePercent!: number;
  @ApiProperty({ type: String, example: '亿元' })
  unit!: '亿元';
  @ApiProperty({ type: Number, minimum: 1, maximum: 3 })
  marketCount!: number;
  @ApiProperty({ type: String, example: '20260818' })
  tradeDate!: string;
  @ApiProperty({ type: String, example: '20260817' })
  previousTradeDate!: string;
 }
 export class SummaryResponseDto extends MarketOverviewMetaDto {
  @ApiProperty({ type: () => SummaryDataDto, nullable: true })
  data!: SummaryDataDto | null;
 }
 export class IndicesResponseDto extends MarketOverviewMetaDto {
  @ApiProperty({ type: () => IndicesDataDto, nullable: true })
  data!: IndicesDataDto | null;
 }
 export class BreadthResponseDto extends MarketOverviewMetaDto {
  @ApiProperty({ type: () => BreadthDataDto, nullable: true })
  data!: BreadthDataDto | null;
 }
 export class SectorsResponseDto extends MarketOverviewMetaDto {
  @ApiProperty({ type: () => SectorDataDto, nullable: true })
  data!: SectorDataDto | null;
 }
 export class FundsResponseDto extends MarketOverviewMetaDto {
  @ApiProperty({ type: () => FundDataDto, nullable: true })
  data!: FundDataDto | null;
 }
@@ -0,0 +1,21 @@
 import { type DynamicModule, Module } from '@nestjs/common';
 import type { ApiRuntimeConfig } from '../../../../libs/config/src/runtime-config';
 import { MarketOverviewController } from './market-overview.controller';
 import { MarketOverviewService, TDX_CLIENT_PORT } from './market-overview.service';
 import { createTdxClient } from './tdx/tdx.client';
@Module({})
 export class MarketOverviewModule {
  /** 将 API 已校验的 TDX 配置注入业务模块，避免模块内部重新读取环境变量。 */
  static register(config: ApiRuntimeConfig): DynamicModule {
    return {
      module: MarketOverviewModule,
      controllers: [MarketOverviewController],
      providers: [
        MarketOverviewService,
        { provide: TDX_CLIENT_PORT, useValue: createTdxClient(config.tdx) },
      ],
    };
  }
 }
@@ -0,0 +1,323 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { MarketOverviewService } from './market-overview.service';
 const indexSeries = {
  Date: ['20260817', '20260818'],
  Open: ['3350', '3370'],
  High: ['3385', '3400'],
  Low: ['3340', '3360'],
  Close: ['3360', '3380'],
  Amount: ['100', '120'],
  Volume: ['1000', '1100'],
 };
 const indexResult = {
  ErrorId: '0',
  Value: Object.fromEntries(
    ['000001.SH', '399001.SZ', '399006.SZ'].map((code) => [code, indexSeries]),
  ),
 };
 const breadthSnapshot = (up: string, down: string) => ({
  ErrorId: '0',
  UpHome: up,
  DownHome: down,
  ItemNum: '0',
 });
 const sectorResult = {
  ErrorId: '0',
  Value: [
    { Code: '881319.SH', Name: '半导体' },
    { Code: '881355.SH', Name: '软件服务' },
  ],
 };
 const sectorKlineResult = {
  ErrorId: '0',
  Value: {
    '881319.SH': {
      Date: ['20260817', '20260818'],
      Open: ['100', '105'],
      High: ['106', '110'],
      Low: ['99', '104'],
      Close: ['100', '108'],
      Amount: ['1000', '1200'],
      Volume: ['100', '120'],
    },
    '881355.SH': {
      Date: ['20260817', '20260818'],
      Open: ['100', '98'],
      High: ['101', '99'],
      Low: ['97', '95'],
      Close: ['100', '96'],
      Amount: ['1000', '900'],
      Volume: ['100', '90'],
    },
  },
 };
 const turnoverResult = {
  ErrorId: '0',
  Value: Object.fromEntries(
    ['000001.SH', '399001.SZ', '899050.BJ'].map((code) => [
      code,
      {
        Date: ['20260817', '20260818'],
        Open: ['100', '100'],
        High: ['101', '101'],
        Low: ['99', '99'],
        Close: ['100', '100'],
        Amount: ['100000', '120000'],
        Volume: ['1000', '1100'],
      },
    ]),
  ),
 };
 describe('市场概览服务', () => {
  beforeEach(() => {
    vi.useFakeTimers();
    vi.setSystemTime(new Date('2026-08-18T03:00:00.000Z'));
  });
  afterEach(() => {
    vi.useRealTimers();
  });
  it('读取指数并返回统一快照元数据', async () => {
    const client = { request: vi.fn().mockResolvedValue(indexResult) };
    const service = new MarketOverviewService(client);
    const response = await service.getIndices();
    expect(response).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: { items: expect.any(Array) },
    });
    expect(response.snapshotId).toMatch(/^20260818-/);
    expect(client.request).toHaveBeenCalledWith(
      'get_market_data',
      expect.objectContaining({ count: 5 }),
    );
  });
  it('核心指数交易日旧于上海当前日期时标记 delayed', async () => {
    vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
    const client = { request: vi.fn().mockResolvedValue(indexResult) };
    const service = new MarketOverviewService(client);
    const response = await service.getIndices();
    expect(response.status).toBe('delayed');
    expect(response.warnings).toEqual(['核心指数交易日期为 20260818，非当前日期']);
  });
  it('汇总三个市场指数的上涨和下跌家数并保留未知平盘数', async () => {
    const client = {
      request: vi
        .fn()
        .mockResolvedValueOnce(breadthSnapshot('10', '5'))
        .mockResolvedValueOnce(breadthSnapshot('20', '15'))
        .mockResolvedValueOnce(breadthSnapshot('3', '2'))
        .mockResolvedValueOnce(indexResult),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getBreadth();
    expect(response).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: { advancing: 33, declining: 22, unchanged: null },
    });
    expect(client.request).toHaveBeenCalledWith(
      'get_market_snapshot',
      expect.objectContaining({ stock_code: '000001.SH' }),
    );
  });
  it('市场宽度排除畸形快照并标记部分数据', async () => {
    const client = {
      request: vi
        .fn()
        .mockResolvedValueOnce(breadthSnapshot('10', '5'))
        .mockResolvedValueOnce({ ErrorId: '0', UpHome: '', DownHome: '3' })
        .mockRejectedValueOnce(new Error('raw network detail'))
        .mockResolvedValueOnce(indexResult),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getBreadth();
    expect(response).toMatchObject({
      status: 'partial',
      data: { advancing: 10, declining: 5, unchanged: null },
    });
    expect(response.warnings[0]).toContain('深证市场、北证市场');
    expect(response.warnings.join(' ')).not.toContain('raw network detail');
  });
  it('市场宽度使用核心指数交易日识别 delayed，不把旧快照标为 fresh', async () => {
    const staleIndexResult = structuredClone(indexResult);
    staleIndexResult.Value['000001.SH'].Date = ['20260816', '20260817'];
    const client = {
      request: vi
        .fn()
        .mockResolvedValueOnce(breadthSnapshot('10', '5'))
        .mockResolvedValueOnce(breadthSnapshot('20', '15'))
        .mockResolvedValueOnce(breadthSnapshot('3', '2'))
        .mockResolvedValueOnce(staleIndexResult),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getBreadth();
    expect(response.status).toBe('delayed');
    expect(response.warnings).toEqual(['市场宽度交易日期为 20260817，非当前日期']);
  });
  it('按一级行业涨跌幅排序板块并保留 TDX 代码', async () => {
    const client = {
      request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(sectorKlineResult),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getSectors();
    expect(response).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: {
        items: [
          expect.objectContaining({ code: '881319.SH', name: '半导体', changePercent: 8 }),
          expect.objectContaining({ code: '881355.SH', name: '软件服务', changePercent: -4 }),
        ],
      },
    });
    expect(client.request).toHaveBeenNthCalledWith(1, 'get_stock_list', {
      market: '16',
      list_type: 1,
    });
  });
  it('一级行业目录为空时返回不可用而不是 fresh 空数据', async () => {
    const client = { request: vi.fn().mockResolvedValue({ ErrorId: '0', Value: [] }) };
    const service = new MarketOverviewService(client);
    const response = await service.getSectors();
    expect(response).toMatchObject({ status: 'unavailable', data: null });
    expect(response.warnings).toEqual(['一级行业目录为空']);
    expect(client.request).toHaveBeenCalledTimes(1);
  });
  it('一级行业强弱结果最多展示前八项', async () => {
    const definitions = Array.from({ length: 9 }, (_, index) => ({
      Code: `88100${index}.SH`,
      Name: `行业${index}`,
    }));
    const value = Object.fromEntries(
      definitions.map(({ Code }, index) => [
        Code,
        {
          ...indexSeries,
          Close: ['100', `${101 + index}`],
        },
      ]),
    );
    const client = {
      request: vi
        .fn()
        .mockResolvedValueOnce({ ErrorId: '0', Value: definitions })
        .mockResolvedValueOnce({ ErrorId: '0', Value: value }),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getSectors();
    expect(response.status).toBe('fresh');
    expect(response.data?.items).toHaveLength(8);
    expect(response.data?.items[0].name).toBe('行业8');
  });
  it('一级行业混合交易日时返回 partial，不把不同日期误标 fresh', async () => {
    const mixedDates = structuredClone(sectorKlineResult);
    mixedDates.Value['881355.SH'].Date = ['20260818', '20260819'];
    const client = {
      request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(mixedDates),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getSectors();
    expect(response).toMatchObject({
      status: 'partial',
      data: { items: [expect.objectContaining({ code: '881355.SH', tradeDate: '20260819' })] },
    });
    expect(response.warnings).toEqual(['部分一级行业未返回有效行情']);
  });
  it('一级行业交易日旧于上海当前日期时标记 delayed', async () => {
    vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
    const client = {
      request: vi.fn().mockResolvedValueOnce(sectorResult).mockResolvedValueOnce(sectorKlineResult),
    };
    const service = new MarketOverviewService(client);
    const response = await service.getSectors();
    expect(response.status).toBe('delayed');
    expect(response.warnings).toEqual(['一级行业交易日期为 20260818，非当前日期']);
  });
  it('按交易所指数成交额计算亿元级趋势而不宣称主力净流入', async () => {
    const client = { request: vi.fn().mockResolvedValue(turnoverResult) };
    const service = new MarketOverviewService(client);
    const response = await service.getFunds();
    expect(response).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: {
        currentAmount: 36,
        previousAmount: 30,
        changePercent: 20,
        unit: '亿元',
        marketCount: 3,
        tradeDate: '20260818',
        previousTradeDate: '20260817',
      },
    });
    expect(response.warnings).toEqual([]);
  });
  it('成交额缺少一个市场时标记 partial 并展示实际市场数', async () => {
    const partialResult = structuredClone(turnoverResult);
    delete partialResult.Value['899050.BJ'];
    const client = { request: vi.fn().mockResolvedValue(partialResult) };
    const service = new MarketOverviewService(client);
    const response = await service.getFunds();
    expect(response).toMatchObject({
      status: 'partial',
      data: { currentAmount: 24, previousAmount: 20, marketCount: 2, tradeDate: '20260818' },
    });
    expect(response.warnings).toEqual(['部分市场成交额不可用，当前汇总 2 个市场']);
  });
  it('成交额交易日旧于上海当前日期时标记 delayed', async () => {
    vi.setSystemTime(new Date('2026-08-19T03:00:00.000Z'));
    const client = { request: vi.fn().mockResolvedValue(turnoverResult) };
    const service = new MarketOverviewService(client);
    const response = await service.getFunds();
    expect(response.status).toBe('delayed');
    expect(response.warnings).toEqual(['成交额交易日期为 20260818，非当前日期']);
  });
 });
@@ -0,0 +1,301 @@
 import { Inject, Injectable } from '@nestjs/common';
 import type {
  BreadthDataDto,
  FundDataDto,
  IndicesDataDto,
  SectorDataDto,
  SummaryDataDto,
 } from './market-overview.dto';
 import { CORE_INDEXES } from './tdx/tdx.types';
 import {
  mapBreadthSnapshots,
  mapIndexQuotes,
  mapSectorQuotes,
  mapTurnoverTrend,
 } from './tdx/tdx.mapper';
 import { TdxClientError, type TdxClient } from './tdx/tdx.client';
 import type {
  TdxMarketDataResult,
  TdxMarketSnapshotResult,
  TdxStockListResult,
 } from './tdx/tdx.types';
 import { BREADTH_INDEXES, TURNOVER_INDEXES } from './tdx/tdx.types';
 export const TDX_CLIENT_PORT = Symbol('TDX_CLIENT_PORT');
 export type MarketOverviewResponse<TData> = {
  snapshotId: string;
  asOf: string;
  source: 'tdx';
  status: 'fresh' | 'delayed' | 'partial' | 'unavailable';
  data: TData | null;
  warnings: string[];
 };
 function createSnapshotMeta(): Pick<
  MarketOverviewResponse<never>,
  'snapshotId' | 'asOf' | 'source'
 > {
  const asOf = new Date().toISOString();
  const snapshotId = `${asOf.slice(0, 10).replaceAll('-', '')}-${asOf.slice(11, 19).replaceAll(':', '')}`;
  return { snapshotId, asOf, source: 'tdx' };
 }
 /** 交易日状态统一按上海日历判断；休市日保守标记 delayed，避免把历史值冒充实时。 */
 function getShanghaiCalendarDate(asOf: string): string {
  const parts = new Intl.DateTimeFormat('en-US', {
    timeZone: 'Asia/Shanghai',
    year: 'numeric',
    month: '2-digit',
    day: '2-digit',
  }).formatToParts(new Date(asOf));
  const values = Object.fromEntries(parts.map((part) => [part.type, part.value]));
  return `${values.year}${values.month}${values.day}`;
 }
 function createTradeDateWarning(subject: string, tradeDate: string | undefined, asOf: string) {
  if (!tradeDate) return `${subject}交易日期无法确认`;
  return tradeDate === getShanghaiCalendarDate(asOf)
    ? null
    : `${subject}交易日期为 ${tradeDate}，非当前日期`;
 }
@Injectable()
 export class MarketOverviewService {
  constructor(@Inject(TDX_CLIENT_PORT) private readonly tdxClient: TdxClient) {}
  async getIndices(): Promise<MarketOverviewResponse<IndicesDataDto>> {
    const meta = createSnapshotMeta();
    try {
      const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
        stock_list: CORE_INDEXES.map((item) => item.code),
        count: 5,
        dividend_type: 'none',
        period: '1d',
      });
      const items = mapIndexQuotes(result, CORE_INDEXES);
      const tradeDateWarning = createTradeDateWarning('核心指数', items[0]?.tradeDate, meta.asOf);
      const status =
        items.length !== CORE_INDEXES.length ? 'partial' : tradeDateWarning ? 'delayed' : 'fresh';
      return {
        ...meta,
        status,
        data: { items },
        warnings:
          status === 'partial'
            ? ['部分核心指数未返回有效数据']
            : tradeDateWarning
              ? [tradeDateWarning]
              : [],
      };
    } catch (error) {
      return {
        ...meta,
        status: 'unavailable',
        data: null,
        warnings: [this.toWarning(error, '核心指数')],
      };
    }
  }
  async getSummary(): Promise<MarketOverviewResponse<SummaryDataDto>> {
    const indices = await this.getIndices();
    if (indices.status === 'unavailable' || !indices.data) {
      return { ...indices, data: null };
    }
    const changes = indices.data.items
      .map((item) => item.changePercent)
      .filter((value): value is number => value !== null);
    const averageChange = changes.length
      ? Math.round((changes.reduce((sum, value) => sum + value, 0) / changes.length) * 100) / 100
      : null;
    const marketStatus =
      averageChange === null ? '指数数据不完整' : averageChange >= 0 ? '指数偏强' : '指数偏弱';
    const summary: SummaryDataDto = {
      verdict:
        averageChange === null
          ? '市场状态待确认'
          : averageChange >= 0
            ? '市场维持偏强震荡'
            : '市场维持偏弱震荡',
      marketStatus,
      volumeStatus: '成交额趋势见下方',
      sentimentStatus: '涨跌家数见下方',
      drivers: changes.length ? [`核心指数平均涨跌幅 ${averageChange}%`] : ['核心指数数据不足'],
      risks: ['主力净流入和盘中新闻仍待补充数据源验证'],
    };
    return { ...indices, data: summary };
  }
  async getBreadth(): Promise<MarketOverviewResponse<BreadthDataDto>> {
    const meta = createSnapshotMeta();
    const [results, [referenceResult]] = await Promise.all([
      Promise.allSettled(
        BREADTH_INDEXES.map((item) =>
          this.tdxClient.request<TdxMarketSnapshotResult>('get_market_snapshot', {
            stock_code: item.code,
          }),
        ),
      ),
      Promise.allSettled([
        this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
          stock_list: [CORE_INDEXES[0].code],
          count: 1,
          dividend_type: 'none',
          period: '1d',
        }),
      ]),
    ]);
    const validSnapshots = results.flatMap((result) => {
      if (result.status === 'rejected') return [];
      return mapBreadthSnapshots([result.value]).validCount === 1 ? [result.value] : [];
    });
    const mapped = mapBreadthSnapshots(validSnapshots);
    const unavailableMarkets = BREADTH_INDEXES.filter((_, index) => {
      const result = results[index];
      return (
        !result ||
        result.status === 'rejected' ||
        mapBreadthSnapshots([result.value]).validCount === 0
      );
    }).map((item) => item.name);
    if (!mapped.data) {
      return {
        ...meta,
        status: 'unavailable',
        data: null,
        warnings: [`市场宽度数据不可用：${unavailableMarkets.join('、')}`],
      };
    }
    const referenceTradeDate =
      referenceResult?.status === 'fulfilled'
        ? mapIndexQuotes(referenceResult.value, [CORE_INDEXES[0]])[0]?.tradeDate
        : undefined;
    const tradeDateWarning = createTradeDateWarning('市场宽度', referenceTradeDate, meta.asOf);
    const status =
      mapped.validCount !== BREADTH_INDEXES.length
        ? 'partial'
        : tradeDateWarning
          ? 'delayed'
          : 'fresh';
    return {
      ...meta,
      status,
      data: mapped.data,
      warnings:
        status === 'partial'
          ? [`部分市场涨跌家数不可用：${unavailableMarkets.join('、')}`]
          : tradeDateWarning
            ? [tradeDateWarning]
            : [],
    };
  }
  async getSectors(): Promise<MarketOverviewResponse<SectorDataDto>> {
    const meta = createSnapshotMeta();
    try {
      const catalog = await this.tdxClient.request<TdxStockListResult>('get_stock_list', {
        market: '16',
        list_type: 1,
      });
      const definitions = catalog.Value.map(({ Code: code, Name: name }) => ({ code, name }));
      if (!definitions.length) {
        return {
          ...meta,
          status: 'unavailable',
          data: null,
          warnings: ['一级行业目录为空'],
        };
      }
      const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
        stock_list: definitions.map((item) => item.code),
        count: 2,
        dividend_type: 'none',
        period: '1d',
      });
      const mappedItems = mapSectorQuotes(result, definitions);
      const items = mappedItems.slice(0, 8);
      const tradeDateWarning = createTradeDateWarning(
        '一级行业',
        mappedItems[0]?.tradeDate,
        meta.asOf,
      );
      const status =
        mappedItems.length === 0
          ? 'unavailable'
          : mappedItems.length !== definitions.length
            ? 'partial'
            : tradeDateWarning
              ? 'delayed'
              : 'fresh';
      return {
        ...meta,
        status,
        data: items.length ? { items } : null,
        warnings:
          status === 'fresh'
            ? []
            : status === 'partial'
              ? ['部分一级行业未返回有效行情']
              : status === 'delayed' && tradeDateWarning
                ? [tradeDateWarning]
                : ['一级行业行情不可用'],
      };
    } catch (error) {
      return {
        ...meta,
        status: 'unavailable',
        data: null,
        warnings: [this.toWarning(error, '板块行情')],
      };
    }
  }
  async getFunds(): Promise<MarketOverviewResponse<FundDataDto>> {
    const meta = createSnapshotMeta();
    try {
      const result = await this.tdxClient.request<TdxMarketDataResult>('get_market_data', {
        stock_list: TURNOVER_INDEXES.map((item) => item.code),
        count: 2,
        dividend_type: 'none',
        period: '1d',
      });
      const mapped = mapTurnoverTrend(result, TURNOVER_INDEXES);
      if (!mapped.data)
        return { ...meta, status: 'unavailable', data: null, warnings: ['成交额趋势数据不完整'] };
      const tradeDateWarning = createTradeDateWarning('成交额', mapped.data.tradeDate, meta.asOf);
      const status =
        mapped.validMarketCount !== TURNOVER_INDEXES.length
          ? 'partial'
          : tradeDateWarning
            ? 'delayed'
            : 'fresh';
      return {
        ...meta,
        status,
        data: mapped.data,
        warnings:
          status === 'partial'
            ? [`部分市场成交额不可用，当前汇总 ${mapped.validMarketCount} 个市场`]
            : tradeDateWarning
              ? [tradeDateWarning]
              : [],
      };
    } catch (error) {
      return {
        ...meta,
        status: 'unavailable',
        data: null,
        warnings: [this.toWarning(error, '成交额趋势')],
      };
    }
  }
  private toWarning(error: unknown, subject: string): string {
    if (error instanceof TdxClientError && error.kind === 'timeout') return `${subject}请求超时`;
    if (error instanceof TdxClientError && error.kind === 'network') return `${subject}网络不可用`;
    return `${subject}数据不可用`;
  }
 }
@@ -0,0 +1,78 @@
 import { describe, expect, it, vi } from 'vitest';
 import { createTdxClient } from './tdx.client';
 function response(body: unknown, init?: ResponseInit): Response {
  return new Response(JSON.stringify(body), {
    status: 200,
    headers: { 'content-type': 'application/json' },
    ...init,
  });
 }
 describe('TDX 客户端', () => {
  it('发送固定 JSON 请求并返回业务结果', async () => {
    const fetchImpl = vi
      .fn<typeof fetch>()
      .mockResolvedValue(response({ id: 1, result: { ErrorId: '0', Value: {} } }));
    const client = createTdxClient({
      baseUrl: 'http://127.0.0.1:17710',
      timeoutMs: 5_000,
      fetchImpl,
    });
    await expect(client.request('get_market_data', { stock_list: ['600519.SH'] })).resolves.toEqual(
      {
        ErrorId: '0',
        Value: {},
      },
    );
    expect(fetchImpl).toHaveBeenCalledWith(
      'http://127.0.0.1:17710/',
      expect.objectContaining({
        method: 'POST',
        headers: { 'content-type': 'application/json' },
      }),
    );
    const request = fetchImpl.mock.calls[0]?.[1];
    expect(JSON.parse(String(request?.body))).toMatchObject({
      id: 1,
      method: 'get_market_data',
      params: { stock_list: ['600519.SH'] },
    });
  });
  it('将 TDX 错误响应转换为脱敏协议错误', async () => {
    const fetchImpl = vi
      .fn<typeof fetch>()
      .mockResolvedValue(
        response({ id: 1, error: { code: 'bad_request', message: '内部连接信息' } }),
      );
    const client = createTdxClient({
      baseUrl: 'http://127.0.0.1:17710',
      timeoutMs: 5_000,
      fetchImpl,
    });
    const firstError = client.request('get_market_data', {});
    await expect(firstError).rejects.toMatchObject({
      kind: 'protocol',
      message: 'TDX 返回业务错误',
    });
    await expect(firstError).rejects.not.toThrow('内部连接信息');
  });
  it('将 AbortError 转换为超时错误', async () => {
    const fetchImpl = vi
      .fn<typeof fetch>()
      .mockRejectedValue(new DOMException('aborted', 'AbortError'));
    const client = createTdxClient({
      baseUrl: 'http://127.0.0.1:17710',
      timeoutMs: 50,
      fetchImpl,
    });
    await expect(client.request('get_market_data', {})).rejects.toMatchObject({ kind: 'timeout' });
  });
 });
@@ -0,0 +1,101 @@
 import type { TdxRuntimeConfig } from '../../../../../libs/config/src/runtime-config';
 export type TdxClientErrorKind = 'timeout' | 'network' | 'protocol' | 'unavailable';
 export class TdxClientError extends Error {
  constructor(
    readonly kind: TdxClientErrorKind,
    message: string,
  ) {
    super(message);
    this.name = 'TdxClientError';
  }
 }
 export interface TdxClient {
  request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse>;
 }
 export interface TdxClientOptions extends TdxRuntimeConfig {
  fetchImpl?: typeof fetch;
  maxResponseBytes?: number;
 }
 interface TdxRpcEnvelope<TResponse> {
  id?: number;
  result?: TResponse;
  error?: unknown;
 }
 const DEFAULT_MAX_RESPONSE_BYTES = 1 * 1024 * 1024;
 function isAbortError(error: unknown): boolean {
  return error instanceof Error && error.name === 'AbortError';
 }
 function hasBusinessError(value: unknown): boolean {
  if (!value || typeof value !== 'object') return false;
  const record = value as Record<string, unknown>;
  return 'ErrorId' in record && record.ErrorId !== '0' && record.ErrorId !== 0;
 }
 /**
 * 将 TDX 的 JSON-RPC/业务错误限制在客户端边界内，避免 URL、请求头和原始载荷进入上层异常。
 */
 export function createTdxClient({
  baseUrl,
  timeoutMs,
  fetchImpl = fetch,
  maxResponseBytes = DEFAULT_MAX_RESPONSE_BYTES,
 }: TdxClientOptions): TdxClient {
  const endpoint = `${baseUrl.replace(/\/$/, '')}/`;
  let requestId = 0;
  return {
    async request<TResponse>(method: string, params: Record<string, unknown>): Promise<TResponse> {
      const controller = new AbortController();
      const timeout = setTimeout(() => controller.abort(), timeoutMs);
      try {
        const response = await fetchImpl(endpoint, {
          method: 'POST',
          headers: { 'content-type': 'application/json' },
          body: JSON.stringify({ id: ++requestId, method, params }),
          signal: controller.signal,
        });
        const contentLength = response.headers.get('content-length');
        if (contentLength && Number(contentLength) > maxResponseBytes) {
          throw new TdxClientError('protocol', 'TDX 响应体超过安全上限');
        }
        const text = await response.text();
        if (Buffer.byteLength(text, 'utf8') > maxResponseBytes) {
          throw new TdxClientError('protocol', 'TDX 响应体超过安全上限');
        }
        if (!response.ok) throw new TdxClientError('unavailable', 'TDX 服务不可用');
        let envelope: TdxRpcEnvelope<TResponse>;
        try {
          envelope = JSON.parse(text) as TdxRpcEnvelope<TResponse>;
        } catch {
          throw new TdxClientError('protocol', 'TDX 返回格式错误');
        }
        if (envelope.error !== undefined || envelope.result === undefined) {
          throw new TdxClientError('protocol', 'TDX 返回业务错误');
        }
        if (hasBusinessError(envelope.result)) {
          throw new TdxClientError('protocol', 'TDX 返回业务错误');
        }
        return envelope.result;
      } catch (error) {
        if (error instanceof TdxClientError) throw error;
        if (isAbortError(error)) throw new TdxClientError('timeout', 'TDX 请求超时');
        throw new TdxClientError('network', 'TDX 网络请求失败');
      } finally {
        clearTimeout(timeout);
      }
    },
  };
 }
@@ -0,0 +1,461 @@
 import { describe, expect, it } from 'vitest';
 import {
  mapBreadthSnapshots,
  mapIndexQuotes,
  mapSectorQuotes,
  mapTurnoverTrend,
 } from './tdx.mapper';
 describe('TDX 行情映射', () => {
  it('将 K 线数组转换为 A 股红涨绿跌的指数报价', () => {
    const result = mapIndexQuotes(
      {
        ErrorId: '0',
        Value: {
          '000001.SH': {
            Date: ['20260817', '20260818'],
            Open: ['3350.00', '3370.00'],
            High: ['3385.00', '3400.00'],
            Low: ['3340.00', '3360.00'],
            Close: ['3360.00', '3380.16'],
            Amount: ['100', '120'],
            Volume: ['1000', '1100'],
          },
        },
      },
      [{ code: '000001.SH', name: '上证指数' }],
    );
    expect(result).toEqual([
      expect.objectContaining({
        code: '000001.SH',
        name: '上证指数',
        price: 3380.16,
        changePercent: 0.6,
        direction: 'up',
        tradeDate: '20260818',
      }),
    ]);
  });
  it('缺少前一日收盘价时标记为平盘并保留当前价', () => {
    const result = mapIndexQuotes(
      {
        ErrorId: '0',
        Value: {
          '399006.SZ': {
            Date: ['20260818'],
            Open: ['2100.00'],
            High: ['2110.00'],
            Low: ['2090.00'],
            Close: ['2105.00'],
            Amount: ['100'],
            Volume: ['1000'],
          },
        },
      },
      [{ code: '399006.SZ', name: '创业板指' }],
    );
    expect(result[0]).toMatchObject({ price: 2105, changePercent: null, direction: 'flat' });
  });
  it.each([
    ['非法公历日期', ['20269999', '20260818']],
    ['重复日期', ['20260818', '20260818']],
    ['倒序日期', ['20260819', '20260818']],
  ])('前一根 K 线为%s时保留指数当前价但不计算涨跌', (_caseName, dates) => {
    const result = mapIndexQuotes(
      {
        ErrorId: '0',
        Value: {
          '000001.SH': {
            Date: dates,
            Open: ['100', '200'],
            High: ['100', '200'],
            Low: ['100', '200'],
            Close: ['100', '200'],
            Amount: ['1', '1'],
            Volume: ['1', '1'],
          },
        },
      },
      [{ code: '000001.SH', name: '上证指数' }],
    );
    expect(result).toEqual([
      expect.objectContaining({
        code: '000001.SH',
        price: 200,
        changePercent: null,
        direction: 'flat',
        tradeDate: '20260818',
      }),
    ]);
  });
  it('市场宽度映射只汇总可用的上涨和下跌家数', () => {
    expect(
      mapBreadthSnapshots([
        { UpHome: '10', DownHome: '5' },
        { UpHome: '2', DownHome: '3' },
      ]),
    ).toEqual({
      data: { advancing: 12, declining: 8, unchanged: null },
      validCount: 2,
    });
  });
  it('市场宽度排除字段缺失、非数值和负数的快照', () => {
    expect(
      mapBreadthSnapshots([
        { UpHome: '10', DownHome: '5' },
        { UpHome: '', DownHome: '3' },
        { UpHome: 'NaN', DownHome: '2' },
        { UpHome: '-1', DownHome: '2' },
      ]),
    ).toEqual({
      data: { advancing: 10, declining: 5, unchanged: null },
      validCount: 1,
    });
  });
  it('市场宽度拒绝小数和十六进制字符串，避免把非计数值纳入汇总', () => {
    expect(
      mapBreadthSnapshots([
        { UpHome: '1.5', DownHome: '5' },
        { UpHome: '0x10', DownHome: '2' },
        { UpHome: '1e3', DownHome: '2' },
        { UpHome: '9007199254740992', DownHome: '2' },
        { UpHome: '10', DownHome: '5' },
      ]),
    ).toEqual({
      data: { advancing: 10, declining: 5, unchanged: null },
      validCount: 1,
    });
  });
  it('核心指数混合交易日时只保留最新交易日，避免跨日组合', () => {
    const result = mapIndexQuotes(
      {
        ErrorId: '0',
        Value: {
          '000001.SH': {
            Date: ['20260817', '20260818'],
            Open: ['1', '1'],
            High: ['1', '1'],
            Low: ['1', '1'],
            Close: ['100', '102'],
            Amount: ['1', '1'],
            Volume: ['1', '1'],
          },
          '399001.SZ': {
            Date: ['20260818', '20260819'],
            Open: ['1', '1'],
            High: ['1', '1'],
            Low: ['1', '1'],
            Close: ['100', '101'],
            Amount: ['1', '1'],
            Volume: ['1', '1'],
          },
        },
      },
      [
        { code: '000001.SH', name: '旧日期指数' },
        { code: '399001.SZ', name: '最新日期指数' },
      ],
    );
    expect(result).toEqual([expect.objectContaining({ code: '399001.SZ', tradeDate: '20260819' })]);
  });
  it('核心指数拒绝不存在的公历日期，避免畸形日期抢占最新截面', () => {
    const series = (dates: string[], close: string[]) => ({
      Date: dates,
      Open: close,
      High: close,
      Low: close,
      Close: close,
      Amount: ['1', '1'],
      Volume: ['1', '1'],
    });
    expect(
      mapIndexQuotes(
        {
          ErrorId: '0',
          Value: {
            '000001.SH': series(['20260817', '20260818'], ['100', '102']),
            '399001.SZ': series(['20269898', '20269999'], ['100', '101']),
          },
        },
        [
          { code: '000001.SH', name: '有效日期指数' },
          { code: '399001.SZ', name: '畸形日期指数' },
        ],
      ),
    ).toEqual([expect.objectContaining({ code: '000001.SH', tradeDate: '20260818' })]);
  });
  it('板块只保留有两个交易日和有效涨跌幅的精确字段', () => {
    const result = mapSectorQuotes(
      {
        ErrorId: '0',
        Value: {
          '881001.SH': {
            Date: ['20260817', '20260818'],
            Open: ['1', '1'],
            High: ['1', '1'],
            Low: ['1', '1'],
            Close: ['100', '102'],
            Amount: ['1', '1'],
            Volume: ['1', '1'],
          },
          '881002.SH': {
            Date: ['20260818'],
            Open: ['1'],
            High: ['1'],
            Low: ['1'],
            Close: ['100'],
            Amount: ['1'],
            Volume: ['1'],
          },
        },
      },
      [
        { code: '881001.SH', name: '行业一' },
        { code: '881002.SH', name: '行业二' },
      ],
    );
    expect(result).toEqual([
      {
        code: '881001.SH',
        name: '行业一',
        changePercent: 2,
        direction: 'up',
        tradeDate: '20260818',
      },
    ]);
  });
  it('板块前一根 K 线日期无效时不进入强弱排序', () => {
    expect(
      mapSectorQuotes(
        {
          ErrorId: '0',
          Value: {
            '881001.SH': {
              Date: ['20269999', '20260818'],
              Open: ['100', '200'],
              High: ['100', '200'],
              Low: ['100', '200'],
              Close: ['100', '200'],
              Amount: ['1', '1'],
              Volume: ['1', '1'],
            },
          },
        },
        [{ code: '881001.SH', name: '畸形日期行业' }],
      ),
    ).toEqual([]);
  });
  it('板块混合交易日时只保留最新交易日，避免把不同日期混排', () => {
    const series = (dates: string[], close: string[]) => ({
      Date: dates,
      Open: close,
      High: close,
      Low: close,
      Close: close,
      Amount: ['1', '1'],
      Volume: ['1', '1'],
    });
    expect(
      mapSectorQuotes(
        {
          ErrorId: '0',
          Value: {
            '881001.SH': series(['20260817', '20260818'], ['100', '102']),
            '881002.SH': series(['20260818', '20260819'], ['100', '101']),
          },
        },
        [
          { code: '881001.SH', name: '旧日期行业' },
          { code: '881002.SH', name: '最新日期行业' },
        ],
      ),
    ).toEqual([expect.objectContaining({ code: '881002.SH', tradeDate: '20260819' })]);
  });
  it('成交额映射将 TDX 万元转换为亿元并计算环比', () => {
    expect(
      mapTurnoverTrend(
        {
          ErrorId: '0',
          Value: {
            '000001.SH': {
              Date: ['20260817', '20260818'],
              Open: ['1', '1'],
              High: ['1', '1'],
              Low: ['1', '1'],
              Close: ['1', '1'],
              Amount: ['100000', '120000'],
              Volume: ['1', '1'],
            },
          },
        },
        [{ code: '000001.SH', name: '上证市场' }],
      ),
    ).toEqual({
      data: {
        currentAmount: 12,
        previousAmount: 10,
        changePercent: 20,
        unit: '亿元',
        marketCount: 1,
        tradeDate: '20260818',
        previousTradeDate: '20260817',
      },
      validMarketCount: 1,
    });
  });
  it('成交额只汇总交易日期一致且金额非负的市场', () => {
    const series = (dates: string[], amounts: string[]) => ({
      Date: dates,
      Open: ['1', '1'],
      High: ['1', '1'],
      Low: ['1', '1'],
      Close: ['1', '1'],
      Amount: amounts,
      Volume: ['1', '1'],
    });
    const result = mapTurnoverTrend(
      {
        ErrorId: '0',
        Value: {
          '000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
          '399001.SZ': series(['20260816', '20260817'], ['200000', '240000']),
          '899050.BJ': series(['20260817', '20260818'], ['10000', '-1']),
        },
      },
      [
        { code: '000001.SH', name: '上证市场' },
        { code: '399001.SZ', name: '深证市场' },
        { code: '899050.BJ', name: '北证市场' },
      ],
    );
    expect(result).toMatchObject({
      validMarketCount: 1,
      data: { currentAmount: 12, previousAmount: 10, marketCount: 1, tradeDate: '20260818' },
    });
  });
  it('成交额以多数市场的最新交易日为锚，避免首个市场日期异常导致丢数', () => {
    const series = (dates: string[], amounts: string[]) => ({
      Date: dates,
      Open: ['1', '1'],
      High: ['1', '1'],
      Low: ['1', '1'],
      Close: ['1', '1'],
      Amount: amounts,
      Volume: ['1', '1'],
    });
    expect(
      mapTurnoverTrend(
        {
          ErrorId: '0',
          Value: {
            '000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
            '399001.SZ': series(['20260818', '20260819'], ['200000', '240000']),
            '899050.BJ': series(['20260818', '20260819'], ['300000', '360000']),
          },
        },
        [
          { code: '000001.SH', name: '上证市场' },
          { code: '399001.SZ', name: '深证市场' },
          { code: '899050.BJ', name: '北证市场' },
        ],
      ),
    ).toEqual({
      data: {
        currentAmount: 60,
        previousAmount: 50,
        changePercent: 20,
        unit: '亿元',
        marketCount: 2,
        tradeDate: '20260819',
        previousTradeDate: '20260818',
      },
      validMarketCount: 2,
    });
  });
  it('成交额排除倒序和非法公历日期，不能让异常日期抢占汇总锚点', () => {
    const series = (dates: string[], amounts: string[]) => ({
      Date: dates,
      Open: ['1', '1'],
      High: ['1', '1'],
      Low: ['1', '1'],
      Close: ['1', '1'],
      Amount: amounts,
      Volume: ['1', '1'],
    });
    expect(
      mapTurnoverTrend(
        {
          ErrorId: '0',
          Value: {
            '000001.SH': series(['20260817', '20260818'], ['100000', '120000']),
            '399001.SZ': series(['20260817', '20260818'], ['200000', '240000']),
            '899050.BJ': series(['20260820', '20260819'], ['300000', '360000']),
            '899051.BJ': series(['20269898', '20269999'], ['300000', '360000']),
          },
        },
        [
          { code: '000001.SH', name: '上证市场' },
          { code: '399001.SZ', name: '深证市场' },
          { code: '899050.BJ', name: '日期倒序市场' },
          { code: '899051.BJ', name: '非法日期市场' },
        ],
      ),
    ).toEqual({
      data: {
        currentAmount: 36,
        previousAmount: 30,
        changePercent: 20,
        unit: '亿元',
        marketCount: 2,
        tradeDate: '20260818',
        previousTradeDate: '20260817',
      },
      validMarketCount: 2,
    });
  });
  it('成交额拒绝日期与金额数组错位的市场', () => {
    expect(
      mapTurnoverTrend(
        {
          ErrorId: '0',
          Value: {
            '000001.SH': {
              Date: ['20260816', '20260817', '20260818'],
              Open: ['1', '1', '1'],
              High: ['1', '1', '1'],
              Low: ['1', '1', '1'],
              Close: ['1', '1', '1'],
              Amount: ['100000', '120000'],
              Volume: ['1', '1', '1'],
            },
          },
        },
        [{ code: '000001.SH', name: '数组错位市场' }],
      ),
    ).toEqual({ data: null, validMarketCount: 0 });
  });
 });
@@ -0,0 +1,200 @@
 import type {
  BreadthDataDto,
  FundDataDto,
  IndexQuoteDto,
  SectorQuoteDto,
 } from '../market-overview.dto';
 import type { IndexDefinition, TdxMarketDataResult, TdxKlineSeries } from './tdx.types';
 function toNumber(value: string | undefined): number | null {
  if (value === undefined || value.trim() === '') return null;
  const parsed = Number(value);
  return Number.isFinite(parsed) ? parsed : null;
 }
 function toNonNegativeNumber(value: string | undefined): number | null {
  const parsed = toNumber(value);
  return parsed !== null && parsed >= 0 ? parsed : null;
 }
 function toNonNegativeInteger(value: string | undefined): number | null {
  const normalized = value?.trim();
  if (!normalized || !/^\d+$/.test(normalized)) return null;
  const parsed = Number(normalized);
  return Number.isSafeInteger(parsed) ? parsed : null;
 }
 function toTradeDate(value: string | undefined): string | null {
  if (!value || !/^\d{8}$/.test(value)) return null;
  const year = Number(value.slice(0, 4));
  const month = Number(value.slice(4, 6));
  const day = Number(value.slice(6, 8));
  const date = new Date(0);
  date.setUTCHours(0, 0, 0, 0);
  date.setUTCFullYear(year, month - 1, day);
  return year >= 1000 &&
    date.getUTCFullYear() === year &&
    date.getUTCMonth() === month - 1 &&
    date.getUTCDate() === day
    ? value
    : null;
 }
 function latestTradeDate<T extends { tradeDate: string }>(items: readonly T[]): string | null {
  return items.reduce<string | null>(
    (latest, item) => (latest === null || item.tradeDate > latest ? item.tradeDate : latest),
    null,
  );
 }
 function mapDirection(changePercent: number | null): IndexQuoteDto['direction'] {
  if (changePercent === null || changePercent === 0) return 'flat';
  return changePercent > 0 ? 'up' : 'down';
 }
 function mapIndexQuote(series: TdxKlineSeries, definition: IndexDefinition): IndexQuoteDto | null {
  const lastIndex = series.Close.length - 1;
  const price = toNumber(series.Close[lastIndex]);
  const previousPrice = toNumber(series.Close[lastIndex - 1]);
  const tradeDate = toTradeDate(series.Date[lastIndex]);
  if (price === null || !tradeDate) return null;
  const previousTradeDate = toTradeDate(series.Date[lastIndex - 1]);
  const changePercent =
    previousPrice === null ||
    previousPrice === 0 ||
    previousTradeDate === null ||
    previousTradeDate >= tradeDate
      ? null
      : Math.round(((price - previousPrice) / previousPrice) * 100 * 100) / 100;
  return {
    code: definition.code,
    name: definition.name,
    price,
    changePercent,
    direction: mapDirection(changePercent),
    tradeDate,
  };
 }
 /** 只把已确认字段映射为领域 DTO，缺失的单个指数不阻断其他指数。 */
 export function mapIndexQuotes(
  result: TdxMarketDataResult,
  definitions: readonly IndexDefinition[],
 ): IndexQuoteDto[] {
  const candidates = definitions.flatMap((definition) => {
    const series = result.Value[definition.code];
    if (!series) return [];
    const quote = mapIndexQuote(series, definition);
    return quote ? [quote] : [];
  });
  const tradeDate = latestTradeDate(candidates);
  return tradeDate ? candidates.filter((item) => item.tradeDate === tradeDate) : [];
 }
 /** TDX 涨跌家数必须成对有效且非负；无效市场整体排除，禁止把缺失字段折算为零。 */
 export function mapBreadthSnapshots(snapshots: readonly { UpHome?: string; DownHome?: string }[]): {
  data: BreadthDataDto | null;
  validCount: number;
 } {
  const validSnapshots = snapshots.flatMap((item) => {
    const advancing = toNonNegativeInteger(item.UpHome);
    const declining = toNonNegativeInteger(item.DownHome);
    return advancing === null || declining === null ? [] : [{ advancing, declining }];
  });
  if (!validSnapshots.length) return { data: null, validCount: 0 };
  return {
    data: {
      advancing: validSnapshots.reduce((total, item) => total + item.advancing, 0),
      declining: validSnapshots.reduce((total, item) => total + item.declining, 0),
      unchanged: null,
    },
    validCount: validSnapshots.length,
  };
 }
 /** 一级行业只有在具备相邻两日收盘价时才参与强弱排序，返回对象严格匹配公开 DTO。 */
 export function mapSectorQuotes(
  result: TdxMarketDataResult,
  definitions: readonly IndexDefinition[],
 ): SectorQuoteDto[] {
  const candidates = definitions.flatMap((definition) => {
    const series = result.Value[definition.code];
    if (!series) return [];
    const quote = mapIndexQuote(series, definition);
    if (!quote || quote.changePercent === null) return [];
    return [
      {
        code: quote.code,
        name: quote.name,
        changePercent: quote.changePercent,
        direction: quote.direction,
        tradeDate: quote.tradeDate,
      },
    ];
  });
  const tradeDate = latestTradeDate(candidates);
  return candidates
    .filter((item) => item.tradeDate === tradeDate)
    .sort((left, right) => right.changePercent - left.changePercent);
 }
 /** 成交额仅汇总交易日期对齐、金额非负的市场；TDX Amount 从万元转换为亿元。 */
 export function mapTurnoverTrend(
  result: TdxMarketDataResult,
  definitions: readonly IndexDefinition[],
 ): { data: FundDataDto | null; validMarketCount: number } {
  const candidates = definitions.flatMap((definition) => {
    const series = result.Value[definition.code];
    if (!series) return [];
    if (series.Date.length < 2 || series.Date.length !== series.Amount.length) return [];
    const current = toNonNegativeNumber(series.Amount.at(-1));
    const previous = toNonNegativeNumber(series.Amount.at(-2));
    const tradeDate = toTradeDate(series.Date.at(-1));
    const previousTradeDate = toTradeDate(series.Date.at(-2));
    if (
      current === null ||
      previous === null ||
      previous === 0 ||
      !tradeDate ||
      !previousTradeDate ||
      previousTradeDate >= tradeDate
    ) {
      return [];
    }
    return [{ current, previous, tradeDate, previousTradeDate }];
  });
  if (!candidates.length) return { data: null, validMarketCount: 0 };
  const expected = candidates.reduce((latest, item) =>
    item.tradeDate > latest.tradeDate ||
    (item.tradeDate === latest.tradeDate && item.previousTradeDate > latest.previousTradeDate)
      ? item
      : latest,
  );
  const aligned = candidates.filter(
    (item) =>
      item.tradeDate === expected.tradeDate &&
      item.previousTradeDate === expected.previousTradeDate,
  );
  const currentAmount = aligned.reduce((total, item) => total + item.current, 0);
  const previousAmount = aligned.reduce((total, item) => total + item.previous, 0);
  if (previousAmount === 0) return { data: null, validMarketCount: aligned.length };
  return {
    data: {
      currentAmount: Math.round((currentAmount / 10000) * 100) / 100,
      previousAmount: Math.round((previousAmount / 10000) * 100) / 100,
      changePercent: Math.round(((currentAmount - previousAmount) / previousAmount) * 10000) / 100,
      unit: '亿元',
      marketCount: aligned.length,
      tradeDate: expected.tradeDate,
      previousTradeDate: expected.previousTradeDate,
    },
    validMarketCount: aligned.length,
  };
 }
@@ -0,0 +1,55 @@
 export interface TdxKlineSeries {
  Date: string[];
  Open: string[];
  High: string[];
  Low: string[];
  Close: string[];
  Amount: string[];
  Volume: string[];
  ForwardFactor?: string[];
 }
 export interface TdxMarketDataResult {
  ErrorId: string | number;
  Value: Record<string, TdxKlineSeries>;
 }
 export interface TdxMarketSnapshotResult {
  ErrorId: string | number;
  UpHome?: string;
  DownHome?: string;
  Inside?: string;
  Outside?: string;
  Amount?: string;
 }
 export interface TdxStockListResult {
  ErrorId: string | number;
  Value: Array<{ Code: string; Name: string }>;
 }
 export interface IndexDefinition {
  code: string;
  name: string;
 }
 /** 首屏只使用已通过 TDX K 线只读冒烟的三大指数，代码口径统一带市场后缀。 */
 export const CORE_INDEXES: readonly IndexDefinition[] = [
  { code: '000001.SH', name: '上证指数' },
  { code: '399001.SZ', name: '深证成指' },
  { code: '399006.SZ', name: '创业板指' },
 ];
 /** TDX 快照对指数提供上涨/下跌家数，三个市场相加后作为首屏市场宽度口径。 */
 export const BREADTH_INDEXES: readonly IndexDefinition[] = [
  { code: '000001.SH', name: '上证市场' },
  { code: '399001.SZ', name: '深证市场' },
  { code: '899050.BJ', name: '北证市场' },
 ];
 /** 首屏资金模块使用交易所指数成交额，避免把成交额趋势误称为主力净流入。 */
 export const TURNOVER_INDEXES: readonly IndexDefinition[] = [
  { code: '000001.SH', name: '上证市场' },
  { code: '399001.SZ', name: '深证市场' },
  { code: '899050.BJ', name: '北证市场' },
 ];
@@ -0,0 +1,119 @@
 import type { INestApplication } from '@nestjs/common';
 import { Test } from '@nestjs/testing';
 import request from 'supertest';
 import { afterEach, describe, expect, it, vi } from 'vitest';
 import { MarketOverviewController } from '../src/market-overview/market-overview.controller';
 import {
  MarketOverviewService,
  TDX_CLIENT_PORT,
 } from '../src/market-overview/market-overview.service';
 describe('市场概览 HTTP API', () => {
  let app: INestApplication | undefined;
  afterEach(async () => {
    await app?.close();
    app = undefined;
  });
  it('按模块返回指数和 TDX 来源元数据', async () => {
    const client = {
      request: vi.fn().mockResolvedValue({
        ErrorId: '0',
        Value: {
          '000001.SH': {
            Date: ['20260817', '20260818'],
            Open: ['3350', '3370'],
            High: ['3385', '3400'],
            Low: ['3340', '3360'],
            Close: ['3360', '3380'],
            Amount: ['100', '120'],
            Volume: ['1000', '1100'],
          },
          '399001.SZ': {
            Date: ['20260817', '20260818'],
            Open: ['10000', '10100'],
            High: ['10200', '10300'],
            Low: ['9900', '10050'],
            Close: ['10000', '10200'],
            Amount: ['100', '120'],
            Volume: ['1000', '1100'],
          },
          '399006.SZ': {
            Date: ['20260817', '20260818'],
            Open: ['2100', '2110'],
            High: ['2120', '2130'],
            Low: ['2090', '2100'],
            Close: ['2100', '2120'],
            Amount: ['100', '120'],
            Volume: ['1000', '1100'],
          },
        },
      }),
    };
    const moduleRef = await Test.createTestingModule({
      controllers: [MarketOverviewController],
      providers: [MarketOverviewService, { provide: TDX_CLIENT_PORT, useValue: client }],
    }).compile();
    app = moduleRef.createNestApplication();
    app.setGlobalPrefix('api/v1');
    await app.init();
    const response = await request(app.getHttpServer())
      .get('/api/v1/market-overview/indices')
      .expect(200);
    expect(response.body).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: { items: expect.any(Array) },
    });
    expect(JSON.stringify(response.body)).not.toContain('127.0.0.1');
  });
  it('板块接口返回可点击的 TDX 一级行业对象', async () => {
    const client = {
      request: vi
        .fn()
        .mockResolvedValueOnce({
          ErrorId: '0',
          Value: [{ Code: '881319.SH', Name: '半导体' }],
        })
        .mockResolvedValueOnce({
          ErrorId: '0',
          Value: {
            '881319.SH': {
              Date: ['20260817', '20260818'],
              Open: ['100', '101'],
              High: ['102', '103'],
              Low: ['99', '100'],
              Close: ['100', '102'],
              Amount: ['1000', '1200'],
              Volume: ['100', '120'],
            },
          },
        }),
    };
    const moduleRef = await Test.createTestingModule({
      controllers: [MarketOverviewController],
      providers: [MarketOverviewService, { provide: TDX_CLIENT_PORT, useValue: client }],
    }).compile();
    app = moduleRef.createNestApplication();
    app.setGlobalPrefix('api/v1');
    await app.init();
    const response = await request(app.getHttpServer())
      .get('/api/v1/market-overview/sectors')
      .expect(200);
    expect(response.body).toMatchObject({
      source: 'tdx',
      status: 'fresh',
      data: {
        items: [expect.objectContaining({ code: '881319.SH', name: '半导体', changePercent: 2 })],
      },
    });
    expect(JSON.stringify(response.body)).not.toContain('127.0.0.1');
  });
 });
@@ -50,6 +50,8 @@ describe('进程级运行配置', () => {
      LOG_LEVEL: 'debug',
      API_HOST: '127.0.0.1',
      API_PORT: '3000',
      TDX_BASE_URL: 'http://127.0.0.1:17710',
      TDX_TIMEOUT_MS: '5000',
      ...baseRedisEnv,
      ...disabledMysqlEnv,
      ...disabledAiEnv,
@@ -129,6 +131,8 @@ describe('进程级运行配置', () => {
      LOG_LEVEL: 'debug',
      API_HOST: '127.0.0.1',
      API_PORT: '3000',
      TDX_BASE_URL: 'http://127.0.0.1:17710',
      TDX_TIMEOUT_MS: '5000',
      ...baseRedisEnv,
      ...enabledMysql,
      ...disabledAiEnv,
@@ -138,12 +142,38 @@ describe('进程级运行配置', () => {
    expect(() => loadApiConfig({ ...apiEnv, MYSQL_TIMEZONE: 'SYSTEM' })).toThrow(/MYSQL_TIMEZONE/);
  });
  it('TDX 只允许本机回环地址和固定端口', () => {
    const apiEnv = {
      APP_ENV: 'development',
      LOG_LEVEL: 'debug',
      API_HOST: '127.0.0.1',
      API_PORT: '3000',
      TDX_BASE_URL: 'http://127.0.0.1:17710',
      TDX_TIMEOUT_MS: '5000',
      ...baseRedisEnv,
      ...disabledMysqlEnv,
      ...disabledAiEnv,
    };
    expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'http://192.168.28.106:17709' })).toThrow(
      /TDX_BASE_URL 必须指向本机回环地址/,
    );
    expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'https://127.0.0.1:17710' })).toThrow(
      /TDX_BASE_URL 必须使用 http 协议/,
    );
    expect(() => loadApiConfig({ ...apiEnv, TDX_BASE_URL: 'http://127.0.0.1:17711' })).toThrow(
      /TDX_BASE_URL 必须使用 17710 端口/,
    );
  });
  it('日志摘要不包含任何连接密码、密钥或未知字段', () => {
    const config = loadApiConfig({
      APP_ENV: 'development',
      LOG_LEVEL: 'debug',
      API_HOST: '127.0.0.1',
      API_PORT: '3000',
      TDX_BASE_URL: 'http://127.0.0.1:17710',
      TDX_TIMEOUT_MS: '5000',
      ...baseRedisEnv,
      ...disabledMysqlEnv,
      ...disabledAiEnv,
@@ -13,7 +13,7 @@ export interface RedisRuntimeConfig {
  tls: boolean;
 }
-/** MySQL 配置固定 5.7.42 兼容口径，启用状态决定凭据是否必填。 */
+/** MySQL 配置固定 5.7.x 兼容口径，启用状态决定凭据是否必填。 */
 export interface MysqlRuntimeConfig {
  enabled: boolean;
  host: string;
@@ -35,6 +35,12 @@ export interface AiRuntimeConfig {
  timeoutMs: number;
 }
 /** API 只允许通过本机 SSH/Tailscale 隧道访问 TDX，禁止把家庭地址暴露给业务请求。 */
 export interface TdxRuntimeConfig {
  baseUrl: string;
  timeoutMs: number;
 }
 /** RocketMQ 公共寻址配置；实际生产/消费参数由相应进程扩展。 */
 export interface RocketMqRuntimeConfig {
  enabled: boolean;
@@ -54,6 +60,7 @@ interface CommonRuntimeConfig {
 export interface ApiRuntimeConfig extends CommonRuntimeConfig {
  processName: 'api';
  api: Readonly<{ host: string; port: number }>;
  tdx: Readonly<TdxRuntimeConfig>;
  mysql: MysqlRuntimeConfig;
  ai: AiRuntimeConfig;
 }
@@ -196,6 +203,30 @@ function loadAiConfig(env: EnvironmentSource): AiRuntimeConfig {
  };
 }
 function loadTdxConfig(env: EnvironmentSource): TdxRuntimeConfig {
  const baseUrl = requireText(env, 'TDX_BASE_URL').replace(/\/$/, '');
  let parsed: URL;
  try {
    parsed = new URL(baseUrl);
  } catch {
    throw new Error('TDX_BASE_URL 必须为有效 URL');
  }
  if (parsed.protocol !== 'http:') throw new Error('TDX_BASE_URL 必须使用 http 协议');
  if (parsed.hostname !== '127.0.0.1') {
    throw new Error('TDX_BASE_URL 必须指向本机回环地址');
  }
  if (parsed.port !== '17710') throw new Error('TDX_BASE_URL 必须使用 17710 端口');
  if (parsed.pathname !== '' && parsed.pathname !== '/') {
    throw new Error('TDX_BASE_URL 不得包含额外路径');
  }
  return {
    baseUrl: parsed.toString().replace(/\/$/, ''),
    timeoutMs: parseInteger(env, 'TDX_TIMEOUT_MS', { min: 100, max: 30_000 }),
  };
 }
 function loadRocketMqConfig(env: EnvironmentSource): RocketMqRuntimeConfig {
  const enabled = parseBoolean(env, 'ROCKETMQ_ENABLED');
  const nameServerAddress = optionalText(env, 'ROCKETMQ_NAMESRV_ADDR');
@@ -225,6 +256,7 @@ export function loadApiConfig(env: EnvironmentSource): ApiRuntimeConfig {
      host: requireText(env, 'API_HOST'),
      port: parseInteger(env, 'API_PORT', { min: 1, max: 65_535 }),
    },
    tdx: loadTdxConfig(env),
    redis: loadRedisConfig(env),
    mysql: loadMysqlConfig(env),
    ai: loadAiConfig(env),
@@ -23,7 +23,7 @@ describe('基础设施只读健康客户端', () => {
    expect(commands).toEqual(['CONNECT', 'PING']);
  });
-  it('MySQL 使用固定元数据查询并校验 5.7 与数据库口径', async () => {
+  it('MySQL 使用固定元数据查询并返回实际 5.7.x 版本', async () => {
    const queries: string[] = [];
    const client = new MysqlHealthClient(
      {
@@ -32,7 +32,7 @@ describe('基础设施只读健康客户端', () => {
          return [
            [
              {
-                version: '5.7.42-log',
+                version: '5.7.41-log',
                databaseName: 'a_share_analysis_dev',
                charset: 'utf8mb4',
                collation: 'utf8mb4_general_ci',
@@ -49,7 +49,7 @@ describe('基础设施只读健康客户端', () => {
    await expect(client.check()).resolves.toEqual({
      status: 'healthy',
-      detail: 'MySQL 5.7.42 / a_share_analysis_dev / +08:00',
+      detail: 'MySQL 5.7.41 / a_share_analysis_dev / +08:00',
    });
    expect(queries).toEqual([MYSQL_HEALTH_QUERY]);
  });
@@ -76,14 +76,17 @@ describe('基础设施只读健康客户端', () => {
        'a_share_analysis_dev',
      );
-    await expect(createClient({ version: '8.0.40' }).check()).rejects.toThrow(/MySQL 5.7/);
+    for (const version of ['5.6.51', '8.0.40', '5.7', '5.7.x']) {
-    await expect(createClient({ version: '5.7.41' }).check()).rejects.toThrow(/5\.7\.42/);
+      await expect(createClient({ version }).check()).rejects.toThrow(/MySQL 5\.7\.x/);
    }
    await expect(createClient({ databaseName: 'a_share_analysis' }).check()).rejects.toThrow(
      /a_share_analysis_dev/,
    );
    await expect(createClient({ charset: 'utf8' }).check()).rejects.toThrow(/utf8mb4/);
    await expect(createClient({ collation: 'utf8mb4_0900_ai_ci' }).check()).rejects.toThrow(
      /utf8mb4_general_ci/,
    );
    await expect(createClient({ timezone: 'SYSTEM' }).check()).rejects.toThrow(/\+08:00/);
  });
  it('MySQL 按当前配置校验生产库名', async () => {
@@ -36,8 +36,9 @@ export class MysqlHealthClient implements OnModuleDestroy {
    const [rows] = await this.client.query(MYSQL_HEALTH_QUERY);
    const row = (rows as unknown as MysqlMetadataRow[])[0];
    if (!row) throw new Error('MySQL 未返回元数据');
-    if (!/^5\.7\.42(?:[-+.]|$)/.test(row.version)) {
+    const versionMatch = /^(5\.7\.\d+)(?:[-+].*)?$/.exec(row.version ?? '');
-      throw new Error('MySQL 5.7.42 版本要求未满足');
+    if (!versionMatch) {
      throw new Error('MySQL 5.7.x 版本要求未满足');
    }
    if (row.databaseName !== this.expectedDatabase) {
      throw new Error(`MySQL 健康检查必须连接 ${this.expectedDatabase}`);
@@ -50,7 +51,7 @@ export class MysqlHealthClient implements OnModuleDestroy {
    return {
      status: 'healthy',
-      detail: `MySQL 5.7.42 / ${row.databaseName} / ${row.timezone}`,
+      detail: `MySQL ${versionMatch[1]} / ${row.databaseName} / ${row.timezone}`,
    };
  }
@@ -63,7 +64,7 @@ export class MysqlHealthClient implements OnModuleDestroy {
  }
 }
-/** 创建最多两个连接的只读健康池，并显式应用 MySQL 5.7.42 会话时区。 */
+/** 创建最多两个连接的只读健康池，并显式应用 MySQL 5.7.x 会话时区。 */
 export function createMysqlHealthClient(config: MysqlRuntimeConfig): MysqlHealthClient {
  const pool: Pool = createPool({
    host: config.host,
@@ -3,7 +3,7 @@ import type { MysqlConnectionOptions } from 'typeorm/driver/mysql/MysqlConnectio
 import type { MysqlRuntimeConfig } from '../../config/src/runtime-config';
 /**
- * 生成 MySQL 5.7.42 TypeORM 基线选项；迁移未落地前不自动运行，且永久禁止 synchronize。
+ * 生成 MySQL 5.7.x TypeORM 基线选项；迁移未落地前不自动运行，且永久禁止 synchronize。
 */
 export function buildTypeOrmOptions(config: MysqlRuntimeConfig): MysqlConnectionOptions {
  return {
@@ -1,6 +1,34 @@
 {
  "components": {
    "schemas": {
      "BreadthDataDto": {
        "properties": {
          "advancing": { "type": "number" },
          "declining": { "type": "number" },
          "unchanged": { "nullable": true, "type": "number" }
        },
        "required": ["advancing", "declining", "unchanged"],
        "type": "object"
      },
      "BreadthResponseDto": {
        "properties": {
          "asOf": { "format": "date-time", "type": "string" },
          "data": {
            "allOf": [{ "$ref": "#/components/schemas/BreadthDataDto" }],
            "nullable": true,
            "type": "object"
          },
          "snapshotId": { "type": "string" },
          "source": { "enum": ["tdx"], "type": "string" },
          "status": {
            "enum": ["fresh", "delayed", "partial", "unavailable"],
            "type": "string"
          },
          "warnings": { "items": { "type": "string" }, "type": "array" }
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      },
      "DependencyHealthDto": {
        "properties": {
          "detail": { "type": "string" },
@@ -12,6 +40,46 @@
        "required": ["status", "detail"],
        "type": "object"
      },
      "FundDataDto": {
        "properties": {
          "changePercent": { "type": "number" },
          "currentAmount": { "type": "number" },
          "marketCount": { "maximum": 3, "minimum": 1, "type": "number" },
          "previousAmount": { "type": "number" },
          "previousTradeDate": { "example": "20260817", "type": "string" },
          "tradeDate": { "example": "20260818", "type": "string" },
          "unit": { "example": "亿元", "type": "string" }
        },
        "required": [
          "currentAmount",
          "previousAmount",
          "changePercent",
          "unit",
          "marketCount",
          "tradeDate",
          "previousTradeDate"
        ],
        "type": "object"
      },
      "FundsResponseDto": {
        "properties": {
          "asOf": { "format": "date-time", "type": "string" },
          "data": {
            "allOf": [{ "$ref": "#/components/schemas/FundDataDto" }],
            "nullable": true,
            "type": "object"
          },
          "snapshotId": { "type": "string" },
          "source": { "enum": ["tdx"], "type": "string" },
          "status": {
            "enum": ["fresh", "delayed", "partial", "unavailable"],
            "type": "string"
          },
          "warnings": { "items": { "type": "string" }, "type": "array" }
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      },
      "HealthDependenciesDto": {
        "properties": {
          "mysql": { "$ref": "#/components/schemas/DependencyHealthDto" },
@@ -32,6 +100,125 @@
        },
        "required": ["status", "process", "checkedAt", "dependencies"],
        "type": "object"
      },
      "IndexQuoteDto": {
        "properties": {
          "changePercent": { "nullable": true, "type": "number" },
          "code": { "type": "string" },
          "direction": { "enum": ["up", "down", "flat"], "type": "string" },
          "name": { "type": "string" },
          "price": { "type": "number" },
          "tradeDate": { "type": "string" }
        },
        "required": ["code", "name", "price", "direction", "tradeDate"],
        "type": "object"
      },
      "IndicesDataDto": {
        "properties": {
          "items": {
            "items": { "$ref": "#/components/schemas/IndexQuoteDto" },
            "type": "array"
          }
        },
        "required": ["items"],
        "type": "object"
      },
      "IndicesResponseDto": {
        "properties": {
          "asOf": { "format": "date-time", "type": "string" },
          "data": {
            "allOf": [{ "$ref": "#/components/schemas/IndicesDataDto" }],
            "nullable": true,
            "type": "object"
          },
          "snapshotId": { "type": "string" },
          "source": { "enum": ["tdx"], "type": "string" },
          "status": {
            "enum": ["fresh", "delayed", "partial", "unavailable"],
            "type": "string"
          },
          "warnings": { "items": { "type": "string" }, "type": "array" }
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      },
      "SectorDataDto": {
        "properties": {
          "items": {
            "items": { "$ref": "#/components/schemas/SectorQuoteDto" },
            "type": "array"
          }
        },
        "required": ["items"],
        "type": "object"
      },
      "SectorQuoteDto": {
        "properties": {
          "changePercent": { "type": "number" },
          "code": { "type": "string" },
          "direction": { "enum": ["up", "down", "flat"], "type": "string" },
          "name": { "type": "string" },
          "tradeDate": { "type": "string" }
        },
        "required": ["code", "name", "changePercent", "direction", "tradeDate"],
        "type": "object"
      },
      "SectorsResponseDto": {
        "properties": {
          "asOf": { "format": "date-time", "type": "string" },
          "data": {
            "allOf": [{ "$ref": "#/components/schemas/SectorDataDto" }],
            "nullable": true,
            "type": "object"
          },
          "snapshotId": { "type": "string" },
          "source": { "enum": ["tdx"], "type": "string" },
          "status": {
            "enum": ["fresh", "delayed", "partial", "unavailable"],
            "type": "string"
          },
          "warnings": { "items": { "type": "string" }, "type": "array" }
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      },
      "SummaryDataDto": {
        "properties": {
          "drivers": { "items": { "type": "string" }, "type": "array" },
          "marketStatus": { "type": "string" },
          "risks": { "items": { "type": "string" }, "type": "array" },
          "sentimentStatus": { "type": "string" },
          "verdict": { "type": "string" },
          "volumeStatus": { "type": "string" }
        },
        "required": [
          "verdict",
          "marketStatus",
          "volumeStatus",
          "sentimentStatus",
          "drivers",
          "risks"
        ],
        "type": "object"
      },
      "SummaryResponseDto": {
        "properties": {
          "asOf": { "format": "date-time", "type": "string" },
          "data": {
            "allOf": [{ "$ref": "#/components/schemas/SummaryDataDto" }],
            "nullable": true,
            "type": "object"
          },
          "snapshotId": { "type": "string" },
          "source": { "enum": ["tdx"], "type": "string" },
          "status": {
            "enum": ["fresh", "delayed", "partial", "unavailable"],
            "type": "string"
          },
          "warnings": { "items": { "type": "string" }, "type": "array" }
        },
        "required": ["snapshotId", "asOf", "source", "status", "warnings", "data"],
        "type": "object"
      }
    }
  },
@@ -67,6 +254,91 @@
        },
        "tags": ["health"]
      }
    },
    "/api/v1/market-overview/breadth": {
      "get": {
        "operationId": "MarketOverviewController_getBreadth",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/BreadthResponseDto" }
              }
            },
            "description": ""
          }
        },
        "tags": ["market-overview"]
      }
    },
    "/api/v1/market-overview/funds": {
      "get": {
        "operationId": "MarketOverviewController_getFunds",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/FundsResponseDto" }
              }
            },
            "description": ""
          }
        },
        "tags": ["market-overview"]
      }
    },
    "/api/v1/market-overview/indices": {
      "get": {
        "operationId": "MarketOverviewController_getIndices",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/IndicesResponseDto" }
              }
            },
            "description": ""
          }
        },
        "tags": ["market-overview"]
      }
    },
    "/api/v1/market-overview/sectors": {
      "get": {
        "operationId": "MarketOverviewController_getSectors",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SectorsResponseDto" }
              }
            },
            "description": ""
          }
        },
        "tags": ["market-overview"]
      }
    },
    "/api/v1/market-overview/summary": {
      "get": {
        "operationId": "MarketOverviewController_getSummary",
        "parameters": [],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SummaryResponseDto" }
              }
            },
            "description": ""
          }
        },
        "tags": ["market-overview"]
      }
    }
  },
  "servers": [],
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
FoXiMao	1f6ed00e6f	docs(FEAT-MO-001): 完成评审与治理收口	2026-08-18 21:24:05 +08:00
FoXiMao	c2fdfa625b	fix(FEAT-MO-001): 校验相邻行情日期	2026-08-18 21:10:58 +08:00
FoXiMao	ae2a7e08ed	fix(FEAT-MO-001): 校验TDX交易日期语义	2026-08-18 20:48:20 +08:00
FoXiMao	7e4dcd9232	fix(FEAT-MO-001): 修复交易日对齐与延迟状态	2026-08-18 20:12:26 +08:00
FoXiMao	49f6be9c43	fix(FEAT-MO-001): 修复TDX数据完整性与状态展示	2026-08-18 19:30:34 +08:00
FoXiMao	ff8ada8316	feat(FEAT-MO-001): 接入TDX市场宽度板块与成交额趋势	2026-08-18 17:37:36 +08:00
FoXiMao	82619489a9	feat(FEAT-MO-001): 完成TDX市场概览首屏	2026-08-18 15:28:35 +08:00
FoXiMao	27bc3c198f	feat(FEAT-MO-001): 同步市场概览前端契约	2026-08-18 13:43:48 +08:00
FoXiMao	15a25002ce	feat(FEAT-MO-001): 增加市场概览分模块接口	2026-08-18 13:31:24 +08:00
FoXiMao	c2fa929936	feat(FEAT-MO-001): 增加TDX直连配置与客户端	2026-08-18 13:16:07 +08:00
FoXiMao	6eb34b5afe	docs(FEAT-MO-001): 记录TDX开发前门禁	2026-08-18 13:05:32 +08:00
FoXiMao	d283ee3196	docs(FEAT-MO-001): 制定TDX概览实施计划	2026-08-18 12:59:17 +08:00
FoXiMao	9a965fab14	docs(FEAT-MO-001): 确认TDX直连概览设计	2026-08-18 12:48:28 +08:00
FoXiMao	b49e7b8b08	docs(GOV-012): 完成发布后基线追溯记录	2026-08-18 03:10:29 +08:00
FoXiMao	11edeb0111	chore(GOV-012): 封存 v0.0.10 开发库 Schema 基线	2026-08-18 03:08:38 +08:00
FoXiMao	16bde94df6	chore(GOV-012): 发布 v0.0.10 元数据	2026-08-18 03:06:48 +08:00
FoXiMao	58026aead3	docs(GOV-012): 完成功能质量与发布追溯档案	2026-08-18 03:04:59 +08:00
FoXiMao	f1c412b6a3	docs(GOV-012): 更新纯 Node Schema 基线规范	2026-08-18 03:00:47 +08:00
FoXiMao	afd186c8a4	fix(GOV-012): 兼容 MySQL 5.7 视图目录并封存 v0.0.9 基线	2026-08-18 02:57:40 +08:00
FoXiMao	874796ab65	fix(GOV-012): 修复 Schema 定义安全与错误语义	2026-08-18 02:46:50 +08:00
FoXiMao	3d12c83621	fix(GOV-012): 修复目录元数据校验与查询错误脱敏	2026-08-18 02:34:14 +08:00
FoXiMao	c11de09fa7	feat(GOV-012): 升级 Schema 基线 format v3	2026-08-18 02:24:54 +08:00
FoXiMao	dc8ad7d4b6	feat(GOV-012): 实现完整 SHOW CREATE 结构导出	2026-08-18 02:02:41 +08:00
FoXiMao	7e9d9065bb	feat(GOV-012): 实现 Schema 对象目录与视图排序	2026-08-18 01:54:50 +08:00
FoXiMao	54fd92837a	docs(GOV-012): 更新安全契约 GitNexus 基线	2026-08-18 01:49:16 +08:00
FoXiMao	8e954a3f5f	fix(GOV-012): 拒绝 MariaDB 伪装版本	2026-08-18 01:44:25 +08:00
FoXiMao	06466f388e	feat(GOV-012): 建立纯 Node 导出器安全契约	2026-08-18 01:21:29 +08:00
FoXiMao	235163cb61	chore(GOV-012): 忽略 SDD 过程账本	2026-08-18 01:11:41 +08:00
FoXiMao	cb2e22c13d	chore(GOV-012): 忽略本地功能工作区	2026-08-18 01:10:46 +08:00
FoXiMao	97535b8b3f	docs(GOV-012): 更新实施计划 GitNexus 基线	2026-08-18 01:08:00 +08:00
FoXiMao	190fba7a0b	docs(GOV-012): 完成纯 Node Schema 导出器实施计划	2026-08-18 01:07:14 +08:00
FoXiMao	0f81677b35	docs(GOV-012): 更新设计阶段 GitNexus 基线	2026-08-18 00:47:16 +08:00
FoXiMao	c605935403	docs(GOV-012): 确认纯 Node Schema 导出器设计	2026-08-18 00:46:03 +08:00
FoXiMao	3555b7c222	docs(FEAT-MO-001): 更新 TDX 接入后的 GitNexus 基线	2026-08-18 00:34:08 +08:00
FoXiMao	998c9276d5	docs(FEAT-MO-001): 记录 TDX 双场景开发接入	2026-08-18 00:32:04 +08:00
FoXiMao	c0a6f55605	docs(GOV-011): 更新最终 GitNexus 基线	2026-08-17 18:00:49 +08:00
FoXiMao	405b9858f0	docs(GOV-011): 回填 v0.0.9 发布追溯	2026-08-17 18:00:11 +08:00
FoXiMao	88e2fdffc8	chore(GOV-011): 发布 v0.0.9 系列版本约束	2026-08-17 17:58:02 +08:00
FoXiMao	7478a96bdc	docs(GOV-011): 完成系列版本验证与审查	2026-08-17 17:50:58 +08:00
FoXiMao	cce77aa884	docs(GOV-011): 统一运行时系列版本口径	2026-08-17 17:36:44 +08:00
FoXiMao	dc8da80809	fix(GOV-011): 支持 MySQL 5.7 系列健康检查	2026-08-17 17:31:10 +08:00
FoXiMao	54499f0678	fix(GOV-011): 放宽 MySQL 服务端为完整 5.7 系列	2026-08-17 17:28:48 +08:00
FoXiMao	c8277ef25a	test(GOV-011): 补充 Node 22 系列边界验证	2026-08-17 17:23:29 +08:00
FoXiMao	426870b704	docs(GOV-011): 制定运行时系列版本实施计划	2026-08-17 17:19:38 +08:00
FoXiMao	fcfef2d524	docs(GOV-011): 确认系列版本约束设计	2026-08-17 17:01:39 +08:00