fix: 修复证据上传审计并补充前端操作提示要求

docs/风控业务演示文档/17-前端合并提示词与验收约束.md

@@ -91,7 +91,78 @@
 - SSE 需要处理 `start`、`tools`、`delta`、`replace`、`done` 和 `error`。
 - 断线重连后根据 `run_id` 恢复最终结果。
 
-## 六、验收要求
+## 六、预警操作结果提示
+
+本节要求不依赖后端修改，前端根据当前接口响应统一实现操作成功和失败提示。
+
+### 成功提示
+
+操作返回 HTTP 2xx 后，根据操作类型显示对应提示：
+
+| 操作 | 提示 |
+|---|---|
+| 确认接收 | 预警已确认接收 |
+| 进入调查 | 已进入调查 |
+| 关闭误报 | 已关闭误报 |
+| 完成结案 | 预警已完成结案 |
+| 升级处理 | 预警已升级 |
+| 上传证据 | 证据上传成功 |
+| 手动扫描 | 预警扫描完成 |
+| 生成日报 | 日报生成完成 |
+| 邮件发送 | 日报发送成功 |
+
+### 失败提示
+
+失败时优先读取主项目统一错误信封：
+
+```json
+{
+  "error": {
+    "code": "AGENT_PERMISSION_DENIED",
+    "message": "缺少操作权限"
+  }
+}
+```
+
+前端统一按以下顺序解析：
+
+```text
+error.message
+-> HTTP 状态码映射
+-> 通用失败提示
+```
+
+推荐映射：
+
+| 状态或错误码 | 提示 |
+|---|---|
+| `401 AUTHENTICATION_REQUIRED` | 登录已失效，请重新登录 |
+| `403 AGENT_PERMISSION_DENIED` | 没有当前操作权限 |
+| `404` | 预警不存在或无权查看 |
+| `409` | 当前状态不允许该操作 |
+| `413` | 文件超过大小限制 |
+| `422` | 提交内容不符合要求 |
+| `500` | 系统异常，请稍后重试 |
+| `503/504` | 服务暂时不可用 |
+
+### 组合操作
+
+“完成处置并上传证据”必须分别提示：
+
+- 文件上传成功、结案失败：提示“证据已上传，结案失败”，不重复上传文件。
+- 文件上传失败、结案未执行：提示上传失败，保留弹窗填写内容。
+- 结案成功、页面刷新失败：继续提示结案成功，再单独刷新列表或详情。
+- 重复操作返回 409：刷新预警详情，提示“预警可能已处理，请核对状态”。
+
+### 交互要求
+
+- 操作进行中禁用重复点击，并显示进行中状态。
+- 成功或失败必须使用主项目统一的消息、Toast 或通知组件。
+- 不能只用控制台日志代替用户提示。
+- 弹窗关闭前必须明确操作结果。
+- 不使用浏览器原生 `alert` 作为正式交互方案。
+
+## 七、验收要求
 
 后续模型完成前端后必须提供：
 
@@ -103,7 +174,7 @@
 6. 权限按钮与服务端权限一致。
 7. 不直接修改风控业务规则和数据库结构。
 
-## 七、可直接交给后续模型的提示词
+## 八、可直接交给后续模型的提示词
 
 ```text
 你正在把风控模块前端合并到主项目中。开始写代码前必须完成以下工作：
@@ -129,6 +200,8 @@
 - 预警队列按风险等级优先排序，行高固定，内容过长省略。
 - 确认接收需要二次确认，误报必须填写理由。
 - Agent 对话必须使用主项目 Agent Run 和 SSE，不新建私有协议。
+- 所有预警操作必须实现成功和失败提示；后端不修改，前端解析统一错误信封并按操作类型生成提示。
+- 完成处置并上传证据时，必须分别处理上传和结案的成功、失败及部分成功场景。
 - 页面权限和按钮可见性必须由后端权限和 roles/permissions 决定。
 - 不修改公共底座，不新增启动顺序和访问地址，不生成演示数据。
 
@@ -139,4 +212,3 @@
 - 文字无重叠、无溢出、无布局抖动。
 - 风控功能与主项目其他模块边界清晰。
 ```
-