fix(FEAT-MO-001): 修正概览时间时区显示

2026-08-24 23:08:46 +08:00
parent 1e80e7d2de
commit b1310fb86d
10 changed files with 139 additions and 4 deletions
@@ -31,6 +31,7 @@
 - 根据二次 Review 继续修复涨跌家数接受非整数、成交额受市场定义顺序影响、指数/板块跨交易日混排和后端从不生成 `delayed` 的边界；宽度增加核心指数日期参考，不新增基础设施或第三方依赖。
 - 根据第三轮独立 Review 修复 8 位畸形日期被误认为有效公历日期、成交额接受倒序日期对与日期/金额数组错位，以及服务测试依赖运行当天的问题。
 - 根据第四轮独立 Review 修复指数/板块未校验前一根 K 线日期的问题；非法、重复或倒序的前一日期不再生成涨跌信号。
+- 修复首屏更新时间直接展示 UTC ISO 字符串的问题：保留 API 的标准 UTC `asOf` 契约，Web 统一按 `Asia/Shanghai` 展示完整日期时间和时分秒。

 ## 未完成与延期项

@@ -40,7 +41,7 @@

 ## 关键提交

- `9a965fa`、`d283ee3`、`6eb34b5`、`c2fa929`、`15a2500`、`27bc3c1`、`8261948`、`ff8ada8`、`49f6be9`、`7e4dcd9`、`ae2a7e0`、`c2fdfa6`
+- `9a965fa`、`d283ee3`、`6eb34b5`、`c2fa929`、`15a2500`、`27bc3c1`、`8261948`、`ff8ada8`、`49f6be9`、`7e4dcd9`、`ae2a7e0`、`c2fdfa6`、本轮待提交的上海时区显示修复

 ## 验证证据

@@ -53,3 +54,4 @@
 - 浏览器桌面与 390px 移动视口验证无横向溢出，视角与引擎切换可用。
 - 五轮独立 Review 均已归档：前四轮发现的数据完整性、状态、日期真实性/顺序、测试时钟和前一根日期校验问题均已关闭；第五轮最终结论为 `Ready to merge: Yes`，无 Critical、Important 或 Minor 问题。
 - 开发 Schema 按用户确认跳过，沿用 `v0.0.10 captured_empty` 追溯边界，不读取生产库。
+- 本轮前端日期工具测试覆盖 UTC 到上海时区转换、无效值占位和两个概览组件接线；未修改后端、OpenAPI、数据库或消息契约。
@@ -17,3 +17,8 @@ npx gitnexus detect-changes --repo "$PWD" --scope staged
 ## 处置

 本轮 medium 来自指数/板块相邻日期比较的局部映射变更，不是未知跨业务扩散。已用 TDX 映射/服务测试、类型检查和 `git diff --check` 验证；前一提交已覆盖 HTTP/OpenAPI、前端状态、构建、浏览器视觉和 4/4 E2E，未发现用户、消息、数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境已使用 GitNexus MCP 与同版本 CLI 交叉确认，没有将工具限制误判为低风险。
+
+## 第六轮显示修复
+
+- GitNexus 对 `useMarketOverview` upstream impact 为 LOW，直接消费者为 `MarketOverviewPage.vue` 和状态测试；Vue 单文件组件文件级符号由查询结果确认，未发现后端或跨模块调用方。
+- 本轮仅变更 Web 日期格式化工具及两个概览组件显示，不修改 API、OpenAPI、TDX、数据库、Redis、RocketMQ、Scheduler 或 Worker。
@@ -2,7 +2,7 @@

 ## 自动化结果

- 前端 Vitest：8 个文件、20 个测试通过。
+- 前端 Vitest：9 个文件、28 个测试通过，新增 UTC 到上海时区格式化和概览组件显示回归。
 - 后端 Vitest：11 个文件、67 个测试通过；API 启动器 Node 测试 2/2 通过，Schema、治理、边界和部署门禁通过。
 - `pnpm verify:e2e`：桌面/移动端页面和健康契约共 4 个测试通过。
 - `pnpm typecheck`、`pnpm build`、`pnpm format:check`：通过。
@@ -17,3 +17,4 @@
 - 第三轮 Review 修复后，非法月份/日期、倒序日期对和日期/金额数组错位均被映射层排除；服务测试统一冻结时钟，不依赖执行当天。
 - 第四轮 Review 修复后，指数前一根非法、重复或倒序日期不再生成涨跌幅，板块对应记录不进入强弱排序。
 - 桌面默认视口与 390px 移动视口无横向溢出；视角和引擎切换可用。
+- 浏览器实测确认结论区显示 `2026-08-24 22:59:55`、指数卡片显示 `22:59:27`，不再显示 UTC 的 `14:59` 时间；桌面和移动视口均无横向溢出。
@@ -84,3 +84,12 @@
 - 验证：指数非法、重复、倒序前一日期参数化用例和板块过滤用例齐全；后端 Vitest `67/67`、启动器 `2/2`、服务端类型检查与 `git diff --check` 均通过。安全、性能及 PRD/设计/测试/QA 口径一致。

 最终结论：passed
+
+## 第六轮显示修复 Review
+
+- 审查范围：市场概览前端日期显示工具、结论组件、指数组件及回归测试。
+- 根因：API `asOf` 是带 `Z` 的标准 UTC 时间，前端原样展示并直接截取 UTC 时分秒。
+- 处置：新增 `Asia/Shanghai` 格式化工具；不修改后端时间契约，非法值统一显示占位符。
+- 安全与性能：仅使用原生 `Intl.DateTimeFormat`，无新依赖、无网络请求、无敏感数据处理；格式化开销只发生在两个展示节点。
+- 验证：前端 Vitest 9 个文件/28 个测试、typecheck、全量 `pnpm verify` 和桌面/移动浏览器实测通过。
+- 结论：passed
@@ -25,5 +25,6 @@
 - 第三轮 Review 的日期真实性、先后顺序、数组对齐和测试时钟问题已按 TDD 修复；需求、设计、测试计划、测试结果、发布说明和开发总结已同步。
 - 第四轮 Review 的前一根日期校验问题已按 TDD 修复；治理结论继续保持 `pending`，等待本次代码修复再次独立确认。
 - 第五轮最终独立 Review 无 Critical、Important 或 Minor 问题并给出 `Ready to merge: Yes`；中文提交、Gitea 推送、GitNexus、完整门禁和视觉证据均已复核。
+- 第六轮显示修复保持后端 UTC 契约、前端 Axios 边界和业务模块职责不变；新增工具有真实重复场景和独立测试依据，无新增依赖，安全、性能、类型、构建和 E2E 证据齐全。

 最终结论：passed
@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+
+import { formatShanghaiDateTime, formatShanghaiTime } from './datetime';
+
+describe('A 股时间显示格式化', () => {
+  it('将 UTC ISO 时间转换为上海时区的完整日期时间', () => {
+    expect(formatShanghaiDateTime('2026-08-24T14:16:26.813Z')).toBe('2026-08-24 22:16:26');
+  });
+
+  it('将 UTC ISO 时间转换为上海时区的时分秒', () => {
+    expect(formatShanghaiTime('2026-08-24T14:16:26.813Z')).toBe('22:16:26');
+  });
+
+  it('收到空值或非法日期时返回占位符', () => {
+    expect(formatShanghaiDateTime(undefined)).toBe('—');
+    expect(formatShanghaiTime('not-a-date')).toBe('—');
+  });
+});
@@ -0,0 +1,45 @@
+const SHANGHAI_TIME_ZONE = 'Asia/Shanghai';
+
+type DatePart = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second';
+
+function getShanghaiDateParts(value: string | undefined): Record<DatePart, string> | null {
+  if (!value) return null;
+
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return null;
+
+  const parts = new Intl.DateTimeFormat('en-CA', {
+    timeZone: SHANGHAI_TIME_ZONE,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23',
+  }).formatToParts(date);
+
+  const result = Object.fromEntries(
+    parts
+      .filter((part): part is Intl.DateTimeFormatPart & { type: DatePart } =>
+        ['year', 'month', 'day', 'hour', 'minute', 'second'].includes(part.type),
+      )
+      .map((part) => [part.type, part.value]),
+  ) as Partial<Record<DatePart, string>>;
+
+  if (Object.values(result).some((part) => !part)) return null;
+  return result as Record<DatePart, string>;
+}
+
+/** A 股页面统一使用上海时区，接口仍保留标准 UTC ISO 时间。 */
+export function formatShanghaiDateTime(value: string | undefined): string {
+  const parts = getShanghaiDateParts(value);
+  return parts
+    ? `${parts.year}-${parts.month}-${parts.day} ${parts.hour}:${parts.minute}:${parts.second}`
+    : '—';
+}
+
+export function formatShanghaiTime(value: string | undefined): string {
+  const parts = getShanghaiDateParts(value);
+  return parts ? `${parts.hour}:${parts.minute}:${parts.second}` : '—';
+}
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import type { IndicesResponse } from '@/types/market-overview';
+import { formatShanghaiTime } from '@/utils/datetime';

 defineProps<{ response: IndicesResponse | null; loading: boolean }>();
 const emit = defineEmits<{ select: [code: string] }>();
@@ -12,7 +13,7 @@ const emit = defineEmits<{ select: [code: string] }>();
        <span class="section-kicker">核心指数</span>
        <h2 id="indices-title">主要市场温度</h2>
      </div>
-      <span class="panel-meta">{{ response?.asOf ? response.asOf.slice(11, 19) : '—' }}</span>
+      <span class="panel-meta">{{ formatShanghaiTime(response?.asOf) }}</span>
    </div>
    <div v-if="loading" class="module-placeholder">正在读取指数…</div>
    <div v-else-if="!response?.data?.items.length" class="module-placeholder">
@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import type { SummaryResponse } from '@/types/market-overview';
+import { formatShanghaiDateTime } from '@/utils/datetime';

 defineProps<{
  response: SummaryResponse | null;
@@ -20,7 +21,9 @@ defineProps<{
      <div class="source-status" :data-status="response?.status || 'unavailable'">
        <span class="status-dot" aria-hidden="true"></span>
        <span>{{ response?.source === 'tdx' ? 'TDX 行情' : '等待数据' }}</span>
-        <small>{{ response?.asOf ? `更新于 ${response.asOf}` : '尚未连接' }}</small>
+        <small>{{
+          response?.asOf ? `更新于 ${formatShanghaiDateTime(response.asOf)}` : '尚未连接'
+        }}</small>
      </div>
    </div>
    <div class="conclusion-facts">
@@ -2,7 +2,9 @@ import { mount } from '@vue/test-utils';
 import { describe, expect, it } from 'vitest';

 import FundTrend from './FundTrend.vue';
+import IndexOverview from './IndexOverview.vue';
 import MarketBreadth from './MarketBreadth.vue';
+import MarketConclusion from './MarketConclusion.vue';
 import SectorOverview from './SectorOverview.vue';
 import ShortTermEmotion from './ShortTermEmotion.vue';

@@ -15,6 +17,54 @@ const meta = {
 };

 describe('市场概览真实数据面板', () => {
+  it('市场结论按上海时区展示更新时间而不是 UTC 原文', () => {
+    const wrapper = mount(MarketConclusion, {
+      props: {
+        loading: false,
+        response: {
+          ...meta,
+          data: {
+            verdict: '市场维持偏强震荡',
+            marketStatus: '指数偏强',
+            volumeStatus: '成交额趋势见下方',
+            sentimentStatus: '涨跌家数见下方',
+            drivers: [],
+            risks: [],
+          },
+        },
+      },
+    });
+
+    expect(wrapper.text()).toContain('更新于 2026-08-18 23:00:00');
+    expect(wrapper.text()).not.toContain('2026-08-18T15:00:00.000Z');
+  });
+
+  it('核心指数按上海时区展示更新时间', () => {
+    const wrapper = mount(IndexOverview, {
+      props: {
+        loading: false,
+        response: {
+          ...meta,
+          data: {
+            items: [
+              {
+                code: '000001.SH',
+                name: '上证指数',
+                price: 3380,
+                changePercent: 1.2,
+                direction: 'up',
+                tradeDate: '20260818',
+              },
+            ],
+          },
+        },
+      },
+    });
+
+    expect(wrapper.text()).toContain('23:00:00');
+    expect(wrapper.text()).not.toContain('15:00:00');
+  });
+
  it('市场宽度对未知平盘家数显示占位符而不是零', () => {
    const wrapper = mount(MarketBreadth, {
      props: {