完善接口和后台页面
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);
|
||||
}
|
||||
}
|
||||
164
app/common/library/finance/WithdrawFlow.php
Normal file
164
app/common/library/finance/WithdrawFlow.php
Normal file
@@ -0,0 +1,164 @@
|
||||
<?php
|
||||
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace app\common\library\finance;
|
||||
|
||||
use support\think\Db;
|
||||
|
||||
/**
|
||||
* 提现打码量（流水）门槛工具库
|
||||
*
|
||||
* 业务口径（打码量即提现配额模型）：
|
||||
* - 每笔提现消耗等额打码配额：折算 = withdraw_coin × ratio
|
||||
* - lifetime_withdrawable_from_flow = bet_flow_coin / ratio
|
||||
* - max_withdraw_by_flow = max(0, lifetime_withdrawable_from_flow - total_withdraw_coin)
|
||||
* - 单笔上限：max_withdrawable = min(coin_balance, max_withdraw_by_flow)
|
||||
* - ratio 来自 game_config.withdraw_bet_flow_ratio；ratio = 0 代表不限制打码量，此时
|
||||
* max_withdraw_by_flow 视为"无限大"（由 UNLIMITED_FLOW 哨兵值表示，API 层兜底用余额）
|
||||
*
|
||||
* 向后兼容：原门槛 bet_flow_coin >= (total_deposit - total_withdraw) × ratio 已被
|
||||
* "单笔上限 ≤ max_withdraw_by_flow" 取代且语义等价更细腻：任何通过新校验的请求必然
|
||||
* 也满足旧门槛口径。字段 required_bet_flow / remaining_bet_flow / eligible 保留仅作展示。
|
||||
*/
|
||||
final class WithdrawFlow
|
||||
{
|
||||
public const CONFIG_KEY = 'withdraw_bet_flow_ratio';
|
||||
|
||||
public const DEFAULT_RATIO = '1.0000';
|
||||
|
||||
/** 当 ratio = 0（不限打码）时，max_withdraw_by_flow 用此哨兵表示"无限"。14 位整数位足够覆盖任何业务金额。 */
|
||||
public const UNLIMITED_FLOW = '99999999999999.9999';
|
||||
|
||||
/** 单用户最多允许同时存在的「待审核」(withdraw_order.status=0) 提现订单数。 */
|
||||
public const MAX_PENDING_WITHDRAW = 3;
|
||||
|
||||
/**
|
||||
* 读取当前打码倍数（字符串 4 位小数，至少 0）
|
||||
*/
|
||||
public static function ratio(): string
|
||||
{
|
||||
$row = Db::name('game_config')->where('config_key', self::CONFIG_KEY)->find();
|
||||
if (!$row) {
|
||||
return self::DEFAULT_RATIO;
|
||||
}
|
||||
$val = $row['config_value'] ?? '';
|
||||
if (!is_string($val) || trim($val) === '' || !is_numeric(trim($val))) {
|
||||
return self::DEFAULT_RATIO;
|
||||
}
|
||||
$normalized = bcadd(trim($val), '0', 4);
|
||||
if (bccomp($normalized, '0', 4) < 0) {
|
||||
return '0.0000';
|
||||
}
|
||||
return $normalized;
|
||||
}
|
||||
|
||||
/**
|
||||
* 归一化金额字段到 4 位小数字符串，非法输入返回 '0.0000'
|
||||
*/
|
||||
public static function amountString($raw): string
|
||||
{
|
||||
if ($raw === null || $raw === '') {
|
||||
return '0.0000';
|
||||
}
|
||||
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);
|
||||
}
|
||||
|
||||
/**
|
||||
* 核算玩家当前打码量状态
|
||||
*
|
||||
* @param array{
|
||||
* total_deposit_coin?: mixed,
|
||||
* total_withdraw_coin?: mixed,
|
||||
* bet_flow_coin?: mixed,
|
||||
* }|null $userSnapshot 允许外部传入字典（节省一次查询）；为 null 时按 $userId 从库取
|
||||
*
|
||||
* @return array{
|
||||
* ratio: string,
|
||||
* net_deposit: string,
|
||||
* required_bet_flow: string,
|
||||
* bet_flow_coin: string,
|
||||
* remaining_bet_flow: string,
|
||||
* eligible: bool,
|
||||
* max_withdraw_by_flow: string,
|
||||
* flow_unlimited: bool,
|
||||
* }
|
||||
*/
|
||||
public static function status(?int $userId, ?array $userSnapshot = null): array
|
||||
{
|
||||
if ($userSnapshot === null && $userId !== null) {
|
||||
$userSnapshot = Db::name('user')
|
||||
->field(['total_deposit_coin', 'total_withdraw_coin', 'bet_flow_coin'])
|
||||
->where('id', $userId)
|
||||
->find();
|
||||
}
|
||||
$userSnapshot = is_array($userSnapshot) ? $userSnapshot : [];
|
||||
|
||||
$deposit = self::amountString($userSnapshot['total_deposit_coin'] ?? '0');
|
||||
$withdraw = self::amountString($userSnapshot['total_withdraw_coin'] ?? '0');
|
||||
$flow = self::amountString($userSnapshot['bet_flow_coin'] ?? '0');
|
||||
|
||||
$net = bcsub($deposit, $withdraw, 4);
|
||||
if (bccomp($net, '0', 4) < 0) {
|
||||
$net = '0.0000';
|
||||
}
|
||||
|
||||
$ratio = self::ratio();
|
||||
$required = bcmul($net, $ratio, 4);
|
||||
$remaining = bcsub($required, $flow, 4);
|
||||
if (bccomp($remaining, '0', 4) < 0) {
|
||||
$remaining = '0.0000';
|
||||
}
|
||||
$eligible = bccomp($flow, $required, 4) >= 0;
|
||||
|
||||
// max_withdraw_by_flow = max(0, bet_flow_coin / ratio - total_withdraw_coin)
|
||||
$unlimited = bccomp($ratio, '0', 4) === 0;
|
||||
if ($unlimited) {
|
||||
$maxByFlow = self::UNLIMITED_FLOW;
|
||||
} else {
|
||||
$lifetime = bcdiv($flow, $ratio, 4);
|
||||
$maxByFlow = bcsub($lifetime, $withdraw, 4);
|
||||
if (bccomp($maxByFlow, '0', 4) < 0) {
|
||||
$maxByFlow = '0.0000';
|
||||
}
|
||||
}
|
||||
|
||||
return [
|
||||
'ratio' => $ratio,
|
||||
'net_deposit' => $net,
|
||||
'required_bet_flow' => $required,
|
||||
'bet_flow_coin' => $flow,
|
||||
'remaining_bet_flow' => $remaining,
|
||||
'eligible' => $eligible,
|
||||
'max_withdraw_by_flow' => $maxByFlow,
|
||||
'flow_unlimited' => $unlimited,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 取单笔最大可提现额 = min(coin_balance, max_withdraw_by_flow)。
|
||||
* 返回值为 4 位小数字符串，已与 ratio=0（不限）逻辑兼容。
|
||||
*/
|
||||
public static function maxWithdrawable(string $coinBalance, array $flowStatus): string
|
||||
{
|
||||
$coin = self::amountString($coinBalance);
|
||||
if (bccomp($coin, '0', 4) < 0) {
|
||||
$coin = '0.0000';
|
||||
}
|
||||
if (!empty($flowStatus['flow_unlimited'])) {
|
||||
return $coin;
|
||||
}
|
||||
$byFlow = self::amountString($flowStatus['max_withdraw_by_flow'] ?? '0');
|
||||
return bccomp($coin, $byFlow, 4) <= 0 ? $coin : $byFlow;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user