makemd/docs/blueprints/frontend-integration/trade-insurance-ui.md

前端集成蓝图：跨主权贸易信用保险自动投保 (Trade Insurance)

[AI-3 @ 2026-03-14]：由后端 Agent 在完成 BIZ_FIN_80 逻辑后产出。

1. 业务意图 (Business Intent)

• 核心价值：针对高价值跨国订单，基于风险评分自动建议投保方案，保护商户免受坏账与货损风险。
• 关联后端 Service：TradeInsuranceService.ts

2. UI/UX 布局方案 (Layout Design)

• 页面入口：Console -> 财务中心 -> 贸易保险管理
• 展示组件：
  • 待投保订单列表：展示 AGI 建议投保的高价值/高风险订单。
  • 保险方案对比卡片：展示不同保司的保费、保额及承保范围。
  • 风险评分仪表盘：展示订单与供应商的实时风险评估分数。
• 交互草图：

  +-----------------------------------------------------------+
  | [Icon] 贸易信用保险管理 (Trade Insurance)               |
  +-----------------------------------------------------------+
  | [ 待处理建议: 3 ] [ 累计保障额度: $150,000 ]               |
  +-----------------------------------------------------------+
  | [ 订单 ID: ORD-5566 ] [ 风险评分: 65 (中高) ]              |
  | --------------------------------------------------------- |
  | 建议保费: $25.00 | 保障额度: $1,250.00 | 承保商: Insure-Global |
  +-----------------------------------------------------------+
  | [ AGI 投保建议 ]                                          |
  | "该订单供应商评分较低且金额较大，建议投保 '综合货损险'。|
  | 投保成本仅占订单额 2%，可 100% 覆盖潜在拒付风险。"       |
  +-----------------------------------------------------------+
  | [ 忽略建议 ]                      [ 一键投保并锁定费率 ]   |
  +-----------------------------------------------------------+
  

3. API 交互契约 (API Integration)

• 数据获取：GET /api/v1/finance/insurance/suggestions
• 关键字段映射
  • premium_amount -> 保费
  • coverage_amount -> 保额
  • status -> 状态 (SUGGESTED, ACTIVE, etc.)
• 状态流转：
  • 点击 [一键投保] -> 调用 TradeInsuranceService.suggestPolicy -> 更新状态为 ACTIVE。

4. 生产校验项 (FE Readiness)

• 供应商风险评分的实时展示。
• 投保成功后的电子保单下载。
• 导出包含投保成本的利润核算报表。