From d5ce17c72d5bec51d0bbb804fdd2adaafc8f1b52 Mon Sep 17 00:00:00 2001
From: Your Name <you@example.com>
Date: Fri, 5 Jun 2026 01:28:31 +0800
Subject: [PATCH] =?UTF-8?q?fix(web):=20=E6=A8=99=E7=A4=BA=20AIOps=20?=
 =?UTF-8?q?=E7=AF=84=E4=BE=8B=E8=B3=87=E6=96=99=E6=A8=A1=E5=BC=8F?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 apps/web/messages/en.json                     |  2 +-
 apps/web/messages/zh-TW.json                  |  2 +-
 .../src/app/[locale]/aiops/timeline/page.tsx  |  2 +-
 .../components/ai/openclaw-state-machine.tsx  |  2 +-
 .../aiops/timeline/AiopsTimelinePanel.tsx     | 19 ++++++++++---------
 .../src/components/aiops/timeline/index.ts    |  2 +-
 .../{mock-data.ts => sample-incidents.ts}     |  4 ++--
 .../genui/__tests__/registry.test.ts          |  4 ++--
 .../neural-command/NeuralApprovalPanel.tsx    |  2 +-
 .../components/neural-command/NeuralStats.tsx |  2 +-
 10 files changed, 21 insertions(+), 20 deletions(-)
 rename apps/web/src/components/aiops/timeline/{mock-data.ts => sample-incidents.ts} (99%)

diff --git a/apps/web/messages/en.json b/apps/web/messages/en.json
index 234d2231..233dde61 100644
--- a/apps/web/messages/en.json
+++ b/apps/web/messages/en.json
@@ -2239,7 +2239,7 @@
   "aiopsTimeline": {
     "title": "AIOps 全景時序",
     "subtitle": "告警→感官調查→AI決策→自動執行→驗證→學習 完整鏈路",
-    "mockBadge": "MOCK 模式",
+    "sampleBadge": "範例資料",
     "stages": {
       "alert": "告警觸發",
       "diagnose": "感官調查",
diff --git a/apps/web/messages/zh-TW.json b/apps/web/messages/zh-TW.json
index 234d2231..233dde61 100644
--- a/apps/web/messages/zh-TW.json
+++ b/apps/web/messages/zh-TW.json
@@ -2239,7 +2239,7 @@
   "aiopsTimeline": {
     "title": "AIOps 全景時序",
     "subtitle": "告警→感官調查→AI決策→自動執行→驗證→學習 完整鏈路",
-    "mockBadge": "MOCK 模式",
+    "sampleBadge": "範例資料",
     "stages": {
       "alert": "告警觸發",
       "diagnose": "感官調查",
diff --git a/apps/web/src/app/[locale]/aiops/timeline/page.tsx b/apps/web/src/app/[locale]/aiops/timeline/page.tsx
index 27c68d4e..3784acb0 100644
--- a/apps/web/src/app/[locale]/aiops/timeline/page.tsx
+++ b/apps/web/src/app/[locale]/aiops/timeline/page.tsx
@@ -5,7 +5,7 @@
 // AIOps 全景時序頁面
 // 告警→感官調查→AI決策→自動執行→驗證→學習 完整鏈路視覺化
 //
-// Mock 模式：NEXT_PUBLIC_AIOPS_TIMELINE_MOCK=true
+// 範例資料模式：NEXT_PUBLIC_AIOPS_TIMELINE_MOCK=true
 // 真實 API: GET /api/v1/aiops/timeline?incident_id=&limit=20
 // ============================================================
 
diff --git a/apps/web/src/components/ai/openclaw-state-machine.tsx b/apps/web/src/components/ai/openclaw-state-machine.tsx
index 2c6a9ebf..9aff1a00 100644
--- a/apps/web/src/components/ai/openclaw-state-machine.tsx
+++ b/apps/web/src/components/ai/openclaw-state-machine.tsx
@@ -12,7 +12,7 @@
  * - ApprovalCard 滑入動畫
  * - 記憶體安全清理
  *
- * 真實性條款: 禁止任何 Mock Data
+ * 真實性條款：禁止以範例資料掩蓋 API 狀態
  * i18n: 100% next-intl
  */
 
diff --git a/apps/web/src/components/aiops/timeline/AiopsTimelinePanel.tsx b/apps/web/src/components/aiops/timeline/AiopsTimelinePanel.tsx
index 1573887f..e3a02f3b 100644
--- a/apps/web/src/components/aiops/timeline/AiopsTimelinePanel.tsx
+++ b/apps/web/src/components/aiops/timeline/AiopsTimelinePanel.tsx
@@ -20,7 +20,7 @@ import {
 import { cn } from '@/lib/utils'
 import { TimelineFilter } from './TimelineFilter'
 import { TimelineStage } from './TimelineStage'
-import { MOCK_INCIDENTS } from './mock-data'
+import { SAMPLE_TIMELINE_INCIDENTS } from './sample-incidents'
 import type {
   TimelineIncident,
   TimelineFilterState,
@@ -31,7 +31,8 @@ import type {
 // Constants
 // ============================================================
 
-const IS_MOCK = process.env.NEXT_PUBLIC_AIOPS_TIMELINE_MOCK === 'true'
+// 保留既有環境變數相容；UI 以「範例資料」呈現，避免誤讀為正式證據。
+const USE_SAMPLE_TIMELINE = process.env.NEXT_PUBLIC_AIOPS_TIMELINE_MOCK === 'true'
 const API_BASE = process.env.NEXT_PUBLIC_API_URL ?? ''
 
 const STAGE_ORDER: StageType[] = ['alert', 'diagnose', 'decide', 'execute', 'verify', 'learn']
@@ -280,14 +281,14 @@ export default function AiopsTimelinePanel() {
   } = useQuery({
     queryKey: ['aiops-timeline', filter.incident_id, filter.time_range],
     queryFn: () => fetchTimeline(filter.incident_id),
-    enabled: !IS_MOCK,
+    enabled: !USE_SAMPLE_TIMELINE,
     staleTime: 30_000,
     refetchInterval: 60_000,
   })
 
   // 客戶端篩選 — rawIncidents 內聯進 useMemo 避免 conditional 依賴警告
   const incidents = useMemo(() => {
-    const rawIncidents: TimelineIncident[] = IS_MOCK ? MOCK_INCIDENTS : (apiData ?? [])
+    const rawIncidents: TimelineIncident[] = USE_SAMPLE_TIMELINE ? SAMPLE_TIMELINE_INCIDENTS : (apiData ?? [])
     let list = rawIncidents
 
     if (filter.incident_id.trim()) {
@@ -325,9 +326,9 @@ export default function AiopsTimelinePanel() {
           <h1 className="font-heading text-2xl font-bold text-nothing-black flex items-center gap-2.5">
             <GitBranch className="w-6 h-6 text-claw-blue" aria-hidden="true" />
             {t('title')}
-            {IS_MOCK && (
+            {USE_SAMPLE_TIMELINE && (
               <span className="inline-flex items-center px-2 py-0.5 rounded text-[10px] font-body font-bold uppercase tracking-widest bg-status-warning/10 border border-status-warning/20 text-status-warning">
-                {t('mockBadge')}
+                {t('sampleBadge')}
               </span>
             )}
           </h1>
@@ -337,7 +338,7 @@ export default function AiopsTimelinePanel() {
         </div>
 
         {/* Refresh button (僅真實模式顯示) */}
-        {!IS_MOCK && (
+        {!USE_SAMPLE_TIMELINE && (
           <button
             onClick={() => refetch()}
             disabled={isLoading}
@@ -362,7 +363,7 @@ export default function AiopsTimelinePanel() {
       />
 
       {/* Loading state (真實 API) */}
-      {!IS_MOCK && isLoading && (
+      {!USE_SAMPLE_TIMELINE && isLoading && (
         <div className="flex items-center justify-center py-20" role="status" aria-live="polite">
           <RefreshCw className="w-5 h-5 animate-spin text-nothing-gray-400" />
           <span className="ml-2 font-body text-sm text-nothing-gray-400">{t('loading')}</span>
@@ -370,7 +371,7 @@ export default function AiopsTimelinePanel() {
       )}
 
       {/* Error state */}
-      {!IS_MOCK && error && !isLoading && (
+      {!USE_SAMPLE_TIMELINE && error && !isLoading && (
         <div
           className="flex flex-col items-center justify-center py-20 gap-3"
           role="alert"
diff --git a/apps/web/src/components/aiops/timeline/index.ts b/apps/web/src/components/aiops/timeline/index.ts
index 70675545..b4207ccc 100644
--- a/apps/web/src/components/aiops/timeline/index.ts
+++ b/apps/web/src/components/aiops/timeline/index.ts
@@ -3,5 +3,5 @@ export { TimelineStage } from './TimelineStage'
 export { TimelineStageDetails } from './TimelineStageDetails'
 export { TimelineFilter } from './TimelineFilter'
 export { EvidenceViewer } from './EvidenceViewer'
-export { MOCK_INCIDENTS } from './mock-data'
+export { SAMPLE_TIMELINE_INCIDENTS } from './sample-incidents'
 export type * from './types'
diff --git a/apps/web/src/components/aiops/timeline/mock-data.ts b/apps/web/src/components/aiops/timeline/sample-incidents.ts
similarity index 99%
rename from apps/web/src/components/aiops/timeline/mock-data.ts
rename to apps/web/src/components/aiops/timeline/sample-incidents.ts
index 8f3c678f..b4a4a9e1 100644
--- a/apps/web/src/components/aiops/timeline/mock-data.ts
+++ b/apps/web/src/components/aiops/timeline/sample-incidents.ts
@@ -1,12 +1,12 @@
 // 2026-04-26 P2.5 by Claude — AIOps Timeline
 // ============================================================
-// Mock Data — 3 範例 incident，完整 6 階段 + metadata
+// Sample incidents — 3 筆範例 incident，完整 6 階段 + metadata
 // NEXT_PUBLIC_AIOPS_TIMELINE_MOCK=true 時使用
 // ============================================================
 
 import type { TimelineIncident } from './types'
 
-export const MOCK_INCIDENTS: TimelineIncident[] = [
+export const SAMPLE_TIMELINE_INCIDENTS: TimelineIncident[] = [
   {
     incident_id: 'INC-2026-0425-001',
     title: 'API Server CPU 100% — k8s-188',
diff --git a/apps/web/src/components/genui/__tests__/registry.test.ts b/apps/web/src/components/genui/__tests__/registry.test.ts
index 1a18b274..8f5de0f0 100644
--- a/apps/web/src/components/genui/__tests__/registry.test.ts
+++ b/apps/web/src/components/genui/__tests__/registry.test.ts
@@ -9,7 +9,7 @@
  * 3. getTerminalComponents — 只返回 allowInTerminal=true 的組件
  * 4. validateProps — 錯誤碼分類 (UNKNOWN_COMPONENT / ZOD_VALIDATION_FAILED)
  *
- * 注意: registry.ts 使用 React.lazy，在 Node 環境需要 Mock
+ * 注意：registry.ts 使用 React.lazy，在 Node 環境需以測試替身隔離 lazy 載入
  *
  * @see ADR-032 GenUI Dynamic Rendering
  * Phase 19.6 ogt 2026-03-31 (台北時間)
@@ -17,7 +17,7 @@
 
 import { vi, describe, it, expect, beforeAll } from 'vitest'
 
-// ===== Mock React (lazy 在 Node 環境無法執行) =====
+// ===== React lazy 測試替身（Node 環境無法執行 lazy import） =====
 vi.mock('react', () => ({
   lazy: vi.fn((factory: () => Promise<unknown>) => factory),
 }))
diff --git a/apps/web/src/components/neural-command/NeuralApprovalPanel.tsx b/apps/web/src/components/neural-command/NeuralApprovalPanel.tsx
index 076e7cd3..bbf17174 100644
--- a/apps/web/src/components/neural-command/NeuralApprovalPanel.tsx
+++ b/apps/web/src/components/neural-command/NeuralApprovalPanel.tsx
@@ -5,7 +5,7 @@
  * =====================================
  * 顯示真實待審核的操作，整合 NuclearKeyButton 長按確認
  *
- * 2026-04-07 Claude Code: Sprint F 打假行動 — 移除 MOCK_PENDING
+ * 2026-04-07 Claude Code: Sprint F 打假行動 — 移除舊待審範例常數
  * 專案鐵律: 接真實 /api/v1/approvals/pending，無資料顯示 EmptyState
  */
 
diff --git a/apps/web/src/components/neural-command/NeuralStats.tsx b/apps/web/src/components/neural-command/NeuralStats.tsx
index a17cf042..44881a79 100644
--- a/apps/web/src/components/neural-command/NeuralStats.tsx
+++ b/apps/web/src/components/neural-command/NeuralStats.tsx
@@ -5,7 +5,7 @@
  * ================================
  * 5 KPI + 執行路徑分佈 + Playbook 排名 + 時間軸
  *
- * 2026-04-07 Claude Code: Sprint F 打假行動 — 移除所有 MOCK 常數
+ * 2026-04-07 Claude Code: Sprint F 打假行動 — 移除所有假資料常數
  * 專案鐵律: 所有數據從 stats/playbooks/history props 計算，禁止寫死！
  */