docs: reorganize MVP interview documentation

interview/acceptance-checklist.md

@@ -1,15 +1,15 @@
-# Acceptance Checklist
+# 面试前验收清单
 
-## 面试前环境检查
+## 1. 环境检查
 
-- 当前分支包含最新 AIOps trace/scope 变更。
+- 当前分支包含最新架构文档和面试材料。
 - MySQL 可连接。
 - Redis 可连接。
 - Milvus/Zilliz 可连接。
 - 模型 API key 可用。
 - `mvp-demo` profile 开启 mock Prometheus 和 mock CLS。
 
-启动：
+启动服务：
 
 ```powershell
 mvn spring-boot:run "-Dspring-boot.run.profiles=mvp-demo"
@@ -24,10 +24,10 @@ mvn -q -DskipTests compile
 目标测试：
 
 ```powershell
-mvn -q "-Dtest=AiOpsServiceTest,ChatServiceSequentialAgentTest,DiagnosisTraceServiceTest" test
+mvn -q "-Dtest=AiOpsServiceTest,ChatServiceSequentialAgentTest,DiagnosisTraceServiceTest,VectorSearchServiceTest,LookupKnowledgeToolTest" test
 ```
 
-## Chat Demo 验收
+## 2. Chat Demo 验收
 
 请求：
 
@@ -50,7 +50,7 @@ Invoke-RestMethod `
 - 返回 `data.success = true`。
 - 返回 `data.sessionId = interview-chat-payment-timeout-001`。
 - `diagnosis_session.agent_flow = CHAT`。
-- trace API 返回 session、steps、toolInvocations。
+- Trace API 返回 session、steps、toolInvocations。
 - 复杂问题下 trace 中能看到 verifier 相关数据。
 
 SQL：
@@ -59,7 +59,7 @@ SQL：
 python scripts/query_mysql.py "SELECT session_id, agent_flow, status, step_count, tool_call_count FROM diagnosis_session WHERE session_id='interview-chat-payment-timeout-001'"
 ```
 
-## AIOps Demo 验收
+## 3. AIOps Demo 验收
 
 请求：
 
@@ -89,11 +89,10 @@ Invoke-WebRequest `
 - `diagnosis_session.agent_flow = AI_OPS`。
 - `diagnosis_session.status = SUCCESS`。
 - `diagnosis_session.answer` 有最终报告。
-- trace API 返回 AIOps steps 和 tool invocations。
+- Trace API 返回 AIOps steps 和 tool invocations。
 - 报告主章节聚焦 `HighCPUUsage/payment-service`。
-- 无 `告警根因分析 - HighMemoryUsage` 独立章节。
-- 无 `告警根因分析 - SlowResponse` 独立章节。
-- 有“相关风险告警”或类似上下文说明。
+- 其他 active alerts 不应展开成独立主根因章节。
+- `self_evaluation.aiops_rule_evaluation` 存在。
 
 SQL：
 
@@ -108,19 +107,10 @@ python scripts/query_mysql.py "SELECT tool_name, COUNT(*) AS cnt FROM tool_invoc
 Scope 检查：
 
 ```powershell
-python scripts/query_mysql.py "SELECT (answer LIKE '%告警根因分析 - HighCPUUsage%') AS has_main_root_cause, (answer LIKE '%告警根因分析 - HighMemoryUsage%') AS has_memory_root_cause, (answer LIKE '%告警根因分析 - SlowResponse%') AS has_slow_root_cause, (answer LIKE '%相关风险告警%') AS has_related_risk FROM diagnosis_session WHERE session_id='interview-aiops-payment-cpu-001'"
+python scripts/query_mysql.py "SELECT (answer LIKE '%HighCPUUsage%') AS has_main_alert, (answer LIKE '%payment-service%') AS has_service FROM diagnosis_session WHERE session_id='interview-aiops-payment-cpu-001'"
 ```
 
-期望：
-
-```text
-has_main_root_cause = 1
-has_memory_root_cause = 0
-has_slow_root_cause = 0
-has_related_risk = 1
-```
-
-## Trace API 验收
+## 4. Trace API 验收
 
 ```powershell
 Invoke-RestMethod `
@@ -128,13 +118,28 @@ Invoke-RestMethod `
   -Uri "http://localhost:9900/api/diagnosis/interview-aiops-payment-cpu-001/trace"
 ```
 
-若 PowerShell 对长 JSON 或特殊字符不稳定，可以用：
+如果 PowerShell 对长 JSON 或特殊字符不稳定，可以用：
 
 ```powershell
 curl.exe --silent --show-error --max-time 60 "http://localhost:9900/api/diagnosis/interview-aiops-payment-cpu-001/trace"
 ```
 
-## 常见问题
+## 5. RAG 验收
+
+```powershell
+Invoke-RestMethod `
+  -Uri "http://127.0.0.1:9900/api/search/similar?query=ERR_TIMEOUT&topK=3" `
+  -Method Get
+```
+
+验收：
+
+- 返回 `code = 200`。
+- top candidates 中包含 `ERR_TIMEOUT` 相关文档。
+- `scoreLabel` 能体现当前检索路径语义。
+- 如果走 VectorStore，日志应出现 Spring AI VectorStore search。
+
+## 6. 常见问题
 
 ### MySQL stale connection
 
@@ -145,26 +150,17 @@ HikariPool - Connection is not available
 No operations allowed after connection closed
 ```
 
-当前已在 `application.yml` 配置：
-
-- `maximum-pool-size: 5`
-- `minimum-idle: 1`
-- `connection-timeout: 10000`
-- `validation-timeout: 5000`
-- `idle-timeout: 60000`
-- `max-lifetime: 120000`
-- `keepalive-time: 30000`
-
 处理：
 
-- 重新编译或重启服务。
-- 确认日志中新的 HikariPool 启动成功。
+- 重启服务。
+- 确认 HikariPool 使用当前配置启动成功。
 - 再跑 trace 或 AIOps 请求。
 
 ### SSE 客户端显示异常
 
-PowerShell `Invoke-WebRequest` 有时对 SSE 或长 JSON 处理不稳定。可以改用 `curl.exe` 或直接查询 MySQL 和 trace API 验证结果。
+PowerShell `Invoke-WebRequest` 有时对 SSE 或长 JSON 处理不稳定。可以改用 `curl.exe` 或直接查询 MySQL 和 Trace API 验证结果。
 
 ### OpenSpec 全量校验失败
 
-`openspec validate --all --strict` 可能因为历史未完成 change 失败。面试材料主要依赖已归档的 AIOps spec 和 MVP trace spec，可以单独验证相关 spec。
+`openspec validate --all --strict` 可能因为历史未完成 change 失败。面试演示主要依赖已归档 spec、MVP trace 和 RAG 验收材料，可以单独验证相关 spec。
+