Dev/v1.1 (#2)

Co-authored-by: ISMAIL MASSERAN <topaz@ISMAILs-Macbook.local>
Reviewed-on: #2

be/Modules/MembershipApplication/Services/MembershipApplicationService.php

@@ -3,6 +3,7 @@
 namespace Modules\MembershipApplication\Services;
 
 use App\Services\DocumentService;
+use App\Services\LetterService;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 use Illuminate\Http\UploadedFile;
 use Illuminate\Support\Facades\DB;
@@ -30,6 +31,7 @@ class MembershipApplicationService
     public function __construct(
         protected MembershipApplicationRepositoryInterface $repository,
         protected DocumentService $documentService,
+        protected LetterService $letterService,
     ) {}
 
     /**
@@ -301,6 +303,106 @@ class MembershipApplicationService
         ];
     }
 
+    public function generateResultLetter(MembershipApplication $application, string $boardMeetingReference,): MembershipApplication {
+        if ($application->status !== ApplicationStatus::Completed) {
+            throw ValidationException::withMessages([
+                'status' => ['Surat keputusan hanya boleh dijana untuk permohonan yang telah selesai.'],
+            ]);
+        }
+
+        if (! in_array($application->board_result, [BoardResult::Pass->value, BoardResult::Fail->value], true)) {
+            throw ValidationException::withMessages([
+                'board_result' => ['Keputusan lembaga belum ditetapkan.'],
+            ]);
+        }
+
+        return DB::transaction(function () use ($application, $boardMeetingReference) {
+            $lockedApplication = MembershipApplication::query()
+                ->whereKey($application->id)
+                ->lockForUpdate()
+                ->firstOrFail();
+
+            if ($lockedApplication->hasDocumentsOfType(MembershipApplication::RESULT_LETTER_DOCUMENT_TYPE)) {
+                throw ValidationException::withMessages([
+                    'result_letter' => ['Surat keputusan telah dijana dan tidak boleh dijana semula.'],
+                ]);
+            }
+
+            $application = $this->repository->findByIdWithRelations($lockedApplication->id);
+
+            if (! $application || ! $application->applicant) {
+                throw ValidationException::withMessages([
+                    'application' => ['Maklumat pemohon tidak lengkap.'],
+                ]);
+            }
+
+            $viewData = $this->buildResultLetterViewData($application, $boardMeetingReference);
+            $pdf = $this->letterService->renderPdf('membershipapplication::pdf.approved-letter', $viewData);
+            $fileName = 'surat-keputusan-'.$application->application_number.'.pdf';
+
+            $this->documentService->storeGeneratedDocument(
+                $application,
+                $pdf,
+                $fileName,
+                MembershipApplication::RESULT_LETTER_DOCUMENT_TYPE,
+            );
+
+            return $this->repository->findByIdWithRelations($application->id);
+        });
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function getResultLetterViewData(
+        MembershipApplication $application,
+        string $boardMeetingReference,
+    ): array {
+        $application = $this->repository->findByIdWithRelations($application->id);
+
+        if (! $application || ! $application->applicant) {
+            throw ValidationException::withMessages([
+                'application' => ['Maklumat pemohon tidak lengkap.'],
+            ]);
+        }
+
+        return $this->buildResultLetterViewData($application, $boardMeetingReference);
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function buildResultLetterViewData(
+        MembershipApplication $application,
+        string $boardMeetingReference,
+    ): array {
+        $applicant = $application->applicant;
+        $isPassed = $application->board_result === BoardResult::Pass->value;
+        $monthlyShareInstallment = number_format(
+            MembershipApplication::MINIMUM_SHARE_CAPITAL / MembershipApplication::SHARE_INSTALLMENT_MONTHS,
+            2,
+            '.',
+            '',
+        );
+
+        return [
+            'application' => $application,
+            'applicant' => $applicant,
+            'boardMeetingReference' => $boardMeetingReference,
+            'isPassed' => $isPassed,
+            'boardResultLabel' => $isPassed ? 'lulus' : 'gagal',
+            'openingTone' => $isPassed ? 'Sukacita' : 'Dukacita',
+            'letterSubject' => $isPassed
+                ? 'KELULUSAN KEANGGOTAAN KOPERASI PERMODALAN KELANTAN BERHAD'
+                : 'KEPUTUSAN PERMOHONAN KEANGGOTAAN KOPERASI PERMODALAN KELANTAN BERHAD',
+            'monthlyShareInstallment' => $monthlyShareInstallment,
+            'stockMonthlyContribution' => number_format((float) $applicant->stock_monthly_contribution, 2, '.', ''),
+            'feeMonthlyContribution' => number_format((float) $applicant->fee_monthly_contribution, 2, '.', ''),
+            'shareInstallmentMonths' => MembershipApplication::SHARE_INSTALLMENT_MONTHS,
+            'minimumShareCapital' => number_format(MembershipApplication::MINIMUM_SHARE_CAPITAL, 2, '.', ''),
+        ];
+    }
+
     protected function createMemberFromApplication(MembershipApplication $application): User
     {
         $application->loadMissing(['applicant', 'heirs']);