feat(finance): P2 手动退款登记与成本异常闭环

- 迁移 112:order_refunds(订单项级退款,整单拆多条共享 batch_no,source/external_ref 预留平台 API)+ cost_exceptions.resolution_note
- 新服务 order-refund-service:整单/指定商品退款、可退金额校验、撤销、全额退完同步 pay_status
- 销售事实改为按有效退款记录冲减;无记录时仍兼容 pay_status=refunded 的历史全额退款
- 订单详情新增退款登记与退款记录表,商品明细显示收入/已退/可退
- 全额退款自动关闭该订单项成本异常并写处理备注;成本异常处理改为带备注弹窗
- 财务事件 UNION 接入退款记录,文档同步 P2 状态与 API
This commit is contained in:
yml2213
2026-10-24 17:18:51 +08:00
parent a78cc1f984
commit faf56e567e
18 changed files with 1127 additions and 48 deletions
@@ -273,6 +273,7 @@ export type CostExceptionRow = {
created_at: string
resolved_at: string | null
resolved_by_admin_user_id: number | null
resolution_note: string
}
export type OrderItemCostContext = {
@@ -557,6 +558,7 @@ export function mapCostException(row: CostExceptionRow) {
resolvedByAdminUserId: row.resolved_by_admin_user_id
? Number(row.resolved_by_admin_user_id)
: null,
resolutionNote: row.resolution_note || '',
}
}
@@ -724,14 +724,18 @@ export async function resolveAdminCostException(
})
}
const now = nowIso()
const note = text(payload.note ?? payload.resolutionNote ?? payload.resolution_note).slice(0, 300)
const result = await query<CostExceptionRow>(
`
UPDATE cost_exceptions
SET status = $1, resolved_at = $2, resolved_by_admin_user_id = $3
SET status = $1,
resolved_at = $2,
resolved_by_admin_user_id = $3,
resolution_note = $5
WHERE id = $4
RETURNING *
`,
[status, now, session.userId, id],
[status, now, session.userId, id, note],
)
return { exception: mapCostException(requiredRow(result.rows[0], '成本异常不存在')) }
}