*/ public function paginate(?string $status, int $perPage, int $page = 1): LengthAwarePaginator { $q = RiskCapVersion::query()->orderByDesc('id'); if ($status !== null && $status !== '') { $q->where('status', $status); } return $q->paginate($perPage, ['*'], 'page', max(1, $page)); } public function createDraft(AdminUser $admin, ?string $reason, ?int $cloneFromVersionId): RiskCapVersion { $nextNo = (int) (RiskCapVersion::query()->max('version_no') ?? 0) + 1; return DB::transaction(function () use ($admin, $reason, $cloneFromVersionId, $nextNo): RiskCapVersion { $draft = RiskCapVersion::query()->create([ 'version_no' => $nextNo, 'status' => ConfigVersionStatus::Draft->value, 'effective_at' => null, 'updated_by' => $admin->id, 'reason' => $reason, ]); $source = null; if ($cloneFromVersionId !== null) { $source = RiskCapVersion::query()->whereKey($cloneFromVersionId)->firstOrFail(); } else { $source = RiskCapVersion::query() ->where('status', ConfigVersionStatus::Active->value) ->first(); } if ($source !== null) { foreach ($source->items()->orderBy('normalized_number')->get() as $row) { RiskCapItem::query()->create([ 'version_id' => $draft->id, 'draw_id' => $row->draw_id, 'normalized_number' => $row->normalized_number, 'cap_amount' => $row->cap_amount, 'cap_type' => $row->cap_type, ]); } } else { RiskCapItem::query()->create([ 'version_id' => $draft->id, 'draw_id' => null, 'normalized_number' => '0000', 'cap_amount' => 50_000_000_000, 'cap_type' => 'default', ]); } return $draft->fresh(['items']); }); } /** * @param array> $items */ public function replaceItems(RiskCapVersion $draft, array $items, AdminUser $admin): void { DB::transaction(function () use ($draft, $items, $admin): void { RiskCapItem::query()->where('version_id', $draft->id)->delete(); foreach ($items as $row) { RiskCapItem::query()->create([ 'version_id' => $draft->id, 'draw_id' => isset($row['draw_id']) ? (int) $row['draw_id'] : null, 'normalized_number' => (string) $row['normalized_number'], 'cap_amount' => (int) $row['cap_amount'], 'cap_type' => (string) $row['cap_type'], ]); } $draft->forceFill(['updated_by' => $admin->id])->save(); }); } public function publish(RiskCapVersion $draft, AdminUser $admin, ?Request $request = null): void { $this->validatePublishableDraft($draft); $before = $this->snapshotVersion($draft); DB::transaction(function () use ($draft, $admin): void { /** @var RiskCapVersion|null $current */ $current = RiskCapVersion::query() ->where('status', ConfigVersionStatus::Active->value) ->lockForUpdate() ->first(); if ($current !== null) { $current->forceFill(['status' => ConfigVersionStatus::Archived->value])->save(); } $draft->forceFill([ 'status' => ConfigVersionStatus::Active->value, 'effective_at' => now(), 'updated_by' => $admin->id, ])->save(); }); $after = $this->snapshotVersion($draft->fresh(['items'])); AuditLogger::recordForAdmin( $admin, $request, moduleCode: 'risk_cap', actionCode: 'publish', targetType: 'risk_cap_version', targetId: (string) $draft->id, beforeJson: $before, afterJson: $after, ); } public function deleteVersion(RiskCapVersion $version, AdminUser $admin, ?Request $request = null): void { $before = $this->snapshotVersion($version); DB::transaction(function () use ($version): void { $version->delete(); }); AuditLogger::recordForAdmin( $admin, $request, moduleCode: 'risk_cap', actionCode: 'delete', targetType: 'risk_cap_version', targetId: (string) $version->id, beforeJson: $before, afterJson: null, ); } /** @return array */ private function snapshotVersion(RiskCapVersion $v): array { return [ 'id' => $v->id, 'version_no' => $v->version_no, 'status' => $v->status, 'effective_at' => $v->effective_at?->toIso8601String(), 'items_count' => $v->items()->count(), ]; } private function validatePublishableDraft(RiskCapVersion $draft): void { $items = $draft->items()->orderBy('draw_id')->orderBy('normalized_number')->get(); $errors = []; $seenKeys = []; if ($items->isEmpty()) { $errors['items'][] = '草稿至少需要一条封顶配置'; } foreach ($items as $index => $row) { $normalizedNumber = (string) $row->normalized_number; $capAmount = (int) $row->cap_amount; $drawId = $row->draw_id === null ? '__null__' : (string) $row->draw_id; $capType = (string) $row->cap_type; $key = $capType === 'default' ? 'default|'.$drawId : $drawId.'|'.$normalizedNumber; if (! preg_match('/^[0-9]{4}$/', $normalizedNumber)) { $errors["items.$index.normalized_number"][] = '号码必须是 4 位数字'; } if ($capAmount <= 0) { $errors["items.$index.cap_amount"][] = '封顶金额必须大于 0'; } if ($capType === 'default' && $row->draw_id !== null) { $errors["items.$index.cap_type"][] = '默认封顶不能绑定具体期号'; } if (isset($seenKeys[$key])) { $errors["items.$index"][] = '同一期号与号码存在重复封顶配置'; } $seenKeys[$key] = true; } if ($errors !== []) { throw ValidationException::withMessages($errors); } } }