kang
a44679665d
- 在多个控制器中更新权限检查逻辑，确保管理员能够更灵活地管理代理和玩家。 - 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。 - 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。 - 在 AgentNodeProfileController 中添加对父代理能力授予的验证，确保子代理的权限在父代理范围内。 - 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义，提升代码复用性。
126 lines
4.4 KiB
PHP
126 lines
4.4 KiB
PHP
<?php
|
||
|
||
namespace App\Services\AgentSettlement;
|
||
|
||
use Illuminate\Support\Facades\DB;
|
||
use Illuminate\Validation\ValidationException;
|
||
|
||
/** 坏账核销：原账单保留，记 bad_debt 调整与归档单（§2、§21.1）。 */
|
||
final class AgentSettlementBadDebtService
|
||
{
|
||
public function __construct(
|
||
private readonly AgentSettlementPeriodCompletionService $periodCompletion,
|
||
) {}
|
||
|
||
public function writeOff(int $originalBillId, ?string $reason, int $adminUserId): int
|
||
{
|
||
$original = DB::table('settlement_bills')->where('id', $originalBillId)->first();
|
||
if ($original === null) {
|
||
throw new \InvalidArgumentException('bill_not_found');
|
||
}
|
||
|
||
if ($this->periodCompletion->isPeriodReadOnly((int) $original->settlement_period_id)) {
|
||
throw ValidationException::withMessages([
|
||
'period' => ['completed'],
|
||
]);
|
||
}
|
||
|
||
if (! in_array((string) $original->status, ['confirmed', 'partial_paid', 'overdue'], true)) {
|
||
throw ValidationException::withMessages([
|
||
'bill' => ['not_eligible'],
|
||
]);
|
||
}
|
||
|
||
$unpaid = (int) $original->unpaid_amount;
|
||
if ($unpaid <= 0) {
|
||
throw ValidationException::withMessages([
|
||
'bill' => ['no_unpaid'],
|
||
]);
|
||
}
|
||
|
||
if (in_array((string) $original->bill_type, ['adjustment', 'reversal', 'bad_debt'], true)) {
|
||
throw ValidationException::withMessages([
|
||
'bill' => ['not_eligible'],
|
||
]);
|
||
}
|
||
|
||
return (int) DB::transaction(function () use ($original, $originalBillId, $unpaid, $reason, $adminUserId): int {
|
||
$now = now();
|
||
$periodId = (int) $original->settlement_period_id;
|
||
|
||
$archiveBillId = (int) DB::table('settlement_bills')->insertGetId([
|
||
'settlement_period_id' => $periodId,
|
||
'bill_type' => 'bad_debt',
|
||
'owner_type' => (string) $original->owner_type,
|
||
'owner_id' => (int) $original->owner_id,
|
||
'counterparty_type' => (string) $original->counterparty_type,
|
||
'counterparty_id' => (int) $original->counterparty_id,
|
||
'gross_win_loss' => 0,
|
||
'rebate_amount' => 0,
|
||
'adjustment_amount' => -$unpaid,
|
||
'platform_rounding_adjustment' => 0,
|
||
'net_amount' => 0,
|
||
'paid_amount' => 0,
|
||
'unpaid_amount' => 0,
|
||
'status' => 'settled',
|
||
'reversed_bill_id' => $originalBillId,
|
||
'meta_json' => json_encode([
|
||
'original_bill_id' => $originalBillId,
|
||
'written_off_amount' => $unpaid,
|
||
'original_net_amount' => (int) $original->net_amount,
|
||
]),
|
||
'locked_at' => $now,
|
||
'confirmed_at' => $now,
|
||
'created_at' => $now,
|
||
'updated_at' => $now,
|
||
]);
|
||
|
||
DB::table('settlement_adjustments')->insert([
|
||
'settlement_period_id' => $periodId,
|
||
'original_bill_id' => $originalBillId,
|
||
'adjustment_type' => 'bad_debt',
|
||
'amount' => $unpaid,
|
||
'reason' => $reason,
|
||
'created_by' => $adminUserId > 0 ? $adminUserId : null,
|
||
'created_at' => $now,
|
||
'updated_at' => $now,
|
||
]);
|
||
|
||
DB::table('settlement_bills')->where('id', $originalBillId)->update([
|
||
'unpaid_amount' => 0,
|
||
'status' => 'settled',
|
||
'meta_json' => json_encode(array_merge(
|
||
$this->decodeMeta($original->meta_json),
|
||
[
|
||
'bad_debt_bill_id' => $archiveBillId,
|
||
'written_off_amount' => $unpaid,
|
||
],
|
||
)),
|
||
'updated_at' => $now,
|
||
]);
|
||
|
||
$this->periodCompletion->syncIfReady($periodId);
|
||
|
||
return $archiveBillId;
|
||
});
|
||
}
|
||
|
||
/**
|
||
* @return array<string, mixed>
|
||
*/
|
||
private function decodeMeta(mixed $metaJson): array
|
||
{
|
||
if ($metaJson === null || $metaJson === '') {
|
||
return [];
|
||
}
|
||
|
||
if (is_array($metaJson)) {
|
||
return $metaJson;
|
||
}
|
||
|
||
$decoded = json_decode((string) $metaJson, true);
|
||
|
||
return is_array($decoded) ? $decoded : [];
|
||
}
|
||
}
|