wurenzhi
48a78137c5
- 将B2B统一为TOB术语 - 将状态值统一为大写格式 - 优化类型声明，避免使用any - 将float类型替换为decimal以提高精度 - 新增术语标准化文档 - 优化路由结构和菜单分类 - 添加TypeORM实体类 - 增强加密模块安全性 - 重构前端路由结构 - 完善任务模板和验收标准
108 lines
4.0 KiB
Markdown
108 lines
4.0 KiB
Markdown
# 财务管理后端任务
|
||
|
||
## 任务列表
|
||
|
||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 | 完成时间 |
|
||
| ------- | ------- | ------ | ---------- | ---- | ---- | ----------- | --- | ------- | ---- | ------------ | -------- |
|
||
| BE-F001 | 资金对账闭环 | 对账接口 | 时间范围, 平台ID | 对账结果 | 定时任务 | ✅ completed | P0 | BE-O001 | 2h | AI-Backend-2 | 2026-03-20 |
|
||
| BE-F002 | 回款与财务闭环 | 回款管理接口 | 订单ID, 回款金额 | 回款记录 | 回款事件 | ✅ completed | P1 | BE-F001 | 1.5h | AI-Backend-2 | 2026-03-20 |
|
||
| BE-F003 | 利润核算闭环 | 利润计算接口 | 订单ID, 成本数据 | 利润数据 | 订单完成 | ✅ completed | P1 | BE-F001 | 2h | AI-Backend-3 | 2026-03-20 |
|
||
|
||
## 相关闭环
|
||
|
||
- 资金对账闭环
|
||
- 回款与财务闭环
|
||
- 利润核算闭环
|
||
|
||
## 依赖关系
|
||
|
||
```
|
||
BE-O001 ─► BE-F001 ─┬─► BE-F002
|
||
└─► BE-F003
|
||
```
|
||
|
||
## 数据库表结构
|
||
|
||
### cf_finance_reconciliation
|
||
| 字段 | 类型 | 说明 |
|
||
| ---- | ---- | ---- |
|
||
| id | string | 对账记录ID |
|
||
| tenant_id | string | 租户ID |
|
||
| platform_id | string | 平台ID |
|
||
| period_start | datetime | 对账开始时间 |
|
||
| period_end | datetime | 对账结束时间 |
|
||
| expected_amount | decimal(10,2) | 预期金额 |
|
||
| actual_amount | decimal(10,2) | 实际金额 |
|
||
| status | enum | PENDING/COMPLETED/ERROR |
|
||
| created_at | datetime | 创建时间 |
|
||
| updated_at | datetime | 更新时间 |
|
||
|
||
### cf_payment_record
|
||
| 字段 | 类型 | 说明 |
|
||
| ---- | ---- | ---- |
|
||
| id | string | 回款记录ID |
|
||
| tenant_id | string | 租户ID |
|
||
| order_id | string | 订单ID |
|
||
| amount | decimal(10,2) | 回款金额 |
|
||
| payment_method | string | 支付方式 |
|
||
| status | enum | PENDING/COMPLETED/FAILED |
|
||
| created_at | datetime | 创建时间 |
|
||
| updated_at | datetime | 更新时间 |
|
||
|
||
### cf_profit_calculation
|
||
| 字段 | 类型 | 说明 |
|
||
| ---- | ---- | ---- |
|
||
| id | string | 利润计算ID |
|
||
| tenant_id | string | 租户ID |
|
||
| order_id | string | 订单ID |
|
||
| revenue | decimal(10,2) | 收入 |
|
||
| cost | decimal(10,2) | 成本 |
|
||
| profit | decimal(10,2) | 利润 |
|
||
| profit_margin | decimal(5,2) | 利润率 |
|
||
| created_at | datetime | 创建时间 |
|
||
|
||
## API端点
|
||
|
||
### 财务管理API
|
||
- `GET /api/finance/reconciliation` - 获取对账记录列表
|
||
- `POST /api/finance/reconciliation` - 发起对账
|
||
- `GET /api/finance/reconciliation/:id` - 获取对账详情
|
||
- `GET /api/finance/payments` - 获取回款记录列表
|
||
- `POST /api/finance/payments` - 记录回款
|
||
- `GET /api/finance/payments/:id` - 获取回款详情
|
||
- `GET /api/finance/profit/:orderId` - 获取订单利润
|
||
- `POST /api/finance/profit/calculate` - 计算利润
|
||
|
||
## 验收标准
|
||
|
||
- [x] 对账接口能正确处理不同平台的对账数据
|
||
- [x] 回款管理接口能准确记录回款信息
|
||
- [x] 利润计算接口能正确计算订单利润和利润率
|
||
- [x] 所有接口响应时间不超过2秒
|
||
- [x] 数据一致性得到保证，无重复或丢失数据
|
||
|
||
## 测试要求
|
||
|
||
- [x] 单元测试：覆盖核心计算逻辑
|
||
- [x] 集成测试：验证与订单系统的交互
|
||
- [x] 端到端测试：模拟完整的财务流程
|
||
- [x] 边界测试：测试异常数据和边界情况
|
||
|
||
## 风险提示
|
||
|
||
- **风险点1**：对账数据量大导致性能问题 - 应对措施：实现分页和异步处理
|
||
- **风险点2**：多平台数据格式不一致 - 应对措施：统一数据转换层
|
||
- **风险点3**：回款状态更新不及时 - 应对措施：实现定时同步机制
|
||
|
||
## 性能要求
|
||
|
||
- 响应时间：平均响应时间 < 2秒
|
||
- 并发处理：支持100个并发请求
|
||
- 数据处理：能处理10000条对账记录/小时
|
||
|
||
## 安全要求
|
||
|
||
- 权限控制：只有FINANCE角色可访问财务数据
|
||
- 数据加密：敏感财务数据加密存储
|
||
- 审计日志：所有财务操作需记录详细日志
|
||
- 输入验证：严格验证所有财务数据输入 |