Files
makemd/docs/SERVICES/finance.md
wurenzhi 2b86715c09 refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
2026-03-23 12:41:35 +08:00

2.3 KiB
Raw Blame History

财务域服务

入口: _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