From 0e86d452888667b6ff14fb2de38c744e2146053b Mon Sep 17 00:00:00 2001
From: lingniu <lingniu@lingnius-Mac-mini.local>
Date: Sun, 5 Jul 2026 12:05:43 +0800
Subject: [PATCH] feat(platform): refine realtime vehicle monitoring copy

---
 .../apps/web/src/pages/Realtime.tsx           | 36 +++++++++----------
 .../apps/web/src/test/App.test.tsx            | 30 ++++++++--------
 2 files changed, 33 insertions(+), 33 deletions(-)

diff --git a/vehicle-data-platform/apps/web/src/pages/Realtime.tsx b/vehicle-data-platform/apps/web/src/pages/Realtime.tsx
index 781019cd..8b8274c2 100644
--- a/vehicle-data-platform/apps/web/src/pages/Realtime.tsx
+++ b/vehicle-data-platform/apps/web/src/pages/Realtime.tsx
@@ -154,8 +154,8 @@ const realtimeExportColumns: CsvColumn<VehicleRealtimeRow>[] = [
   { title: '车牌', value: (row) => row.plate },
   { title: '手机号', value: (row) => row.phone },
   { title: 'OEM', value: (row) => row.oem },
-  { title: '主证据来源', value: (row) => row.primaryProtocol },
-  { title: '证据通道', value: (row) => row.protocols?.join('|') },
+  { title: '主要数据通道', value: (row) => row.primaryProtocol },
+  { title: '数据通道', value: (row) => row.protocols?.join('|') },
   { title: '在线', value: (row) => row.online ? '在线' : '离线' },
   { title: '车辆服务状态', value: (row) => vehicleServiceStatus(row).label },
   { title: '通道在线', value: (row) => sourceEvidenceText(row) },
@@ -187,7 +187,7 @@ function realtimeExportFileName(filters: Record<string, string>) {
 function realtimeFilterSummary(filters: Record<string, string>) {
   return [
     filters.keyword ? `关键词：${filters.keyword}` : '',
-    filters.protocol ? `证据来源：${filters.protocol}` : '',
+    filters.protocol ? `数据通道：${filters.protocol}` : '',
     filters.online ? `在线：${onlineLabel[filters.online] ?? filters.online}` : '',
     filters.serviceStatus ? `服务状态：${serviceStatusLabel[filters.serviceStatus] ?? filters.serviceStatus}` : ''
   ].filter(Boolean);
@@ -225,7 +225,7 @@ function realtimeOperationsSummaryText({
     `当前筛选：${realtimeFilterSummary(filters).join('；') || '全部实时车辆'}`,
     `车辆总数：${total.toLocaleString()}，当前页：${rows.length.toLocaleString()}`,
     `在线车辆：${onlineCount.toLocaleString()}，定位有效：${locatedCount.toLocaleString()}`,
-    `需要关注：${degradedCount.toLocaleString()}，证据通道：${sourceTypeCount.toLocaleString()}`,
+    `需要关注：${degradedCount.toLocaleString()}，数据通道：${sourceTypeCount.toLocaleString()}`,
     `地图配置：${amapConfigured ? '已配置' : '未配置'}`,
     '重点车辆：',
     issueLines,
@@ -271,7 +271,7 @@ function realtimeIssueAction(row: VehicleRealtimeRow) {
     return `确认${row.primaryProtocol || '实时数据'}是否持续上报，必要时查看告警事件`;
   }
   if (hasSourceIssue(row)) {
-    return '处理离线证据通道，确认车辆实时状态一致';
+    return '处理离线数据通道，确认车辆实时状态一致';
   }
   return issues === '暂无异常' ? '持续观察' : '结合车辆服务详情继续排查';
 }
@@ -367,7 +367,7 @@ function realtimeDutyHandoffText({
     '【实时运营交接包】',
     `当前筛选：${realtimeFilterSummary(filters).join('；') || '全部实时车辆'}`,
     `页面车辆：${rows.length.toLocaleString()} / 总计 ${total.toLocaleString()}；版本：${runtimeRelease || '未标记'}`,
-    `在线：${onlineCount.toLocaleString()}；离线：${(rows.length - onlineCount).toLocaleString()}；定位有效：${locatedCount.toLocaleString()}；需要关注：${degradedCount.toLocaleString()}；超时：${staleCount.toLocaleString()}；证据通道：${sourceTypeCount.toLocaleString()}`,
+    `在线：${onlineCount.toLocaleString()}；离线：${(rows.length - onlineCount).toLocaleString()}；定位有效：${locatedCount.toLocaleString()}；需要关注：${degradedCount.toLocaleString()}；超时：${staleCount.toLocaleString()}；数据通道：${sourceTypeCount.toLocaleString()}`,
     `地图：${amapConfigured ? '高德已配置' : '高德未配置'}`,
     `车辆覆盖：${sourceLines.length > 0 ? sourceLines.join('；') : '当前页暂无来源明细'}`,
     `实时入口：${appURL(buildAppHash({ page: 'realtime', protocol: filters.protocol, filters }))}`,
@@ -916,12 +916,12 @@ export function Realtime({
       secondaryDisabled: !selectedMapRow || !canOpenVehicle(selectedMapRow.vin)
     },
     {
-      title: '数据交付',
+      title: '查询导出',
       value: `${rows.length.toLocaleString()} 辆当前页`,
-      detail: '导出当前车辆清单，或进入选中车辆的原始记录证据。',
+      detail: '导出当前车辆清单，或进入选中车辆的历史记录。',
       color: 'blue' as const,
       primaryAction: '导出当前页',
-      secondaryAction: '原始记录',
+      secondaryAction: '历史记录',
       onPrimary: exportRealtime,
       onSecondary: openSelectedVehicleRaw,
       disabled: false,
@@ -956,7 +956,7 @@ export function Realtime({
     {
       label: '选车复盘',
       value: selectedVehicleLabel,
-      detail: selectedMapRow ? `${vehicleServiceStatus(selectedMapRow).label}，${dataFreshness(selectedMapRow).detail}` : '从地图或车辆列表选择一辆车后进入轨迹、里程和数据导出。',
+      detail: selectedMapRow ? `${vehicleServiceStatus(selectedMapRow).label}，${dataFreshness(selectedMapRow).detail}` : '从地图或车辆列表选择一辆车后进入轨迹、里程和历史查询。',
       color: selectedMapRow ? vehicleServiceStatus(selectedMapRow).color : 'grey' as const,
       action: '轨迹回放',
       disabled: !selectedMapRow || !canOpenVehicle(selectedMapRow.vin),
@@ -1063,7 +1063,7 @@ export function Realtime({
     },
     {
       step: '05',
-      title: '数据交付',
+      title: '查询导出',
       value: `${rows.length.toLocaleString()} 当前页`,
       detail: '导出当前实时车辆清单，用于客户问询和运营交接。',
       action: '导出 CSV',
@@ -1082,7 +1082,7 @@ export function Realtime({
             applyFilters(values as Record<string, string>);
           }}>
             <Form.Input field="keyword" label="车辆" placeholder="VIN / 车牌 / 手机号 / OEM" style={{ width: 260 }} />
-            <Form.Select field="protocol" label="证据来源" placeholder="全部来源" style={{ width: 160 }}>
+            <Form.Select field="protocol" label="数据通道" placeholder="全部通道" style={{ width: 160 }}>
               <Select.Option value="GB32960">GB32960</Select.Option>
               <Select.Option value="JT808">JT808</Select.Option>
               <Select.Option value="YUTONG_MQTT">YUTONG_MQTT</Select.Option>
@@ -1111,9 +1111,9 @@ export function Realtime({
                 <Tag color={amapConfigured ? 'green' : 'orange'}>{amapConfigured ? '高德地图可用' : '坐标预览'}</Tag>
                 <Tag color={mapAttentionRows.length > 0 ? 'orange' : 'green'}>{mapAttentionRows.length.toLocaleString()} 辆关注</Tag>
               </Space>
-              <Typography.Text strong>先判断车辆是否在线、是否有位置、是否有异常，再进入单车轨迹和数据交付。</Typography.Text>
+              <Typography.Text strong>先判断车辆是否在线、是否有位置、是否有异常，再进入单车轨迹和历史查询。</Typography.Text>
               <Typography.Text type="secondary">
-                地图页面向客户展示车辆服务状态，协议来源只作为定位、在线和异常追溯证据。
+                地图页面向客户展示车辆服务状态，数据通道只作为定位、在线和异常追溯依据。
               </Typography.Text>
               <Space wrap>
                 <Button size="small" theme="solid" type="primary" onClick={() => applyFilters({ ...filters, online: 'online' })}>查看在线车辆</Button>
@@ -1400,7 +1400,7 @@ export function Realtime({
           applyFilters(nextFilters);
         }} style={{ marginBottom: 12 }}>
           <Form.Input field="keyword" label="车辆关键词" placeholder="VIN / 车牌 / 手机号 / OEM" style={{ width: 260 }} />
-          <Form.Select field="protocol" label="证据来源" placeholder="全部证据来源" style={{ width: 180 }}>
+          <Form.Select field="protocol" label="数据通道" placeholder="全部数据通道" style={{ width: 180 }}>
             <Select.Option value="GB32960">GB32960</Select.Option>
             <Select.Option value="JT808">JT808</Select.Option>
             <Select.Option value="YUTONG_MQTT">YUTONG_MQTT</Select.Option>
@@ -1454,7 +1454,7 @@ export function Realtime({
                 { label: '定位有效', value: locatedCount, color: locatedCount > 0 ? 'blue' as const : 'orange' as const },
                 { label: '需要关注', value: degradedCount, color: degradedCount > 0 ? 'orange' as const : 'green' as const, action: () => applyFilters({ ...filters, serviceStatus: 'degraded' }) },
                 { label: '更新超时', value: staleCount, color: staleCount > 0 ? 'red' as const : 'green' as const },
-                { label: '证据通道', value: primaryProtocols.size, color: 'blue' as const }
+                { label: '数据通道', value: primaryProtocols.size, color: 'blue' as const }
               ].map((item) => (
                 item.action ? (
                   <button
@@ -1503,7 +1503,7 @@ export function Realtime({
                 key={item.protocol}
                 type="button"
                 className="vp-source-coverage-item"
-                aria-label={`筛选证据来源 ${item.protocol}`}
+                aria-label={`筛选数据通道 ${item.protocol}`}
                 onClick={() => applyFilters({ ...filters, protocol: item.protocol })}
               >
                 <div className="vp-source-coverage-item-head">
@@ -1549,7 +1549,7 @@ export function Realtime({
               { label: '定位有效', value: locatedCount.toLocaleString(), color: 'green' as const },
               { label: '超时车辆', value: staleCount.toLocaleString(), color: staleCount > 0 ? 'orange' as const : 'green' as const },
               { label: '需要关注', value: degradedCount.toLocaleString(), color: degradedCount > 0 ? 'orange' as const : 'green' as const },
-              { label: '证据通道', value: primaryProtocols.size.toLocaleString(), color: 'blue' as const }
+              { label: '数据通道', value: primaryProtocols.size.toLocaleString(), color: 'blue' as const }
             ].map((item) => (
               <div key={item.label} className="vp-monitor-metric">
                 <Tag color={item.color}>{item.label}</Tag>
diff --git a/vehicle-data-platform/apps/web/src/test/App.test.tsx b/vehicle-data-platform/apps/web/src/test/App.test.tsx
index 0b5cdb7b..dbd67fcd 100644
--- a/vehicle-data-platform/apps/web/src/test/App.test.tsx
+++ b/vehicle-data-platform/apps/web/src/test/App.test.tsx
@@ -9060,14 +9060,14 @@ test('frames realtime page as one vehicle service with source evidence', async (
   render(<App />);
 
   expect(await screen.findByRole('heading', { name: '实时监控' })).toBeInTheDocument();
-  expect(screen.getByText('高德地图待配置')).toBeInTheDocument();
+  expect(screen.getAllByText('高德地图待配置').length).toBeGreaterThan(0);
   expect(screen.getByText('客户实时监控')).toBeInTheDocument();
   expect(screen.getByText('从实时列表直接完成车辆监控闭环')).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '实时监控路径 只看在线 在线车辆' })).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '实时监控路径 地图态势 查看地图' })).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '实时监控路径 异常优先 关注车辆' })).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '实时监控路径 单车复盘 轨迹回放' })).toBeInTheDocument();
-  expect(screen.getByRole('button', { name: '实时监控路径 数据交付 导出 CSV' })).toBeInTheDocument();
+  expect(screen.getByRole('button', { name: '实时监控路径 查询导出 导出 CSV' })).toBeInTheDocument();
   expect(screen.getAllByText('定位有效').length).toBeGreaterThan(0);
   expect(screen.getByText('车辆核心数据')).toBeInTheDocument();
   expect(screen.getByText('实时通道')).toBeInTheDocument();
@@ -9226,8 +9226,8 @@ test('shows realtime freshness status for recently updated and stale vehicles',
   expect(screen.getAllByText('数据新鲜').length).toBeGreaterThan(0);
   expect(screen.getAllByText('更新超时').length).toBeGreaterThan(0);
   expect(screen.getByText('地图客户决策')).toBeInTheDocument();
-  expect(screen.getByText('先判断车辆是否在线、是否有位置、是否有异常，再进入单车轨迹和数据交付。')).toBeInTheDocument();
-  expect(screen.getByText('地图页面向客户展示车辆服务状态，协议来源只作为定位、在线和异常追溯证据。')).toBeInTheDocument();
+  expect(screen.getByText('先判断车辆是否在线、是否有位置、是否有异常，再进入单车轨迹和历史查询。')).toBeInTheDocument();
+  expect(screen.getByText('地图页面向客户展示车辆服务状态，数据通道只作为定位、在线和异常追溯依据。')).toBeInTheDocument();
   expect(screen.getByText('先看在线')).toBeInTheDocument();
   expect(screen.getByText('再看定位')).toBeInTheDocument();
   expect(screen.getByText('优先异常')).toBeInTheDocument();
@@ -9239,11 +9239,11 @@ test('shows realtime freshness status for recently updated and stale vehicles',
   expect(screen.getByText('实时盯车')).toBeInTheDocument();
   expect(screen.getByText('异常优先')).toBeInTheDocument();
   expect(screen.getAllByText('轨迹复盘').length).toBeGreaterThanOrEqual(1);
-  expect(screen.getAllByText('数据交付').length).toBeGreaterThanOrEqual(1);
+  expect(screen.getAllByText('查询导出').length).toBeGreaterThanOrEqual(1);
   expect(screen.getByRole('button', { name: '地图监控任务 实时盯车 只看在线' })).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '地图监控任务 异常优先 关注车辆' })).toBeInTheDocument();
   expect(screen.getByRole('button', { name: '地图监控任务 轨迹复盘 轨迹回放' })).toBeInTheDocument();
-  expect(screen.getByRole('button', { name: '地图监控任务 数据交付 导出当前页' })).toBeInTheDocument();
+  expect(screen.getByRole('button', { name: '地图监控任务 查询导出 导出当前页' })).toBeInTheDocument();
   expect(screen.getByText('客户地图监控包')).toBeInTheDocument();
   expect(screen.getByText('面向客户看图时，先确认车辆范围、在线态势、定位态势和选中车辆，再进入轨迹、里程、历史数据或告警通知。')).toBeInTheDocument();
   expect(screen.getByText('车辆范围')).toBeInTheDocument();
@@ -9492,9 +9492,9 @@ test('copies realtime operations summary from realtime page', async () => {
   expect(screen.getByText('建议处置')).toBeInTheDocument();
   expect(screen.getByText('查看需关注车辆 2')).toBeInTheDocument();
   expect(screen.getByText('车辆覆盖概览')).toBeInTheDocument();
-  expect(screen.getByRole('button', { name: '筛选证据来源 GB32960' })).toHaveTextContent('GB32960');
-  expect(screen.getByRole('button', { name: '筛选证据来源 JT808' })).toHaveTextContent('2 辆');
-  expect(screen.getByRole('button', { name: '筛选证据来源 YUTONG_MQTT' })).toHaveTextContent('超时 1');
+  expect(screen.getByRole('button', { name: '筛选数据通道 GB32960' })).toHaveTextContent('GB32960');
+  expect(screen.getByRole('button', { name: '筛选数据通道 JT808' })).toHaveTextContent('2 辆');
+  expect(screen.getByRole('button', { name: '筛选数据通道 YUTONG_MQTT' })).toHaveTextContent('超时 1');
   expect(screen.getByText('实时覆盖判读')).toBeInTheDocument();
   expect(screen.getByText('在线率')).toBeInTheDocument();
   expect(screen.getAllByText('66.7%').length).toBeGreaterThanOrEqual(3);
@@ -9505,17 +9505,17 @@ test('copies realtime operations summary from realtime page', async () => {
   fireEvent.click(screen.getByRole('button', { name: '复制实时摘要' }));
 
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【实时监控摘要】'));
-  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('当前筛选：证据来源：JT808；在线：在线'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('当前筛选：数据通道：JT808；在线：在线'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('车辆总数：3，当前页：3'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('在线车辆：2，定位有效：2'));
-  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('需要关注：2，证据通道：3'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('需要关注：2，数据通道：3'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('地图配置：已配置'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('重点车辆：'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('粤A摘要3 / YUTONG_MQTT / 车辆离线'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('实时页面：http://localhost:3000/#/realtime?protocol=JT808&online=online'));
   fireEvent.click(screen.getByRole('button', { name: '复制实时异常处置清单' }));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('【实时异常处置清单】'));
-  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('当前筛选：证据来源：JT808；在线：在线'));
+  expect(writeText).toHaveBeenCalledWith(expect.stringContaining('当前筛选：数据通道：JT808；在线：在线'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('异常车辆：3 / 当前页 3 / 总计 3'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('粤A摘要3 / VIN-RT-SUMMARY-003 / JT808'));
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('状态：车辆离线；在线：离线；问题：'));
@@ -9536,7 +9536,7 @@ test('copies realtime operations summary from realtime page', async () => {
   expect(writeText).toHaveBeenCalledWith(expect.stringContaining('原始记录：http://localhost:3000/api/history/raw-frames?protocol=JT808&vin=VIN-RT-SUMMARY-003&limit=20&includeFields=true'));
   fireEvent.click(screen.getByRole('button', { name: '实时筛选 需要关注 2' }));
   expect(window.location.hash).toBe('#/realtime?protocol=JT808&serviceStatus=degraded&online=online');
-  fireEvent.click(screen.getByRole('button', { name: '筛选证据来源 GB32960' }));
+  fireEvent.click(screen.getByRole('button', { name: '筛选数据通道 GB32960' }));
   expect(window.location.hash).toBe('#/realtime?protocol=GB32960&serviceStatus=degraded&online=online');
 });
 
@@ -10319,7 +10319,7 @@ test('shows and clears current realtime service filters', async () => {
 
   expect(await screen.findByText('当前实时筛选')).toBeInTheDocument();
   expect(screen.getByText('关键词：粤ART002')).toBeInTheDocument();
-  expect(screen.getByText('证据来源：JT808')).toBeInTheDocument();
+  expect(screen.getByText('数据通道：JT808')).toBeInTheDocument();
   expect(screen.getByText('在线：在线')).toBeInTheDocument();
   expect(screen.getByText('服务状态：来源不完整')).toBeInTheDocument();
   fireEvent.click(screen.getByRole('button', { name: '清空筛选' }));
@@ -10358,7 +10358,7 @@ test('updates realtime hash when source filters are submitted', async () => {
 
   await screen.findByRole('heading', { name: '实时监控' });
   fireEvent.change(screen.getByPlaceholderText('VIN / 车牌 / 手机号 / OEM'), { target: { value: '粤ART002' } });
-  fireEvent.click(screen.getByText('全部证据来源'));
+  fireEvent.click(screen.getByText('全部数据通道'));
   fireEvent.click(await screen.findByText('JT808'));
   fireEvent.click(screen.getByRole('button', { name: '查询' }));