docs: reorganize MVP interview documentation

interview/README.md

@@ -1,48 +1,54 @@
-# SuperBizAgent Interview Guide
+# SuperBizAgent 面试资料包
 
 ## 一句话定位
 
-SuperBizAgent 是一个面向企业故障诊断场景的 Agent Engineering 项目：它把用户问题或告警事件转成可追踪的多 Agent 执行链路，并把工具证据、模型步骤、最终答案和反馈统一落到诊断 trace 中。
+SuperBizAgent 是一个面向企业故障诊断场景的 Agent 工程项目。它把用户问题或 AIOps 告警转换成可追踪的 Agent 执行链路，并把工具证据、模型步骤、最终答案、自评估和用户反馈统一沉淀到诊断 Trace 中。
 
 ## 面试重点
 
-- **多 Agent 编排**：普通 Chat 的复杂问题走 `Planner -> Executor -> Verifier`；AIOps 告警入口走 Supervisor 调度 Planner/Executor。
-- **工具证据链**：知识库、日志、指标和 Prometheus 告警都通过工具调用进入链路，并记录到 `tool_invocation`。
-- **可追踪诊断**：一次会话对应一个 `sessionId`，最终可以通过 `GET /api/diagnosis/{sessionId}/trace` 回放。
-- **质量门**：Chat 链路包含 Verifier，把 groundedness、facts checked 和 evidence refs 写回 `diagnosis_session.self_evaluation`。
-- **AIOps 产品边界**：有告警 payload 时聚焦该告警；没有 payload 时先自动发现 active alerts。
-- **可复现 Demo**：`mvp-demo` profile 使用 mock Prometheus 和 mock CLS，让面试演示不依赖真实线上故障。
+- **Agent 编排**：Chat 复杂问题走 `Planner -> Executor -> Verifier`；AIOps 告警入口走 `Supervisor -> Planner / Executor`。
+- **工具证据链**：知识库、日志、指标、Prometheus 告警都通过显式工具调用进入链路，并记录到 `tool_invocation`。
+- **可追踪诊断**：一次诊断对应一个 `sessionId`，可通过 `GET /api/diagnosis/{sessionId}/trace` 回放。
+- **质量门禁**：Chat Verifier 校验 groundedness；AIOps 规则评估检查报告完整性、payload 聚焦和证据工具覆盖。
+- **RAG 工程化**：`lookup_knowledge` 是显式 Agent Tool，底层通过 Spring AI VectorStore 主路径 + Milvus SDK fallback。
+- **反馈闭环**：用户反馈 `useful` 会沉淀 `case_library`，`not_useful` 保留 bad case 信号。
 
 ## 推荐阅读顺序
 
-1. `interview/demo-script.md`：面试现场怎么讲、怎么演示。
-2. `interview/architecture.md`：系统架构和两条主链路。
-3. `interview/design-tradeoffs.md`：关键设计取舍和可被追问的问题。
-4. `interview/acceptance-checklist.md`：面试前验证清单。
-5. `mvp/demo/README.md`：更细的 MVP 可执行 runbook。
+1. `mvp/architecture/interview-one-pager.md`：一页式架构图和 2-5 分钟讲解。
+2. `mvp/demo/ten-minute-interview-demo.md`：10 分钟现场演示脚本。
+3. `interview/story-cases.md`：可复用的面试故事案例。
+4. `interview/architecture.md`：面试版系统架构。
+5. `interview/design-tradeoffs.md`：关键设计取舍。
+6. `interview/demo-script.md`：更细的命令式演示脚本。
+7. `interview/acceptance-checklist.md`：面试前验收清单。
+8. RAG 专题文档：`rag-refactor-story.md`、`rag-vectorstore-interview-notes.md`、`rag-retrieval-quality-report.md`。
 
-## 核心 Demo
+## 核心演示链路
 
-### Chat Diagnosis
+### Chat 诊断
 
 ```text
 POST /api/chat
--> ChatService.executeChatWithStrategy(...)
--> simple ReactAgent or Planner -> Executor -> Verifier
+-> ChatService
+-> Planner -> Executor -> Verifier
 -> lookup_knowledge / query_logs / query_metrics
 -> diagnosis_session + agent_step + tool_invocation
 -> GET /api/diagnosis/{sessionId}/trace
+-> POST /api/feedback
 ```
 
-### AIOps Alert Diagnosis
+### AIOps 告警诊断
 
 ```text
 POST /api/ai_ops
--> AiOpsService.executeAiOpsAnalysis(...)
+-> AiOpsService
+-> PAYLOAD_TARGETED / AUTO_DISCOVERY
 -> ai_ops_supervisor
 -> planner_agent / executor_agent
--> queryPrometheusAlerts + logs + knowledge
--> scoped alert report
+-> queryPrometheusAlerts + logs + metrics + lookup_knowledge
+-> alert report
+-> aiops_rule_evaluation
 -> GET /api/diagnosis/{sessionId}/trace
 ```
 
@@ -50,10 +56,11 @@ POST /api/ai_ops
 
 - Chat 诊断链路：可运行、可追踪、有 Verifier。
 - AIOps 告警链路：可运行、可追踪、支持 payload scope control。
+- RAG 检索链路：Spring AI VectorStore 主路径、Milvus SDK fallback、L0 hint、检索评测 baseline。
 - Trace API：统一返回 session、agent steps、tool invocations 和 summary。
-- Demo 文档：`mvp/demo/README.md` 和 `mvp/demo/aiops-alert-acceptance.md`。
-- Devflow 沉淀：`devflow/index.md` 记录了 MVP、Verifier、AIOps trace 和 AIOps scope-control 的演进。
+- Demo 材料：`mvp/demo/README.md`、`mvp/demo/ten-minute-interview-demo.md`。
 
-## 面试时的主叙事
+## 主叙事
+
+这个项目不是简单调用大模型，而是在做一个可审计、可验证、可回归的 Agent 诊断系统。模型可以规划和推理，但每一步工具证据、最终结论、Verifier 结果和用户反馈都能被 Trace API 回放。面试时重点展示“从问题到证据到答案到验证再到反馈”的闭环。
 
-这个项目不是简单调用大模型，而是在做一个可审计的 Agent 诊断系统。核心价值是：模型可以规划和推理，但每一步工具证据、最终结论和质量评估都能被 trace API 回放。面试时重点展示“从问题到证据到答案到验证”的完整闭环。