feat: AfterSales CRM - SOP compliant real-estate customer care system

- Departments + cross-department transfer workflow - Role-based closing (staff→resolved, manager→closed) with proof_of_resolution - Private file storage with collection system + temporary signed URLs - Dashboard: resolved tickets table, stats, handler performance bar chart - Spatie RBAC (admin/manager/staff) - Notifications: TicketTransferred, TicketClosed (database + mail) - Pest tests: 8 tests, 21 assertions - Docker production-ready (Dockerfile + compose + entrypoint)
2026-04-27 05:29:48 +00:00
parent 8ad7826f56
commit 887765bbd7
134 changed files with 17416 additions and 45 deletions
--- a/app/Services/ClosingService.php
+++ b/app/Services/ClosingService.php
@@ -0,0 +1,74 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Department;
+use App\Models\Feedback;
+use App\Models\User;
+use Illuminate\Support\Facades\App;
+use Illuminate\Validation\ValidationException;
+use Symfony\Component\HttpKernel\Exception\HttpException;
+
+class ClosingService
+{
+    /**
+     * Close a feedback. Throws if staff tries to close or no proof exists.
+     */
+    public function close(Feedback $feedback, User $actor): void
+    {
+        if ($feedback->status === 'closed') {
+            throw ValidationException::withMessages([
+                'status' => __('Phiếu này đã được đóng.'),
+            ]);
+        }
+
+        if ($actor->hasRole('staff')) {
+            throw new HttpException(403, __('Chỉ lãnh đạo cấp phòng mới có quyền đóng phiếu.'));
+        }
+
+        if ($actor->hasRole('manager') && ! $actor->hasRole('admin')) {
+            $managedDeptIds = Department::where('manager_id', $actor->id)->pluck('id');
+            if (! $managedDeptIds->contains($feedback->current_department_id)) {
+                throw new HttpException(403, __('Bạn chỉ có thể đóng phiếu thuộc phòng ban mình quản lý.'));
+            }
+        }
+
+        $fileService = App::make(FileService::class);
+
+        if (! $fileService->hasCollection($feedback, 'proof_of_resolution')) {
+            throw ValidationException::withMessages([
+                'status' => __('Yêu cầu cung cấp tài liệu bằng chứng để hoàn tất quy trình.'),
+            ]);
+        }
+
+        $feedback->update(['status' => 'closed']);
+
+        $this->notifyStakeholders($feedback, $actor);
+    }
+
+    /**
+     * Resolve a feedback. Any role can resolve.
+     */
+    public function resolve(Feedback $feedback, User $actor): void
+    {
+        if (in_array($feedback->status, ['closed', 'resolved'])) {
+            throw ValidationException::withMessages([
+                'status' => __('Phiếu này đã được xử lý hoặc đóng.'),
+            ]);
+        }
+
+        $feedback->update(['status' => 'resolved']);
+    }
+
+    protected function notifyStakeholders(Feedback $feedback, User $actor): void
+    {
+        if ($feedback->assignedTo) {
+            $feedback->assignedTo->notify(new \App\Notifications\TicketClosed($feedback, $actor));
+        }
+
+        $department = $feedback->currentDepartment;
+        if ($department && $department->manager && $department->manager->id !== ($feedback->assignedTo?->id ?? null)) {
+            $department->manager->notify(new \App\Notifications\TicketClosed($feedback, $actor));
+        }
+    }
+}