feat(ai): complete v3.2 risk watch agent

docs/workflow.md

@@ -339,9 +339,9 @@ Implementation convention:
 - `xiaobao.warning:manage`：查看所有未结束版本的预警。
 - `xiaobao.warning:view`：仅查看当前用户在 `version.members` 中的未结束版本。
 
-V2.6 后小宝当前 summary 由服务端后台刷新：领域写入标记 `xiaobao_risk_summaries.dirty=true` 并排入 `xiaobao.summary.refresh`，worker 从版本下的计划、开发任务、测试用例、Bug、日报和工作活动重新计算风险。页面仍可用前端 `buildXiaobaoWorkItems` 做兼容聚合和快照保存，但默认优先读取 V2.2 summary。
+V2.6/V3.2 后小宝当前 summary 由服务端后台刷新：领域写入标记 `xiaobao_risk_summaries.dirty=true` 并排入 `xiaobao.summary.refresh`，worker 从版本下的计划、开发任务、测试用例、Bug、日报和工作活动重新计算风险。页面仍可用前端 `buildXiaobaoWorkItems` 做兼容聚合和快照保存，但默认优先读取 V2.2 summary。
 
-AI 解读不由人工按钮触发。服务端 summary 刷新后按 policy 排入 `xiaobao.ai.interpret`：`at_risk`、`likely_delayed`、`blocked` 自动触发；`attention` 当前服务端只在临近发版且仍有未完成工作时触发，页面完整趋势策略仍保留作为兼容。缓存命中时复用解读；同版本最近 6 小时内已有解读时进入 cooldown，不重复请求，风险等级升级时可绕过；缓存保存时间使用服务端写入时间，不信任模型返回的 `generatedAt` 作为缓存新鲜度。
+AI 解读不由人工按钮触发。服务端 summary 刷新后按 policy 排入 `xiaobao.ai.interpret`：`at_risk`、`likely_delayed`、`blocked` 自动触发；`attention` 当前服务端只在临近发版且仍有未完成工作时触发，页面完整趋势策略仍保留作为兼容。缓存命中时复用解读；同版本最近 6 小时内已有解读时进入 cooldown，不重复请求，风险等级升级时可绕过；缓存保存时间使用服务端写入时间，不信任模型返回的 `generatedAt` 作为缓存新鲜度。V2.2 小宝快读会带出当前版本最新 generated 关系表解读，前端优先展示这份解读，再兼容旧 `xiaobao-risk-insights` AppData 缓存。
 
 静默风险包括长期无更新、无日报、无活动、进行中事项无人处理等信号。日报和工作活动是风险解释的重要证据，必须进入 AI 解读输入。
 
@@ -360,6 +360,43 @@ AI 解读不由人工按钮触发。服务端 summary 刷新后按 policy 排入
 
 管理驾驶舱 `/admin/management` 只查关系表和小宝 summary，不读取 AppData，并通过 RBAC adapter 校验 `management:view`。治理设置 `/admin/governance` 集中维护任务类型与需求字典；使用中的字典不可硬删，字典变更必须写 audit，并通过 RBAC adapter 校验 `governance:manage`。
 
+## Business Analysis Agent 工作流（规划）
+
+Business Analysis Agent 用于 AI 助手业务数据对话，以及产品/项目/版本详情页的上下文分析入口。它只读关系表和 summary，不写业务数据。
+
+标准流程：
+
+1. 用户在 `/wenfan-xiaobao` 或详情页输入问题。
+2. 前端提交问题和上下文：`surface`、`productId`、`projectId`、`versionId`。
+3. 后端 Analysis Planner 识别用户意图。
+4. Semantic Layer 将自然语言映射成系统语义、指标、维度、分析类型和时间意图。
+5. Permission Scope Resolver 根据当前用户权限和页面上下文收窄数据范围。
+6. Analysis Strategy 生成分析计划：
+   - Template Strategy 优先命中固定高频模板。
+   - Rule Composition Strategy 用确定性规则组合已知指标、维度和时间口径。
+   - AI Planning Strategy 只生成计划建议，不直接执行。
+7. Analysis Plan Processor 校验权限、指标、维度、聚合、时间范围、Top N 和筛选条件，并规范化为统一 `AnalysisPlan`。
+8. Metric Engine 执行关系表查询和聚合，返回 `MetricResult`。
+9. ChartSpec Builder、Insight Engine、Report Builder、Follow-up Builder 并行消费 `MetricResult`。
+10. 前端展示 Insight Card、ECharts 图表、固定结构报告、可点击 Evidence 和只读 Follow-up。
+
+时间口径：
+
+- 用户明确说本月、季度、年份、最近 N 天时，按用户指定。
+- 当前状态或风险问题不默认套近 30 天，使用实时状态、未完成事项、小宝 summary、阻塞、Bug、测试完成率和发版日期。
+- 趋势、吞吐、效率、投入和变化类问题，用户未指定时间时默认近 30 天。
+- 对比类问题未指定基准时，用近 30 天对比前 30 天。
+- 生命周期类问题按对象生命周期统计。
+- 每次回答必须显示统计范围、数据截止时间、权限范围和时间口径类型。
+
+无数据时返回 No Data 结果，不生成虚假解释。低语义置信时先说明系统默认解释，必要时给用户可选追问。
+
+视觉工作流：
+
+- 结果先显示一句 Insight Card，再显示图表和报告。
+- 图表使用平台 Unified ChartSpec，通过前端 ECharts Renderer 渲染。
+- 图表遵循 AI Analysis Design System：Apple Vision 风格、大留白、大圆角、轻阴影、半透明材质、数字优先、折线面积渐变、横向圆角柱状、少坐标、少颜色、无大屏炫光。
+
 ## 日期选择与计划时间
 
 - 调研、产品方案、UI 设计、开发任务、测试用例、Bug 创建时使用统一工作日日期时间选择器。