wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
2.5 KiB
2.5 KiB
前端集成蓝图：跨主权贸易信用保险自动投保 (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)
- 供应商风险评分的实时展示。
- 投保成功后的电子保单下载。
- 导出包含投保成本的利润核算报表。