@fleetbase/fleetops-engine 0.6.49 → 0.6.51

package/server/src/Http/Controllers/Internal/v1/ContactController.php

@@ -4,12 +4,23 @@ namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
 use Fleetbase\FleetOps\Exports\ContactExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
+use Fleetbase\FleetOps\Http\Resources\v1\Vendor as VendorResource;
 use Fleetbase\FleetOps\Imports\ContactImport;
+use Fleetbase\FleetOps\Mail\CustomerCredentialsMail;
 use Fleetbase\FleetOps\Models\Contact;
+use Fleetbase\FleetOps\Models\Entity;
+use Fleetbase\FleetOps\Models\Issue;
+use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Models\PurchaseRate;
+use Fleetbase\FleetOps\Models\Vendor;
+use Fleetbase\FleetOps\Models\VendorPersonnel;
+use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
 use Fleetbase\Models\User;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
 use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
@@ -28,6 +39,8 @@ class ContactController extends FleetOpsController
     public function onBeforeCreate(Request $request, array &$input)
     {
         $this->resolveUserInput($request, $input);
+        $this->assertCustomerIdentityIsAvailable($input);
+        $this->assertCustomerPortalCanSendWelcomeEmail($input);
     }
 
     /**
@@ -40,6 +53,7 @@ class ContactController extends FleetOpsController
         }
 
         $this->resolveUserInput($request, $input);
+        $this->assertCustomerIdentityIsAvailable($input, $contact);
     }
 
     /**
@@ -49,6 +63,7 @@ class ContactController extends FleetOpsController
     {
         if ($contact->type === 'customer') {
             $contact->normalizeCustomerUser();
+            $this->sendCustomerPortalWelcomeEmail($contact);
         }
 
         $customFieldValues = $request->array('contact.custom_field_values');
@@ -93,6 +108,57 @@ class ContactController extends FleetOpsController
         ]);
     }
 
+    public function convertToVendor(Request $request, string $id)
+    {
+        $contact = Contact::where('company_uuid', session('company'))
+            ->where(function ($query) use ($id) {
+                $query->where('uuid', $id)->orWhere('public_id', $id)->orWhere('id', $id);
+            })
+            ->firstOrFail();
+
+        $vendor = DB::transaction(function () use ($contact, $request) {
+            $originalType = $contact->type;
+            $vendor       = Vendor::create([
+                'company_uuid' => $contact->company_uuid,
+                'place_uuid'   => $contact->place_uuid,
+                'name'         => $request->input('name', $contact->name),
+                'email'        => $request->input('email', $contact->email),
+                'phone'        => $request->input('phone', $contact->phone),
+                'status'       => 'active',
+                'type'         => 'customer',
+                'meta'         => [
+                    'converted_from_contact_uuid' => $contact->uuid,
+                    'converted_from_contact_type' => $originalType,
+                    'converted_by_uuid'           => session('user'),
+                    'converted_at'                => now()->toISOString(),
+                ],
+            ]);
+
+            VendorPersonnel::updateOrCreate(
+                ['vendor_uuid' => $vendor->uuid, 'contact_uuid' => $contact->uuid],
+                ['role' => 'admin', 'status' => 'active', 'invited_by_uuid' => session('user')]
+            );
+
+            $this->migrateContactCustomerContextToVendor($contact, $vendor);
+
+            $contact->update([
+                'type' => 'customer',
+                'meta' => array_merge((array) $contact->meta, [
+                    'converted_from_type'            => $originalType,
+                    'converted_to_vendor_uuid'       => $vendor->uuid,
+                    'converted_to_vendor_public_id'  => $vendor->public_id,
+                    'converted_to_vendor_at'         => now()->toISOString(),
+                ]),
+            ]);
+
+            return $vendor;
+        });
+
+        return response()->json([
+            'vendor' => (new VendorResource($vendor->load('personnels')))->resolve(),
+        ]);
+    }
+
     /**
      * Export the contacts to excel or csv.
      *
@@ -131,6 +197,29 @@ class ContactController extends FleetOpsController
         return response()->json(['status' => 'ok', 'message' => 'Import completed', 'imported' => $importedCount]);
     }
 
+    private function migrateContactCustomerContextToVendor(Contact $contact, Vendor $vendor): void
+    {
+        $contactType = Utils::getMutationType($contact);
+        $vendorType  = Utils::getMutationType($vendor);
+        $filter      = ['customer_uuid' => $contact->uuid, 'customer_type' => $contactType];
+        $replacement = ['customer_uuid' => $vendor->uuid, 'customer_type' => $vendorType];
+
+        Order::where($filter)->update($replacement);
+        PurchaseRate::where($filter)->update($replacement);
+        Entity::where($filter)->update($replacement);
+
+        Issue::where('company_uuid', $contact->company_uuid)
+            ->where('meta->customer_portal->customer_uuid', $contact->uuid)
+            ->where('meta->customer_portal->customer_type', 'contact')
+            ->get()
+            ->each(function (Issue $issue) use ($vendor) {
+                $meta = (array) $issue->meta;
+                data_set($meta, 'customer_portal.customer_uuid', $vendor->uuid);
+                data_set($meta, 'customer_portal.customer_type', 'vendor');
+                $issue->update(['meta' => $meta]);
+            });
+    }
+
     private function resolveUserInput(Request $request, array &$input): void
     {
         $user = data_get($input, 'user_uuid') ?? data_get($input, 'user') ?? $request->input('contact.user_uuid') ?? $request->input('contact.user');
@@ -146,4 +235,69 @@ class ContactController extends FleetOpsController
         $input['user_uuid'] = User::where('uuid', $user)->orWhere('public_id', $user)->value('uuid') ?? $user;
         unset($input['user']);
     }
+
+    private function assertCustomerPortalCanSendWelcomeEmail(array $input): void
+    {
+        $type = data_get($input, 'type', 'contact');
+        if ($type !== 'customer' || !data_get($input, 'meta.customer_portal.send_welcome_email')) {
+            return;
+        }
+
+        if (!$this->isCustomerPortalInstalled()) {
+            throw new \Exception('Customer portal must be installed before sending a customer welcome email.');
+        }
+    }
+
+    private function sendCustomerPortalWelcomeEmail(Contact $contact): void
+    {
+        if (!data_get($contact->meta, 'customer_portal.send_welcome_email')) {
+            return;
+        }
+
+        if (!$this->isCustomerPortalInstalled()) {
+            throw new \Exception('Customer portal must be installed before sending a customer welcome email.');
+        }
+
+        $user = $contact->getUser() ?? Contact::createUserFromContact($contact, false, true);
+        if (!$user) {
+            throw new \Exception('Unable to create customer portal login.');
+        }
+
+        $password = Str::random(16);
+        $user->changePassword($password);
+
+        if ($user->status !== 'active') {
+            $user->activate();
+        }
+
+        Mail::to($user)->send(new CustomerCredentialsMail($password, $contact));
+
+        $meta = (array) $contact->meta;
+        data_forget($meta, 'customer_portal.send_welcome_email');
+        $contact->forceFill(['meta' => $meta])->saveQuietly();
+        $contact->setAttribute('meta', $meta);
+    }
+
+    private function isCustomerPortalInstalled(): bool
+    {
+        return collect(Utils::getInstalledFleetbaseExtensions())
+            ->contains(fn ($package) => data_get($package, 'name') === 'fleetbase/customer-portal-api');
+    }
+
+    private function assertCustomerIdentityIsAvailable(array $input, ?Contact $contact = null): void
+    {
+        $type = data_get($input, 'type', $contact?->type);
+        if ($type !== 'customer') {
+            return;
+        }
+
+        $customer = $contact ? $contact->replicate() : new Contact();
+        if ($contact) {
+            $customer->forceFill($contact->getAttributes());
+            $customer->exists = $contact->exists;
+        }
+
+        $customer->forceFill($input);
+        $customer->assertCustomerIdentityIsAvailable();
+    }
 }

package/server/src/Http/Controllers/Internal/v1/CustomerController.php

@@ -8,9 +8,78 @@ use Fleetbase\Http\Controllers\Controller;
 use Fleetbase\Models\User;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Mail;
+use Illuminate\Support\Str;
 
 class CustomerController extends Controller
 {
+    public function createPortalLogin(Request $request)
+    {
+        $customer = $this->resolveCustomer($request);
+        $user     = $this->resolveCustomerUser($customer);
+
+        if (!$user) {
+            return response()->error('Unable to create customer portal login.');
+        }
+
+        if ($user->status !== 'active') {
+            $user->activate();
+        }
+
+        return response()->json([
+            'customer' => $this->customerPayload($customer->fresh()),
+        ]);
+    }
+
+    public function sendCredentials(Request $request)
+    {
+        $customer = $this->resolveCustomer($request);
+        $user     = $this->resolveCustomerUser($customer);
+
+        if (!$user) {
+            return response()->error('Unable to send customer portal credentials.');
+        }
+
+        $password = Str::random(16);
+        $user->changePassword($password);
+        Mail::to($user)->send(new CustomerCredentialsMail($password, $customer));
+
+        return response()->json([
+            'customer' => $this->customerPayload($customer->fresh()),
+        ]);
+    }
+
+    public function deactivatePortalLogin(Request $request)
+    {
+        $customer = $this->resolveCustomer($request);
+        $user     = $customer->user_uuid ? User::where('uuid', $customer->user_uuid)->first() : null;
+
+        if (!$user) {
+            return response()->error('Customer portal login not found.');
+        }
+
+        $user->deactivate();
+
+        return response()->json([
+            'customer' => $this->customerPayload($customer->fresh()),
+        ]);
+    }
+
+    public function reactivatePortalLogin(Request $request)
+    {
+        $customer = $this->resolveCustomer($request);
+        $user     = $customer->user_uuid ? User::where('uuid', $customer->user_uuid)->first() : null;
+
+        if (!$user) {
+            return response()->error('Customer portal login not found.');
+        }
+
+        $user->activate();
+
+        return response()->json([
+            'customer' => $this->customerPayload($customer->fresh()),
+        ]);
+    }
+
     /**
      * Resets the password for a specified customer and optionally sends the new credentials via email.
      *
@@ -72,13 +141,10 @@ class CustomerController extends Controller
             return response()->error('Passwords do not match.');
         }
 
-        $customer = Contact::where(['uuid' => $customerId, 'company_uuid' => session('company'), 'type' => 'customer'])->first();
-        if (!$customer) {
-            return response()->error('Customer not found to change password for.');
-        }
+        $customer = $this->resolveCustomer($request);
 
         // Load customer user
-        $user = $customer->user_uuid ? User::where('uuid', $customer->user_uuid)->first() : $customer->createUser();
+        $user = $this->resolveCustomerUser($customer);
         if (!$user) {
             return response()->error('Unable to reset customer credentials');
         }
@@ -91,6 +157,50 @@ class CustomerController extends Controller
             Mail::to($user)->send(new CustomerCredentialsMail($password, $customer));
         }
 
-        return response()->json(['status' => 'ok']);
+        return response()->json([
+            'status'   => 'ok',
+            'customer' => $this->customerPayload($customer->fresh()),
+        ]);
+    }
+
+    protected function resolveCustomer(Request $request): Contact
+    {
+        $customerId = $request->input('customer');
+
+        abort_if(!$customerId, 400, 'No customer specified.');
+
+        return Contact::where('company_uuid', session('company'))
+            ->where(function ($query) use ($customerId) {
+                $query->where('uuid', $customerId)
+                    ->orWhere('public_id', $customerId)
+                    ->orWhere('id', $customerId);
+            })
+            ->firstOrFail();
+    }
+
+    protected function resolveCustomerUser(Contact $customer): ?User
+    {
+        return $customer->user_uuid ? User::where('uuid', $customer->user_uuid)->first() : Contact::createUserFromContact($customer, false, true);
+    }
+
+    protected function customerPayload(Contact $customer): array
+    {
+        $customer->loadMissing('user');
+
+        return [
+            'id'        => $customer->public_id,
+            'uuid'      => $customer->uuid,
+            'user_uuid' => $customer->user_uuid,
+            'user'      => $customer->user ? [
+                'id'             => $customer->user->public_id,
+                'uuid'           => $customer->user->uuid,
+                'name'           => $customer->user->name,
+                'email'          => $customer->user->email,
+                'phone'          => $customer->user->phone,
+                'status'         => $customer->user->status,
+                'session_status' => $customer->user->session_status,
+                'avatar_url'     => $customer->user->avatar_url,
+            ] : null,
+        ];
     }
 }

package/server/src/Http/Controllers/Internal/v1/GettingStartedController.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
+
+use Fleetbase\FleetOps\Support\GettingStarted;
+use Fleetbase\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+
+class GettingStartedController extends Controller
+{
+    public function status(Request $request)
+    {
+        return response()->json(
+            GettingStarted::forCompany($request->user()->company)->get()
+        );
+    }
+}

package/server/src/Http/Controllers/Internal/v1/IssueController.php

@@ -6,9 +6,15 @@ use Fleetbase\FleetOps\Exports\IssueExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Imports\IssueImport;
 use Fleetbase\FleetOps\Models\Issue;
+use Fleetbase\FleetOps\Models\Order;
 use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
+use Fleetbase\Models\Activity;
+use Fleetbase\Models\Comment;
+use Fleetbase\Models\File;
+use Fleetbase\Models\User;
 use Illuminate\Http\Request;
+use Illuminate\Support\Collection;
 use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
@@ -26,10 +32,255 @@ class IssueController extends FleetOpsController
      */
     public function afterSave(Request $request, Issue $issue)
     {
+        if ($issue->assigned_to_uuid) {
+            $assignee = User::where('uuid', $issue->assigned_to_uuid)->first();
+
+            if ($assignee && $assignee->type === 'customer') {
+                $issue->assigned_to_uuid = null;
+                $issue->saveQuietly();
+            }
+        }
+
         $customFieldValues = $request->array('issue.custom_field_values');
         if ($customFieldValues) {
             $issue->syncCustomFieldValues($customFieldValues);
         }
+
+        $uploads = $request->array('issue.files');
+        if ($uploads) {
+            File::whereIn('uuid', $uploads)->get()->each(function (File $file) use ($issue) {
+                $file->setKey($issue);
+            });
+        }
+
+        if (!$issue->order_uuid && data_get($issue, 'meta.order_uuid')) {
+            $order = Order::where('uuid', data_get($issue, 'meta.order_uuid'))->where('company_uuid', $issue->company_uuid)->first();
+            if ($order) {
+                $issue->order_uuid = $order->uuid;
+                $issue->saveQuietly();
+            }
+        }
+    }
+
+    /**
+     * Return curated activity timeline entries for an issue.
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function timeline($id)
+    {
+        $issue = Issue::findById($id, ['reporter', 'assignee']);
+
+        if (!$issue || $issue->company_uuid !== session('company')) {
+            return response()->error('Issue not found for this organization.', 404);
+        }
+
+        $events = collect([$this->makeIssueOpenedEvent($issue)])
+            ->merge($this->issueActivityEvents($issue))
+            ->merge($this->commentEvents($issue))
+            ->merge($this->fileEvents($issue))
+            ->sortByDesc('created_at')
+            ->values();
+
+        return response()->json(['events' => $events]);
+    }
+
+    protected function issueActivityEvents(Issue $issue): Collection
+    {
+        return Activity::with(['causer'])
+            ->where('subject_type', Issue::class)
+            ->where('subject_id', $issue->uuid)
+            ->latest()
+            ->get()
+            ->flatMap(function (Activity $activity) use ($issue) {
+                if ($activity->event === 'created') {
+                    return [];
+                }
+
+                $events = [];
+                foreach (['status', 'priority', 'assigned_to_uuid', 'vehicle_uuid', 'driver_uuid', 'order_uuid', 'type', 'category', 'tags', 'resolved_at'] as $field) {
+                    $from = data_get($activity->properties, "old.{$field}");
+                    $to   = data_get($activity->properties, "attributes.{$field}");
+
+                    if ($from === $to || $to === null) {
+                        continue;
+                    }
+
+                    $events[] = $this->makeFieldChangedEvent($activity, $issue, $field, $from, $to);
+                }
+
+                return $events ?: [$this->makeGenericActivityEvent($activity, $issue)];
+            });
+    }
+
+    protected function commentEvents(Issue $issue): Collection
+    {
+        return Comment::with(['author'])
+            ->where('subject_type', Issue::class)
+            ->where('subject_uuid', $issue->uuid)
+            ->latest()
+            ->get()
+            ->map(function (Comment $comment) {
+                return [
+                    'id'               => $comment->uuid,
+                    'type'             => 'correspondence_added',
+                    'label'            => 'Correspondence added',
+                    'description'      => Str::limit(strip_tags($comment->content ?? ''), 120),
+                    'actor_name'       => data_get($comment, 'author.name', 'Someone'),
+                    'actor_avatar_url' => data_get($comment, 'author.avatar_url'),
+                    'created_at'       => $comment->created_at,
+                    'icon'             => 'comment',
+                    'tone'             => 'blue',
+                    'meta'             => [
+                        'comment_id' => $comment->public_id ?? $comment->uuid,
+                    ],
+                ];
+            });
+    }
+
+    protected function fileEvents(Issue $issue): Collection
+    {
+        $currentFiles = File::with(['uploader'])
+            ->where('subject_type', Issue::class)
+            ->where('subject_uuid', $issue->uuid)
+            ->latest()
+            ->get()
+            ->map(function (File $file) {
+                return [
+                    'id'               => $file->uuid,
+                    'type'             => 'document_uploaded',
+                    'label'            => 'Document uploaded',
+                    'description'      => $file->original_filename,
+                    'actor_name'       => data_get($file, 'uploader.name', 'Someone'),
+                    'actor_avatar_url' => data_get($file, 'uploader.avatar_url'),
+                    'created_at'       => $file->created_at,
+                    'icon'             => 'file-arrow-up',
+                    'tone'             => 'purple',
+                    'meta'             => [
+                        'file_id'   => $file->public_id ?? $file->uuid,
+                        'file_name' => $file->original_filename,
+                        'file_url'  => $file->url,
+                    ],
+                ];
+            });
+
+        $fileActivities = Activity::with(['causer'])
+            ->where('subject_type', File::class)
+            ->where(function ($query) use ($issue) {
+                $query->where('properties->attributes->subject_uuid', $issue->uuid)
+                    ->orWhere('properties->old->subject_uuid', $issue->uuid);
+            })
+            ->latest()
+            ->get()
+            ->filter(fn (Activity $activity) => $activity->event === 'deleted')
+            ->map(function (Activity $activity) {
+                $fileName = data_get($activity->properties, 'old.original_filename')
+                    ?? data_get($activity->properties, 'attributes.original_filename')
+                    ?? 'Document';
+
+                return [
+                    'id'               => $activity->uuid ?? $activity->id,
+                    'type'             => 'document_removed',
+                    'label'            => 'Document removed',
+                    'description'      => $fileName,
+                    'actor_name'       => data_get($activity, 'causer.name', 'Someone'),
+                    'actor_avatar_url' => data_get($activity, 'causer.avatar_url'),
+                    'created_at'       => $activity->created_at,
+                    'icon'             => 'file-circle-xmark',
+                    'tone'             => 'red',
+                    'meta'             => [
+                        'file_name' => $fileName,
+                    ],
+                ];
+            });
+
+        return $currentFiles->merge($fileActivities);
+    }
+
+    protected function makeIssueOpenedEvent(Issue $issue): array
+    {
+        return [
+            'id'               => $issue->uuid . '-opened',
+            'type'             => 'issue_opened',
+            'label'            => 'Issue opened',
+            'description'      => 'Reported by ' . ($issue->reporter_name ?: 'Unknown reporter'),
+            'actor_name'       => $issue->reporter_name ?: 'Unknown reporter',
+            'actor_avatar_url' => data_get($issue, 'reporter.avatar_url'),
+            'created_at'       => $issue->created_at,
+            'icon'             => 'circle-plus',
+            'tone'             => 'green',
+            'meta'             => [
+                'issue_id' => $issue->public_id,
+            ],
+        ];
+    }
+
+    protected function makeFieldChangedEvent(Activity $activity, Issue $issue, string $field, $from, $to): array
+    {
+        $eventMap = [
+            'status'           => ['status_changed', 'Status changed', 'arrows-rotate', 'blue'],
+            'priority'         => ['priority_changed', 'Priority changed', 'flag', 'orange'],
+            'assigned_to_uuid' => ['assignee_changed', 'Assignee changed', 'user-check', 'indigo'],
+            'vehicle_uuid'     => ['vehicle_changed', 'Vehicle linked', 'truck', 'slate'],
+            'driver_uuid'      => ['driver_changed', 'Driver linked', 'id-card', 'slate'],
+            'order_uuid'       => ['order_changed', 'Order linked', 'box', 'slate'],
+            'resolved_at'      => [$to ? 'issue_closed' : 'issue_reopened', $to ? 'Issue closed' : 'Issue re-opened', $to ? 'circle-check' : 'rotate-left', $to ? 'green' : 'orange'],
+        ];
+
+        [$type, $label, $icon, $tone] = $eventMap[$field] ?? ['issue_updated', Str::headline(str_replace('_uuid', '', $field)) . ' changed', 'pen', 'slate'];
+
+        if ($field === 'status' && in_array($to, ['closed', 'resolved', 'completed'])) {
+            [$type, $label, $icon, $tone] = ['issue_closed', 'Issue closed', 'circle-check', 'green'];
+        }
+
+        if ($field === 'status' && $to === 're_opened') {
+            [$type, $label, $icon, $tone] = ['issue_reopened', 'Issue re-opened', 'rotate-left', 'orange'];
+        }
+
+        return [
+            'id'               => ($activity->uuid ?? $activity->id) . '-' . $field,
+            'type'             => $type,
+            'label'            => $label,
+            'description'      => $this->formatChangeDescription($field, $from, $to),
+            'actor_name'       => data_get($activity, 'causer.name', 'Someone'),
+            'actor_avatar_url' => data_get($activity, 'causer.avatar_url'),
+            'created_at'       => $activity->created_at,
+            'icon'             => $icon,
+            'tone'             => $tone,
+            'meta'             => [
+                'field'    => $field,
+                'from'     => $from,
+                'to'       => $to,
+                'issue_id' => $issue->public_id,
+            ],
+        ];
+    }
+
+    protected function makeGenericActivityEvent(Activity $activity, Issue $issue): array
+    {
+        return [
+            'id'               => $activity->uuid ?? $activity->id,
+            'type'             => 'issue_updated',
+            'label'            => 'Issue updated',
+            'description'      => $activity->description,
+            'actor_name'       => data_get($activity, 'causer.name', 'Someone'),
+            'actor_avatar_url' => data_get($activity, 'causer.avatar_url'),
+            'created_at'       => $activity->created_at,
+            'icon'             => 'pen',
+            'tone'             => 'slate',
+            'meta'             => [
+                'issue_id' => $issue->public_id,
+            ],
+        ];
+    }
+
+    protected function formatChangeDescription(string $field, $from, $to): string
+    {
+        $fieldLabel = Str::headline(str_replace('_uuid', '', $field));
+        $fromLabel  = blank($from) ? 'none' : Str::headline((string) $from);
+        $toLabel    = blank($to) ? 'none' : Str::headline((string) $to);
+
+        return "{$fieldLabel} changed from {$fromLabel} to {$toLabel}.";
     }
 
     /**