*/ public function account(Supplier $supplier, ?string $key = null): Builder { $query = SupplierBankDetail::query()->where('tenant_id', $supplier->tenant_id)->where('supplier_id', $supplier->id); if ($this->multipleReady()) { $query->where('account_key', $key); } else { abort_unless($key === null, 503, 'A estrutura de contas independentes ainda não está instalada.'); } return $query; } public function latest(Supplier $supplier, ?string $key = null): ?SupplierBankDetail { return $this->account($supplier, $key)->latest('revision')->first(); } /** @return Collection */ public function currentAccounts(Supplier $supplier): Collection { $query = SupplierBankDetail::query()->where('tenant_id', $supplier->tenant_id)->where('supplier_id', $supplier->id); if (! $this->multipleReady()) { return $query->latest('revision')->limit(1)->get(); } return $query->whereIn('revision', fn ($q) => $q->from('supplier_bank_details')->where('tenant_id', $supplier->tenant_id) ->where('supplier_id', $supplier->id)->groupBy('account_key')->selectRaw('MAX(revision)')) ->orderBy('revision')->get(); } private function actor(User $user, Supplier $supplier): void { abort_unless(auth()->id() === $user->id && $user->tenant_id !== null && $supplier->tenant_id === $user->tenant_id, 403); abort_if(app(OrganizationAccess::class)->maintenanceOnly($user), 403); if (app(ConflictGuard::class)->hasConflict($user->id, $supplier->id, null)) { throw ValidationException::withMessages(['bank' => 'Conflito de interesses com este fornecedor.']); } } /** @param array $data */ public function propose(User $user, Supplier $supplier, array $data): SupplierBankDetail { $this->actor($user, $supplier); abort_unless($user->hasFunctions([PurchasingRole::Procurement]), 403); return DB::transaction(function () use ($user, $supplier, $data) { app(ConflictGuard::class)->lockCompany($user); $user = app(CurrentActor::class)->lock($user, [PurchasingRole::Procurement]); $supplier = Supplier::query()->lockForUpdate()->findOrFail($supplier->id); $this->actor($user, $supplier); $key = validator($data, ['account_key' => 'nullable|uuid'])->validate()['account_key'] ?? null; $key = $key === null ? null : strtolower($key); $latest = $this->latest($supplier, $key); $fields = ['bank_name', 'country', 'currency', 'beneficiary', 'account_identifier', 'evidence_reference', 'reason']; if ($key !== null && (int) $data['previous_id'] === 0 && $latest !== null) { $original = $this->account($supplier, $key)->oldest('revision')->firstOrFail(); if ($original->created_by === $user->id && array_map(fn ($field) => $original->$field, $fields) === array_map(fn ($field) => $data[$field] ?? null, $fields)) { return $original; } throw ValidationException::withMessages(['account_key' => 'A identidade desta conta já foi utilizada com outros dados.']); } if ((int) $data['previous_id'] !== ($latest->id ?? 0)) { throw ValidationException::withMessages(['previous_id' => 'Dados bancários alterados. Reabra a ficha antes de propor outra versão.']); } $revision = (int) SupplierBankDetail::query()->where('supplier_id', $supplier->id)->max('revision') + 1; $detail = SupplierBankDetail::query()->create(['tenant_id' => $user->tenant_id, 'supplier_id' => $supplier->id, 'created_by' => $user->id, 'revision' => $revision, ...($key === null ? [] : ['account_key' => $key]), ...array_intersect_key($data, array_flip($fields)), 'created_at' => now()]); app(RequisitionWorkflow::class)->audit($user, 'supplier.bank_proposed', null, null, ['supplier_id' => $supplier->id, 'bank_detail_id' => $detail->id, 'revision' => $detail->revision]); return $detail; }); } public function review(User $user, SupplierBankDetail $detail, string $decision, string $reason): void { abort_unless($user->hasFunctions([PurchasingRole::Finance]) && $detail->tenant_id === $user->tenant_id && $detail->created_by !== $user->id, 403); if (! in_array($decision, ['approved', 'rejected']) || trim($reason) === '') { throw ValidationException::withMessages(['bank' => 'Decisão e fundamento obrigatórios.']); } DB::transaction(function () use ($user, $detail, $decision, $reason) { app(ConflictGuard::class)->lockCompany($user); $user = app(CurrentActor::class)->lock($user, [PurchasingRole::Finance]); $supplier = Supplier::query()->lockForUpdate()->findOrFail($detail->supplier_id); $this->actor($user, $supplier); $latest = $this->latest($supplier, $detail->account_key); if ($latest === null || $latest->id !== $detail->id) { throw ValidationException::withMessages(['bank' => 'Versão substituída. Reveja os dados bancários actuais.']); } $existing = SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->where('reviewed_by', $user->id)->first(); if ($existing) { if ($existing->decision !== $decision || $existing->reason !== $reason) { throw ValidationException::withMessages(['bank' => 'A decisão anterior é imutável. Proponha nova versão para corrigir dados.']); } return; } if (! $supplier->eligible() || SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->where('decision', 'rejected')->exists() || SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->count() >= 2) { throw ValidationException::withMessages(['bank' => 'Fornecedor não elegível ou versão já decidida.']); } SupplierBankReview::query()->create(['tenant_id' => $user->tenant_id, 'supplier_bank_detail_id' => $detail->id, 'reviewed_by' => $user->id, 'decision' => $decision, 'reason' => $reason, 'created_at' => now()]); app(RequisitionWorkflow::class)->audit($user, 'supplier.bank_'.$decision, null, null, ['supplier_id' => $supplier->id, 'bank_detail_id' => $detail->id]); }); } /** Re-evaluate inside the payment transaction in the future; UI readiness is not authorisation. */ public function state(Supplier $supplier, ?string $key = null): string { $detail = $this->latest($supplier, $key); if (! $detail) { return 'missing'; } $reviews = SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->get(); if ($reviews->contains('decision', 'rejected')) { return 'rejected'; } if ($reviews->count() < 2) { return 'pending'; } if (! $supplier->eligible() || app(ConflictGuard::class)->hasConflict($detail->created_by, $supplier->id, null)) { return 'blocked'; } foreach ($reviews as $review) { $user = User::query()->where('tenant_id', $supplier->tenant_id)->find($review->reviewed_by); if (! $user || ! $user->hasFunctions([PurchasingRole::Finance]) || $user->id === $detail->created_by || app(ConflictGuard::class)->hasConflict($user->id, $supplier->id, null)) { return 'blocked'; } } return 'approved'; } public function canReview(User $actor, SupplierBankDetail $detail): bool { if ($actor->tenant_id !== $detail->tenant_id || $actor->id === $detail->created_by || ! $actor->hasFunctions([PurchasingRole::Finance]) || app(OrganizationAccess::class)->maintenanceOnly($actor) || SupplierBankReview::query()->where('supplier_bank_detail_id', $detail->id)->where('reviewed_by', $actor->id)->exists()) { return false; } $supplier = Supplier::query()->find($detail->supplier_id); return $supplier !== null && $supplier->eligible() && $this->latest($supplier, $detail->account_key)?->id === $detail->id && ! app(ConflictGuard::class)->hasConflict($actor->id, $supplier->id, null) && $this->state($supplier, $detail->account_key) === 'pending'; } }