xiaokang/lotteryLaravel
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(core): harden sessions settlement and credit activity
Some checks failed
lotterLaravel CI / test (push) Has been cancelled
Details
lotterLaravel E2E / e2e-api (push) Has been cancelled
Details

Browse Source
This commit is contained in:
wchino
2026-07-22 20:53:43 +08:00
parent 35f6e46958
commit 15bd997c4e
48 changed files with 1920 additions and 93 deletions
Download Patch File Download Diff File Expand all files Collapse all files

505
tests/Feature/CreditWalletLogsTest.php
View File

@@ -3,10 +3,11 @@
use App\Models\Player;
use App\Support\PlayerAuthSource;
use App\Support\PlayerFundingMode;
use Illuminate\Support\Facades\DB;
use Database\Seeders\CurrencySeeder;
use Database\Seeders\LotterySettingsSeeder;
use App\Services\Player\PlayerCreditService;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
uses(RefreshDatabase::class);
@@ -345,3 +346,505 @@ test('credit wallet logs page 2 balance_after continues from page 1 baseline', f
// Page 2 must continue the running balance from page 1, capped by credit limit.
expect($page2FirstBalanceAfter)->toBe(min($page1LastBalanceAfter + 1000, 50000));
});
test('credit player activity merges hold release loss and rebate into one order result', function (): void {
$player = Player::query()->create([
'site_code' => 'default_site',
'site_player_id' => 'native:activity-loss',
'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
'funding_mode' => PlayerFundingMode::CREDIT,
'username' => 'credit_activity_loss',
'default_currency' => 'NPR',
'status' => 0,
]);
DB::table('player_credit_accounts')->insert([
'player_id' => $player->id,
'credit_limit' => 500,
'used_credit' => 21,
'frozen_credit' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
$drawId = (int) DB::table('draws')->insertGetId([
'draw_no' => 'ACTIVITY-LOSS-001',
'business_date' => now()->toDateString(),
'sequence_no' => 1,
'status' => 'settled',
'created_at' => now()->subMinutes(10),
'updated_at' => now(),
]);
$orderId = (int) DB::table('ticket_orders')->insertGetId([
'order_no' => 'ORDER-ACTIVITY-LOSS-001',
'player_id' => $player->id,
'draw_id' => $drawId,
'currency_code' => 'NPR',
'total_bet_amount' => 2100,
'total_rebate_amount' => 0,
'total_actual_deduct' => 2100,
'total_estimated_payout' => 50000,
'status' => 'placed',
'created_at' => now()->subMinutes(10),
'updated_at' => now(),
]);
$ticketItemId = (int) DB::table('ticket_items')->insertGetId([
'ticket_no' => 'TICKET-ACTIVITY-LOSS-001',
'order_id' => $orderId,
'player_id' => $player->id,
'draw_id' => $drawId,
'original_number' => '1234',
'normalized_number' => '1234',
'play_code' => '4d',
'total_bet_amount' => 2100,
'actual_deduct_amount' => 2100,
'status' => 'settled_lose',
'win_amount' => 0,
'jackpot_win_amount' => 0,
'settled_at' => now(),
'created_at' => now()->subMinutes(10),
'updated_at' => now(),
]);
DB::table('share_ledger')->insert([
'ticket_item_id' => $ticketItemId,
'player_id' => $player->id,
'agent_node_id' => null,
'game_win_loss' => 2100,
'basic_rebate' => 11,
'shared_net_win_loss' => 2089,
'settled_at' => now(),
'created_at' => now(),
'updated_at' => now(),
]);
DB::table('rebate_records')->insert([
'player_id' => $player->id,
'ticket_item_id' => $ticketItemId,
'game_type' => '4d',
'valid_bet_amount' => 2100,
'rebate_rate' => 0.0052,
'rebate_amount' => 11,
'rebate_type' => 'basic',
'owner_agent_id' => null,
'status' => 'accrued',
'created_at' => now(),
'updated_at' => now(),
]);
DB::table('credit_ledger')->insert([
[
'owner_type' => 'player',
'owner_id' => $player->id,
'amount' => -2100,
'reason' => 'bet_hold',
'ref_type' => 'ticket_order',
'ref_id' => $orderId,
'created_at' => now()->subMinutes(10),
'updated_at' => now()->subMinutes(10),
],
[
'owner_type' => 'player',
'owner_id' => $player->id,
'amount' => 2100,
'reason' => 'bet_hold_release',
'ref_type' => 'ticket_item',
'ref_id' => $ticketItemId,
'created_at' => now(),
'updated_at' => now(),
],
[
'owner_type' => 'player',
'owner_id' => $player->id,
'amount' => -2100,
'reason' => 'game_settlement_loss',
'ref_type' => 'ticket_item',
'ref_id' => $ticketItemId,
'created_at' => now(),
'updated_at' => now(),
],
]);
$response = $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?page=1&size=10')
->assertOk()
->assertJsonPath('data.total', 1)
->assertJsonPath('data.items.0.activity_kind', 'draw_result')
->assertJsonPath('data.items.0.biz_type', 'settled_loss')
->assertJsonPath('data.items.0.order_no', 'ORDER-ACTIVITY-LOSS-001')
->assertJsonPath('data.items.0.draw_no', 'ACTIVITY-LOSS-001')
->assertJsonPath('data.items.0.ticket_no', 'TICKET-ACTIVITY-LOSS-001')
->assertJsonPath('data.items.0.stake_amount', 2100)
->assertJsonPath('data.items.0.rebate_amount', 11)
->assertJsonPath('data.items.0.net_amount', -2089)
->assertJsonPath('data.items.0.balance_after', 47900);
expect($response->json('data.items'))->toHaveCount(1);
$this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?type=bet')
->assertOk()
->assertJsonPath('data.total', 0);
$newerOrderId = (int) DB::table('ticket_orders')->insertGetId([
'order_no' => 'ORDER-ACTIVITY-PENDING-001',
'player_id' => $player->id,
'draw_id' => $drawId,
'currency_code' => 'NPR',
'total_bet_amount' => 100,
'total_rebate_amount' => 0,
'total_actual_deduct' => 100,
'total_estimated_payout' => 1000,
'status' => 'placed',
'created_at' => now()->addSecond(),
'updated_at' => now()->addSecond(),
]);
DB::table('ticket_items')->insert([
'ticket_no' => 'TICKET-ACTIVITY-PENDING-001',
'order_id' => $newerOrderId,
'player_id' => $player->id,
'draw_id' => $drawId,
'original_number' => '5678',
'normalized_number' => '5678',
'play_code' => '4d',
'total_bet_amount' => 100,
'actual_deduct_amount' => 100,
'status' => 'pending_draw',
'created_at' => now()->addSecond(),
'updated_at' => now()->addSecond(),
]);
DB::table('player_credit_accounts')
->where('player_id', $player->id)
->update(['used_credit' => 22, 'updated_at' => now()]);
$this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?type=game_settlement')
->assertOk()
->assertJsonPath('data.total', 1)
->assertJsonPath('data.items.0.balance_after', 47900);
});
test('credit player activities describe wins refunds and settlement reversals in player terms', function (): void {
$player = Player::query()->create([
'site_code' => 'default_site',
'site_player_id' => 'native:activity-outcomes',
'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
'funding_mode' => PlayerFundingMode::CREDIT,
'username' => 'credit_activity_outcomes',
'default_currency' => 'NPR',
'status' => 0,
]);
DB::table('player_credit_accounts')->insert([
'player_id' => $player->id,
'credit_limit' => 1000,
'used_credit' => 7,
'frozen_credit' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
$drawId = (int) DB::table('draws')->insertGetId([
'draw_no' => 'ACTIVITY-OUTCOMES-001',
'business_date' => now()->toDateString(),
'sequence_no' => 1,
'status' => 'open',
'created_at' => now(),
'updated_at' => now(),
]);
$createOrder = function (
string $orderNo,
string $ticketNo,
string $orderStatus,
string $ticketStatus,
int $stake,
int $minutesAgo,
) use ($player, $drawId): array {
$createdAt = now()->subMinutes($minutesAgo);
$orderId = (int) DB::table('ticket_orders')->insertGetId([
'order_no' => $orderNo,
'player_id' => $player->id,
'draw_id' => $drawId,
'currency_code' => 'NPR',
'total_bet_amount' => $stake,
'total_rebate_amount' => 0,
'total_actual_deduct' => $stake,
'total_estimated_payout' => 5000,
'status' => $orderStatus,
'created_at' => $createdAt,
'updated_at' => $createdAt,
]);
$ticketId = (int) DB::table('ticket_items')->insertGetId([
'ticket_no' => $ticketNo,
'order_id' => $orderId,
'player_id' => $player->id,
'draw_id' => $drawId,
'original_number' => '1234',
'normalized_number' => '1234',
'play_code' => '4d',
'total_bet_amount' => $stake,
'actual_deduct_amount' => $stake,
'status' => $ticketStatus,
'win_amount' => $ticketStatus === 'settled_win' ? 4000 : 0,
'jackpot_win_amount' => 0,
'settled_at' => $ticketStatus === 'settled_win' ? $createdAt : null,
'created_at' => $createdAt,
'updated_at' => $createdAt,
]);
return [$orderId, $ticketId];
};
[, $winningTicketId] = $createOrder(
'ORDER-ACTIVITY-WIN-001',
'TICKET-ACTIVITY-WIN-001',
'placed',
'settled_win',
1000,
3,
);
DB::table('share_ledger')->insert([
'ticket_item_id' => $winningTicketId,
'player_id' => $player->id,
'agent_node_id' => null,
'game_win_loss' => -4000,
'basic_rebate' => 0,
'shared_net_win_loss' => -4000,
'settled_at' => now()->subMinutes(3),
'created_at' => now()->subMinutes(3),
'updated_at' => now()->subMinutes(3),
]);
$createOrder(
'ORDER-ACTIVITY-REFUND-001',
'TICKET-ACTIVITY-REFUND-001',
'refunded',
'refunded',
500,
2,
);
[, $reversedTicketId] = $createOrder(
'ORDER-ACTIVITY-REVERSED-001',
'TICKET-ACTIVITY-REVERSED-001',
'placed',
'pending_draw',
700,
1,
);
$originalShareId = (int) DB::table('share_ledger')->insertGetId([
'ticket_item_id' => $reversedTicketId,
'player_id' => $player->id,
'agent_node_id' => null,
'game_win_loss' => 700,
'basic_rebate' => 0,
'shared_net_win_loss' => 700,
'settled_at' => now()->subMinute(),
'created_at' => now()->subMinute(),
'updated_at' => now()->subMinute(),
]);
DB::table('share_ledger')->insert([
'ticket_item_id' => $reversedTicketId,
'player_id' => $player->id,
'agent_node_id' => null,
'game_win_loss' => -700,
'basic_rebate' => 0,
'shared_net_win_loss' => -700,
'reversal_of_id' => $originalShareId,
'settled_at' => now(),
'created_at' => now(),
'updated_at' => now(),
]);
$items = collect($this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?page=1&size=10')
->assertOk()
->assertJsonPath('data.total', 3)
->json('data.items'))
->keyBy('order_no');
expect($items['ORDER-ACTIVITY-WIN-001']['activity_kind'])->toBe('draw_result')
->and($items['ORDER-ACTIVITY-WIN-001']['biz_type'])->toBe('settled_win')
->and($items['ORDER-ACTIVITY-WIN-001']['win_amount'])->toBe(4000)
->and($items['ORDER-ACTIVITY-WIN-001']['net_amount'])->toBe(4000)
->and($items['ORDER-ACTIVITY-REFUND-001']['activity_kind'])->toBe('refund')
->and($items['ORDER-ACTIVITY-REFUND-001']['biz_type'])->toBe('bet_refund')
->and($items['ORDER-ACTIVITY-REFUND-001']['net_amount'])->toBe(500)
->and($items['ORDER-ACTIVITY-REVERSED-001']['activity_kind'])->toBe('bet')
->and($items['ORDER-ACTIVITY-REVERSED-001']['activity_status'])->toBe('pending')
->and($items['ORDER-ACTIVITY-REVERSED-001']['net_amount'])->toBe(-700);
});
test('credit hold records the real ticket order reference when provided', function (): void {
$player = Player::query()->create([
'site_code' => 'default_site',
'site_player_id' => 'native:hold-order-ref',
'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
'funding_mode' => PlayerFundingMode::CREDIT,
'username' => 'credit_hold_order_ref',
'default_currency' => 'NPR',
'status' => 0,
]);
DB::table('player_credit_accounts')->insert([
'player_id' => $player->id,
'credit_limit' => 500,
'used_credit' => 0,
'frozen_credit' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
app(PlayerCreditService::class)->holdForBet($player, 2100, 77);
$row = DB::table('credit_ledger')->where('owner_id', $player->id)->first();
expect($row?->ref_type)->toBe('ticket_order')
->and((int) $row?->ref_id)->toBe(77);
});
test('credit player activity shows each partial period payment as one player-facing record', function (): void {
$player = Player::query()->create([
'site_code' => 'default_site',
'site_player_id' => 'native:period-payments',
'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
'funding_mode' => PlayerFundingMode::CREDIT,
'username' => 'credit_period_payments',
'default_currency' => 'NPR',
'status' => 0,
]);
DB::table('player_credit_accounts')->insert([
'player_id' => $player->id,
'credit_limit' => 500,
'used_credit' => 0,
'frozen_credit' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
$siteId = (int) DB::table('admin_sites')->where('code', 'default_site')->value('id');
$periodId = (int) DB::table('settlement_periods')->insertGetId([
'admin_site_id' => $siteId,
'period_start' => now()->subWeek(),
'period_end' => now(),
'status' => 'closed',
'created_at' => now(),
'updated_at' => now(),
]);
$billId = (int) DB::table('settlement_bills')->insertGetId([
'settlement_period_id' => $periodId,
'bill_type' => 'player',
'owner_type' => 'player',
'owner_id' => $player->id,
'counterparty_type' => 'agent',
'counterparty_id' => 0,
'net_amount' => 300,
'paid_amount' => 300,
'unpaid_amount' => 0,
'status' => 'settled',
'created_at' => now(),
'updated_at' => now(),
]);
DB::table('payment_records')->insert([
[
'settlement_bill_id' => $billId,
'payer_type' => 'player',
'payer_id' => $player->id,
'payee_type' => 'agent',
'payee_id' => 0,
'amount' => 100,
'status' => 'confirmed',
'confirmed_at' => now()->subMinute(),
'created_at' => now()->subMinute(),
'updated_at' => now()->subMinute(),
],
[
'settlement_bill_id' => $billId,
'payer_type' => 'player',
'payer_id' => $player->id,
'payee_type' => 'agent',
'payee_id' => 0,
'amount' => 200,
'status' => 'confirmed',
'confirmed_at' => now(),
'created_at' => now(),
'updated_at' => now(),
],
]);
$this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?type=bill_settlement')
->assertOk()
->assertJsonPath('data.total', 2)
->assertJsonPath('data.items.0.activity_kind', 'period_settlement')
->assertJsonPath('data.items.0.biz_type', 'period_paid')
->assertJsonPath('data.items.0.net_amount', -200)
->assertJsonPath('data.items.1.net_amount', -100);
});
test('credit player activity paginates after grouping orders', function (): void {
$player = Player::query()->create([
'site_code' => 'default_site',
'site_player_id' => 'native:activity-pages',
'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
'funding_mode' => PlayerFundingMode::CREDIT,
'username' => 'credit_activity_pages',
'default_currency' => 'NPR',
'status' => 0,
]);
DB::table('player_credit_accounts')->insert([
'player_id' => $player->id,
'credit_limit' => 500,
'used_credit' => 11,
'frozen_credit' => 0,
'created_at' => now(),
'updated_at' => now(),
]);
$drawId = (int) DB::table('draws')->insertGetId([
'draw_no' => 'ACTIVITY-PAGE-001',
'business_date' => now()->toDateString(),
'sequence_no' => 1,
'status' => 'open',
'created_at' => now(),
'updated_at' => now(),
]);
for ($i = 1; $i <= 11; $i++) {
$placedAt = now()->subMinutes(11 - $i);
$orderId = (int) DB::table('ticket_orders')->insertGetId([
'order_no' => 'ORDER-ACTIVITY-PAGE-'.$i,
'player_id' => $player->id,
'draw_id' => $drawId,
'currency_code' => 'NPR',
'total_bet_amount' => 100,
'total_rebate_amount' => 0,
'total_actual_deduct' => 100,
'total_estimated_payout' => 1000,
'status' => 'placed',
'created_at' => $placedAt,
'updated_at' => $placedAt,
]);
DB::table('ticket_items')->insert([
'ticket_no' => 'TICKET-ACTIVITY-PAGE-'.$i,
'order_id' => $orderId,
'player_id' => $player->id,
'draw_id' => $drawId,
'original_number' => '1234',
'normalized_number' => '1234',
'play_code' => '4d',
'total_bet_amount' => 100,
'actual_deduct_amount' => 100,
'status' => 'pending_draw',
'created_at' => $placedAt,
'updated_at' => $placedAt,
]);
}
$page1 = $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?page=1&size=10')
->assertOk()
->json('data');
$page2 = $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
->getJson('/api/v1/wallet/logs?page=2&size=10')
->assertOk()
->json('data');
expect($page1['total'])->toBe(11)
->and($page1['items'])->toHaveCount(10)
->and($page2['items'])->toHaveCount(1)
->and($page2['items'][0]['activity_kind'])->toBe('bet');
});