refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
This commit is contained in:
110
docs/SERVICES/finance.md
Normal file
110
docs/SERVICES/finance.md
Normal file
@@ -0,0 +1,110 @@
|
||||
# 财务域服务
|
||||
|
||||
> **入口**: [_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*
|
||||
Reference in New Issue
Block a user