完善接口和后台页面
This commit is contained in:
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