wurenzhi
136c2fa579
- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
45 lines
2.4 KiB
Markdown
45 lines
2.4 KiB
Markdown
# 前端集成蓝图：跨主权税务路由优化引擎 (Tax Routing Optimizer)
|
||
|
||
> **[AI-3 @ 2026-03-14]**：由后端 Agent 在完成 BIZ_FIN_60 逻辑后产出。
|
||
|
||
## 1. 业务意图 (Business Intent)
|
||
- **核心价值**：在多个目的国发货时，自动选择税务成本最低（如 IOSS vs OSS）的路由，保护商户资金。
|
||
- **关联后端 Service**：`TaxRoutingOptimizerService.ts`
|
||
|
||
## 2. UI/UX 布局方案 (Layout Design)
|
||
- **页面入口**：Console -> 财务中心 -> 税务路由管理
|
||
- **展示组件**：
|
||
- [ ] **多国税务政策对比图**：展示 IOSS, OSS, DDP, DDU 在不同国家的成本差异。
|
||
- [ ] **税务路由建议表**：展示已生成的路由建议（Method, Tax, Cost）。
|
||
- [ ] **合规风险雷达图**：展示不同方法的风险评估（Risk Level）。
|
||
- **交互草图**：
|
||
```text
|
||
+-----------------------------------------------------------+
|
||
| [Icon] 税务路由优化管理 (Tax Routing) |
|
||
+-----------------------------------------------------------+
|
||
| [ 目的国: 德国 (DE) ] [ 订单金额: €120 ] [ 路由建议: IOSS ] |
|
||
+-----------------------------------------------------------+
|
||
| 预估税额: €24.00 | 合规费用: €1.50 | 总成本: €25.50 |
|
||
+-----------------------------------------------------------+
|
||
| [ AGI 路由洞察 (Tax Insight) ] |
|
||
| "该订单金额低于 €150，使用 IOSS 路由可享受极低合规成本。|
|
||
| 相比 DDP 节省：€3.50。风险等级：低 (LOW)。" |
|
||
+-----------------------------------------------------------+
|
||
| [ 忽略建议 ] [ 应用 IOSS 路由策略 ] |
|
||
+-----------------------------------------------------------+
|
||
```
|
||
|
||
## 3. API 交互契约 (API Integration)
|
||
- **数据获取**：`GET /api/v1/finance/tax/routing/optimize?country=DE&value=120`
|
||
- **关键字段映射**
|
||
- `chosen_method` -> 建议税务方法
|
||
- `estimated_tax` -> 预估税额
|
||
- `total_cost` -> 总合规成本
|
||
- **状态流转**：
|
||
- 切换目的国 -> 调用 `TaxRoutingOptimizerService.optimizeTaxRoute` -> 重新渲染成本对比。
|
||
|
||
## 4. 生产校验项 (FE Readiness)
|
||
- [ ] 各国税率数据的实时性核对（< 24 hour 延迟）。
|
||
- [ ] 货币转换的实时汇率应用。
|
||
- [ ] 导出包含税务路径选择理由的财务报表。
|