feat: 初始化项目结构并添加核心功能模块
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
This commit is contained in:
46
archive/handover/trade-insurance-ui.md
Normal file
46
archive/handover/trade-insurance-ui.md
Normal file
@@ -0,0 +1,46 @@
|
||||
# 前端集成蓝图:跨主权贸易信用保险自动投保 (Trade Insurance)
|
||||
|
||||
> **[AI-3 @ 2026-03-14]**:由后端 Agent 在完成 BIZ_FIN_80 逻辑后产出。
|
||||
|
||||
## 1. 业务意图 (Business Intent)
|
||||
- **核心价值**:针对高价值跨国订单,基于风险评分自动建议投保方案,保护商户免受坏账与货损风险。
|
||||
- **关联后端 Service**:`TradeInsuranceService.ts`
|
||||
|
||||
## 2. UI/UX 布局方案 (Layout Design)
|
||||
- **页面入口**:Console -> 财务中心 -> 贸易保险管理
|
||||
- **展示组件**:
|
||||
- [ ] **待投保订单列表**:展示 AGI 建议投保的高价值/高风险订单。
|
||||
- [ ] **保险方案对比卡片**:展示不同保司的保费、保额及承保范围。
|
||||
- [ ] **风险评分仪表盘**:展示订单与供应商的实时风险评估分数。
|
||||
- **交互草图**:
|
||||
```text
|
||||
+-----------------------------------------------------------+
|
||||
| [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)
|
||||
- [ ] 供应商风险评分的实时展示。
|
||||
- [ ] 投保成功后的电子保单下载。
|
||||
- [ ] 导出包含投保成本的利润核算报表。
|
||||
Reference in New Issue
Block a user