wurenzhi/makemd

Files

wurenzhi 48a78137c5 refactor(terminology): 统一术语标准并优化代码类型安全

- 将B2B统一为TOB术语
- 将状态值统一为大写格式
- 优化类型声明，避免使用any
- 将float类型替换为decimal以提高精度
- 新增术语标准化文档
- 优化路由结构和菜单分类
- 添加TypeORM实体类
- 增强加密模块安全性
- 重构前端路由结构
- 完善任务模板和验收标准

2026-03-20 09:43:50 +08:00

4.0 KiB

Raw Blame History

财务管理后端任务

任务列表

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 - 计算利润

验收标准

对账接口能正确处理不同平台的对账数据
回款管理接口能准确记录回款信息
利润计算接口能正确计算订单利润和利润率
所有接口响应时间不超过2秒
数据一致性得到保证，无重复或丢失数据

测试要求

单元测试：覆盖核心计算逻辑
集成测试：验证与订单系统的交互
端到端测试：模拟完整的财务流程
边界测试：测试异常数据和边界情况

风险提示

风险点1：对账数据量大导致性能问题 - 应对措施：实现分页和异步处理
风险点2：多平台数据格式不一致 - 应对措施：统一数据转换层
风险点3：回款状态更新不及时 - 应对措施：实现定时同步机制

性能要求

响应时间：平均响应时间 < 2秒
并发处理：支持100个并发请求
数据处理：能处理10000条对账记录/小时

安全要求

权限控制：只有FINANCE角色可访问财务数据
数据加密：敏感财务数据加密存储
审计日志：所有财务操作需记录详细日志
输入验证：严格验证所有财务数据输入