@fleetbase/fleetops-engine 0.6.50 → 0.6.51

package/server/tests/CustomerContactIdentitySafetyTest.php

@@ -52,3 +52,44 @@ test('customer conflict audit command is registered and read only', function ()
         ->not->toContain('->update(')
         ->not->toContain('forceFill');
 });
+
+test('customer portal welcome email is opt in and does not create organization invites', function () {
+    $internalContact     = file_get_contents(__DIR__ . '/../src/Http/Controllers/Internal/v1/ContactController.php');
+    $internalCustomer    = file_get_contents(__DIR__ . '/../src/Http/Controllers/Internal/v1/CustomerController.php');
+    $contactModel        = file_get_contents(__DIR__ . '/../src/Models/Contact.php');
+    $customerCredentials = file_get_contents(__DIR__ . '/../src/Mail/CustomerCredentialsMail.php');
+    $customerEmail       = file_get_contents(__DIR__ . '/../resources/views/mail/customer-credentials.blade.php');
+    $customerForm        = file_get_contents(__DIR__ . '/../../addon/components/customer/form.hbs');
+
+    expect($internalContact)
+        ->toContain('meta.customer_portal.send_welcome_email')
+        ->toContain('assertCustomerPortalCanSendWelcomeEmail')
+        ->toContain('sendCustomerPortalWelcomeEmail')
+        ->toContain('Contact::createUserFromContact($contact, false, true)')
+        ->toContain('Mail::to($user)->send(new CustomerCredentialsMail($password, $contact))')
+        ->toContain("data_forget(\$meta, 'customer_portal.send_welcome_email')")
+        ->toContain('fleetbase/customer-portal-api')
+        ->not->toContain('UserInvited')
+        ->not->toContain('Invite::create');
+
+    expect($internalCustomer)
+        ->toContain('Contact::createUserFromContact($customer, false, true)')
+        ->not->toContain('send_invite');
+
+    expect($customerCredentials)->toContain('customer portal access is ready')
+        ->and($customerCredentials)->toContain("Utils::consoleUrl(\$accessUrlSlug ?: 'customer-portal')")
+        ->and($customerEmail)->toContain('Your customer portal access is ready')
+        ->and($customerEmail)->toContain('Sign in to customer portal')
+        ->and($customerEmail)->toContain('Temporary password:')
+        ->and($customerEmail)->toContain('You can change your password after signing in.')
+        ->and($customerForm)->toContain('this.showWelcomeEmailOption')
+        ->and($customerForm)->toContain('this.toggleWelcomeEmail');
+
+    expect($contactModel)
+        ->toContain('assignUserToContactCompany')
+        ->toContain('$contact->company->addUser($user, $role)')
+        ->toContain('Deprecated and ignored. Contact and customer users do not receive organization invitations.')
+        ->not->toContain('UserInvited')
+        ->not->toContain('Invite::create')
+        ->not->toContain('->assignCompany(');
+});

package/server/tests/DriverVehicleStatusDefaultTest.php

@@ -11,14 +11,14 @@ test('driver and vehicle statuses default to available', function () {
 });
 
 test('legacy active and null driver and vehicle statuses normalize to available', function () {
-    $driver = new Driver();
+    $driver         = new Driver();
     $driver->status = 'active';
     expect($driver->status)->toBe('available');
 
     $driver->status = null;
     expect($driver->status)->toBe('available');
 
-    $vehicle = new Vehicle();
+    $vehicle         = new Vehicle();
     $vehicle->status = 'active';
     expect($vehicle->status)->toBe('available');
 

package/server/tests/GettingStartedStatusTest.php

@@ -0,0 +1,21 @@
+<?php
+
+test('getting started status route is registered', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)
+        ->toContain("['prefix' => 'getting-started']")
+        ->toContain("\$router->get('status', 'GettingStartedController@status');");
+});
+
+test('getting started support exposes checklist and generic recommendations', function () {
+    $support = file_get_contents(dirname(__DIR__) . '/src/Support/GettingStarted.php');
+
+    expect($support)
+        ->toContain("'key'         => 'add_driver'")
+        ->toContain("'key'         => 'create_order'")
+        ->toContain("'key'         => 'assign_driver'")
+        ->toContain("'key'         => 'update_activity'")
+        ->toContain("'profile_source'  => 'generic'")
+        ->toContain("'recommendations' => \$this->recommendations()");
+});

package/server/tests/OrderActivityFlowRegressionTest.php

@@ -0,0 +1,116 @@
+<?php
+
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\Waypoint;
+use Fleetbase\FleetOps\Support\ResolvesOrderServiceStops;
+
+function activity_flow_helper()
+{
+    return new class {
+        use ResolvesOrderServiceStops {
+            payloadServiceStops as public serviceStops;
+            payloadUsesServiceStopActivity as public usesServiceStopActivity;
+            resolveServiceStopFromKey as public resolveStop;
+        }
+    };
+}
+
+function activity_flow_place(string $key): Place
+{
+    $place            = new Place();
+    $place->uuid      = (string) Illuminate\Support\Str::uuid();
+    $place->public_id = "place_{$key}";
+    $place->id        = "place_{$key}";
+    $place->name      = ucfirst($key);
+
+    return $place;
+}
+
+function activity_flow_waypoint(Payload $payload, Place $place, int $order): Waypoint
+{
+    $waypoint                       = new Waypoint();
+    $waypoint->uuid                 = (string) Illuminate\Support\Str::uuid();
+    $waypoint->public_id            = "waypoint_{$order}";
+    $waypoint->payload_uuid         = $payload->uuid;
+    $waypoint->place_uuid           = $place->uuid;
+    $waypoint->order                = $order;
+    $waypoint->tracking_number_uuid = null;
+    $waypoint->setRelation('place', $place);
+    $waypoint->setRelation('trackingNumber', null);
+
+    return $waypoint;
+}
+
+function activity_flow_payload(?Place $pickup = null, ?Place $dropoff = null, array $waypointPlaces = [], ?Place $return = null): Payload
+{
+    $payload       = new Payload();
+    $payload->uuid = (string) Illuminate\Support\Str::uuid();
+    $payload->setRelation('pickup', $pickup);
+    $payload->setRelation('dropoff', $dropoff);
+    $payload->setRelation('return', $return);
+    $payload->setRelation('waypoints', collect($waypointPlaces));
+    $payload->setRelation('waypointMarkers', collect($waypointPlaces)->values()->map(fn (Place $place, int $index) => activity_flow_waypoint($payload, $place, $index)));
+
+    return $payload;
+}
+
+test('classic pickup and dropoff route stays order activity driven even with a destination param', function () {
+    $pickup  = activity_flow_place('pickup');
+    $dropoff = activity_flow_place('dropoff');
+    $payload = activity_flow_payload($pickup, $dropoff);
+    $helper  = activity_flow_helper();
+
+    expect($helper->usesServiceStopActivity($payload))->toBeFalse()
+        ->and($helper->resolveStop($payload, $pickup->public_id))->not->toBeNull();
+});
+
+test('pickup waypoint and dropoff route uses service stop activity in pickup waypoint dropoff order', function () {
+    $pickup   = activity_flow_place('pickup');
+    $waypoint = activity_flow_place('middle');
+    $dropoff  = activity_flow_place('dropoff');
+    $payload  = activity_flow_payload($pickup, $dropoff, [$waypoint]);
+    $helper   = activity_flow_helper();
+    $stops    = $helper->serviceStops($payload);
+
+    expect($helper->usesServiceStopActivity($payload))->toBeTrue()
+        ->and($stops)->toHaveCount(3)
+        ->and($stops->pluck('type')->all())->toBe(['pickup', 'waypoint', 'dropoff']);
+});
+
+test('pickup plus waypoints without dropoff and waypoint only routes use service stop activity', function () {
+    $pickup       = activity_flow_place('pickup');
+    $firstStop    = activity_flow_place('first');
+    $secondStop   = activity_flow_place('second');
+    $withPickup   = activity_flow_payload($pickup, null, [$firstStop, $secondStop]);
+    $waypointOnly = activity_flow_payload(null, null, [$firstStop, $secondStop]);
+    $helper       = activity_flow_helper();
+
+    expect($helper->usesServiceStopActivity($withPickup))->toBeTrue()
+        ->and($helper->serviceStops($withPickup)->pluck('type')->all())->toBe(['pickup', 'waypoint', 'waypoint'])
+        ->and($helper->usesServiceStopActivity($waypointOnly))->toBeTrue()
+        ->and($helper->serviceStops($waypointOnly)->pluck('type')->all())->toBe(['waypoint', 'waypoint']);
+});
+
+test('return address is excluded from normal service stop activity sequence', function () {
+    $pickup  = activity_flow_place('pickup');
+    $dropoff = activity_flow_place('dropoff');
+    $return  = activity_flow_place('return');
+    $payload = activity_flow_payload($pickup, $dropoff, [], $return);
+    $helper  = activity_flow_helper();
+
+    expect($helper->serviceStops($payload)->pluck('type')->all())->toBe(['pickup', 'dropoff']);
+});
+
+test('pod bypass is internal console only', function () {
+    $internalController = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/OrderController.php');
+    $publicController   = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Api/v1/OrderController.php');
+    $consoleModal       = file_get_contents(dirname(__DIR__, 2) . '/addon/components/modals/update-order-activity.hbs');
+
+    expect($internalController)
+        ->toContain("boolean('bypass_proof')")
+        ->and($publicController)
+        ->not->toContain('bypass_proof')
+        ->and($consoleModal)
+        ->toContain('Bypass proof of delivery');
+});

package/server/tests/ServiceAreaZoneApiShapeTest.php

@@ -1,5 +1,8 @@
 <?php
 
+use Fleetbase\FleetOps\Models\ServiceArea;
+use Fleetbase\FleetOps\Models\Zone;
+
 test('service area create and update accept persisted map geometry and style fields', function () {
     $controller = file_get_contents(__DIR__ . '/../src/Http/Controllers/Api/v1/ServiceAreaController.php');
 
@@ -32,3 +35,44 @@ test('zone create accepts only service area public ids on the consumable api', f
         ->toContain("'public_id'    => \$request->input('service_area')")
         ->not->toContain("->orWhere('uuid'");
 });
+
+test('service area zones relationship uses the stored service area uuid foreign key', function () {
+    $relation = (new ServiceArea())->zones();
+
+    expect($relation->getForeignKeyName())->toBe('service_area_uuid')
+        ->and($relation->getLocalKeyName())->toBe('uuid');
+});
+
+test('zone service area relationship uses the stored service area uuid foreign key', function () {
+    $relation = (new Zone())->serviceArea();
+
+    expect($relation->getForeignKeyName())->toBe('service_area_uuid')
+        ->and($relation->getOwnerKeyName())->toBe('uuid');
+});
+
+test('zone observer is registered to invalidate service area cache when zones change', function () {
+    $provider = file_get_contents(__DIR__ . '/../src/Providers/FleetOpsServiceProvider.php');
+    $observer = file_get_contents(__DIR__ . '/../src/Observers/ZoneObserver.php');
+
+    expect($provider)
+        ->toContain('\Fleetbase\FleetOps\Models\Zone::class')
+        ->toContain('\Fleetbase\FleetOps\Observers\ZoneObserver::class');
+
+    expect($observer)
+        ->toContain('function created')
+        ->toContain('function updated')
+        ->toContain('function deleted')
+        ->toContain('function restored')
+        ->toContain("\$zone->getOriginal('service_area_uuid')")
+        ->toContain('ServiceArea::invalidateApiCacheManually($zone->company_uuid)')
+        ->toContain('ServiceArea::invalidateApiCacheManually()');
+});
+
+test('internal service area controller does not bypass api cache directly', function () {
+    $controller = file_get_contents(__DIR__ . '/../src/Http/Controllers/Internal/v1/ServiceAreaController.php');
+
+    expect($controller)
+        ->not->toContain('disableApiCache')
+        ->not->toContain('function queryRecord')
+        ->not->toContain('function findRecord');
+});

package/translations/ar-ae.yml

@@ -721,6 +721,15 @@ fleet-ops:
       fleet-ops-quickstart:
         message: لنرى ما يمكنك فعله لبدء العمليات...
         start-task: بدء المهمة
+      get-started:
+        title: Get Started with Fleet-Ops
+        subtitle: Set up the essentials and complete your first dispatch flow.
+        completed: completed
+        preview-title: First order workflow
+      recommended-features:
+        title: Recommended features for you
+        subtitle: Explore tools that help new operations teams get productive faster.
+        learn-more: Learn more
       key-metrics:
         title: مقاييس Fleet-Ops
         earnings: الأرباح

package/translations/bg-bg.yaml

@@ -1594,6 +1594,15 @@ widget:
   fleet-ops-quickstart:
     message: Нека видим какво можете да направите, за да стартирате операциите...
     start-task: Започнете задача
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Метрики на Fleet-Ops
     earnings: Печалби

package/translations/en-us.yaml

@@ -403,6 +403,8 @@ customer:
         select-address: Select Address
         new-address: New Adddress
         select-user: Select User
+        send-welcome-email: Send customer portal welcome email
+        send-welcome-email-help-text: Generate a temporary password and email this customer a link to sign in to the customer portal.
         upload-new-photo: Upload New Photo
         user-account: User Account
         user-account-help-text: Each customer profile needs to be connected to a specific user account. This association is essential for handling the authentication process, ensuring that each customer can securely access and manage their profile and other services.
@@ -1688,6 +1690,15 @@ widget:
         title: Geofence Violations
     live-fleet:
         title: Live Fleet Map
+    get-started:
+        title: Get Started with Fleet-Ops
+        subtitle: Set up the essentials and complete your first dispatch flow.
+        completed: completed
+        preview-title: First order workflow
+    recommended-features:
+        title: Recommended features for you
+        subtitle: Explore tools that help new operations teams get productive faster.
+        learn-more: Learn more
     fleet-ops-quickstart:
         message: Let's see what you can do to jumpstart operations...
         start-task: Start Task

package/translations/es-pa.yaml

@@ -1487,6 +1487,15 @@ widget:
   fleet-ops-quickstart:
     message: Veamos qué puedes hacer para impulsar las operaciones...
     start-task: Iniciar tarea
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Métricas de operaciones de flota
     earnings: Ganancias

package/translations/fr-fr.yaml

@@ -1614,6 +1614,15 @@ widget:
   fleet-ops-quickstart:
     message: Voyons ce que vous pouvez faire pour démarrer rapidement les opérations...
     start-task: Démarrer la tâche
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Métriques Fleet-Ops
     earnings: Gains

package/translations/mn-mn.yaml

@@ -1565,6 +1565,15 @@ widget:
   fleet-ops-quickstart:
     message: Үйл ажиллагааг эхлүүлэхийн тулд юу хийж чадахаа харцгаая...
     start-task: Ажлыг эхлүүлэх
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Флийт-Опсын хэмжүүрүүд
     earnings: Орлого

package/translations/pt-br.yaml

@@ -1584,6 +1584,15 @@ widget:
   fleet-ops-quickstart:
     message: Vamos ver o que você pode fazer para acelerar as operações...
     start-task: Iniciar Tarefa
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Métricas Fleet-Ops
     earnings: Ganhos

package/translations/ru-ru.yaml

@@ -1578,6 +1578,15 @@ widget:
   fleet-ops-quickstart:
     message: Давайте посмотрим, что вы можете сделать, чтобы быстро начать работу...
     start-task: Начать задачу
+  get-started:
+    title: Get Started with Fleet-Ops
+    subtitle: Set up the essentials and complete your first dispatch flow.
+    completed: completed
+    preview-title: First order workflow
+  recommended-features:
+    title: Recommended features for you
+    subtitle: Explore tools that help new operations teams get productive faster.
+    learn-more: Learn more
   key-metrics:
     title: Метрики Fleet-Ops
     earnings: Доходы

package/translations/vi-vn.yaml

@@ -722,6 +722,15 @@ fleet-ops:
       fleet-ops-quickstart:
         message: Hãy xem những gì bạn có thể làm để khởi động các hoạt động...
         start-task: Bắt đầu Nhiệm vụ
+      get-started:
+        title: Get Started with Fleet-Ops
+        subtitle: Set up the essentials and complete your first dispatch flow.
+        completed: completed
+        preview-title: First order workflow
+      recommended-features:
+        title: Recommended features for you
+        subtitle: Explore tools that help new operations teams get productive faster.
+        learn-more: Learn more
       key-metrics:
         title: Các Chỉ số Fleet-Ops
         earnings: Doanh thu