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

.gitignore

@@ -3,12 +3,18 @@ node_modules/
 dist/
 coverage/
 *.tsbuildinfo
+playwright-report/
+test-results/
 
 # 本地环境与密钥
 .env
 .env.*
 !.env.example
+*.env
+*.env.*
+!*.env.example
 *.local
+.local/
 
 # 编辑器与操作系统
 .DS_Store
@@ -24,3 +30,5 @@ CLAUDE.md
 *.log
 tmp/
 work/
+.worktrees/
+.superpowers/

.npmrc

@@ -0,0 +1,4 @@
+engine-strict=true
+save-exact=true
+strict-peer-dependencies=true
+only-built-dependencies[]=esbuild

.prettierignore

@@ -0,0 +1,11 @@
+# 自动生成或不可变发布产物
+AGENTS.md
+pnpm-lock.yaml
+database/schema-baselines/
+
+# 历史功能档案与人类维护文档不由代码格式器改写，追溯内容保持原样。
+docs/
+
+# 已有治理脚本保留原历史格式；其行为由专项测试门禁覆盖。
+tools/database/
+tools/governance/

.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "semi": true
+}

AGENTS.md

@@ -9,20 +9,27 @@
 
 ## 强制要求
 
-1. 修改生产代码前必须执行 `npm run governance:start -- <功能编号> <短名称>`，刷新 GitNexus，并完成开发前影响分析。
+1. 开发下一版本前必须先执行 `npm run schema:baseline` 和 `npm run schema:verify`，将上一已发布版本的开发库 Schema 基线用中文提交推送 Gitea；随后才能执行 `npm run governance:start -- <功能编号> <短名称>`，刷新 GitNexus 并完成开发前影响分析。
 2. 修改完成后必须执行测试、构建、视觉验证和 `npm run governance:finish -- <功能编号> <短名称>`，再次刷新 GitNexus并保存前后对比。
 3. 任何功能必须先有 `docs/features/<功能编号>-<短名称>/` 功能档案；没有 PRD、需求、设计、计划和回退说明不得视为完成。
 4. Git 提交必须使用中文 Conventional Commit，并带功能编号；禁止英文摘要和含糊提交信息。
 5. 代码必须为关键业务逻辑、数据口径、异常恢复和架构取舍提供准确的中文注释；禁止无意义逐行注释。
 6. 文件按稳定职责拆分，不以追求“原子化”为目的过度拆分。优先保证普通开发者能够连续阅读完整业务流程。
-7. 不使用 GitHub。当前只使用本地 Git，远程仓库仅在用户安装 Gitea 后配置。
+7. 不使用 GitHub。本项目唯一远程仓库为项目级配置的 Gitea `https://git.foximao.com/FoXiMao/a-share-analysis.git`；禁止修改 Git 全局配置或影响其他项目。
-8. 禁止提交密钥、真实凭据、生产数据、`.env` 和 GitNexus 本地索引。
+8. 禁止提交密钥、密码、访问令牌、生产数据、`.env` 和 GitNexus 本地索引；凭据不得写入远程 URL、文档、脚本或命令参数。
 9. 开发完成后必须先通过代码 Review 和开发规范符合性 Review，再进入发布；Review 结论和问题处置必须写入功能档案。
+10. 每次提交验证通过后必须立即推送当前分支到项目 Gitea；本次新建标签必须单独推送。推送失败时任务不得标记完成，禁止强推或自动覆盖未知远程提交。
+11. Schema 基线只能读取 `APP_ENV=development` 的 `a_share_analysis_dev`，启用时主机必须命中代码内固定开发白名单（开发机回环地址或 `112.192.20.11`）；禁止连接、探测或读取生产数据库。MySQL 未启用时只允许生成可验证的 `not_applicable` 清单，启用但无对象时生成 `captured_empty` 清单，禁止用空 SQL 冒充基线。`governance:start` 还必须确认基线已提交、已推送且远程标签一致。
+12. 功能和缺陷修复开发前必须用 GitNexus 评估直接、间接及跨模块影响，并逐项判断 HTTP/OpenAPI、Web API、消息、数据库、Redis、API、Scheduler、Worker、部署、测试和文档是否同步修改；`partial` 结果不得视为无影响。
+13. 设计、测试计划和 Review 必须包含安全策略、性能目标、验证证据及残余风险；不适用项必须写明原因与边界。
+14. 每个未发布功能必须有独立 `development-summary.md`，明确原始需求、范围变化、实际完成、修复缺陷、延期项、关键提交和验证证据，不得合并到发布说明。
+15. 后端以业务模块为一级目录并在模块内按需分层，小模块不凑目录；前端统一由 `web/src/utils/request.ts` 封装 Axios，业务请求只能位于 `web/src/api/<业务域>/index.ts`，OpenAPI 类型继续作为契约来源。
+16. 复用代码只有在真实重复和稳定职责出现后才能抽取；新增依赖必须先评估用途、替代、安全、许可证、体积或运行成本、维护和退出方案。
 
 <!-- gitnexus:start -->
 # GitNexus — Code Intelligence
 
-This project is indexed by GitNexus as **a-share-analysis** (301 symbols, 326 relationships, 0 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.
 

CHANGELOG.md

@@ -2,6 +2,69 @@
 
 本项目采用语义化版本。功能级变化请从 `docs/features/` 按功能编号追溯。
 
+## 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 跨模块影响和独立开发总结的可执行治理门禁。
+- 约定后端业务模块内按需分层，以及前端 Axios 统一封装、API 分域和 OpenAPI 类型契约。
+- 项目生产交付统一为 Ubuntu 源码部署，移除 Dockerfile、Compose、镜像校验和容器测试入口。
+- 本地 Redis、MySQL 5.7.42 与 RocketMQ 5.x 均作为外部服务，项目不再提供自动启动或容器兜底。
+- 新增源码发布门禁，校验 Web/Server 构建产物与 systemd、Nginx 配置一致性。
+- 完成 Vue 3 Web、NestJS API/Scheduler/Worker、OpenAPI 单向契约和最小权限配置的工程基线确认。
+- 补充 Tailscale 访问 Windows TDX 的开发操作文档和采集 PoC 前置档案；本版本不实现常驻采集程序。
+
+## 0.0.7 - 2026-08-13
+
+- 将项目唯一消息队列技术基线由 RabbitMQ 调整为 RocketMQ 5.x。
+- 建立 MessageBusAdapter、Topic/Group、重试、死信和顺序消息约束。
+- 更新 Scheduler/Worker 环境模板和双部署文档，并记录本机 NameServer 分层连接验证。
+
+## 0.0.6 - 2026-08-13
+
+- 建立上一发布版本开发数据库 Schema 基线生成、规范化和自动校验工具。
+- 固定只读开发库安全边界、完整 MySQL 5.7 对象范围和禁止覆盖规则。
+- 为 MySQL 未启用状态建立可验证的不适用记录，并接入治理前后门禁。
+
+## 0.0.5 - 2026-08-13
+
+- 建立开发与生产环境配置契约及八份无秘密模板。
+- 增加仅运行 Redis 的本地开发 Compose。
+- 建立 Docker Compose 与 Ubuntu 源码生产部署边界、systemd 和 Nginx 示例。
+- 增加环境配置自动化契约测试。
+
+## 0.0.4 - 2026-08-13
+
+- 固定 MySQL 5.7.x、`utf8mb4` 和 `utf8mb4_general_ci` 技术基线。
+- 增加 MySQL 8.x 禁用能力、迁移、索引、比较语义和 Review 规则。
+- 新增数据库基线自动化契约测试。
+
+## 0.0.3 - 2026-08-12
+
+- 将当前分支推送设为每次提交后的强制步骤，新标签采用精确推送。
+- 将远程同步成功加入完成定义，明确失败留痕、禁止强推和远程引用核对规则。
+- GOV-004 取代 GOV-003 的“只接入、不主动推送”历史规则，但保留原档案用于追溯。
+
+## 0.0.2 - 2026-08-12
+
+- 配置仅作用于本项目的 Gitea 远程仓库和凭据隔离策略。
+- 明确密码不入文档、不入配置、不入 Git 历史，以及推送需再次获得用户明确授权。
+
 ## 0.0.1 - 2026-08-12
 
 - 增加 PRD 与开发后 Review 强制门禁。

README.md

@@ -9,12 +9,19 @@ A read-only A-share market overview and analysis tool.
 ## Projects
 
 - `web/`: Vue 3 market terminal frontend.
-- `server/`: NestJS API, scheduler, and workers. Added in a later module.
+- `server/`: NestJS API、Scheduler 与 Worker 三个独立进程。
-- `deploy/`: MySQL, Redis, and RabbitMQ deployment configuration. Added with the backend module.
+- `deploy/`: MySQL 5.7、Redis、RocketMQ 5.x 的配置契约，以及 systemd/Nginx 源码部署模板。
 - `docs/`: Product and implementation specifications.
 
 The first implementation slice is the market overview screen in `web/`.
 
+## 环境与部署
+
+- [本地开发环境](docs/deployment/local-development.md)：使用开发机已有 Redis，应用全部从源码运行。
+- [Ubuntu 源码生产部署](docs/deployment/ubuntu-source-production.md)：项目唯一生产部署方式，支持 Ubuntu 22.04/24.04 LTS x86_64。
+
+无秘密环境模板位于 `deploy/env/`。生产配置不进入 Git 或发布目录；Node.js 22.x、pnpm 10.25.0、Nginx 和外部基础设施由服务器管理员提供。项目不安装、启动、停止或删除 Redis、MySQL 和 RocketMQ。
+
 ## 开发入口
 
 - [文档索引](docs/index.md)
@@ -25,7 +32,20 @@ The first implementation slice is the market overview screen in `web/`.
 开始任何模块前，先阅读根目录 `AGENTS.md`，然后运行：
 
 ```bash
+npm run schema:baseline
+npm run schema:verify
 npm run governance:start -- FEAT-MO-001 market-overview
 ```
 
-当前只使用本地 Git。Gitea 安装完成后再按治理文档配置远程仓库。
+Schema 命令只允许处理固定开发库；导出器使用 Node.js `mysql2`，本机无需安装 MySQL Server 或 CLI。当前 MySQL 未启用时会为上一发布版本生成可验证的不适用清单，不会连接数据库或创建空 SQL；启用但无对象时生成 format v3 `captured_empty` 清单。完整规则见 [开发流程规范](docs/governance/development-workflow.md)。
+
+## 项目仓库
+
+- Gitea：<https://git.foximao.com/FoXiMao/a-share-analysis>
+- 远程名：`origin`
+- 配置范围：仅当前项目的 `.git/config`，不修改 Git 全局配置。
+
+凭据不写入仓库、文档或远程 URL。首次需要认证时由 Git 调用 macOS Keychain
+安全保存；详细规则见 [Git 与 Gitea 规范](docs/governance/version-control-and-gitea.md)。
+
+验证通过的中文提交必须立即同步当前分支到 Gitea；本次创建的版本标签单独同步。远程同步失败时，开发任务保持未完成状态。

VERSION

@@ -1 +1 @@
-0.0.1
+0.0.10

database/schema-baselines/v0.0.10/manifest.yaml

@@ -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"
+}

database/schema-baselines/v0.0.5/manifest.yaml

@@ -0,0 +1,24 @@
+{
+  "format_version": 1,
+  "status": "not_applicable",
+  "application_version": "v0.0.5",
+  "git_commit": "0a69aa1d43f40093c6482f48a13d9d222f6faec5",
+  "source_environment": "development",
+  "database_name": "a_share_analysis_dev",
+  "mysql_client_version": "not_enabled",
+  "mysqldump_client_version": "not_enabled",
+  "mysql_server_version": "not_enabled",
+  "charset": "utf8mb4",
+  "collation": "utf8mb4_general_ci",
+  "generated_at": "2026-08-13T03:15:28.832Z",
+  "generator": "schema-baseline/1.0.0",
+  "reason": "mysql_disabled",
+  "schema_sha256": "not_applicable",
+  "objects": {
+    "tables": false,
+    "views": false,
+    "triggers": false,
+    "routines": false,
+    "events": false
+  }
+}

database/schema-baselines/v0.0.6/manifest.yaml

@@ -0,0 +1,24 @@
+{
+  "format_version": 1,
+  "status": "not_applicable",
+  "application_version": "v0.0.6",
+  "git_commit": "70f020f87c0cf9e19512581d798a3491c9aae5f6",
+  "source_environment": "development",
+  "database_name": "a_share_analysis_dev",
+  "mysql_client_version": "not_enabled",
+  "mysqldump_client_version": "not_enabled",
+  "mysql_server_version": "not_enabled",
+  "charset": "utf8mb4",
+  "collation": "utf8mb4_general_ci",
+  "generated_at": "2026-08-13T05:58:53.506Z",
+  "generator": "schema-baseline/1.0.0",
+  "reason": "mysql_disabled",
+  "schema_sha256": "not_applicable",
+  "objects": {
+    "tables": false,
+    "views": false,
+    "triggers": false,
+    "routines": false,
+    "events": false
+  }
+}

database/schema-baselines/v0.0.7/manifest.yaml

@@ -0,0 +1,24 @@
+{
+  "format_version": 1,
+  "status": "not_applicable",
+  "application_version": "v0.0.7",
+  "git_commit": "7dc04a267199fb3a11c2ac43c2914ae5e1460cb9",
+  "source_environment": "development",
+  "database_name": "a_share_analysis_dev",
+  "mysql_client_version": "not_enabled",
+  "mysqldump_client_version": "not_enabled",
+  "mysql_server_version": "not_enabled",
+  "charset": "utf8mb4",
+  "collation": "utf8mb4_general_ci",
+  "generated_at": "2026-08-13T06:55:43.710Z",
+  "generator": "schema-baseline/1.0.0",
+  "reason": "mysql_disabled",
+  "schema_sha256": "not_applicable",
+  "objects": {
+    "tables": false,
+    "views": false,
+    "triggers": false,
+    "routines": false,
+    "events": false
+  }
+}

database/schema-baselines/v0.0.9/manifest.yaml

@@ -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"
+}

deploy/env/development/api.env.example

@@ -0,0 +1,34 @@
+# 运行环境；本地源码运行固定为 development。
+APP_ENV=development
+# API 只监听本机，避免开发服务暴露到局域网。
+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
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=0
+REDIS_TLS=false
+
+# 第一阶段关闭 MySQL；启用后下列连接变量变为必填。
+MYSQL_ENABLED=false
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DATABASE=a_share_analysis_dev
+MYSQL_USERNAME=
+MYSQL_PASSWORD=
+MYSQL_CHARSET=utf8mb4
+MYSQL_COLLATION=utf8mb4_general_ci
+MYSQL_TIMEZONE=+08:00
+
+# 第一阶段关闭付费 AI；启用后 BASE_URL、API_KEY 和 MODEL 变为必填。
+AI_ENABLED=false
+AI_BASE_URL=
+AI_API_KEY=
+AI_MODEL=
+AI_TIMEOUT_MS=30000

deploy/env/development/scheduler.env.example

@@ -0,0 +1,19 @@
+# Scheduler 只负责触发时间和调度锁。
+APP_ENV=development
+LOG_LEVEL=debug
+SCHEDULER_TIMEZONE=Asia/Shanghai
+SCHEDULER_ENABLED=true
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=1
+REDIS_TLS=false
+
+# 第一阶段关闭 RocketMQ，任务通过服务内 MessageBusAdapter 调用。
+ROCKETMQ_ENABLED=false
+ROCKETMQ_NAMESRV_ADDR=127.0.0.1:9876
+ROCKETMQ_ENDPOINT=127.0.0.1:8081
+ROCKETMQ_TOPIC_PREFIX=a-share-analysis
+ROCKETMQ_SEND_TIMEOUT_MS=3000

deploy/env/development/web.env.example

@@ -0,0 +1,5 @@
+# VITE 变量会进入浏览器，只允许公开配置。
+VITE_APP_ENV=development
+VITE_APP_TITLE=A-Share Analysis
+VITE_API_BASE_URL=
+VITE_ENABLE_DEVTOOLS=true

deploy/env/development/worker.env.example

@@ -0,0 +1,37 @@
+# 开发环境使用确定性模拟行情，不访问生产数据源。
+APP_ENV=development
+LOG_LEVEL=debug
+MARKET_DATA_MODE=mock
+MARKET_DATA_PROVIDER=deterministic-fixture
+MARKET_DATA_BASE_URL=
+MARKET_DATA_API_KEY=
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=2
+REDIS_TLS=false
+
+MYSQL_ENABLED=false
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DATABASE=a_share_analysis_dev
+MYSQL_USERNAME=
+MYSQL_PASSWORD=
+MYSQL_CHARSET=utf8mb4
+MYSQL_COLLATION=utf8mb4_general_ci
+MYSQL_TIMEZONE=+08:00
+
+ROCKETMQ_ENABLED=false
+ROCKETMQ_NAMESRV_ADDR=127.0.0.1:9876
+ROCKETMQ_ENDPOINT=127.0.0.1:8081
+ROCKETMQ_TOPIC_PREFIX=a-share-analysis
+ROCKETMQ_CONSUMER_GROUP=a-share-analysis-worker
+ROCKETMQ_CONSUMER_CONCURRENCY=4
+
+AI_ENABLED=false
+AI_BASE_URL=
+AI_API_KEY=
+AI_MODEL=
+AI_TIMEOUT_MS=30000

deploy/env/production/api.env.example

@@ -0,0 +1,31 @@
+# 生产进程必须显式使用 production，禁止回退开发默认值。
+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
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=0
+REDIS_TLS=false
+
+# 第一阶段关闭；启用后必须填写真实生产连接，但不得提交本文件副本。
+MYSQL_ENABLED=false
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DATABASE=a_share_analysis
+MYSQL_USERNAME=
+MYSQL_PASSWORD=
+MYSQL_CHARSET=utf8mb4
+MYSQL_COLLATION=utf8mb4_general_ci
+MYSQL_TIMEZONE=+08:00
+
+AI_ENABLED=false
+AI_BASE_URL=
+AI_API_KEY=
+AI_MODEL=
+AI_TIMEOUT_MS=30000

deploy/env/production/scheduler.env.example

@@ -0,0 +1,17 @@
+APP_ENV=production
+LOG_LEVEL=info
+SCHEDULER_TIMEZONE=Asia/Shanghai
+SCHEDULER_ENABLED=true
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=1
+REDIS_TLS=false
+
+ROCKETMQ_ENABLED=false
+ROCKETMQ_NAMESRV_ADDR=
+ROCKETMQ_ENDPOINT=
+ROCKETMQ_TOPIC_PREFIX=a-share-analysis
+ROCKETMQ_SEND_TIMEOUT_MS=3000

deploy/env/production/web.env.example

@@ -0,0 +1,5 @@
+# VITE 变量会进入浏览器，只允许公开配置。
+VITE_APP_ENV=production
+VITE_APP_TITLE=A-Share Analysis
+VITE_API_BASE_URL=
+VITE_ENABLE_DEVTOOLS=false

deploy/env/production/worker.env.example

@@ -0,0 +1,37 @@
+# 生产环境必须使用 live，启动校验拒绝 mock。
+APP_ENV=production
+LOG_LEVEL=info
+MARKET_DATA_MODE=live
+MARKET_DATA_PROVIDER=
+MARKET_DATA_BASE_URL=
+MARKET_DATA_API_KEY=
+
+REDIS_HOST=127.0.0.1
+REDIS_PORT=6379
+REDIS_USERNAME=
+REDIS_PASSWORD=
+REDIS_DATABASE=2
+REDIS_TLS=false
+
+MYSQL_ENABLED=false
+MYSQL_HOST=127.0.0.1
+MYSQL_PORT=3306
+MYSQL_DATABASE=a_share_analysis
+MYSQL_USERNAME=
+MYSQL_PASSWORD=
+MYSQL_CHARSET=utf8mb4
+MYSQL_COLLATION=utf8mb4_general_ci
+MYSQL_TIMEZONE=+08:00
+
+ROCKETMQ_ENABLED=false
+ROCKETMQ_NAMESRV_ADDR=
+ROCKETMQ_ENDPOINT=
+ROCKETMQ_TOPIC_PREFIX=a-share-analysis
+ROCKETMQ_CONSUMER_GROUP=a-share-analysis-worker
+ROCKETMQ_CONSUMER_CONCURRENCY=4
+
+AI_ENABLED=false
+AI_BASE_URL=
+AI_API_KEY=
+AI_MODEL=
+AI_TIMEOUT_MS=30000

deploy/nginx/a-share-analysis.conf.example

@@ -0,0 +1,20 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /opt/a-share-analysis/current/web/dist;
+    index index.html;
+
+    location /api/ {
+        proxy_pass http://127.0.0.1:3000;
+        proxy_http_version 1.1;
+        proxy_set_header Host $host;
+        proxy_set_header X-Real-IP $remote_addr;
+        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+        proxy_set_header X-Forwarded-Proto $scheme;
+    }
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+}

deploy/systemd/a-share-api.service.example

@@ -0,0 +1,22 @@
+[Unit]
+Description=A Share Analysis API
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=a-share
+Group=a-share
+WorkingDirectory=/opt/a-share-analysis/current
+EnvironmentFile=/etc/a-share-analysis/api.env
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/api/main.js
+ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/api.env
+Restart=on-failure
+RestartSec=5
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=strict
+ProtectHome=true
+
+[Install]
+WantedBy=multi-user.target

deploy/systemd/a-share-scheduler.service.example

@@ -0,0 +1,22 @@
+[Unit]
+Description=A Share Analysis Scheduler
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=a-share
+Group=a-share
+WorkingDirectory=/opt/a-share-analysis/current
+EnvironmentFile=/etc/a-share-analysis/scheduler.env
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/scheduler/main.js
+ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/scheduler.env
+Restart=on-failure
+RestartSec=5
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=strict
+ProtectHome=true
+
+[Install]
+WantedBy=multi-user.target

deploy/systemd/a-share-worker.service.example

@@ -0,0 +1,22 @@
+[Unit]
+Description=A Share Analysis Worker
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=a-share
+Group=a-share
+WorkingDirectory=/opt/a-share-analysis/current
+EnvironmentFile=/etc/a-share-analysis/worker.env
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/worker/main.js
+ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/worker.env
+Restart=on-failure
+RestartSec=5
+NoNewPrivileges=true
+PrivateTmp=true
+ProtectSystem=strict
+ProtectHome=true
+
+[Install]
+WantedBy=multi-user.target

docs/adr/ADR-0003-rocketmq-message-bus.md

@@ -0,0 +1,31 @@
+# ADR-0003：采用 RocketMQ 5.x 作为唯一消息队列
+
+- 状态：accepted
+- 日期：2026-08-13
+- 关联功能：GOV-008
+
+## 背景
+
+项目此前在架构和环境模板中约定 RabbitMQ，但尚未实现消息客户端、Topic 或业务消费流程。产品需要分钟级盘中分析、定时采集、指标计算、AI 分析和失败重试，决定在实现前统一切换到 RocketMQ。
+
+## 决策
+
+- 项目唯一消息队列为 RocketMQ 5.x，不维护 RabbitMQ 双栈。
+- Scheduler 和 Worker 只依赖项目级 `MessageBusAdapter` 与版本化事件契约。
+- Node.js 客户端优先通过 RocketMQ 5.x Proxy 接入；若改用直接 NameServer/Broker 客户端，必须通过兼容性和可靠性验证。
+- Topic、Tag、Producer Group、Consumer Group、顺序键、重试与死信语义必须在功能设计中明确。
+- 本地和生产基础设施独立于应用发布；NameServer、Broker、Proxy 不随应用版本自动创建或删除。
+
+## 原因
+
+RocketMQ 对定时/延迟任务、重试、死信、顺序消息和后续任务规模扩展更符合预期。Adapter 边界用于控制 Node 客户端成熟度和接入协议变化带来的风险。
+
+## 代价
+
+- 本地和生产运维复杂度高于单节点 RabbitMQ，需要区分 NameServer、Broker 和 Proxy。
+- Node.js 生态需要在 Server 脚手架阶段单独验证，不能仅凭 NameServer 端口可达决定客户端可用。
+- 所有消费者必须按至少一次投递设计幂等和受控重放。
+
+## 验证
+
+GOV-008 只验证配置、文档契约和本机 NameServer 状态。真实 Topic 生产/消费必须在 Broker/Proxy 可用且 Server 客户端选定后补充契约测试。

docs/architecture/system-architecture.md

@@ -7,8 +7,10 @@
 ```text
 web/        Vue 3 前端
 server/     NestJS API、Scheduler 与 Worker
-contracts/  HTTP 与 RabbitMQ 版本化契约
+server/openapi/                 HTTP OpenAPI 产物
-deploy/     MySQL、Redis、RabbitMQ 和运行配置
+server/libs/http-contracts/     后端 HTTP DTO
+server/libs/message-contracts/  后端 RocketMQ 版本化契约
+deploy/     MySQL、Redis、RocketMQ 5.x 和运行配置
 docs/       规范、架构、ADR 与功能档案
 tools/      可重复执行的治理和开发工具
 ```
@@ -20,7 +22,8 @@ tools/      可重复执行的治理和开发工具
 ```text
 免费数据源
   → Scheduler 定时投递
-  → RabbitMQ
+  → MessageBusAdapter
+  → RocketMQ 5.x
   → 行情采集 Worker
   → 指标计算 Worker
   → 规则 / AI / 混合分析
@@ -30,12 +33,48 @@ tools/      可重复执行的治理和开发工具
 ```
 
 - Scheduler只负责触发时间。
-- RabbitMQ只负责任务传递、确认、重试和死信。
+- MessageBusAdapter 隔离业务与 RocketMQ 客户端，禁止业务模块直接依赖 SDK。
+- RocketMQ 只负责任务传递、确认、重试、延迟消息和死信；重复投递由 Worker 幂等处理。
 - Worker负责采集、标准化、计算和分析。
 - MySQL保存可追溯事实与历史报告。
 - Redis保存最新快照、缓存、锁和限流状态。
 - Vue前端只读后端 API，不直接接触外部数据源和密钥。
 
-## 3. 当前实施顺序
+## 3. 前后端模块边界
+
+后端以业务模块为一级目录，模块内部按实际职责建立 Controller、Service、DTO、Domain、Repository 和 Adapter。小模块不强制凑齐目录，禁止把全部 Controller/Service 堆入全局目录，也禁止无业务逻辑的透传层。领域规则只依赖项目端口，MySQL、Redis、RocketMQ、免费数据源和 AI Provider 由基础设施 Adapter 实现。
+
+前端 HTTP 数据流固定为：
+
+```text
+NestJS DTO 与 Swagger 元数据
+  → server/openapi/openapi.json
+  → openapi-typescript 生成 web/src/api/generated/schema.ts
+  → web/src/api/<业务域>/index.ts
+  → web/src/utils/request.ts（Axios）
+  → 功能 adapter / ViewModel
+  → 页面、组件和 Store
+```
+
+OpenAPI 负责描述本项目 HTTP 契约，Axios 负责浏览器实际请求。页面、组件、Store 和 Composable 不直接发 HTTP。兼容 OpenAI API 指未来后端 AI Provider 的外部协议，与前端请求库无关。
+
+## 4. 数据库技术基线
+
+- 数据库服务端统一使用 MySQL 5.7.x；开发、测试和生产环境禁止使用 MySQL 5.6.x、8.x、MariaDB 或其他数据库代替兼容性验证，但不锁定 5.7 系列内的补丁版本。
+- 数据库与表默认字符集固定为 `utf8mb4`，排序规则固定为 `utf8mb4_general_ci`。
+- 数据库初始化、表结构、连接会话、ORM 配置和迁移脚本必须显式声明或验证该字符集与排序规则，不能依赖服务器默认值。
+- 正式启用持久化前，必须在真实 MySQL 5.7.x 环境验证服务端版本、Schema/表排序规则、迁移和关键查询。
+- 第一阶段市场概览只定义 MySQL Repository 接口并使用内存实现，不启动数据库、不建立生产连接；后续启用时不得改变前端 API 和核心分析契约。
+
+## 5. 当前实施顺序
 
 第一阶段先实现可交互的市场综合概览和稳定数据契约，再接入正式行情采集链路。用户、邀请、权限、会员和支付后置，不进入当前核心架构。
+
+## 6. 环境与部署基线
+
+- 应用运行环境只定义 `development` 与 `production`；生产环境禁止模拟数据、热更新、调试端口和开发默认值回退。
+- API、Scheduler、Worker、Web 分别拥有开发和生产模板；同一进程跨环境使用相同变量名，通过启动 Schema 校验条件必填项。
+- 本地开发直接连接开发机已开机自启的 Redis `127.0.0.1:6379`，应用进程从源码运行；第一阶段 MySQL 与 RocketMQ 保持关闭，需要联调时连接开发者独立维护的外部服务。
+- 生产只支持 Ubuntu 22.04/24.04 LTS x86_64 源码部署，不提供容器运行、构建、测试或部署入口。
+- 源码部署由管理员预装 Node.js 22.x、pnpm 10.25.0、Nginx 和外部基础设施；项目只验证，不安装、启动、停止或删除系统服务。
+- 源码部署使用不可变发布目录、`a-share` 用户和 systemd 独立进程配置；生产 env 存放在 `/etc/a-share-analysis/`，不随代码版本切换覆盖。

docs/deployment/local-development.md

@@ -0,0 +1,42 @@
+# 本地开发环境
+
+本地开发由开发机提供 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 也是外部服务，项目脚本不负责安装、启动、停止或删除任何基础设施。
+
+## 首次准备
+
+```bash
+node --version
+pnpm --version
+redis-cli -h 127.0.0.1 -p 6379 ping
+pnpm install --frozen-lockfile
+pnpm check:runtime
+```
+
+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.x 且不限制系列内补丁版本，字符集为 `utf8mb4`、排序规则为 `utf8mb4_general_ci`、会话时区为 `+08:00`。Schema 工具和开发检查禁止连接、探测或读取生产库。
+
+## 启动顺序
+
+建议分别打开四个终端，依次运行：
+
+```bash
+pnpm --filter @a-share-analysis/server dev:api
+pnpm --filter @a-share-analysis/server dev:scheduler
+pnpm --filter @a-share-analysis/server dev:worker
+pnpm --filter @a-share-analysis/web dev
+```
+
+API 健康端点是 `http://127.0.0.1:3000/api/v1/health`，Web 是 `http://127.0.0.1:5173/`。Scheduler 与 Worker 在 GOV-009 中保持 `ROCKETMQ_ENABLED=false`；没有经过验证的 Node RocketMQ 客户端时，启用配置会直接失败，不使用内存队列伪降级。
+
+## 日常验证与停止
+
+```bash
+pnpm check:contracts
+pnpm verify
+pnpm verify:release
+```
+
+应用进程通过各自终端或信号正常停止，外部 Redis/MySQL/RocketMQ 生命周期不由项目管理。RocketMQ 的 TCP 端口可达不等于生产消费链路通过，完整联调仍需验证 Topic 路由和实际生产/消费。

docs/deployment/tailscale-tdx-development.md

@@ -0,0 +1,441 @@
+# Tailscale + SSH 隧道访问 TDX 开发手册
+
+## 1. 用途与适用边界
+
+本手册用于 Mac 本地开发期间，访问家中 Windows 上仅监听回环地址的 TDX HTTP 接口。TDX 是市场概览的正式行情来源；SSH 隧道负责把家庭局域网和外部 Tailscale 两种开发位置统一成同一个 Mac 回环入口。该链路不是生产采集、数据上报或公网部署方案。
+
+```text
+Mac 本地程序 / TDX Bridge
+  -> 127.0.0.1:17710
+  -> SSH 本地端口转发
+  -> 家庭局域网或 Tailscale 私有网络
+  -> 同一台 Windows OpenSSH
+  -> Windows 127.0.0.1:17709
+  -> TDX
+```
+
+两个场景只切换 SSH 目标别名，TDX Bridge 和上层业务始终访问 `http://127.0.0.1:17710/`。离线样本只允许作为显式开发和自动化测试回退，并必须标记为离线数据；不得伪装为实时 TDX。Windows 离线不得阻塞普通测试或构建。
+
+## 2. 安全边界
+
+- 不在路由器上开放或转发 SSH、RDP、`17709`、`17710` 等端口。
+- TDX 继续只监听 Windows `127.0.0.1:17709`，不得改为 `0.0.0.0`。
+- SSH 使用独立 Ed25519 密钥，不在脚本、仓库、文档或远程 URL 中保存密码和私钥。
+- Mac 转发端口只绑定 `127.0.0.1:17710`，不得绑定局域网或所有网卡。
+- 真实返回只用于只读验证。日志和测试报告必须脱敏，不保存家庭网络信息、登录信息或无关原始载荷。
+- 开发隧道不连接生产数据库、不承担生产采集，也不证明数据源具备商业展示或再分发授权。
+
+文档中的值均为占位符：
+
+- `<WINDOWS_TAILSCALE_HOST>`：Windows 的 Tailscale MagicDNS 名称或 Tailscale IP。
+- `<WINDOWS_SSH_USER>`：用于 SSH 登录的 Windows 用户。
+- `<MAC_TAILSCALE_IP>`：Mac 的 Tailscale IP，仅在收紧防火墙来源时使用。
+
+## 3. 首次建立 Tailscale 网络
+
+### 3.1 Mac
+
+1. 从 Tailscale 官方渠道安装客户端。
+2. 登录项目使用的同一个 Tailnet。
+3. 确认菜单栏中的 Tailscale 状态为已连接。
+4. 在终端检查本机和节点列表：
+
+```bash
+tailscale ip -4
+tailscale status
+```
+
+### 3.2 Windows
+
+1. 从 Tailscale 官方渠道安装客户端。
+2. 登录与 Mac 相同的 Tailnet。
+3. 确认 Windows 节点在 Tailscale 管理后台和 Mac 的 `tailscale status` 中均为在线。
+4. 在 Windows PowerShell 中检查地址和状态：
+
+```powershell
+tailscale ip -4
+tailscale status
+```
+
+### 3.3 私网连通验证
+
+在 Mac 执行：
+
+```bash
+tailscale ping <WINDOWS_TAILSCALE_HOST>
+```
+
+只有 Tailscale ping 成功后再排查 SSH。不要用公网 IP 替换占位符，也不要为排障临时开放路由器端口。
+
+## 4. 配置 Windows OpenSSH Server
+
+以下命令在 Windows 管理员 PowerShell 中执行。
+
+### 4.1 安装并启动服务
+
+```powershell
+Get-WindowsCapability -Online | Where-Object Name -Like 'OpenSSH.Server*'
+Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
+Start-Service sshd
+Set-Service -Name sshd -StartupType Automatic
+Get-Service sshd
+```
+
+如果 OpenSSH Server 已安装，`Add-WindowsCapability` 可以跳过。`Get-Service sshd` 应显示服务正在运行且启动类型为自动。
+
+检查端口监听：
+
+```powershell
+Get-NetTCPConnection -LocalPort 22 -State Listen
+```
+
+### 4.2 确认防火墙规则
+
+OpenSSH 安装通常会创建入站规则。先检查，不要重复创建同名规则：
+
+```powershell
+Get-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -ErrorAction SilentlyContinue
+```
+
+首次联调可以保留系统创建的 SSH 规则；链路确认后按第 11 节限制为 Tailscale 来源。不得新增公网端口映射。
+
+## 5. 配置 SSH 密钥登录
+
+### 5.1 在 Mac 生成项目专用密钥
+
+```bash
+ssh-keygen -t ed25519 -a 100 -f ~/.ssh/tdx_windows -C "tdx-windows-development"
+chmod 600 ~/.ssh/tdx_windows
+chmod 644 ~/.ssh/tdx_windows.pub
+pbcopy < ~/.ssh/tdx_windows.pub
+```
+
+私钥 `~/.ssh/tdx_windows` 只保留在 Mac，不发送给 Windows，也不提交仓库。建议为私钥设置口令，并由 macOS 钥匙串或 `ssh-agent` 管理。
+
+### 5.2 Windows 管理员账户
+
+Windows OpenSSH 默认从 `C:\ProgramData\ssh\administrators_authorized_keys` 读取管理员公钥。必须先创建文件，再设置 ACL；否则 `icacls` 会报“系统找不到指定的文件”。
+
+在管理员 PowerShell 中执行，按提示粘贴刚复制的单行公钥：
+
+```powershell
+$authorizedKeys = "$env:ProgramData\ssh\administrators_authorized_keys"
+New-Item -ItemType Directory -Force -Path (Split-Path $authorizedKeys)
+if (-not (Test-Path $authorizedKeys)) {
+  New-Item -ItemType File -Path $authorizedKeys
+}
+$publicKey = Read-Host '粘贴 Mac 的单行 SSH 公钥'
+if (-not (Get-Content $authorizedKeys | Where-Object { $_ -eq $publicKey })) {
+  Add-Content -Path $authorizedKeys -Value $publicKey -Encoding ascii
+}
+icacls $authorizedKeys /inheritance:r
+icacls $authorizedKeys /grant "*S-1-5-18:F" "*S-1-5-32-544:F"
+Restart-Service sshd
+```
+
+`S-1-5-18` 是 SYSTEM，`S-1-5-32-544` 是本地 Administrators 组。使用 SID 可以避免中文 Windows 的组名本地化问题。
+
+### 5.3 Windows 非管理员账户
+
+非管理员账户使用用户目录下的 `authorized_keys`。在该登录用户自己的 PowerShell 中执行：
+
+```powershell
+$sshDirectory = "$env:USERPROFILE\.ssh"
+$authorizedKeys = "$sshDirectory\authorized_keys"
+New-Item -ItemType Directory -Force -Path $sshDirectory
+if (-not (Test-Path $authorizedKeys)) {
+  New-Item -ItemType File -Path $authorizedKeys
+}
+$publicKey = Read-Host '粘贴 Mac 的单行 SSH 公钥'
+if (-not (Get-Content $authorizedKeys | Where-Object { $_ -eq $publicKey })) {
+  Add-Content -Path $authorizedKeys -Value $publicKey -Encoding ascii
+}
+icacls $authorizedKeys /inheritance:r
+icacls $authorizedKeys /grant "$($env:USERNAME):F"
+Restart-Service sshd
+```
+
+管理员和非管理员两种方式只选与实际账户匹配的一种。若修改了 `C:\ProgramData\ssh\sshd_config`，先执行 `sshd -t` 校验，再重启服务。
+
+## 6. 配置 Mac SSH 双场景别名
+
+家庭局域网和外部 Tailscale 连接同一台 Windows、同一个账户和同一个 `sshd`，复用同一把项目专用密钥，不创建第二把 SSH 密钥。编辑 Mac 的 `~/.ssh/config`，加入：
+
+```sshconfig
+Host tdx-windows-lan tdx-windows-tailnet
+  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}'
+```
+
+然后修正权限：
+
+```bash
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/config ~/.ssh/tdx_windows
+```
+
+首次连接先验证密钥登录：
+
+先在 Windows 管理员 PowerShell 查看主机公钥指纹：
+
+```powershell
+ssh-keygen -lf "$env:ProgramData\ssh\ssh_host_ed25519_key.pub"
+```
+
+再在 Mac 连接，并确认首次连接提示的 Ed25519 指纹与 Windows 输出一致：
+
+```bash
+ssh -v tdx-windows-tailnet
+```
+
+预期可以直接登录，或只要求输入私钥口令。若仍要求 Windows 账户密码，重点检查公钥文件位置、ACL、登录账户是否属于 Administrators，以及 SSH 调试输出中实际使用的密钥。
+
+## 7. 两种场景的选择、启动和停止
+
+### 7.1 选择规则
+
+| 当前场景 | 使用别名 | 前置条件 |
+|---|---|---|
+| 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 -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
+```
+
+仓库文档不保存真实地址，家庭路径直接通过 SSH 别名验证。首次连接必须核对局域网地址与已信任的 Tailscale 地址返回相同 Windows 主机密钥指纹。
+
+后台启动和检查：
+
+```bash
+ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
+ssh -S ~/.ssh/tdx-windows-lan-control -O check tdx-windows-lan
+```
+
+停止：
+
+```bash
+ssh -S ~/.ssh/tdx-windows-lan-control -O exit tdx-windows-lan
+```
+
+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 链路
+
+### 8.1 Windows 本机验证
+
+先确认 TDX 客户端已启动、已登录，接口监听 `127.0.0.1:17709`：
+
+```powershell
+Get-NetTCPConnection -LocalAddress 127.0.0.1 -LocalPort 17709 -State Listen
+```
+
+端口没有监听时，应先恢复 TDX 客户端；SSH 和 Tailscale 无法替代 TDX 服务本身。
+
+### 8.2 Mac 端口验证
+
+隧道启动后在 Mac 执行：
+
+```bash
+nc -vz 127.0.0.1 17710
+lsof -nP -iTCP:17710 -sTCP:LISTEN
+```
+
+`17710` 的监听进程应为本次 SSH 隧道，不应是其他应用。
+
+### 8.3 只读 HTTP 冒烟
+
+```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 业务响应中的错误码表示成功。只验证少量公开行情，不调用交易、账户、自选、写入或大批量接口。
+
+## 9. 外网场景验证
+
+在真正离开家庭网络前，使用 Mac 手机热点或其他外部网络完成一次演练：
+
+1. 确认 Windows 保持开机、联网，Tailscale 和 `sshd` 在线，TDX 已启动并登录。
+2. Mac 切换到外部网络后重新连接 Tailscale。
+3. 执行 `tailscale ping <WINDOWS_TAILSCALE_HOST>`。
+4. 执行 `ssh -N tdx-windows-tailnet` 并保持终端运行。
+5. 依次执行 `nc` 和只读 `curl` 冒烟。
+6. 停止隧道，确认 `127.0.0.1:17710` 不再监听。
+
+如果外网演练失败，开发和自动化测试可显式切换到离线样本，并明确标记数据来源。不要临时开放公网 SSH、RDP 或 TDX 端口。
+
+## 10. Windows 无人值守准备
+
+当前链路是开发辅助，不承诺生产级 7x24 可用性。为了减少外出后无法联调的概率，可在 Windows 上做以下准备：
+
+- 将虚拟机配置为宿主机启动后自动启动，并确认异常关机后的恢复策略。
+- 保持 Tailscale 与 `sshd` 服务自动启动，重启后通过另一台 Tailnet 设备验证在线状态。
+- 接通电源时禁用自动睡眠：
+
+```powershell
+powercfg /change standby-timeout-ac 0
+```
+
+- 明确 TDX 是否需要交互式桌面登录、验证码或人工确认。需要人工登录时，不得把它描述为无人值守服务。
+- 安排 Windows 更新和虚拟机重启窗口；更新后重新验证 Tailscale、SSH、TDX 监听和只读请求。
+- 不为自动启动把 Windows 密码、TDX 凭据或 SSH 私钥写入仓库和普通脚本。
+
+## 11. 收紧访问范围
+
+链路验证通过后，在 Tailscale 管理后台将访问规则限制为指定开发身份或 Mac 到 Windows SSH 端口。具体策略应以当前 Tailnet 的身份和标签设计为准，不在仓库保存真实账户和地址。
+
+还可在 Windows 中新增一条仅允许 Mac Tailscale IP 访问 SSH 的规则。先确认 Tailscale 网卡名称，再创建规则：
+
+```powershell
+Get-NetAdapter | Where-Object InterfaceDescription -Match 'Tailscale'
+New-NetFirewallRule `
+  -DisplayName 'OpenSSH Server - Tailscale Mac Only' `
+  -Direction Inbound `
+  -Action Allow `
+  -Protocol TCP `
+  -LocalPort 22 `
+  -RemoteAddress '<MAC_TAILSCALE_IP>' `
+  -InterfaceAlias 'Tailscale'
+```
+
+新规则必须在外网场景实测通过后，才能禁用范围更宽的旧 SSH 规则。若实际网卡别名不是 `Tailscale`，使用 `Get-NetAdapter` 显示的名称，不凭猜测修改。
+
+## 12. 故障排查
+
+### Tailscale ping 不通
+
+- 检查两端是否登录同一个 Tailnet、节点是否过期、Windows 是否睡眠或断网。
+- 检查 Tailnet ACL 或设备审批状态。
+- 不要先排查 TDX；此时底层私网尚未连通。
+
+### SSH 连接超时或拒绝
+
+- Windows 执行 `Get-Service sshd` 和 `Get-NetTCPConnection -LocalPort 22 -State Listen`。
+- 检查 Windows 防火墙和 Tailscale 访问规则。
+- Mac 执行 `ssh -vvv tdx-windows-tailnet`，确认目标是 Tailscale 地址而非家庭公网地址。
+
+### SSH 仍要求 Windows 密码
+
+- 确认 `IdentityFile` 指向 `~/.ssh/tdx_windows`，并检查 `ssh -vvv` 是否提供了该密钥。
+- 管理员账户确认文件是 `C:\ProgramData\ssh\administrators_authorized_keys`；非管理员账户确认文件是用户目录下的 `.ssh\authorized_keys`。
+- 确认公钥为完整单行文本，文件已先创建，ACL 没有继承无关权限。
+- 执行 `sshd -t` 检查配置，再执行 `Restart-Service sshd`。
+
+### Mac 的 `17710` 无法监听
+
+- 查看 SSH 前台错误；`ExitOnForwardFailure yes` 会在端口冲突或转发失败时直接退出。
+- 执行 `lsof -nP -iTCP:17710 -sTCP:LISTEN` 查找占用者。
+- 不要把本地端口改成 `0.0.0.0`；需要换端口时同步修改本机开发配置，并保持回环绑定。
+
+### 端口可连但 HTTP 失败
+
+- 在 Windows 本机确认 TDX `127.0.0.1:17709` 正在监听。
+- 确认 TDX 客户端已登录且当前版本仍支持目标方法。
+- 使用最小只读请求检查 HTTP 状态、TDX 错误码和响应时间，不把协议错误误判为网络错误。
+
+### 外出后 Windows 不在线
+
+- 无法远程唤醒或恢复交互式 TDX 登录时，显式切回离线样本继续开发，并保持非实时标记。
+- 不通过新增公网暴露、共享密码或关闭防火墙绕过问题。
+- 待公网部署需求明确后，另立功能实现生产级采集器、心跳、补传和远程运维。
+
+## 13. 日常操作速查
+
+### 13.1 在家开发
+
+```bash
+ssh -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
+ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
+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-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`，不得保存家庭网络或 Tailscale 地址。
+- TDX 是正式行情来源；离线样本只作为显式开发和测试回退，必须展示来源与陈旧状态，生产环境禁止启用。
+- Provider 必须限制请求超时、响应体大小、股票数量和并发，并输出来源、采集时间、交易日期、协议版本、追踪 ID 和陈旧状态。
+- TDX 原始字段仅在 Adapter 内转换，上层市场概览、规则分析和 AI 分析只依赖版本化内部契约。
+- 隧道中断必须返回明确的不可用或陈旧状态，不能把离线样本伪装成实时行情。
+- Windows 采集器、公网接收 API、多目标推送、补传队列和无人值守运维继续延期，实施时单独立项并重新进行安全、性能和合规评估。

docs/deployment/ubuntu-source-production.md

@@ -0,0 +1,50 @@
+# Ubuntu 源码生产部署
+
+这是项目唯一生产部署方式，支持 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；项目不负责安装、升级、启动、停止、删除或修改这些系统软件与服务。
+
+## 构建发布目录
+
+在固定提交的干净工作区执行：
+
+```bash
+uname -m
+node --version
+pnpm --version
+pnpm install --frozen-lockfile
+pnpm verify:release
+```
+
+架构必须为 `x86_64`，Node.js 必须为 22.x，pnpm 必须为 10.25.0。发布门禁会完成测试、Web/Server 构建、双视口浏览器检查，并核对 Web、API、Scheduler、Worker 产物与 systemd/Nginx 模板。
+
+每次发布使用 `/opt/a-share-analysis/releases/<版本或提交>/` 新目录。完整传输并验证目录后，再把 `/opt/a-share-analysis/current` 原子切换到目标目录；禁止在 `current` 中原地覆盖文件，也禁止只发布部分进程产物。
+
+## 配置与 systemd
+
+生产配置放在 `/etc/a-share-analysis/api.env`、`scheduler.env`、`worker.env`，建议权限 `root:a-share 0640`；Web 的 `VITE_` 公开变量在构建前注入。三个 systemd 单元通过各自的 `EnvironmentFile=` 只读取本进程需要的键，运行用户为非登录系统用户 `a-share`。
+
+```bash
+sudo install -m 0644 deploy/systemd/a-share-api.service.example /etc/systemd/system/a-share-api.service
+sudo install -m 0644 deploy/systemd/a-share-scheduler.service.example /etc/systemd/system/a-share-scheduler.service
+sudo install -m 0644 deploy/systemd/a-share-worker.service.example /etc/systemd/system/a-share-worker.service
+sudo install -m 0644 deploy/nginx/a-share-analysis.conf.example /etc/nginx/conf.d/a-share-analysis.conf
+sudo systemd-analyze verify /etc/systemd/system/a-share-api.service
+sudo systemd-analyze verify /etc/systemd/system/a-share-scheduler.service
+sudo systemd-analyze verify /etc/systemd/system/a-share-worker.service
+sudo nginx -t
+sudo systemctl daemon-reload
+sudo systemctl restart a-share-api.service
+sudo systemctl restart a-share-scheduler.service
+sudo systemctl restart a-share-worker.service
+sudo systemctl status a-share-api.service a-share-scheduler.service a-share-worker.service
+sudo journalctl -u a-share-api.service -u a-share-scheduler.service -u a-share-worker.service --since '5 minutes ago'
+curl --fail http://127.0.0.1:3000/api/v1/health
+curl --fail http://127.0.0.1/
+```
+
+当前工程尚无业务表迁移；后续新增迁移后必须在切换 `current` 前单独执行并记录结果。生产环境禁止 `synchronize: true`，开发流程也禁止用生产数据库做 Schema 基线或连接测试。
+
+## 检查与回退
+
+使用 `systemctl status`、`journalctl -u`、HTTP 健康端点和 Nginx 同源访问结果确认发布。任一验证失败时，把 `/opt/a-share-analysis/current` 原子切回上一完整发布目录，重启三个 systemd 服务并重复健康检查。
+
+`/etc/a-share-analysis/*.env` 和外部 Redis、MySQL、RocketMQ 数据不随应用目录切换而覆盖或删除。RocketMQ 的 NameServer、Broker、Proxy 与 CommitLog 由运维独立维护。

docs/features/FEAT-DS-001-tdx-ingestion-poc/design.md

@@ -0,0 +1,55 @@
+# 数据源接入架构与 TDX PoC 规划
+
+## 方案结论
+
+当前采用“平台先行、采集器后置”。Mac 本地开发以固定样本回放为默认 Provider；需要验证真实字段时，通过 Tailscale + SSH 隧道访问家中 Windows 的 TDX `127.0.0.1:17709`。不在当前阶段实现 Windows 常驻采集程序、GUI 或公网推送。
+
+```text
+固定样本 / Mac TDX 隧道
+        ↓
+DataProvider 端口
+        ↓
+标准化市场事件 → 市场概览业务
+
+未来公网模式：采集器 → 多目标隔离推送 → 平台接收 API
+```
+
+## 方案比较
+
+- 本地样本回放（当前采用）：不引入 Windows/公网依赖，测试稳定可重复，适合先开发市场概览；缺点是不能代表实时数据质量。
+- Mac 通过 Tailscale SSH 隧道调用 TDX（当前联调）：可以验证真实字段，但依赖家中 Windows 在线和人工维护。
+- Windows 常驻采集器（延期）：未来可选 Node、Python、Go、Rust、Electron、Tauri 或系统服务，必须按部署规模、资源、自动更新和安全能力重新评估。
+
+## 当前组件边界
+
+当前只新增/维护平台侧 Provider 端口和固定样本。样本 Provider 与真实 TDX Provider 使用同一标准化契约，市场概览不感知来源差异。未来采集器应作为独立项目或 workspace，不反向污染 NestJS 业务模块；公网接收 API、目标队列、签名握手和 GUI 另立功能档案。
+
+## Provider 与事件模型
+
+Provider 生成不可变标准化事件，包含 `eventId`、`source`、`capturedAt`、`tradeDate`、`schemaVersion`、`traceId` 和数据新鲜度。TDX 原始字段只能存在于 Adapter 内，规则分析、AI 分析、API 和页面只依赖内部模型。
+
+## 安全策略与评估
+
+- Mac 本地样本和 TDX 隧道均不接触生产配置、生产数据库或公网接收 API。
+- 真实 TDX 只读调用使用 SSH 密钥隧道，`17709`、SSH 和 RDP 不做公网端口映射。
+- 样本删除凭据、家庭地址和无关原始字段；日志只保存统一错误分类和性能摘要。
+- 未来采集器的密钥存储、目标认证、IPC 和自动更新不在当前方案中预设，必须重新安全评估。
+- 数据再分发许可属于外部合规风险。PoC 只用于个人开发验证，不宣称获得商业展示或再分发授权。
+
+## 性能目标与评估
+
+- 固定样本回放必须确定性、可重复且不访问网络；Provider 标准化耗时纳入单元测试与基准记录。
+- 真实 TDX 请求目标超时 5 秒并记录响应耗时和字段完整性。
+- 公网上传并发、队列容量、心跳周期和 GUI 资源目标延期到采集器立项，不在当前阶段作容量承诺。
+
+## 失败恢复
+
+TDX 请求失败返回统一错误分类和陈旧状态；本地平台可切回固定样本继续开发，不能把样本伪装为实时行情。上传重试、补传、熔断和备用免费源切换属于后续公网功能。
+
+## 测试边界
+
+单元测试使用固定 TDX 响应验证 Provider、标准化和错误映射；通过 Tailscale SSH 隧道做真实只读冒烟。Electron/Tauri 安装、托盘、开机启动、操作系统密钥存储、目标队列和公网接收测试延期，不能在当前阶段宣称通过。
+
+## 依赖与退出方案
+
+当前不新增 Electron、Python、Go、Rust 或其他采集器运行时依赖。未来采集器实现前重新比较语言、部署形态、许可证、资源、自动更新和安全边界；只要遵循 Provider/上传契约，采集器可替换而不改市场概览。

docs/features/FEAT-DS-001-tdx-ingestion-poc/gitnexus/before.md

@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：FEAT-DS-001
+- 记录时间：2026年8月14日 GMT+8 02:38:03
+- 分支：main
+- 基线提交：a398bc418d39
+
+## 工作区
+
+```text
+?? docs/features/FEAT-DS-001-tdx-ingestion-poc/
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/14/2026, 2:38:02 AM
+Indexed commit: a398bc4
+Current commit: a398bc4
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。

docs/features/FEAT-DS-001-tdx-ingestion-poc/gitnexus/impact-plan.md

@@ -0,0 +1,24 @@
+# GitNexus 开发前影响计划
+
+- 功能编号：FEAT-DS-001
+- 总体风险：LOW（当前仅规划 Provider 边界和本地联调，不新增桌面应用或公网入口）
+
+## 直接与间接影响
+
+- `gitnexus query --repo a-share-analysis "market data ingestion TDX adapter scheduler worker"` 未找到现成行情 Provider，相关现有流程集中在 Scheduler/Worker 启动和运行时配置。
+- `gitnexus query --repo a-share-analysis "configuration HTTP API health Redis MySQL RocketMQ"` 表明 API 当前只有健康检查流程，新增接收模块不会修改 `HealthService`。
+- 对名称 `health` 的 upstream impact 命中 Web API 目录且风险为 LOW、无上游消费者；由于名称存在歧义，结论仅作为辅助证据，不解释为对 API 全局无影响。
+- 当前不新增 `desktop/tdx-agent` 或 `MarketIngestModule`，不会修改现有 Web、API、Scheduler 或 Worker 符号。
+- 直接消费者是后续市场概览 Service；未来采集器、RocketMQ Worker、Redis 快照和 MySQL 历史属于延期功能，必须重新执行影响分析。
+
+## 跨模块同步修改
+
+- HTTP/OpenAPI：当前不新增公网握手或上报 DTO；Provider 内部契约不得泄漏到 Web。
+- Web API：主平台 Vue 不修改；不存在 Electron renderer。
+- 消息契约：本 PoC 不启用 RocketMQ，也不预留伪接收实现。
+- 数据库与 Redis：不新增 Schema，不读取生产库；PoC 接收仅做受控确认。
+- API：后续 Provider 如进入 API，再对 `ApiModule.register`、OpenAPI 和运行时配置执行影响分析。
+- Scheduler/Worker：本 PoC 不修改；后续正式排队功能另立功能档案和影响分析。
+- 配置部署：当前不新增 Windows 或公网配置，不改变主平台源码部署政策。
+- 测试：使用固定样本和 TDX 隧道冒烟；采集器打包和 Windows 无人值守测试延期。
+- 文档：记录延期原因、Provider 边界、安全、性能和未来重新立项条件。

docs/features/FEAT-DS-001-tdx-ingestion-poc/implementation-plan.md

@@ -0,0 +1,17 @@
+# 数据源接入架构与 TDX PoC 规划
+
+## 当前计划（不实现采集器）
+
+1. 建立与运行时无关的 `DataProvider`、市场事件和数据新鲜度契约。
+2. 用固定样本 Provider 支撑市场概览的规则、AI、混合和对照分析开发。
+3. 按 [Tailscale + SSH 隧道访问 TDX 开发手册](../../deployment/tailscale-tdx-development.md) 执行真实 TDX 只读请求，保存脱敏字段报告。
+4. 对 TDX 字段缺失、协议错误和陈旧数据做 Provider 层降级，不连接生产数据。
+5. 暂不新增 Windows 应用、Electron/Tauri、目标推送、补传队列、公网接收 API、RocketMQ 事件或数据库表。
+6. 待公网部署需求确定后，另立采集器功能档案，重新评估 Node、Python、Go、Rust 或系统服务方案。
+
+## 后置功能必须覆盖
+
+- 单次采集、多目标隔离推送。
+- production/development 独立地址、密钥、队列、状态和启停；两者地址均可修改。
+- production 未配置或停止为正常状态；停止时不删除队列、不转投 development。
+- HTTPS/HMAC、重放防护、握手身份、限流、补传、熔断、心跳、无人值守运行和系统更新。

docs/features/FEAT-DS-001-tdx-ingestion-poc/manifest.yaml

@@ -0,0 +1,12 @@
+id: FEAT-DS-001
+name: 数据源接入架构与 TDX PoC 规划
+slug: tdx-ingestion-poc
+status: deferred
+owner: project
+created_at: 2026-08-14
+requirements: requirements.md
+prd: prd.md
+design: design.md
+implementation_plan: implementation-plan.md
+traceability_note: 当前只完成数据源边界和本地联调规划；操作步骤见 ../../deployment/tailscale-tdx-development.md；Windows 采集器与公网接入延期到公网部署需求确认后单独立项。
+release: unreleased

docs/features/FEAT-DS-001-tdx-ingestion-poc/prd.md

@@ -0,0 +1,37 @@
+# TDX 数据接入 PoC PRD
+
+## 用户问题
+
+TDX 客户端运行在家中 Windows 虚拟机，并且接口只监听 Windows 本机 `127.0.0.1:17709`。公网平台和人在外面的开发设备都不能直接访问该端口，需要验证一套不暴露 TDX、可 7×24 小时运行的数据上报链路。
+
+## 目标
+
+在不提前引入公网部署和 Windows 常驻程序的前提下，先确定 TDX 数据源边界、标准化 Provider 契约和 Mac 本地联调方式。Windows 采集器、托盘 GUI、目标推送和公网接收入口延期，避免在生产部署形态尚未确定时锁定技术栈。
+
+## 范围
+
+- Mac 本地开发使用固定样本回放作为默认数据源，并保留通过 Tailscale SSH 隧道调用家中 Windows TDX 的人工联调方式。
+- 只定义与运行时无关的 `DataProvider`、标准化事件和数据新鲜度字段，不实现 Windows 常驻采集程序。
+- 记录未来公网模式的单次采集、多目标隔离推送、地址可变和目标启停原则，但不在本功能实现。
+- 只读验证指数、单股 K 线、快照、分时和板块接口中实际可用的字段。
+- 通过 Tailscale + SSH 隧道从外部 Mac 远程验证家中 Windows TDX；验证结果只用于 Provider 契约，不写入生产链路。
+
+## 非目标
+
+- 不在本功能中开发 Windows 采集应用、Electron/Tauri GUI、开发/生产接收 API、目标队列或公网推送。
+- 不在本功能中开发市场概览页面、AI 分析、正式 Worker 消费或生产接入。
+- 不开放 TDX `17709`、SSH 或 RDP 到公网。
+- 不写入自选、交易、账户或 TDX 状态。
+- 不把通达信数据授权问题解释为已解决；商业展示和再分发授权仍需单独确认。
+
+## 成功指标
+
+- 固定样本能够覆盖 Provider 的 K 线、快照、分时、板块和错误映射测试。
+- 通过 SSH 隧道完成至少一次真实 TDX 只读请求，并保存脱敏字段报告。
+- Provider 契约不依赖 Node、Electron、Python 或具体传输方式；未来采集器可独立替换。
+
+## 风险
+
+- TDX 客户端协议和返回字段可能变化；代理必须保留原始字段版本和来源标识。
+- 未来公网部署会增加采集节点、推送认证和再分发风险；延期期间不把这些风险误标为已解决。
+- 行情数据的展示、再分发和商业使用权利不由代码许可证自动授予。

docs/features/FEAT-DS-001-tdx-ingestion-poc/requirements.md

@@ -0,0 +1,28 @@
+# 数据源接入架构与 TDX PoC 工程需求
+
+## 当前阶段 Provider 边界
+
+- Provider 暴露与采集器语言和传输方式无关的只读接口，统一返回 `source`、`capturedAt`、`tradeDate`、`schemaVersion`、`traceId` 和数据新鲜度。
+- 默认开发 Provider 使用仓库内固定样本，不连接生产数据源；真实 TDX Provider 只通过显式本地配置和 Tailscale SSH 隧道联调。
+- TDX Provider 限制回环地址、请求超时、响应体大小、股票列表和并发；不得把家庭地址或凭据写入代码。
+- Provider 原始响应映射为版本化内部载荷，上层分析不得依赖 TDX 原始字段名称。
+
+## 当前运行与环境
+
+- 平台仅在 Mac 本地源码运行，不要求安装 Windows 采集程序。
+- 固定样本支持离线、确定性和可重复测试；真实 TDX 联调依赖家中 Windows 在线，但不能成为日常测试门禁。
+- 当前不新增 Electron、Tauri、Python 服务、Go/Rust 程序、公网接收 API、文件补传队列或目标密钥。
+- SSH 私钥、TDX 地址、家庭网络信息和开发数据库凭据不得进入仓库、日志、样本或前端构建物。
+
+## 延期的公网采集原则
+
+- 采集器语言、GUI 壳和打包方式不预设为 Node/Electron，待公网部署需求确认后比较 Node、Python、Go、Rust 和系统服务方案。
+- 未来采集器只采集一次，production/development 使用独立地址、节点 ID、密钥、队列、上传器、心跳和启停状态。
+- production 与 development 地址均可修改且独立测试；任一目标故障或重配不得影响另一目标。
+- production 未配置或停止属于正常状态；停止时不删除已有队列、不转投 development。
+- 公网模式必须重新设计 HTTPS/HMAC、重放防护、身份握手、限流、补传、熔断、无人值守运行和操作系统密钥存储。
+
+## 可观测性
+
+- Provider 结果标记来源、采集时间、数据时间、陈旧状态和统一错误分类。
+- 真实联调报告必须脱敏，不保存完整家庭地址、SSH 信息、供应商凭据或未筛选的原始载荷。

docs/features/FEAT-DS-001-tdx-ingestion-poc/test-plan.md

@@ -0,0 +1,23 @@
+# 数据源接入架构与 TDX PoC 测试计划
+
+## 当前阶段功能验证
+
+- 固定样本验证 K 线、快照、分时和板块 Provider 载荷映射。
+- 通过 Tailscale SSH 隧道验证真实 TDX 只读请求，并保存脱敏字段报告。
+- 验证 Provider 在 TDX 错误、超时、空结果和陈旧数据下返回统一错误分类。
+- 验证市场概览只依赖内部模型，不直接读取 TDX 原始字段。
+
+## 安全验证
+
+- SSH 私钥、TDX 地址、家庭网络信息和开发数据库凭据不进入仓库、样本、日志或前端构建物。
+- TDX 只通过 SSH 隧道访问，`17709` 不开放公网。
+- 固定样本不包含供应商凭据和不必要的完整原始载荷。
+
+## 性能验证
+
+- 固定样本下测量 Provider 标准化耗时，确保回放不依赖外部网络。
+- 真实 TDX 请求记录响应耗时和字段完整性；不对未来采集器的上传、队列和 GUI 资源作结论。
+
+## 不适用项与边界
+
+不做 Electron/Tauri 窗口、托盘、安装包、生产数据库迁移、RocketMQ 收发和公网接收验证，原因是采集器与公网部署已延期。市场概览页面另按业务功能执行视觉验证。

docs/features/FEAT-MO-001-market-overview/design.md

@@ -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监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。

docs/features/FEAT-MO-001-market-overview/development-summary.md

@@ -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` 追溯边界，不读取生产库。

docs/features/FEAT-MO-001-market-overview/gitnexus/after.md

@@ -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 自动维护的入口说明，未纳入功能提交。

docs/features/FEAT-MO-001-market-overview/gitnexus/before.md

@@ -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`。

docs/features/FEAT-MO-001-market-overview/gitnexus/comparison.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/页面和测试夹具；生产数据边界、基础设施暂不启用边界和回退路径保持不变。

docs/features/FEAT-MO-001-market-overview/gitnexus/detected-changes.md

@@ -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 交叉确认，没有将工具限制误判为低风险。

docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md

@@ -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`。本功能不借该例外修改数据库结构、读取生产数据库或声称发布门禁通过。

docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.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`，本功能分支不将其纳入提交。功能代码只在本隔离工作区开发。

docs/features/FEAT-MO-001-market-overview/implementation-plan.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 后再收口功能档案。

docs/features/FEAT-MO-001-market-overview/manifest.yaml

@@ -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

docs/features/FEAT-MO-001-market-overview/prd.md

@@ -23,7 +23,7 @@
 ## 非目标
 
 - 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
-- 本切片不接正式行情源、RabbitMQ、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 直接提供；主力净流入与盘中新闻保留补充源边界。

docs/features/FEAT-MO-001-market-overview/qa/test-results.md

@@ -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 移动视口无横向溢出；视角和引擎切换可用。

docs/features/FEAT-MO-001-market-overview/qa/visual-qa.md

@@ -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 隧道和真实接口响应，不使用离线样本伪装实时行情。

docs/features/FEAT-MO-001-market-overview/release-notes.md

@@ -0,0 +1,17 @@
+# FEAT-MO-001 发布说明
+
+## 本次发布
+
+- 新增 TDX 直连的市场概览首屏和五个模块 API。
+- 支持综合、短线、中长线视角与规则、AI、混合、对照偏好选择。
+- 市场宽度、一级行业强弱和成交额趋势接入真实 TDX 数据，并对空数据、部分数据、日期不一致和延迟状态显示明确边界。
+- 指数和板块按最新交易日截面对齐，成交额按最新有效交易日期对汇总；后端根据上海当前日历日期实际生成 `delayed`，市场宽度使用同批核心指数日期参考。
+- 拒绝非法公历日期、倒序交易日期以及日期/金额数组错位的 TDX 数据，避免异常市场抢占最新截面或产生时间倒置的成交额趋势。
+- 指数和板块仅使用有效且严格递增的相邻 K 线日期计算涨跌，前一日期非法、重复或倒序时不生成市场强弱信号。
+- 明确显示 TDX 来源、快照时间、交易日期、市场覆盖数和模块级错误。
+
+## 明确不包含
+
+- 不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
+- 不包含用户体系、详情页、依据抽屉、交易操作和荐股能力。
+- 不包含主力净流入、盘中新闻、真实图表和详情页；这些能力需另立补充数据源和功能需求。

docs/features/FEAT-MO-001-market-overview/requirements.md

@@ -2,4 +2,12 @@
 
 首屏为“市场概览”模块中的综合概览，采用结论优先。市场概览内部通过轻量分析状态入口切换综合、短线和中长线视角，并支持规则、AI、混合与对照分析。
 
-当前切片仅开发 Vue 3 可交互首屏和本地模拟数据，不接用户体系和正式数据链路。
+当前切片开发 Vue 3 可交互首屏，Nest API 通过 TDX 只读桥接层提供真实指数、市场宽度、板块和成交额趋势；主力净流入与盘中新闻不作为本次 TDX 主链路指标，不使用离线样本。不接用户体系，也不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
+
+## 本次实际范围
+
+- 已完成综合、短线、中长线视角切换，以及规则、AI、混合、对照偏好选择；偏好只保存于浏览器本地。
+- 已完成按摘要、指数、宽度、板块、资金拆分的五个 HTTP 接口和前端 API 封装。
+- 已完成 TDX 请求超时、响应大小限制、错误脱敏和模块级失败隔离。
+- 已确认并接入 TDX 市场宽度、一级行业板块和成交额趋势；资金模块明确不等同于主力净流入，`unchanged` 无可靠总数时返回 `null`。
+- 详情页和“查看依据”抽屉只保留入口，另立需求实现，不在本次发布范围内。

docs/features/FEAT-MO-001-market-overview/review/code-review.md

@@ -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

docs/features/FEAT-MO-001-market-overview/review/standards-review.md

@@ -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

docs/features/FEAT-MO-001-market-overview/rollback.md

@@ -0,0 +1,17 @@
+# FEAT-MO-001 回退说明
+
+## 触发条件
+
+- TDX 请求错误导致核心指数无法展示或页面加载阻断。
+- 发现前端横向溢出、来源状态误标为实时，或不可用指标被伪造。
+- 生产部署验证发现配置边界、权限或错误脱敏回归。
+
+## 操作
+
+1. 停止当前 API/Web systemd 服务，保留日志和失败快照摘要，不保存原始行情载荷。
+2. 回退到上一个已推送的 Gitea 提交/标签，重新执行源码构建和 `pnpm verify:source`。
+3. 恢复 TDX 桥接隧道后只做只读接口冒烟；确认通过前不得重新对外开放。
+
+## 数据边界
+
+本功能没有写入 MySQL、Redis 或 RocketMQ，也没有数据库迁移；回退不执行生产数据库操作。开发 Schema 继续遵循仅读取开发库的门禁。

docs/features/FEAT-MO-001-market-overview/schema-baseline-waiver.md

@@ -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 证据的自动治理门禁无法通过。用户接受本次追溯风险；该例外不表示数据库门禁、发布门禁或未来数据库变更已经通过。

docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md

@@ -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 生产采集、商业再分发授权、主力净流入口径或盘中新闻接口已经可用。
+- 主力净流入和盘中新闻继续保留为补充数据源需求；后续接入必须单独记录来源、权限、口径和数据质量。

docs/features/FEAT-MO-001-market-overview/test-plan.md

@@ -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 断线重连和消息/缓存压力测试不适用于当前只读首屏，已列为后续采集与生产功能边界。

docs/features/GOV-003-gitea-local-remote/design.md

@@ -0,0 +1,17 @@
+# 设计
+
+## 配置边界
+
+Git 仓库级配置存放在本项目 `.git/config`，天然不被提交，也不会作用于同一台机器上的其他项目。远程 URL 只包含协议、主机、所有者与仓库名，不嵌入用户名密码。
+
+## 凭据处理
+
+选择 macOS 原生 `osxkeychain` 凭据助手，避免明文凭据。设置 `credential.useHttpPath=true`，使 `git.foximao.com` 下不同仓库可以按 URL 路径隔离凭据；项目账号作为非敏感标识保存在本地仓库配置和治理文档中。
+
+## 授权边界
+
+远程接入分为两种权限：只读检查属于本次配置验证；推送会改变外部状态，需要用户另行明确授权。因此本次只执行非交互 `ls-remote`，不推送 `main` 或标签。
+
+## 文档边界
+
+文档记录可复现配置，但只引用密码的安全管理规则，不记录密码本身。这样既满足项目可追溯性，也避免秘密随克隆、备份和历史版本扩散。

docs/features/GOV-003-gitea-local-remote/gitnexus/after.md

@@ -0,0 +1,10 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 提交前工作区索引：349 个节点、375 条关系、5 个集群、0 条执行流程。
+- 提交后最终索引：361 个节点、387 条关系、5 个集群、0 条执行流程。
+- 最终增量分析：4 个已修改文件、0 个新增文件、0 个删除文件；其余 77 个文件行复用既有索引。
+- 索引提交：`b69023e`。
+- 状态：up-to-date。
+
+本功能没有修改生产代码、函数调用关系或业务流程。新增节点主要来自 GOV-003 功能档案和版本控制文档标题。提交后再次分析用于把索引锚定到确定提交，而不是只保留工作区快照。

docs/features/GOV-003-gitea-local-remote/gitnexus/before.md

@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-003
+- 记录时间：2026年8月12日 GMT+8 18:28:00
+- 分支：main
+- 基线提交：7c7190998b6d
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:27:10 PM
+Indexed commit: 7c71909
+Current commit: 7c71909
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。

docs/features/GOV-003-gitea-local-remote/gitnexus/comparison.md

@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 开发后 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 301 | 361 | +60 |
+| 关系 | 326 | 387 | +61 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+节点和关系增长来自 Gitea 治理说明及完整功能档案；没有新增或改变业务执行流程。变更检测风险为低，与开发前影响预估一致。最终索引已锚定实现提交 `b69023e`。

docs/features/GOV-003-gitea-local-remote/gitnexus/detected-changes.md

@@ -0,0 +1,8 @@
+# GitNexus 变更检测
+
+- 命令：`npx gitnexus detect-changes --repo a-share-analysis --scope all`。
+- 最终暂存区识别范围：24 个文件、51 个文档符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+初次对未暂存变化检测到 7 个既有文件、14 个符号；完整暂存后，GOV-003 新建档案也被纳入检测，最终扩大为 24 个文件、51 个符号。纯文本版本文件和 Changelog 另外通过 `git status`、`git diff --stat` 和完整必备文件门禁核对。

docs/features/GOV-003-gitea-local-remote/gitnexus/impact-plan.md

@@ -0,0 +1,8 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`Gitea local remote version control configuration`。
+- 主要关联：`docs/governance/version-control-and-gitea.md`、`docs/index.md`、`VERSION`、`AGENTS.md` 和 `README.md`。
+- 符号影响检查：`getRequiredFeatureFiles` 只有 1 个直接上游依赖 `finish.mjs`，不参与执行流程，风险为低。
+- 实际变化以文档和 Git 仓库级配置为主，不修改生产代码、API、数据库或前端页面。
+- 预计影响：版本控制入口说明、开发代理约束、版本号和 GOV-003 功能档案。
+- 风险控制：不修改全局配置、不保存密码、不执行推送；修改后重新索引并执行变更检测。

docs/features/GOV-003-gitea-local-remote/implementation-plan.md

@@ -0,0 +1,10 @@
+# 实施计划
+
+1. 执行开发前 GitNexus 更新、查询和影响分析。
+2. 核对当前远程、本地配置和全局配置基线。
+3. 添加 `origin`，使用 `--local` 设置凭据隔离和默认推送目标。
+4. 通过非交互 `git ls-remote origin` 验证只读连通性。
+5. 更新版本控制规范、代理约束、README、文档索引与版本记录。
+6. 保存 PRD、设计、测试、GitNexus 前后对比和回退说明。
+7. 执行治理测试、敏感信息检查、配置边界检查和双 Review。
+8. 以中文提交封存，并建立本地 `v0.0.2` 标签；不推送。

docs/features/GOV-003-gitea-local-remote/manifest.yaml

@@ -0,0 +1,17 @@
+id: GOV-003
+name: 项目专用 Gitea 远程仓库
+slug: gitea-local-remote
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: b69023e
+release: v0.0.2

docs/features/GOV-003-gitea-local-remote/prd.md

@@ -0,0 +1,37 @@
+# 项目专用 Gitea 远程仓库 PRD
+
+- 功能编号：GOV-003
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+项目已有可追溯的本地 Git 基线，但尚未关联用户自建 Gitea。接入过程中必须避免把项目凭据扩散到其他仓库，或把密码写入可提交文件和 Git 历史。
+
+## 目标
+
+- 将当前项目的 `origin` 指向指定 Gitea 仓库。
+- 所有 Git 设置只作用于当前项目，不修改全局配置。
+- 使用系统钥匙串保存未来交互式认证产生的凭据，并按仓库路径隔离。
+- 在治理文档中记录地址、账号、配置、验证和回退方法。
+
+## 非目标
+
+- 本次不向远程推送任何提交或标签。
+- 不在项目内保存密码或访问令牌。
+- 不配置 Gitea Actions、Webhook、分支保护或持续集成服务端规则。
+- 不修改其他项目的 Git 配置。
+
+## 用户流程
+
+项目维护者可以从文档确认唯一远程地址和项目账号；代理和开发者使用项目级配置进行读取。首次获得明确推送授权后，维护者在交互式终端完成认证，凭据由 macOS Keychain 管理。
+
+## 验收标准
+
+- `git remote -v` 的 fetch/push 均为指定仓库。
+- 项目级凭据助手为 `osxkeychain`，`credential.useHttpPath` 为 `true`。
+- 全局凭据助手与默认推送目标保持修改前状态。
+- 无密码进入文档、远程 URL、Git 配置或 Git 历史。
+- `git ls-remote origin` 可以建立只读连接。
+- PRD、设计、测试、Review 和回退档案完整。

docs/features/GOV-003-gitea-local-remote/qa/test-results.md

@@ -0,0 +1,20 @@
+# 测试结果
+
+## 结果摘要
+
+- `npm run test:governance`：5 个测试通过，0 个失败。
+- `GIT_TERMINAL_PROMPT=0 git ls-remote origin`：退出码 0；远程是空仓库，返回引用为空。
+- fetch 与 push URL：均精确匹配指定 Gitea 仓库。
+- 项目级配置：`osxkeychain`、路径隔离、账号和默认推送目标全部匹配设计。
+- 全局边界：全局 `credential.helper` 和 `remote.pushDefault` 仍未设置。
+- 凭据模式扫描：未发现带用户名密码的 URL、密码赋值或令牌赋值。
+- `git diff --check`：通过。
+
+## 诊断与修正
+
+1. 测试计划最初写成不存在的 `npm test`，执行时因缺少脚本失败；检查 `package.json` 后修正为项目实际提供的 `npm run test:governance`，复测通过。
+2. GitNexus 变更检测最初未指定仓库；本机存在多个索引时工具拒绝猜测。增加 `--repo a-share-analysis` 后成功；最终暂存区结果为 24 个文件、51 个符号、0 条流程，风险为低。
+
+## 完成门禁
+
+双 Review 完成后执行 `npm run governance:finish -- GOV-003 gitea-local-remote`，退出码为 0。门禁确认完整功能档案和两份固定 `passed` Review 均已就绪。

docs/features/GOV-003-gitea-local-remote/qa/visual-qa.md

@@ -0,0 +1,3 @@
+# 视觉验证
+
+本功能只修改 Git 仓库级配置和治理文档，不改变界面、样式或交互，因此视觉验证不适用。

docs/features/GOV-003-gitea-local-remote/release-notes.md

@@ -0,0 +1,9 @@
+# 发布说明
+
+## v0.0.2
+
+- 实现提交：`b69023e`。
+- 为当前项目配置指定 Gitea `origin`，不影响其他项目。
+- 使用 macOS Keychain 与仓库路径隔离策略管理未来认证凭据。
+- 增加远程接入、授权边界、验证和回退文档。
+- 本版本只建立远程连接，不推送本地提交或标签。

docs/features/GOV-003-gitea-local-remote/requirements.md

@@ -0,0 +1,9 @@
+# 工程需求
+
+- 远程名固定为 `origin`，地址固定为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`。
+- 使用 `git config --local` 写入凭据助手、路径隔离、账号和默认推送目标。
+- 不调用 `git config --global`，验证前后全局相关配置一致。
+- 不将密码传给 Shell 命令，也不把密码写入仓库文件或 `.git/config`。
+- 使用非交互、只读的 `git ls-remote origin` 检查网络与仓库可达性。
+- 未取得单独明确授权时，不运行 `git push`。
+- 更新根目录入口、治理规范、文档索引、版本和完整功能档案。

docs/features/GOV-003-gitea-local-remote/review/code-review.md

@@ -0,0 +1,31 @@
+# 配置与文档 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`7c71909`
+- 实现提交：`b69023e`
+- 审查范围：项目级 Gitea 远程、凭据隔离、治理文档和回退方案
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+实现满足六项验收标准：远程 URL 正确；凭据设置仅位于 `.git/config`；全局配置未变化；密码没有进入文档、配置或历史；只读连通性成功；功能档案完整。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 用户提供了密码，但写入文档或命令会形成长期泄露面 | 文档只保存基础地址、账号和仓库 URL；密码不落盘，由 Keychain 在未来交互认证时接管 |
+| Important | 使用全局凭据配置会影响其他项目 | 全部使用 `git config --local`，并验证相关全局项保持未设置 |
+| Minor | 初始测试计划引用了不存在的 `npm test` | 改用仓库实际的 `npm run test:governance` 并复测 5/5 通过 |
+| Minor | GitNexus 多仓库环境无法自动选择索引 | 显式增加 `--repo a-share-analysis`，变更检测成功 |
+
+## 验证
+
+- 远程只读连接、fetch/push URL 和四项本地配置断言全部通过。
+- 全局配置边界断言通过。
+- 凭据模式扫描与 `git diff --check` 通过。
+- GitNexus 最终暂存区检测 24 个文件、51 个符号、0 条流程，风险为低。
+- 没有执行 `git push`，未改变 Gitea 远程仓库内容。
+
+最终结论：passed

docs/features/GOV-003-gitea-local-remote/review/standards-review.md

@@ -0,0 +1,24 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`b69023e`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 开发前执行治理启动命令并保存 GitNexus 基线。
+- [x] PRD、工程需求、设计、实施计划、测试计划和回退说明一致。
+- [x] 修改仅涉及项目级 Git 配置和治理文档，没有过度拆分生产代码。
+- [x] 基础地址、账号和仓库 URL 可追溯，密码和令牌未进入仓库。
+- [x] Git 全局配置没有修改，不影响其他项目。
+- [x] 未配置 GitHub，唯一远程为用户指定 Gitea。
+- [x] 没有未经授权推送外部状态。
+- [x] 治理测试、配置断言、敏感信息扫描和 GitNexus 变更检测通过。
+- [x] 本功能无界面变化，视觉验证已合理标记为不适用。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。两项执行期错误均属于测试命令选择问题，已修正文档并以成功复测关闭。
+
+最终结论：passed

docs/features/GOV-003-gitea-local-remote/rollback.md

@@ -0,0 +1,13 @@
+# 回退说明
+
+本功能的运行时影响仅限当前项目 `.git/config`。如需解除接入，在本项目根目录执行：
+
+```bash
+git remote remove origin
+git config --local --unset credential.helper
+git config --local --unset credential.useHttpPath
+git config --local --unset credential.username
+git config --local --unset remote.pushDefault
+```
+
+若 Keychain 已在后续交互式认证中保存凭据，再使用“钥匙串访问”按 `git.foximao.com` 删除对应项。文档和版本记录通过新的中文修复提交回退；不得改写已共享历史。本次未执行推送，因此远程不存在需要回滚的外部提交。

docs/features/GOV-003-gitea-local-remote/test-plan.md

@@ -0,0 +1,9 @@
+# 测试计划
+
+- 检查 `origin` 的 fetch/push URL 精确匹配指定仓库。
+- 检查四项 Git 配置来自 `--local` 作用域。
+- 检查全局凭据助手和默认推送目标仍保持未设置。
+- 使用 `GIT_TERMINAL_PROMPT=0 git ls-remote origin` 验证远程只读连通性。
+- 搜索仓库文件、暂存区 diff 和远程 URL，确认不存在密码或凭据 URL。
+- 运行 `npm run test:governance` 和 `npm run governance:finish -- GOV-003 gitea-local-remote`。
+- 本功能不改变页面，视觉验证标记为不适用并说明原因。

docs/features/GOV-004-mandatory-gitea-push/design.md

@@ -0,0 +1,78 @@
+# 提交后强制推送 Gitea 设计规格
+
+- 功能编号：GOV-004
+- 规格版本：0.1
+- 状态：approved_for_review
+- 日期：2026-08-12
+
+## 背景与目标
+
+本地提交如果没有同步到远程，无法实现跨设备备份、Gitea 审阅和可靠的版本追溯。本功能把推送从“需要逐次授权的可选动作”改成项目开发流程的固定完成条件。
+
+目标是：每次本地提交在验证通过后立即同步当前分支；创建版本标签后同步该标签；任何推送失败都会阻止任务被报告为完成。
+
+## 方案比较
+
+### 方案 A：按变化精确推送（采用）
+
+- 普通提交执行 `git push origin <当前分支>`。
+- 创建新标签后执行 `git push origin <标签名>`。
+- 优点：只同步本次明确产生的引用，行为可预测，不会意外发布其他本地标签。
+- 代价：分支和标签需要分别执行推送。
+
+### 方案 B：每次提交推送分支及全部标签
+
+- 执行 `git push origin <当前分支> --tags`。
+- 优点：命令较少。
+- 缺点：可能把尚未准备发布的历史或实验标签一并推送，不采用。
+
+### 方案 C：仅发布时批量推送
+
+- 多个本地提交积累到版本发布时再统一同步。
+- 优点：减少远程交互次数。
+- 缺点：提交期间缺少远程备份，也不符合“提交后需要推送”的要求，不采用。
+
+## 强制流程
+
+1. 完成测试、构建、Review、GitNexus 变更检测和敏感信息检查。
+2. 创建符合中文 Conventional Commit 的本地提交。
+3. 获取当前分支名，执行 `git push origin <当前分支>`。
+4. 如果本次创建了标签，再执行 `git push origin <标签名>`。
+5. 使用 `git status -sb` 或远程引用检查，确认本地分支与远程分支一致。
+6. 把提交 SHA、推送目标、推送结果和标签结果写入功能档案。
+7. 只有分支及本次新建标签全部推送成功后，任务才可以标记完成。
+
+## 失败处理
+
+- 认证、网络、分支保护或服务器错误发生时，保留本地提交和标签，不删除、不改写历史。
+- 将任务状态标为“推送失败/未完成”，记录失败命令、时间和不包含凭据的错误摘要。
+- 修复原因后重复同一个精确推送命令；禁止使用 `--force`、`--force-with-lease` 或绕过保护规则。
+- 远程出现未知提交导致非快进失败时，先获取并检查差异，不自动 rebase、merge 或覆盖远程。
+- 密码和令牌继续由 macOS Keychain 管理，禁止写入文档、脚本、远程 URL、命令参数和 Git 历史。
+
+## 配置与作用域
+
+- 唯一允许的推送远程是当前项目 `.git/config` 中的 `origin`。
+- 推送前必须验证 `origin` 仍为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`。
+- 禁止修改 Git 全局配置，禁止影响其他项目，禁止新增 GitHub 远程。
+- 本规则适用于业务代码、治理文档、规格、Review 修正和版本封存等所有提交。
+
+## 文档变更范围
+
+- `AGENTS.md`：把提交后推送改为代理强制要求。
+- `docs/governance/development-workflow.md`：把推送加入开发后流程和完成定义。
+- `docs/governance/version-control-and-gitea.md`：记录标准命令、失败处理和验证方法。
+- `README.md`：简述项目提交会同步到 Gitea。
+- `docs/features/GOV-004-mandatory-gitea-push/`：保存 PRD、需求、实施计划、测试、Review、GitNexus 前后对比、发布和回退证据。
+
+GOV-003 是当时“只接入、不推送”的历史决策记录，保持原文不变；GOV-004 作为后续决策明确取代其推送授权规则，保证历史可追溯。
+
+## 验收标准
+
+- 所有现行入口规范不再包含“默认不推送”或“逐次取得用户授权”的冲突要求。
+- 规范明确普通提交推当前分支、新标签单独推送、失败不算完成、禁止强推。
+- `main` 的本地历史同步到 `origin/main`。
+- 已有版本标签 `v0.0.0`、`v0.0.1`、`v0.0.2` 同步到远程。
+- GOV-004 的提交和后续封存标签也按相同规则同步。
+- 全局 Git 配置保持不变，敏感信息扫描无发现。
+- 治理测试、完成门禁和 GitNexus 前后检测通过。

docs/features/GOV-004-mandatory-gitea-push/gitnexus/after.md

@@ -0,0 +1,10 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 开发后工作区索引：426 个节点、452 条关系、5 个集群、0 条执行流程。
+- 实现提交后索引：432 个节点、458 条关系、5 个集群、0 条执行流程。
+- 增量分析：6 个已修改文件、17 个新增文件、0 个删除文件；75 个未变化文件行复用既有索引。
+- 最终索引提交：`2a16e9f`。
+- 状态：up-to-date。
+
+本功能没有修改生产代码、函数调用关系或业务执行流程。实现提交后再次分析，最终索引已锚定到确定提交。

docs/features/GOV-004-mandatory-gitea-push/gitnexus/before.md

@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-004
+- 记录时间：2026年8月12日 GMT+8 18:35:43
+- 分支：main
+- 基线提交：4b390d998909
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:34:06 PM
+Indexed commit: 4b390d9
+Current commit: 4b390d9
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。

docs/features/GOV-004-mandatory-gitea-push/gitnexus/comparison.md

@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 实现提交后 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 361 | 432 | +71 |
+| 关系 | 387 | 458 | +71 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+增长来自 GOV-004 的规格、实施计划、现行治理入口和追溯档案。执行流程保持为 0，符合开发前“只影响治理文档与远程同步流程”的预估。最终索引锚定实现提交 `2a16e9f`。

docs/features/GOV-004-mandatory-gitea-push/gitnexus/detected-changes.md

@@ -0,0 +1,9 @@
+# GitNexus 变更检测
+
+- 初次工作区命令：`npx gitnexus detect-changes --repo a-share-analysis --scope all`。
+- 初次识别：7 个既有文件、16 个文档符号。
+- 最终暂存区识别：21 个文件、44 个文档符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+完整暂存后使用 `--scope staged` 将 GOV-004 新建档案纳入检测；最终结果仍为 0 条受影响流程、低风险。

docs/features/GOV-004-mandatory-gitea-push/gitnexus/impact-plan.md

@@ -0,0 +1,9 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`mandatory push after commit Gitea workflow`。
+- 主要关联：GOV-003 功能档案、`docs/governance/version-control-and-gitea.md`、`docs/governance/development-workflow.md`、`AGENTS.md`、`README.md` 和文档索引。
+- 查询没有返回业务执行流程，说明变化不触及前端、后端、数据任务或运行时调用链。
+- 本次不修改函数、类或方法，因此不存在需要符号级上游影响分析的生产代码目标。
+- 预计影响：开发完成定义、远程同步授权规则、标签发布规则、版本号和治理档案。
+- 风险：文档冲突可能让代理继续遵循旧规则；通过限定扫描现行治理入口并保留 GOV-003 为历史记录解决。
+- 外部状态风险：推送改变 Gitea；用户已经明确授权，并要求此后把推送设为固定开发步骤。

docs/features/GOV-004-mandatory-gitea-push/implementation-plan.md

@@ -0,0 +1,169 @@
+# 提交后强制推送 Gitea 实施计划
+
+> **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:** 将每次验证通过的本地提交和本次新增版本标签精确推送到项目专用 Gitea，并把推送成功设为任务完成条件。
+
+**Architecture:** Git 仍使用当前项目 `.git/config` 中唯一的 `origin`，不增加脚本服务或全局配置。流程层通过现行治理文档、代理入口和 GOV-004 功能档案强制执行“验证—提交—推送—远程核对”，GOV-003 保持为历史决策，由 GOV-004 明确取代其推送规则。
+
+**Tech Stack:** Git、Gitea、macOS Keychain、Markdown、GitNexus、Node.js 治理门禁。
+
+## Global Constraints
+
+- 远程固定为 `https://git.foximao.com/FoXiMao/a-share-analysis.git`，作用域仅限当前项目。
+- 不修改 Git 全局配置，不新增 GitHub 远程。
+- 普通提交只推送当前分支；新标签只推送本次创建的标签。
+- 推送失败时任务不得标记完成，且禁止任何形式的强推。
+- 密码和令牌不得进入文件、远程 URL、命令参数或 Git 历史。
+- 每次提交必须使用中文 Conventional Commit，并在提交后立即推送。
+
+---
+
+### Task 1: 固化产品与工程规则
+
+**Files:**
+- Create: `docs/features/GOV-004-mandatory-gitea-push/prd.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/requirements.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/test-plan.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/impact-plan.md`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/implementation-plan.md`
+
+**Interfaces:**
+- Consumes: 已确认的 `design.md` 和 GitNexus 开发前基线。
+- Produces: 可由完成门禁和 Review 逐条验证的功能需求。
+
+- [ ] **Step 1: 编写 PRD 与工程需求**
+
+明确当前分支推送、新标签精确推送、失败阻断完成、禁止强推、凭据安全和现有历史标签同步六类验收项。
+
+- [ ] **Step 2: 编写测试及影响计划**
+
+列出治理测试、冲突文本扫描、远程 URL、远程分支 SHA、远程标签集合、全局配置边界和敏感信息扫描命令。
+
+- [ ] **Step 3: 核对规格覆盖**
+
+运行：
+
+```bash
+rg -n "当前分支|新标签|推送失败|禁止强推|Keychain|v0.0.0|v0.0.1|v0.0.2" docs/features/GOV-004-mandatory-gitea-push
+```
+
+预期：所有约束均能从设计、PRD、需求或测试计划定位。
+
+### Task 2: 更新现行治理入口
+
+**Files:**
+- Modify: `AGENTS.md`
+- Modify: `README.md`
+- Modify: `docs/governance/development-workflow.md`
+- Modify: `docs/governance/version-control-and-gitea.md`
+- Modify: `docs/index.md`
+- Modify: `CHANGELOG.md`
+- Modify: `VERSION`
+
+**Interfaces:**
+- Consumes: Task 1 的验收要求。
+- Produces: 对所有后续代理和开发者生效的强制推送规范。
+
+- [ ] **Step 1: 更新代理入口和开发流程**
+
+删除“推送需逐次授权”的现行条款，加入提交后立即推送、标签精确推送、失败阻断完成和禁止强推。
+
+- [ ] **Step 2: 更新 Gitea 操作规范**
+
+记录 `git push origin <当前分支>`、`git push origin <标签名>`、远程 SHA 验证、错误留痕和安全重试规则。
+
+- [ ] **Step 3: 更新索引和版本记录**
+
+新增 GOV-004 文档入口，将版本提升到 `0.0.3` 并记录规则变化。
+
+- [ ] **Step 4: 验证不存在现行冲突**
+
+运行：
+
+```bash
+rg -n "不得主动.*推送|只有用户明确要求.*推送|本地提交和标签完成后仍不得自动推送" AGENTS.md README.md docs/governance
+```
+
+预期：无匹配。GOV-003 历史档案允许保留旧规则。
+
+### Task 3: 补齐验证、Review 与发布档案
+
+**Files:**
+- Create: `docs/features/GOV-004-mandatory-gitea-push/manifest.yaml`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/after.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/detected-changes.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/gitnexus/comparison.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/qa/test-results.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/qa/visual-qa.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/review/code-review.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/review/standards-review.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/release-notes.md`
+- Create: `docs/features/GOV-004-mandatory-gitea-push/rollback.md`
+
+**Interfaces:**
+- Consumes: Task 2 的文档 diff 和远程同步结果。
+- Produces: GOV-004 完成门禁所需的全部追溯文件。
+
+- [ ] **Step 1: 执行本地验证**
+
+运行：
+
+```bash
+npm run test:governance
+git diff --check
+npx gitnexus analyze
+npx gitnexus detect-changes --repo a-share-analysis --scope all
+```
+
+预期：5 个治理测试通过、diff 无空白错误、GitNexus 状态最新且风险为低。
+
+- [ ] **Step 2: 扫描敏感信息和全局配置边界**
+
+对仓库文件与暂存 diff 扫描凭据 URL、密码和令牌赋值；确认全局 `credential.helper` 与 `remote.pushDefault` 未被本功能修改。
+
+- [ ] **Step 3: 编写双 Review 和完成档案**
+
+两份 Review 必须逐条对应 PRD，处理所有 Important 问题，并以固定行 `最终结论：passed` 结束。
+
+- [ ] **Step 4: 运行完成门禁**
+
+运行：
+
+```bash
+npm run governance:finish -- GOV-004 mandatory-gitea-push
+```
+
+预期：退出码为 0。
+
+### Task 4: 提交、推送并核对远程
+
+**Files:**
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/manifest.yaml`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/qa/test-results.md`
+- Modify: `docs/features/GOV-004-mandatory-gitea-push/release-notes.md`
+
+**Interfaces:**
+- Consumes: 通过 Task 3 完成门禁的暂存区。
+- Produces: 与本地 `main` 和版本标签一致的 Gitea 远程引用。
+
+- [ ] **Step 1: 创建中文实现提交并推送**
+
+```bash
+git commit -m "docs(GOV-004): 强制提交后同步 Gitea"
+git push origin main
+```
+
+预期：`origin/main` 指向新提交。
+
+- [ ] **Step 2: 同步既有标签**
+
+分别推送 `v0.0.0`、`v0.0.1` 和 `v0.0.2`，不使用 `--tags`。
+
+- [ ] **Step 3: 封存版本并推送**
+
+回填实现提交，创建中文封存提交并推送；创建带注释 `v0.0.3` 标签，再单独推送该标签。
+
+- [ ] **Step 4: 最终远程核对**
+
+比较 `git rev-parse main` 与 `git ls-remote origin refs/heads/main`；逐一比较四个本地标签与远程 peeled tag 提交，确认工作区干净、GitNexus 索引最新。

docs/features/GOV-004-mandatory-gitea-push/manifest.yaml

@@ -0,0 +1,18 @@
+id: GOV-004
+name: 提交后强制推送 Gitea
+slug: mandatory-gitea-push
+status: released
+owner: project
+created_at: 2026-08-12
+prd: prd.md
+requirements: requirements.md
+design: design.md
+implementation_plan: implementation-plan.md
+gitnexus_before: gitnexus/before.md
+gitnexus_after: gitnexus/after.md
+gitnexus_comparison: gitnexus/comparison.md
+code_review: review/code-review.md
+standards_review: review/standards-review.md
+implementation_commit: 2a16e9f
+release_commit: d1e54dc
+release: v0.0.3

docs/features/GOV-004-mandatory-gitea-push/prd.md

@@ -0,0 +1,44 @@
+# 提交后强制推送 Gitea PRD
+
+- 功能编号：GOV-004
+- PRD 版本：0.1
+- 状态：approved
+- 日期：2026-08-12
+
+## 问题
+
+项目此前只要求保存本地提交，是否推送需要逐次确认。这会导致本地版本与 Gitea 长期不一致，使远程备份、跨设备读取、历史审阅和版本回退缺少可靠依据。
+
+## 目标
+
+- 每次验证通过的本地提交立即推送当前分支。
+- 本次创建的新标签在分支推送成功后单独推送。
+- 推送失败时任务保持未完成，并提供安全、可审计的重试路径。
+- 让提交、远程分支、标签和功能档案保持可核对的一致关系。
+
+## 非目标
+
+- 不自动推送其他本地分支或非本次创建的标签。
+- 不使用强推，不自动合并、rebase 或覆盖未知远程提交。
+- 不新增 GitHub、CI、Webhook 或 Gitea 服务端配置。
+- 不修改全局 Git 配置，不影响其他项目。
+
+## 用户流程
+
+开发者完成验证与 Review 后创建中文提交，随即把当前分支推送到项目 `origin`；若同时发布版本，则精确推送新标签。系统核对远程 SHA 并在功能档案中记录结果。任何环节失败都保留本地状态，解决原因后重试，不能对外宣称完成。
+
+## 验收标准
+
+- 现行规范明确普通提交只推当前分支，新标签只推本次创建的标签。
+- 现行规范明确推送成功属于完成定义，失败必须留痕并阻断完成。
+- 现行规范禁止 `--force`、`--force-with-lease`、自动覆盖或自动改写远程历史。
+- `origin/main` 与最终本地 `main` SHA 一致。
+- 既有 `v0.0.0`、`v0.0.1`、`v0.0.2` 以及新 `v0.0.3` 标签均能从远程读取并对应本地标签提交。
+- 凭据继续由 macOS Keychain 管理，仓库和提交历史无密码或令牌。
+- 全局 Git 配置保持不变，治理门禁和 GitNexus 变更检测通过。
+
+## 风险
+
+- 远程网络或认证故障会延迟任务完成，但不会破坏本地提交。
+- 分支保护或远程出现未知提交时可能拒绝推送；必须停下检查，不得绕过保护。
+- 将所有标签批量推送可能发布未批准标签，因此只允许精确推送指定标签。

docs/features/GOV-004-mandatory-gitea-push/qa/test-results.md

@@ -0,0 +1,27 @@
+# 测试结果
+
+## 本地验证
+
+- `npm run test:governance`：5 个测试通过，0 个失败。
+- `git diff --check`：通过。
+- 现行推送规则冲突扫描：无匹配。
+- `origin` push URL：精确匹配项目 Gitea。
+- 项目配置：Keychain、路径隔离、账号和默认推送目标均符合设计。
+- 全局边界：全局 `credential.helper` 和 `remote.pushDefault` 保持未设置。
+- 敏感信息扫描：未发现凭据 URL、密码赋值或令牌赋值。
+- GitNexus：426 个节点、452 条关系、5 个集群、0 条流程；变更风险为低。
+- GitNexus 最终暂存区：21 个文件、44 个符号、0 条流程，风险为低。
+- `npm run governance:finish -- GOV-004 mandatory-gitea-push`：退出码 0，完整档案和双 Review 门禁通过。
+
+## 诊断记录
+
+初次冲突扫描命中新规范中的否定说明“不再逐次请求推送授权”。该文本并未要求逐次授权，但会让机器扫描误报，因此改写为“用户已授予本项目持续推送权限”；同一扫描复测无匹配。
+
+## 远程同步
+
+- 设计提交 `757d8ab` 已推送，首次建立 `origin/main`。
+- 计划提交 `2d2502c` 已推送，并验证远程 `main` 与本地 SHA 一致。
+- 实现提交 `2a16e9f` 已推送，远程 `main` SHA 与本地一致。
+- 既有 `v0.0.0`、`v0.0.1`、`v0.0.2` 已分别精确推送；远程 peeled tag 提交与本地标签提交一致。
+- `v0.0.3` 已在封存提交 `d1e54dc` 创建并精确推送；远程 peeled tag 提交与本地标签提交一致。
+- 最终远程核对：`origin/main` 与本地 `main` 一致，四个版本标签全部存在且分别指向预期提交。

docs/features/GOV-004-mandatory-gitea-push/qa/visual-qa.md

@@ -0,0 +1,3 @@
+# 视觉验证
+
+本功能只修改 Git/Gitea 流程与治理文档，不改变页面、样式、图表或交互，因此视觉验证不适用。

docs/features/GOV-004-mandatory-gitea-push/release-notes.md

@@ -0,0 +1,11 @@
+# 发布说明
+
+## v0.0.3
+
+- 实现提交：`2a16e9f`。
+- 发布封存提交：`d1e54dc`；带注释标签 `v0.0.3` 已精确推送并核对。
+- 把当前分支推送设为每次提交后的固定完成步骤。
+- 本次创建的新标签采用精确推送，禁止用 `--tags` 批量发布其他标签。
+- 推送失败将阻断任务完成，并禁止强推或自动覆盖未知远程历史。
+- 增加远程 SHA 核对与功能档案留痕要求。
+- GOV-004 取代 GOV-003 的旧推送授权规则，历史档案保持不变。

docs/features/GOV-004-mandatory-gitea-push/requirements.md

@@ -0,0 +1,13 @@
+# 工程需求
+
+- 提交前必须完成测试、构建或适用性说明、双 Review、GitNexus 变更检测及敏感信息检查。
+- 提交信息必须使用中文 Conventional Commit 并包含功能编号。
+- 提交后读取当前分支名，执行 `git push origin <当前分支>`。
+- 创建新标签后执行 `git push origin <标签名>`，禁止使用 `--tags` 代替精确推送。
+- 推送完成后比较本地分支 SHA 与 `git ls-remote origin refs/heads/<当前分支>`。
+- 标签核对必须解析带注释标签指向的提交，而不是只比较标签对象 SHA。
+- 推送失败时保留本地提交，记录不含凭据的错误摘要并阻断任务完成。
+- 禁止 `--force`、`--force-with-lease`、自动 rebase、自动 merge 和覆盖未知远程引用。
+- 唯一远程必须是本项目 `.git/config` 中的指定 `origin`，不得修改全局 Git 配置。
+- 密码和令牌只能由系统 Keychain 管理，不得进入项目文件、Git URL、命令参数和 Git 历史。
+- GOV-003 保留原始历史文本；现行推送规则以 GOV-004 和治理入口为准。

docs/features/GOV-004-mandatory-gitea-push/review/code-review.md

@@ -0,0 +1,35 @@
+# 配置与文档 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 基线提交：`4b390d9`
+- 设计提交：`757d8ab`
+- 计划提交：`2d2502c`
+- 实现提交：`2a16e9f`
+- 审查范围：强制推送流程、远程核对、失败处理、版本同步和功能档案
+- 日期：2026-08-12
+
+## PRD 与设计符合性
+
+现行规范已经覆盖当前分支立即推送、新标签精确推送、失败阻断完成、禁止强推、远程 SHA 核对、Keychain 凭据边界和功能档案留痕。GOV-003 保持原文，GOV-004 明确取代其旧推送授权规则。
+
+## 发现与处置
+
+| 严重程度 | 发现 | 处置 |
+|---|---|---|
+| Important | 原 `AGENTS.md` 和开发流程仍要求逐次获得推送授权，与用户新要求冲突 | 现行入口统一改为持续授权和提交后强制推送，并增加冲突文本扫描 |
+| Important | 批量 `--tags` 可能发布无关标签 | 明确只允许 `git push origin <本次标签名>`，并把禁止 `--tags` 写入规范 |
+| Important | 推送失败后自动强推、合并或 rebase 可能破坏未知远程历史 | 明确失败阻断完成、先检查差异以及禁止强推和自动改写 |
+| Minor | 新规范中的否定句触发冲突扫描误报 | 改为肯定式持续授权声明，复测无冲突匹配 |
+
+## 验证
+
+- 5 个治理测试通过，`git diff --check` 通过。
+- 现行规则冲突扫描和敏感信息扫描通过。
+- Git 配置仅位于当前项目，全局相关配置保持未设置。
+- GitNexus 最终暂存区检测为 21 个文件、44 个符号、0 条流程、低风险。
+- 设计和计划两次提交均已按新规则推送并核对远程 `main`。
+
+实现提交和标签引用将在创建后按规范精确推送，不存在阻断提交的 Review 问题。
+
+最终结论：passed

docs/features/GOV-004-mandatory-gitea-push/review/standards-review.md

@@ -0,0 +1,25 @@
+# 开发规范符合性 Review
+
+- reviewer_type：self
+- reviewer：Codex
+- 实现提交：`2a16e9f`
+- 日期：2026-08-12
+
+## 检查结果
+
+- [x] 用户批准设计规格后才进入实施。
+- [x] 开发前运行治理启动、GitNexus 查询并保存基线。
+- [x] PRD、工程需求、设计、计划、测试和回退说明一致。
+- [x] GOV-003 历史原文未被篡改，后续决策通过 GOV-004 追溯。
+- [x] 现行入口没有相互冲突的推送授权规则。
+- [x] 未修改生产代码，没有不必要的代码拆分或依赖变化。
+- [x] 未配置 GitHub，唯一远程仍为项目专用 Gitea。
+- [x] 未修改 Git 全局配置，密码和令牌未进入仓库。
+- [x] 治理测试、文档检查、GitNexus 和敏感信息扫描通过。
+- [x] 界面没有变化，视觉验证合理标记为不适用。
+
+## 不符合项与处置
+
+没有未解决的 Critical 或 Important 不符合项。最终分支和标签同步属于提交后的发布步骤，将通过远程引用比较闭环。
+
+最终结论：passed

docs/features/GOV-004-mandatory-gitea-push/rollback.md

@@ -0,0 +1,12 @@
+# 回退说明
+
+本功能已经把 `main` 同步到共享 Gitea，因此不得使用 reset、强推或删除共享提交回退。
+
+如果强制推送规则需要撤销：
+
+1. 创建新的治理功能编号并说明撤销原因。
+2. 使用中文修复提交恢复治理入口文字，不修改 GOV-004 历史档案。
+3. 通过完整测试、Review 和 GitNexus 门禁后正常推送修复提交。
+4. 已共享的 `v0.0.3` 标签不得移动或删除；使用新的补丁版本表达修正。
+
+认证或网络故障不需要回退本地提交。保留提交，修复连接后重试精确推送；禁止将密码写入诊断记录。

docs/features/GOV-004-mandatory-gitea-push/test-plan.md

@@ -0,0 +1,13 @@
+# 测试计划
+
+- 运行 `npm run test:governance`，要求 5 个治理测试通过、0 个失败。
+- 运行 `git diff --check`，要求无空白错误。
+- 扫描 `AGENTS.md`、`README.md` 和 `docs/governance/`，要求不存在“默认不推送”或“逐次授权后才能推送”的现行冲突文本。
+- 检查 `git remote get-url --push origin` 精确等于指定 Gitea 仓库。
+- 比较 `git rev-parse main` 与远程 `refs/heads/main` SHA。
+- 分别解析本地和远程 `v0.0.0`、`v0.0.1`、`v0.0.2`、`v0.0.3` 指向的提交并比较。
+- 检查全局 `credential.helper` 和 `remote.pushDefault` 与 GOV-004 开始前一致。
+- 扫描仓库文件和暂存区，要求没有凭据 URL、密码赋值或令牌赋值。
+- 运行 `npx gitnexus analyze` 和指定仓库的 `detect-changes`，记录节点、关系、流程和风险。
+- 运行 `npm run governance:finish -- GOV-004 mandatory-gitea-push`，要求退出码为 0。
+- 本功能不修改页面，视觉验证标记不适用并说明原因。

docs/features/GOV-005-mysql57-charset-baseline/design.md

@@ -0,0 +1,80 @@
+# MySQL 5.7 字符集与兼容性基线设计规格
+
+- 功能编号：GOV-005
+- 规格版本：0.1
+- 状态：approved_for_review
+- 日期：2026-08-13
+
+## 背景与目标
+
+系统架构和开发规范已经选择 MySQL，但尚未固定服务端版本、字符集和排序规则。不同开发环境如果分别使用 MySQL 5.7、8.x 或不同排序规则，会造成迁移语法、索引行为、字符串比较和排序结果不一致。
+
+本功能建立项目级数据库兼容性基线：所有正式实现固定使用 MySQL 5.7.x，字符集固定为 `utf8mb4`，排序规则固定为 `utf8mb4_general_ci`。虽然市场概览第一阶段只定义持久化接口、不启用 MySQL，该约束仍从数据模型设计开始生效。
+
+## 约束方案
+
+### 采用方案：全链路显式声明
+
+数据库实例/Schema、连接会话、迁移脚本、表、需要覆盖默认值的文本列，以及 Docker、测试和 CI 环境都显式声明或验证版本和字符集规则。
+
+采用原因：只设置服务器默认值无法防止迁移脚本、ORM 连接或外部工具创建出不同排序规则的对象。全链路显式声明能够在代码审查和自动测试中直接验证。
+
+### 不采用：仅依赖服务器默认值
+
+部署配置简单，但开发机、测试环境或后续迁移工具可能使用不同默认值，无法保证可复现，不采用。
+
+### 不采用：允许 MySQL 8.x 向下兼容
+
+在 8.x 开发、声称兼容 5.7，容易无意引入 CTE、窗口函数、函数索引和 8.x 行为差异。项目明确要求不使用 8.x，因此不采用。
+
+## 技术基线
+
+- 数据库服务端：MySQL `5.7.x`，部署镜像和测试环境必须固定到明确的 5.7 补丁版本；禁止 `latest`、`8` 或 `8.x`。
+- 默认字符集：`utf8mb4`。
+- 默认排序规则：`utf8mb4_general_ci`。
+- 数据库创建语句必须包含 `DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci`。
+- 表创建或迁移必须显式保持 `DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci`。
+- ORM/数据库驱动连接配置必须设置 `charset=utf8mb4`，连接建立后验证会话排序规则为 `utf8mb4_general_ci`，不能假设服务器默认值正确。
+- 文本列原则上继承表级规则；只有确实需要不同比较语义时才允许列级覆盖，并必须另建 ADR 获得批准。
+
+## MySQL 5.7 兼容边界
+
+代码、查询、迁移和测试不得使用仅在 MySQL 8.x 可用或行为不同的能力，包括但不限于：
+
+- 公用表表达式 `WITH` 和递归 CTE。
+- 窗口函数，例如 `ROW_NUMBER()`、`RANK()` 和 `OVER (...)`。
+- 函数索引和不可见索引。
+- `CHECK` 约束在 8.x 的强制执行语义；5.7 中业务约束必须由应用校验、普通索引或可验证的数据写入逻辑保证。
+- `utf8mb4_0900_*` 排序规则。
+- 依赖 MySQL 8.x 默认认证插件、保留字、数据字典或 JSON 增强能力的实现。
+
+JSON 字段只有在需求能够由 MySQL 5.7 原生 JSON 能力稳定完成时才能使用；查询和索引设计必须有 5.7 实际测试证据。
+
+## 排序规则语义
+
+`utf8mb4_general_ci` 为不区分大小写的通用排序规则。业务代码不得把数据库字符串比较误认为大小写敏感；证券代码、外部事件 ID、幂等键等需要严格身份语义的字段，应通过规范化输入、二进制字段/排序规则或明确的唯一键设计解决，并在具体功能设计中说明。
+
+索引长度必须按 MySQL 5.7、`utf8mb4` 最多四字节字符进行预算。迁移设计不得假设 MySQL 8.x 的默认索引能力；超长文本标识应使用长度受控字段、前缀索引或稳定摘要，并提供碰撞与唯一性处理说明。
+
+## 配置落点
+
+- `docs/architecture/system-architecture.md`：记录数据库技术基线、第一阶段接口边界和未来启用条件。
+- `docs/governance/code-development-standards.md`：把版本、字符集、排序规则、禁用能力、迁移和 Review 检查设为强制规范。
+- 后续 `deploy/`：MySQL 镜像固定 5.7 补丁版本，初始化参数显式声明字符集和排序规则。
+- 后续 `server/`：ORM 与连接配置、迁移、Repository 实现按本规格验证。
+- 后续测试：连接真实 MySQL 5.7 检查 `SELECT VERSION()`、数据库/表排序规则和查询兼容性。
+
+## 实施范围
+
+本功能只更新架构、开发规范、版本记录和 GOV-005 追溯档案，不创建数据库、不启动容器、不引入 ORM，也不启用市场概览的 MySQL Repository。正式部署配置和代码实现由后续业务功能按照本基线完成。
+
+## 验收标准
+
+- 系统架构明确 MySQL 5.7.x、`utf8mb4` 和 `utf8mb4_general_ci`。
+- 开发规范明确数据库、表、连接、迁移、测试和 Review 的全链路要求。
+- 开发规范明确禁止依赖 MySQL 8.x 专属能力和 `utf8mb4_0900_*` 排序规则。
+- 文档说明 `utf8mb4_general_ci` 不区分大小写及对身份字段、唯一键和索引长度的影响。
+- 市场概览第一阶段仍只定义 MySQL Repository 接口，不实际启用数据库。
+- GOV-005 具备 PRD、需求、设计、实施计划、测试、GitNexus 前后对比、双 Review、发布和回退档案。
+- 治理测试、文档一致性检查、敏感信息检查和 GitNexus 变更检测通过。
+- 中文提交和 `v0.0.4` 标签均精确推送到 Gitea。

docs/features/GOV-005-mysql57-charset-baseline/gitnexus/after.md

@@ -0,0 +1,9 @@
+# GitNexus 开发后结果
+
+- 执行：`npx gitnexus analyze`。
+- 工作区索引：528 个节点、553 条关系、5 个集群、0 条执行流程。
+- 增量分析：6 个已修改文件、18 个新增文件、0 个删除文件，并新增 1 个导入关系到可写集合。
+- 最终索引提交：`91d9b9c`。
+- 状态：up-to-date。
+
+实现提交后再次分析，索引已锚定到确定提交。

docs/features/GOV-005-mysql57-charset-baseline/gitnexus/before.md

@@ -0,0 +1,26 @@
+# GitNexus 开发前基线
+
+- 功能编号：GOV-005
+- 记录时间：2026年8月13日 GMT+8 09:45:51
+- 分支：main
+- 基线提交：6aa9fed62158
+
+## 工作区
+
+```text
+(干净)
+```
+
+## GitNexus 状态
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
+Indexed: 8/12/2026, 6:45:56 PM
+Indexed commit: 6aa9fed
+Current commit: 6aa9fed
+Status: ✅ up-to-date
+```
+
+## 后续人工分析
+
+在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。

docs/features/GOV-005-mysql57-charset-baseline/gitnexus/comparison.md

@@ -0,0 +1,10 @@
+# GitNexus 前后对比
+
+| 项目 | 开发前 | 开发后工作区 | 变化 |
+|---|---:|---:|---:|
+| 节点 | 432 | 528 | +96 |
+| 关系 | 458 | 553 | +95 |
+| 集群 | 5 | 5 | 0 |
+| 执行流程 | 0 | 0 | 0 |
+
+增长来自数据库规范、契约测试与完整 GOV-005 档案；生产执行流程保持不变，符合影响预估。最终索引锚定实现提交 `91d9b9c`。

docs/features/GOV-005-mysql57-charset-baseline/gitnexus/detected-changes.md

@@ -0,0 +1,8 @@
+# GitNexus 变更检测
+
+- 命令：`npx gitnexus detect-changes --repo a-share-analysis --scope staged`。
+- 最终暂存区：23 个文件、45 个符号。
+- 受影响流程：0。
+- 风险等级：低。
+
+识别范围包含系统架构、开发规范、GOV-005 档案、测试与文档索引；版本纯文本和 Changelog 通过 Git diff 另行核对。

docs/features/GOV-005-mysql57-charset-baseline/gitnexus/impact-plan.md

@@ -0,0 +1,7 @@
+# GitNexus 开发前影响分析
+
+- 查询主题：`MySQL 5.7 utf8mb4 general ci compatibility architecture standards`。
+- 主要关联：`docs/architecture/system-architecture.md`、`docs/governance/code-development-standards.md`、README、文档索引和治理 Review。
+- 本次不修改既有函数、类或方法；新增测试文件不参与生产调用链，因此没有生产符号需要上游影响分析。
+- GitNexus 查询没有识别业务执行流程，预计影响限于架构规范、治理测试和版本档案。
+- 风险控制：测试先行锁定文字契约；不连接数据库、不创建部署配置、不声称已验证真实 MySQL 实例。

docs/features/GOV-005-mysql57-charset-baseline/implementation-plan.md

@@ -0,0 +1,102 @@
+# MySQL 5.7 字符集与兼容性基线实施计划
+
+> **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:** 将 MySQL 5.7.x、`utf8mb4`、`utf8mb4_general_ci` 和禁止 MySQL 8.x 专属能力写入系统架构与开发规范，并以自动化测试锁定。
+
+**Architecture:** 约束以系统架构定义全局技术基线，以代码开发规范定义实现与 Review 门禁。新增独立 Node.js 静态契约测试读取这两份文档，防止后续删除版本、字符集、排序规则或兼容性要求。
+
+**Tech Stack:** Markdown、Node.js 内置测试运行器、GitNexus、Git/Gitea。
+
+## Global Constraints
+
+- 数据库服务端固定 MySQL 5.7.x，禁止 MySQL 8.x。
+- 字符集固定 `utf8mb4`，排序规则固定 `utf8mb4_general_ci`。
+- 数据库、表、连接、迁移和测试环境必须显式声明或验证基线。
+- 禁止依赖 CTE、窗口函数、函数索引、不可见索引和 `utf8mb4_0900_*`。
+- 当前只建立规范，不创建数据库、容器、ORM 或生产连接。
+
+---
+
+### Task 1: 建立失败的数据库基线契约测试
+
+**Files:**
+- Create: `tools/governance/mysql-baseline.test.mjs`
+- Modify: `package.json`
+
+**Interfaces:**
+- Consumes: `docs/architecture/system-architecture.md` 与 `docs/governance/code-development-standards.md`。
+- Produces: `npm run test:mysql-baseline`，验证数据库基线的机器可读证据。
+
+- [ ] **Step 1: 编写测试**
+
+测试必须断言两份文档包含 `MySQL 5.7`、`utf8mb4`、`utf8mb4_general_ci`，并断言开发规范包含 MySQL 8.x 禁用能力、大小写语义、索引长度、迁移与 Review 要求。
+
+- [ ] **Step 2: 验证测试因规范缺失而失败**
+
+运行：`npm run test:mysql-baseline`
+
+预期：失败原因明确指向系统架构或开发规范缺少 MySQL 基线文本。
+
+### Task 2: 更新架构与开发规范
+
+**Files:**
+- Modify: `docs/architecture/system-architecture.md`
+- Modify: `docs/governance/code-development-standards.md`
+
+**Interfaces:**
+- Consumes: Task 1 的断言。
+- Produces: 所有后续数据库、ORM、迁移和部署功能必须遵守的规范。
+
+- [ ] **Step 1: 更新系统架构**
+
+增加数据库技术基线、第一阶段接口边界以及正式启用 MySQL 时的验证条件。
+
+- [ ] **Step 2: 更新开发规范**
+
+增加 Schema/表/连接/迁移显式配置、5.7 禁用能力、排序语义、索引预算和 Review 检查。
+
+- [ ] **Step 3: 验证测试转绿**
+
+运行：`npm run test:mysql-baseline && npm run test:governance`
+
+预期：全部通过。
+
+### Task 3: 完成追溯、Review 与发布
+
+**Files:**
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/manifest.yaml`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/prd.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/requirements.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/test-plan.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/gitnexus/impact-plan.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/gitnexus/after.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/gitnexus/detected-changes.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/gitnexus/comparison.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/qa/test-results.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/qa/visual-qa.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/review/code-review.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/review/standards-review.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/release-notes.md`
+- Create: `docs/features/GOV-005-mysql57-charset-baseline/rollback.md`
+- Modify: `docs/index.md`
+- Modify: `CHANGELOG.md`
+- Modify: `VERSION`
+
+**Interfaces:**
+- Consumes: 通过测试的架构和规范。
+- Produces: 可审查、可发布、可回退的 GOV-005 完整档案和 `v0.0.4`。
+
+- [ ] **Step 1: 完成 GitNexus 分析和全部档案**
+
+重新索引，检测完整暂存区，记录前后节点、关系、流程和风险。
+
+- [ ] **Step 2: 完成双 Review 与门禁**
+
+运行：`npm run governance:finish -- GOV-005 mysql57-charset-baseline`
+
+预期：两份 Review 均为 `passed`，门禁退出码为 0。
+
+- [ ] **Step 3: 中文提交、推送与标签**
+
+提交规范变化并推送 `main`；封存验证结果后创建带注释 `v0.0.4`，精确推送该标签并核对远程引用。