# 市场概览 E2E 测试时钟隔离开发总结

- 功能编号：FEAT-QA-001
- 总结版本：0.1
- 日期：2026-08-24

## 原始开发需求

在 FEAT-MO-002/003 收尾的完整门禁中，修复市场概览 HTTP E2E 随自然日期变化而失败的问题，并保持生产行情逻辑不变。

## 需求与范围变化

最初只计划收尾端口和 README；完整门禁暴露测试夹具时钟缺陷后，经用户确认新增独立 `FEAT-QA-001`，避免把缺陷混入端口提交。

## 实际完成需求

- E2E suite 固定到夹具交易日，并在每个用例后恢复真实时钟。
- 生产 Service、Controller、DTO、TDX 和 OpenAPI 未修改。
- 根因、影响、安全、性能与回退边界建立独立档案。

## 修复缺陷

修复固定交易日夹具依赖真实系统日期导致 `fresh` 断言跨日变为 `delayed` 的非确定性缺陷。RED 为 Server 65/67、2 个状态断言失败；GREEN 为定向 E2E 2/2 通过。

## 未完成与延期项

权威交易日历仍不在本功能范围；本功能只保证测试确定性，不改变休市日保守标记 `delayed` 的既有生产策略。

## 关键提交

- `368672f001bb88f7fb2f012604986d7f8ce2820a`：`fix(FEAT-QA-001): 隔离市场概览 E2E 测试时钟`。
- 该修复提交已推送至项目 Gitea `origin/main`，远端分支 SHA 与本地一致。

## 验证证据

定向 E2E 2/2 和完整 `pnpm verify` 已通过：Web 21/21、Server 67/67、启动器 2/2、Playwright 4/4。最终 GitNexus 刷新为 3,134 nodes、4,355 edges、68 clusters、85 flows，状态 `up-to-date`；detect changes 为 LOW、0 受影响执行流。独立代码 Review 和开发规范符合性 Review 均已通过。