170 lines
9.0 KiB
PHP
170 lines
9.0 KiB
PHP
<?php
|
|
|
|
namespace App\Services;
|
|
|
|
use App\Enums\PurchasingRole;
|
|
use App\Models\Supplier;
|
|
use App\Models\SupplierBankDetail;
|
|
use App\Models\SupplierBankReview;
|
|
use App\Models\User;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use Illuminate\Database\Eloquent\Collection;
|
|
use Illuminate\Support\Facades\DB;
|
|
use Illuminate\Support\Facades\Schema;
|
|
use Illuminate\Validation\ValidationException;
|
|
|
|
class SupplierBankWorkflow
|
|
{
|
|
public function multipleReady(): bool
|
|
{
|
|
return Schema::hasColumn('supplier_bank_details', 'account_key');
|
|
}
|
|
|
|
/** @return Builder<SupplierBankDetail> */
|
|
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<int,SupplierBankDetail> */
|
|
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<string,mixed> $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';
|
|
}
|
|
}
|