完善接口和后台页面
This commit is contained in:
218
app/common/library/finance/DepositSettlement.php
Normal file
218
app/common/library/finance/DepositSettlement.php
Normal file
@@ -0,0 +1,218 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace app\common\library\finance;
|
||||
|
||||
use RuntimeException;
|
||||
use support\think\Db;
|
||||
use Throwable;
|
||||
|
||||
/**
|
||||
* 充值订单结算公共库
|
||||
*
|
||||
* 所有"把 deposit_order 变为成功并给玩家钱包加币"的逻辑必须收敛到这里，
|
||||
* 以便 mock 支付瞬时成功、未来第三方网关回调、历史数据的人工补单共用同一事务边界。
|
||||
*
|
||||
* 关键约束：
|
||||
* - 只结算 status=0 的订单，幂等；重复调用同一订单返回现有结算结果；
|
||||
* - 钱包流水 user_wallet_record 以 "deposit_settle_{order_no}" 为 idempotency_key，保证不重复入账；
|
||||
* - 同时更新 user.coin 与 update_time，user_wallet_record 记录 balance_before/after 快照。
|
||||
*/
|
||||
final class DepositSettlement
|
||||
{
|
||||
public const SOURCE_MOCK_GATEWAY = 'mock_gateway';
|
||||
|
||||
public const SOURCE_ADMIN_APPROVE = 'admin_approve';
|
||||
|
||||
public const SOURCE_THIRD_PARTY = 'third_party';
|
||||
|
||||
/**
|
||||
* 结算指定订单。
|
||||
*
|
||||
* @param int $orderId deposit_order.id
|
||||
* @param string $source 来源（SOURCE_* 常量），写入 remark
|
||||
* @param string $sourceLabel 人类可读描述，写入 remark，如 "mock gateway auto settled"
|
||||
* @param int|null $operatorAdminId 操作管理员 ID（仅管理员审核时有值）
|
||||
* @param string|null $extraRemark 追加到订单 remark（可选）
|
||||
*
|
||||
* @return array{
|
||||
* order_id: int,
|
||||
* order_no: string,
|
||||
* amount: string,
|
||||
* balance_before: string,
|
||||
* balance_after: string,
|
||||
* pay_time: int,
|
||||
* already_settled: bool,
|
||||
* }
|
||||
*
|
||||
* @throws RuntimeException 订单不存在、金额非法、并发冲突等
|
||||
*/
|
||||
public static function settle(
|
||||
int $orderId,
|
||||
string $source,
|
||||
string $sourceLabel,
|
||||
?int $operatorAdminId = null,
|
||||
?string $extraRemark = null
|
||||
): array {
|
||||
if ($orderId <= 0) {
|
||||
throw new RuntimeException('订单 ID 非法');
|
||||
}
|
||||
|
||||
$order = Db::name('deposit_order')->where('id', $orderId)->find();
|
||||
if (!$order) {
|
||||
throw new RuntimeException('订单不存在');
|
||||
}
|
||||
|
||||
$orderNo = is_string($order['order_no']) ? $order['order_no'] : strval($order['order_no']);
|
||||
if ($orderNo === '') {
|
||||
throw new RuntimeException('订单号为空');
|
||||
}
|
||||
|
||||
$statusRaw = $order['status'] ?? 0;
|
||||
$status = is_numeric($statusRaw) ? intval($statusRaw) : 0;
|
||||
|
||||
// 如果已结算，直接返回已有结果（幂等）
|
||||
if ($status === 1) {
|
||||
$userId = is_numeric($order['user_id'] ?? null) ? intval($order['user_id']) : 0;
|
||||
$coinAfter = '0.0000';
|
||||
if ($userId > 0) {
|
||||
$coin = Db::name('user')->where('id', $userId)->value('coin');
|
||||
$coinAfter = is_string($coin) ? $coin : strval($coin);
|
||||
}
|
||||
$amt = self::amountString($order['amount'] ?? '0');
|
||||
$bns = self::amountString($order['bonus_amount'] ?? '0');
|
||||
return [
|
||||
'order_id' => $orderId,
|
||||
'order_no' => $orderNo,
|
||||
'amount' => $amt,
|
||||
'bonus_amount' => $bns,
|
||||
'credit' => bcadd($amt, $bns, 4),
|
||||
'balance_before' => $coinAfter,
|
||||
'balance_after' => $coinAfter,
|
||||
'pay_time' => is_numeric($order['pay_time'] ?? null) ? intval($order['pay_time']) : 0,
|
||||
'already_settled' => true,
|
||||
];
|
||||
}
|
||||
|
||||
if ($status !== 0) {
|
||||
throw new RuntimeException('订单状态不允许结算');
|
||||
}
|
||||
|
||||
$amount = self::amountString($order['amount'] ?? '0');
|
||||
if (bccomp($amount, '0', 4) <= 0) {
|
||||
throw new RuntimeException('订单金额异常');
|
||||
}
|
||||
$bonus = self::amountString($order['bonus_amount'] ?? '0');
|
||||
if (bccomp($bonus, '0', 4) < 0) {
|
||||
$bonus = '0.0000';
|
||||
}
|
||||
$credit = bcadd($amount, $bonus, 4);
|
||||
|
||||
$userId = is_numeric($order['user_id'] ?? null) ? intval($order['user_id']) : 0;
|
||||
if ($userId <= 0) {
|
||||
throw new RuntimeException('订单所属玩家无效');
|
||||
}
|
||||
|
||||
$user = Db::name('user')->where('id', $userId)->find();
|
||||
if (!$user) {
|
||||
throw new RuntimeException('玩家不存在');
|
||||
}
|
||||
|
||||
$channelId = is_numeric($order['channel_id'] ?? null) ? intval($order['channel_id']) : null;
|
||||
$balanceBefore = self::amountString($user['coin'] ?? '0');
|
||||
$balanceAfter = bcadd($balanceBefore, $credit, 4);
|
||||
|
||||
$now = time();
|
||||
$baseRemark = is_string($order['remark'] ?? null) ? $order['remark'] : '';
|
||||
// 备注包含充值与赠送的明细，方便后续稽核
|
||||
$detail = sprintf('amount=%s,bonus=%s,credit=%s', $amount, $bonus, $credit);
|
||||
$note = sprintf('[%s] %s (%s)', $source, $sourceLabel, $detail);
|
||||
$combined = $baseRemark === '' ? $note : ($baseRemark . ' | ' . $note);
|
||||
if ($extraRemark !== null && $extraRemark !== '') {
|
||||
$combined .= ' | ' . $extraRemark;
|
||||
}
|
||||
$finalRemark = mb_substr($combined, 0, 255);
|
||||
|
||||
$walletIdem = 'deposit_settle_' . $orderNo;
|
||||
|
||||
Db::startTrans();
|
||||
try {
|
||||
$affected = Db::name('deposit_order')
|
||||
->where('id', $orderId)
|
||||
->where('status', 0)
|
||||
->update([
|
||||
'status' => 1,
|
||||
'pay_time' => $now,
|
||||
'review_admin_id' => $operatorAdminId,
|
||||
'review_time' => $operatorAdminId !== null ? $now : null,
|
||||
'remark' => $finalRemark,
|
||||
'update_time' => $now,
|
||||
]);
|
||||
if ($affected <= 0) {
|
||||
throw new RuntimeException('订单状态已变更，请刷新后重试');
|
||||
}
|
||||
|
||||
Db::name('user')->where('id', $userId)->update([
|
||||
'coin' => $balanceAfter,
|
||||
'update_time' => $now,
|
||||
]);
|
||||
|
||||
$walletExists = Db::name('user_wallet_record')
|
||||
->where('idempotency_key', $walletIdem)
|
||||
->value('id');
|
||||
if (!$walletExists) {
|
||||
Db::name('user_wallet_record')->insert([
|
||||
'user_id' => $userId,
|
||||
'channel_id' => $channelId,
|
||||
'biz_type' => 'deposit',
|
||||
'direction' => 1,
|
||||
'amount' => $credit,
|
||||
'balance_before' => $balanceBefore,
|
||||
'balance_after' => $balanceAfter,
|
||||
'ref_type' => 'deposit_order',
|
||||
'ref_id' => $orderId,
|
||||
'idempotency_key' => $walletIdem,
|
||||
'operator_admin_id' => $operatorAdminId,
|
||||
'remark' => mb_substr($note, 0, 500),
|
||||
'create_time' => $now,
|
||||
]);
|
||||
}
|
||||
|
||||
Db::commit();
|
||||
} catch (Throwable $e) {
|
||||
Db::rollback();
|
||||
throw new RuntimeException($e->getMessage());
|
||||
}
|
||||
|
||||
return [
|
||||
'order_id' => $orderId,
|
||||
'order_no' => $orderNo,
|
||||
'amount' => $amount,
|
||||
'bonus_amount' => $bonus,
|
||||
'credit' => $credit,
|
||||
'balance_before' => $balanceBefore,
|
||||
'balance_after' => $balanceAfter,
|
||||
'pay_time' => $now,
|
||||
'already_settled' => false,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 将任意数值输入格式化为 4 位小数字符串（不做强制类型转换）
|
||||
*/
|
||||
private static function amountString($raw): string
|
||||
{
|
||||
if (is_string($raw)) {
|
||||
$s = trim($raw);
|
||||
} elseif (is_int($raw) || is_float($raw)) {
|
||||
$s = strval($raw);
|
||||
} else {
|
||||
return '0.0000';
|
||||
}
|
||||
if (!is_numeric($s)) {
|
||||
return '0.0000';
|
||||
}
|
||||
return bcadd($s, '0', 4);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user