wurenzhi
2b86715c09
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
111 lines
2.3 KiB
Markdown
111 lines
2.3 KiB
Markdown
# 财务域服务
|
||
|
||
> **入口**: [_index.md](_index.md)
|
||
|
||
---
|
||
|
||
## 服务列表
|
||
|
||
| 服务 | 文件 | 职责 |
|
||
|------|------|------|
|
||
| FinanceService | services/FinanceService.ts | 财务管理 |
|
||
| ReconciliationService | services/ReconciliationService.ts | 对账管理 |
|
||
| SettlementService | services/SettlementService.ts | 结算管理 |
|
||
|
||
---
|
||
|
||
## 核心流程
|
||
|
||
```
|
||
订单完成 → 对账 → 结算 → 利润核算
|
||
```
|
||
|
||
---
|
||
|
||
## FinanceService
|
||
|
||
### 方法列表
|
||
|
||
| 方法 | 说明 | 参数 | 返回 |
|
||
|------|------|------|------|
|
||
| getOverview | 财务概览 | tenantId | FinanceOverview |
|
||
| getProfit | 利润计算 | orderId | Profit |
|
||
| getReport | 财务报表 | params | Report |
|
||
|
||
---
|
||
|
||
## ReconciliationService
|
||
|
||
### 方法列表
|
||
|
||
| 方法 | 说明 | 参数 | 返回 |
|
||
|------|------|------|------|
|
||
| reconcile | 执行对账 | params | ReconciliationResult |
|
||
| getDiscrepancies | 获取差异 | reconciliationId | Discrepancy[] |
|
||
| resolve | 解决差异 | discrepancyId, resolution | void |
|
||
|
||
---
|
||
|
||
## SettlementService
|
||
|
||
### 方法列表
|
||
|
||
| 方法 | 说明 | 参数 | 返回 |
|
||
|------|------|------|------|
|
||
| list | 结算列表 | params | Settlement[] |
|
||
| get | 结算详情 | id | Settlement |
|
||
| create | 创建结算 | CreateRequest | Settlement |
|
||
| confirm | 确认结算 | id | Settlement |
|
||
|
||
---
|
||
|
||
## 利润计算
|
||
|
||
### 计算公式
|
||
|
||
```
|
||
净利润 = 售价 - 采购成本 - 平台费用 - 物流费用 - 税费 - 汇率对冲 - 售后损耗 - 广告摊销
|
||
|
||
利润率 = 净利润 / 售价 × 100%
|
||
```
|
||
|
||
### 利润红线
|
||
|
||
| 业务类型 | 阈值 | 处理 |
|
||
|---------|------|------|
|
||
| TOC | < 20% | 风控预警 |
|
||
| TOB | < 15% | 禁止报价 |
|
||
|
||
---
|
||
|
||
## 状态机
|
||
|
||
```
|
||
PENDING → PROCESSING → COMPLETED
|
||
↓
|
||
FAILED
|
||
```
|
||
|
||
| 状态 | 说明 |
|
||
|------|------|
|
||
| PENDING | 待处理 |
|
||
| PROCESSING | 处理中 |
|
||
| COMPLETED | 已完成 |
|
||
| FAILED | 失败 |
|
||
|
||
---
|
||
|
||
## API端点
|
||
|
||
| 端点 | 方法 | 服务方法 |
|
||
|------|------|----------|
|
||
| /api/v1/finance/overview | GET | FinanceService.getOverview |
|
||
| /api/v1/finance/profit/:orderId | GET | FinanceService.getProfit |
|
||
| /api/v1/reconciliation | POST | ReconciliationService.reconcile |
|
||
| /api/v1/settlements | GET | SettlementService.list |
|
||
| /api/v1/settlements | POST | SettlementService.create |
|
||
|
||
---
|
||
|
||
*最后更新: 2026-03-22*
|