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

GitNexus 开发前影响计划

• 功能编号：FEAT-MO-001
• 基线提交：c0a6f5560584
• 当前阶段：TDX 开发连接设计与首页方案确认
• 当前总体风险：LOW（仅本机 SSH 配置和操作文档）；首页业务代码风险待设计确认后按符号补充

直接与间接影响

TDX 双路径开发连接

• 正式行情来源确定为 TDX；家庭局域网和外部 Tailscale 只改变 Mac 到同一 Windows sshd 的网络路径。
• TDX Bridge 的稳定入口固定为 Mac 回环地址 127.0.0.1:17710，市场概览、规则分析、AI 分析和未来 HTTP 契约不得依赖家庭地址、Tailscale 地址或 TDX 原始字段。
• 当前仓库没有 TDX Provider 或市场概览运行时符号，本阶段只更新操作文档；GitNexus 未识别可执行调用链影响。
• 首页业务设计确认后，必须对 App.vue、createAppRouter、后端模块装配、HTTP DTO 和新增市场概览符号分别执行 upstream impact。HIGH 或 CRITICAL 结果先告知用户再修改。

跨模块同步修改

• HTTP/OpenAPI：当前连接文档不修改；首页正式接入时需要版本化市场概览 DTO 与 OpenAPI 契约。
• Web API 与 adapter：当前不修改；未来页面只能经 web/src/api/<业务域>/index.ts、Axios 封装和 ViewModel 消费数据。
• 消息契约、Redis、MySQL、Scheduler、Worker：当前不启用。正式采集链路仍按独立功能立项，不能由 API 请求临时抓取全市场数据。
• 配置部署：真实地址、用户名、密钥和控制套接字只保留在开发机，不进入仓库、环境模板或前端构建物。
• 测试：两种 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。本功能不借该例外修改数据库结构、读取生产数据库或声称发布门禁通过。