store/app/Services/Finance/EmployeeAdvanceService.php

<?php

namespace App\Services\Finance;

use App\Enums\EmployeeAdvanceStatus;
use App\Models\EmployeeAdvance;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Support\Facades\DB;
use Illuminate\Validation\ValidationException;

class EmployeeAdvanceService
{
    public function __construct(
        private readonly CashService $cashService,
    ) {}

    /**
     * @return array{outstanding_amount: int, outstanding_amount_formatted: string, outstanding_count: int}
     */
    public function outstandingSummary(): array
    {
        $outstandingAmount = (int) EmployeeAdvance::query()
            ->where('status', EmployeeAdvanceStatus::APPROVED)
            ->sum('amount');

        $outstandingCount = EmployeeAdvance::query()
            ->where('status', EmployeeAdvanceStatus::APPROVED)
            ->count();

        return [
            'outstanding_amount' => $outstandingAmount,
            'outstanding_amount_formatted' => 'Rp '.number_format($outstandingAmount, 0, ',', '.'),
            'outstanding_count' => $outstandingCount,
        ];
    }

    /**
     * @param  array{search: string, sort: string, direction: 'asc'|'desc'}  $tableQuery
     */
    public function paginateForIndex(array $tableQuery): LengthAwarePaginator
    {
        $query = EmployeeAdvance::query()
            ->with(['employee.user.profile', 'rejection'])
            ->when($tableQuery['search'] !== '', function (Builder $query) use ($tableQuery): void {
                $search = $tableQuery['search'];
                $query->where(function (Builder $query) use ($search): void {
                    $query->where('description', 'like', "%{$search}%")
                        ->orWhereHas('employee.user.profile', fn (Builder $query) => $query->where('full_name', 'like', "%{$search}%"))
                        ->orWhereHas('employee.user', fn (Builder $query) => $query->where('username', 'like', "%{$search}%"))
                        ->orWhereHas('rejection', fn (Builder $query) => $query->where('reason', 'like', "%{$search}%"));
                });
            });

        $this->applySorting($query, $tableQuery['sort'], $tableQuery['direction']);

        return $query
            ->paginate(10)
            ->withQueryString();
    }

    /**
     * @param  array{amount: int, description: string, due_date: string}  $validated
     */
    public function create(array $validated): void
    {
        $employee = auth()->user()?->employee;

        if ($employee === null) {
            throw ValidationException::withMessages([
                'employee' => 'Akun Anda tidak terhubung ke data pegawai.',
            ]);
        }

        EmployeeAdvance::create([
            'employee_id' => $employee->id,
            'amount' => (int) $validated['amount'],
            'description' => $validated['description'],
            'due_date' => $validated['due_date'],
            'status' => EmployeeAdvanceStatus::PENDING,
        ]);
    }

    /**
     * @param  array{amount: int, description: string, due_date: string}  $validated
     */
    public function update(EmployeeAdvance $employeeAdvance, array $validated): void
    {
        $this->ensureOwnedBySubmitter($employeeAdvance);
        $this->ensurePending($employeeAdvance, 'Kasbon hanya dapat diubah saat status menunggu.');

        $employeeAdvance->amount = (int) $validated['amount'];
        $employeeAdvance->description = $validated['description'];
        $employeeAdvance->due_date = $validated['due_date'];
        $employeeAdvance->save();
    }

    public function delete(EmployeeAdvance $employeeAdvance): void
    {
        $this->ensureOwnedBySubmitter($employeeAdvance);
        $this->ensurePending($employeeAdvance, 'Kasbon hanya dapat dihapus saat status menunggu.');

        $employeeAdvance->delete();
    }

    public function approve(EmployeeAdvance $employeeAdvance): void
    {
        $this->ensurePending($employeeAdvance, 'Kasbon ini sudah diverifikasi.');

        $user = auth()->user();

        DB::transaction(function () use ($employeeAdvance, $user): void {
            $employeeAdvance->loadMissing('employee.user.profile');

            $description = sprintf(
                'Pencairan kasbon: %s',
                $employeeAdvance->employeeName,
            );

            $cashTransaction = $this->cashService->recordOutgoing(
                $employeeAdvance,
                $employeeAdvance->amount,
                $description,
                $user,
            );

            $employeeAdvance->cash_transaction_id = $cashTransaction->id;
            $employeeAdvance->status = EmployeeAdvanceStatus::APPROVED;
            $employeeAdvance->verified_at = now();
            $employeeAdvance->verified_by_id = $user->id;
            $employeeAdvance->save();
        });
    }

    public function reject(EmployeeAdvance $employeeAdvance, string $reason): void
    {
        $this->ensurePending($employeeAdvance, 'Kasbon ini sudah diverifikasi.');

        $user = auth()->user();

        DB::transaction(function () use ($employeeAdvance, $user, $reason): void {
            $employeeAdvance->status = EmployeeAdvanceStatus::REJECTED;
            $employeeAdvance->verified_at = now();
            $employeeAdvance->verified_by_id = $user->id;
            $employeeAdvance->save();

            $employeeAdvance->rejection()->create([
                'reason' => $reason,
                'rejected_by_id' => $user->id,
            ]);
        });
    }

    public function pay(EmployeeAdvance $employeeAdvance): void
    {
        if ($employeeAdvance->status !== EmployeeAdvanceStatus::APPROVED) {
            throw ValidationException::withMessages([
                'employee_advance' => 'Kasbon hanya dapat dilunasi setelah disetujui.',
            ]);
        }

        $user = auth()->user();

        DB::transaction(function () use ($employeeAdvance, $user): void {
            $employeeAdvance->loadMissing('employee.user.profile');

            $description = sprintf(
                'Pelunasan kasbon: %s',
                $employeeAdvance->employeeName,
            );

            $cashTransaction = $this->cashService->recordIncoming(
                $employeeAdvance,
                $employeeAdvance->amount,
                $description,
                $user,
            );

            $employeeAdvance->repayment_cash_transaction_id = $cashTransaction->id;
            $employeeAdvance->paid_at = now();
            $employeeAdvance->paid_by_id = $user->id;
            $employeeAdvance->status = EmployeeAdvanceStatus::PAID;
            $employeeAdvance->save();
        });
    }

    private function ensureOwnedBySubmitter(EmployeeAdvance $employeeAdvance): void
    {
        if (auth()->user()?->employee?->id !== $employeeAdvance->employee_id) {
            throw ValidationException::withMessages([
                'employee_advance' => 'Anda tidak memiliki akses untuk mengubah kasbon ini.',
            ]);
        }
    }

    private function ensurePending(EmployeeAdvance $employeeAdvance, string $message): void
    {
        if ($employeeAdvance->status !== EmployeeAdvanceStatus::PENDING) {
            throw ValidationException::withMessages([
                'employee_advance' => $message,
            ]);
        }
    }

    private function applySorting(Builder $query, string $sort, string $direction): void
    {
        if (in_array($sort, ['created_at', 'amount', 'due_date', 'status', 'description'], true)) {
            $query->orderBy($sort, $direction);

            return;
        }

        $query->latest();
    }
}