@fleetbase/fleetops-engine 0.4.15 → 0.4.17

package/server/src/Models/OrderConfig.php

@@ -0,0 +1,419 @@
+<?php
+
+namespace Fleetbase\FleetOps\Models;
+
+use Fleetbase\Casts\Json;
+use Fleetbase\FleetOps\Casts\OrderConfigEntities;
+use Fleetbase\FleetOps\Flow\Activity;
+use Fleetbase\Models\Model;
+use Fleetbase\Support\Auth;
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasMetaAttributes;
+use Fleetbase\Traits\HasUuid;
+use Fleetbase\Traits\Searchable;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+
+class OrderConfig extends Model
+{
+    use HasUuid;
+    use Searchable;
+    use HasMetaAttributes;
+    use HasApiModelBehavior;
+
+    /**
+     * The database table used by the model.
+     *
+     * @var string
+     */
+    protected $table = 'order_configs';
+
+    /**
+     * These attributes that can be queried.
+     *
+     * @var array
+     */
+    protected $searchableColumns = ['name'];
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'company_uuid',
+        'author_uuid',
+        'category_uuid',
+        'icon_uuid',
+        'name',
+        'namespace',
+        'description',
+        'key',
+        'status',
+        'version',
+        'core_service',
+        'tags',
+        'flow',
+        'entities',
+        'meta',
+    ];
+
+    /**
+     * The attributes that should be cast to native types.
+     *
+     * @var array
+     */
+    protected $casts = [
+        'tags'     => Json::class,
+        'flow'     => Json::class,
+        'entities' => OrderConfigEntities::class,
+        'meta'     => Json::class,
+    ];
+
+    /**
+     * Dynamic attributes that are appended to object.
+     *
+     * @var array
+     */
+    protected $appends = ['type'];
+
+    /**
+     * The attributes excluded from the model's JSON form.
+     *
+     * @var array
+     */
+    protected $hidden = [];
+
+    /**
+     * The current order in context to this config.
+     *
+     * @var Order
+     */
+    protected $orderContext;
+
+    /**
+     * Bootstraps the model and its events.
+     *
+     * This method overrides the default Eloquent model boot method
+     * to add a custom 'creating' event listener. This listener is used
+     * to set default values when a new model instance is being created.
+     *
+     * @return void
+     */
+    protected static function boot()
+    {
+        parent::boot();
+
+        static::creating(function ($model) {
+            $model->namespace = empty($model->namespace) ? static::createNamespace($model->name) : $model->namespace;
+            $model->version   = '0.0.1';
+            $model->status    = 'private';
+            $model->key       = Str::slug($model->name);
+        });
+    }
+
+    /**
+     * Creates a namespaced string based on the provided name.
+     *
+     * This method generates a namespaced string using the company's name
+     * retrieved from the authenticated user's company, followed by a fixed
+     * segment ':order-config:', and the provided name. This is used to
+     * create a unique namespace for each model instance.
+     *
+     * @param string $name the name to be included in the namespace
+     *
+     * @return string the generated namespaced string
+     */
+    public static function createNamespace(string $name): string
+    {
+        $company = Auth::getCompany();
+
+        return Str::slug($company->name) . ':order-config:' . Str::slug($name);
+    }
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function company()
+    {
+        return $this->belongsTo(Order::class);
+    }
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function author()
+    {
+        return $this->belongsTo(\Fleetbase\Models\User::class);
+    }
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function category()
+    {
+        return $this->belongsTo(\Fleetbase\Models\Category::class);
+    }
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function icon()
+    {
+        return $this->belongsTo(\Fleetbase\Models\File::class);
+    }
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany
+     */
+    public function customFields()
+    {
+        return $this->belongsTo(\Fleetbase\Models\CustomField::class);
+    }
+
+    /**
+     * Accessor method for getting the type attribute of the order config.
+     *
+     * @return string the type of the order config
+     */
+    public function getTypeAttribute()
+    {
+        return 'order-config';
+    }
+
+    /**
+     * Sets the order context for the current order config.
+     *
+     * @param Order $order the order to set as the context
+     *
+     * @return self returns the instance for chaining
+     */
+    public function setOrderContext(Order $order): self
+    {
+        $this->orderContext = $order;
+
+        return $this;
+    }
+
+    /**
+     * Retrieves the current order context, setting it if not already set.
+     *
+     * @param Order|null $order the order to use as context if no current context is set
+     *
+     * @return Order|null the current order context
+     *
+     * @throws \Exception if no order context is found and none is provided
+     */
+    public function getOrderContext(?Order $order = null): ?Order
+    {
+        if (!$this->orderContext && $order instanceof Order) {
+            $this->setOrderContext($order);
+
+            return $order;
+        }
+
+        if (!$this->orderContext) {
+            throw new \Exception('No order context found to run order config.');
+        }
+
+        return $this->orderContext;
+    }
+
+    /**
+     * Retrieves all activities defined in the order config's flow.
+     *
+     * @return Collection a collection of Activity objects
+     */
+    public function activities(): Collection
+    {
+        $activities = collect();
+        foreach ($this->flow as $activity) {
+            $activities->push(new Activity($activity, $this->flow));
+        }
+
+        return $activities;
+    }
+
+    /**
+     * Retrieves the 'created' activity from the flow.
+     *
+     * @return Activity|null the created Activity object or null if not found
+     */
+    public function getCreatedActivity(): ?Activity
+    {
+        return $this->activities()->firstWhere('code', 'created');
+    }
+
+    /**
+     * Retrieves the 'dispatched' activity from the flow.
+     *
+     * @return Activity|null the dispatched Activity object or null if not found
+     */
+    public function getDispatchActivity(): ?Activity
+    {
+        return $this->activities()->firstWhere('code', 'dispatched');
+    }
+
+    /**
+     * Determines the current activity based on the order's status.
+     *
+     * @param Order|null $order the order to evaluate
+     *
+     * @return Activity|null the current Activity object or null if not found
+     */
+    public function currentActivity(?Order $order = null): ?Activity
+    {
+        $order = $this->getOrderContext($order);
+
+        return $this->activities()->firstWhere('code', $order->status);
+    }
+
+    /**
+     * Determines the next set of activities based on the current activity.
+     *
+     * @param Order|null $order the order to evaluate
+     *
+     * @return Collection a collection of the next activities
+     */
+    public function nextActivity(?Order $order = null): Collection
+    {
+        $order           = $this->getOrderContext($order);
+        $currentActivity = $this->currentActivity($order);
+        if ($currentActivity) {
+            return $currentActivity->getNext($order);
+        }
+
+        return collect();
+    }
+
+    /**
+     * Retrieves the first activity in the next set of activities.
+     *
+     * @param Order|null $order the order to evaluate
+     *
+     * @return Activity|null the first Activity object in the next set or null if not found
+     */
+    public function nextFirstActivity(?Order $order = null): ?Activity
+    {
+        $next            = collect();
+        $order           = $this->getOrderContext($order);
+        $currentActivity = $this->currentActivity($order);
+        if ($currentActivity) {
+            $next = $currentActivity->getNext($order);
+        }
+
+        return $next->first();
+    }
+
+    /**
+     * Retrieves the activity that follows after the next activity.
+     *
+     * @param Order|null $order the order to evaluate
+     *
+     * @return Activity|null the Activity object that follows after the next or null if not found
+     */
+    public function afterNextActivity(?Order $order = null): ?Activity
+    {
+        $afterNext       = collect();
+        $order           = $this->getOrderContext($order);
+        $nextActivity    = $this->nextFirstActivity($order);
+        if ($nextActivity) {
+            $afterNext = $nextActivity->getNext($order);
+        }
+
+        return $afterNext->first();
+    }
+
+    /**
+     * Retrieves the previous activities based on the current activity.
+     *
+     * @param Order|null $order the order to evaluate
+     *
+     * @return Collection a collection of previous activities
+     */
+    public function previousActivity(?Order $order = null): Collection
+    {
+        $order           = $this->getOrderContext($order);
+        $currentActivity = $this->currentActivity($order);
+        if ($currentActivity) {
+            return $currentActivity->getPrevious($order);
+        }
+
+        return collect();
+    }
+
+    /**
+     * Creates an Activity instance representing a canceled order.
+     *
+     * This method constructs an Activity object with specific attributes
+     * like key, code, status, and details, indicating that the order has been canceled.
+     * It utilizes the flow associated with the OrderConfig for this purpose.
+     *
+     * @return Activity a new Activity instance representing a canceled order
+     */
+    public function getCanceledActivity()
+    {
+        $canceledActivity = $this->activities()->firstWhere('code', 'canceled');
+        if ($canceledActivity) {
+            return $canceledActivity;
+        }
+
+        return new Activity([
+            'key'      => 'order_canceled',
+            'code'     => 'canceled',
+            'status'   => 'Order canceled',
+            'details'  => 'Order was canceled',
+            'complete' => false,
+        ], $this->flow);
+    }
+
+    /**
+     * Creates an Activity instance representing a completed order.
+     *
+     * This method constructs an Activity object with specific attributes
+     * such as key, code, status, and details, indicating that the order has been completed.
+     * It leverages the flow associated with the OrderConfig to construct this Activity.
+     *
+     * @return Activity a new Activity instance representing a completed order
+     */
+    public function getCompletedActivity()
+    {
+        $completedActivity = $this->activities()->firstWhere('code', 'completed');
+        if ($completedActivity) {
+            return $completedActivity;
+        }
+
+        return new Activity([
+            'key'      => 'order_completed',
+            'code'     => 'completed',
+            'status'   => 'Order completed',
+            'details'  => 'Order was completed',
+            'complete' => true,
+        ], $this->flow);
+    }
+
+    /**
+     * Creates an Activity instance representing a started order.
+     *
+     * This method constructs an Activity object with specific attributes
+     * such as key, code, status, and details, indicating that the order has been started.
+     * It leverages the flow associated with the OrderConfig to construct this Activity.
+     *
+     * @return Activity a new Activity instance representing a started order
+     */
+    public function getStartedActivity()
+    {
+        $startedActivity = $this->activities()->firstWhere('code', 'started');
+        if ($startedActivity) {
+            return $startedActivity;
+        }
+
+        return new Activity([
+            'key'      => 'order_started',
+            'code'     => 'started',
+            'status'   => 'Order started',
+            'details'  => 'Order has started',
+            'complete' => false,
+        ], $this->flow);
+    }
+}

package/server/src/Models/Payload.php

@@ -3,6 +3,7 @@
 namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\FleetOps\Flow\Activity;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Http\Resources\Internal\v1\Payload as PayloadResource;
 use Fleetbase\LaravelMysqlSpatial\Types\Point;
@@ -578,6 +579,7 @@ class Payload extends Model
         }
 
         $this->load('order');
+
         return $this->order;
     }
 
@@ -585,6 +587,7 @@ class Payload extends Model
     {
         Waypoint::where('payload_uuid', $this->uuid)->delete();
         $this->setRelation('waypoints', collect());
+
         return $this;
     }
 
@@ -699,12 +702,11 @@ class Payload extends Model
     /**
      * Set the first waypoint and update activity.
      *
-     * @param array $activity
      * @param Point $location
      *
      * @return void
      */
-    public function setFirstWaypoint($activity = null, $location = null)
+    public function setFirstWaypoint(?Activity $activity = null, $location = null)
     {
         $destination = null;
 
@@ -728,27 +730,26 @@ class Payload extends Model
     /**
      * Update the current waypoint activity and it's entities.
      *
-     * @param array                               $activity
      * @param Point                               $location
      * @param \Fleetbase\Models\Proof|string|null $proof    resolvable proof of delivery/activity
      *
      * @return $this
      */
-    public function updateWaypointActivity($activity = null, $location = null, $proof = null)
+    public function updateWaypointActivity(?Activity $activity = null, $location = null, $proof = null)
     {
-        if ($this->isMultipleDropOrder && is_array($activity) && $location) {
+        if ($this->isMultipleDropOrder && Utils::isActivity($activity) && $location) {
             // update activity for the current waypoint
             $currentWaypoint = $this->waypointMarkers->firstWhere('place_uuid', $this->current_waypoint_uuid);
 
             if ($currentWaypoint) {
-                $currentWaypoint->insertActivity($activity['status'], $activity['details'], $location, $activity['code'], $proof);
+                $currentWaypoint->insertActivity($activity, $location, $proof);
             }
 
             // update activity for all entities for this destination/waypoint
             $entities = $this->entities->where('destination_uuid', $this->current_waypoint_uuid);
 
             foreach ($entities as $entity) {
-                $entity->insertActivity($activity['status'], $activity['details'], $location, $activity['code'], $proof);
+                $entity->insertActivity($activity, $location, $proof);
             }
         }
 

package/server/src/Notifications/OrderAssigned.php

@@ -65,7 +65,7 @@ class OrderAssigned extends Notification implements ShouldQueue
     /**
      * Get the channels the event should broadcast on.
      *
-     * @return \Illuminate\Broadcasting\Channel|array
+     * @return Channel|array
      */
     public function broadcastOn()
     {

package/server/src/Notifications/OrderCanceled.php

@@ -65,7 +65,7 @@ class OrderCanceled extends Notification implements ShouldQueue
     /**
      * Get the channels the event should broadcast on.
      *
-     * @return \Illuminate\Broadcasting\Channel|array
+     * @return Channel|array
      */
     public function broadcastOn()
     {

package/server/src/Notifications/OrderDispatchFailed.php

@@ -59,7 +59,7 @@ class OrderDispatchFailed extends Notification implements ShouldQueue
     /**
      * Get the channels the event should broadcast on.
      *
-     * @return \Illuminate\Broadcasting\Channel|array
+     * @return Channel|array
      */
     public function broadcastOn()
     {

package/server/src/Notifications/OrderDispatched.php

@@ -77,7 +77,7 @@ class OrderDispatched extends Notification implements ShouldQueue
     /**
      * Get the channels the event should broadcast on.
      *
-     * @return \Illuminate\Broadcasting\Channel|array
+     * @return Channel|array
      */
     public function broadcastOn()
     {

package/server/src/Notifications/OrderPing.php

@@ -82,7 +82,7 @@ class OrderPing extends Notification implements ShouldQueue
     /**
      * Get the channels the event should broadcast on.
      *
-     * @return \Illuminate\Broadcasting\Channel|array
+     * @return Channel|array
      */
     public function broadcastOn()
     {

package/server/src/Providers/FleetOpsServiceProvider.php

@@ -6,8 +6,9 @@ use Brick\Geo\Engine\GeometryEngineRegistry;
 use Brick\Geo\Engine\GEOSEngine;
 use Fleetbase\Providers\CoreServiceProvider;
 use Fleetbase\Support\NotificationRegistry;
+use Fleetbase\Support\Utils;
 
-if (!class_exists(CoreServiceProvider::class)) {
+if (!Utils::classExists(CoreServiceProvider::class)) {
     throw new \Exception('FleetOps cannot be loaded without `fleetbase/core-api` installed!');
 }
 
@@ -45,6 +46,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
         \Fleetbase\FleetOps\Console\Commands\DispatchOrders::class,
         \Fleetbase\FleetOps\Console\Commands\TrackOrderDistanceAndTime::class,
         \Fleetbase\FleetOps\Console\Commands\FixDriverCompanies::class,
+        \Fleetbase\FleetOps\Console\Commands\FixLegacyOrderConfigs::class,
     ];
 
     /**

package/server/src/Providers/NotificationServiceProvider.php

@@ -4,8 +4,9 @@ namespace Fleetbase\FleetOps\Providers;
 
 use Fleetbase\Providers\CoreServiceProvider;
 use Fleetbase\Support\NotificationRegistry;
+use Fleetbase\Support\Utils;
 
-if (!class_exists(CoreServiceProvider::class)) {
+if (!Utils::classExists(CoreServiceProvider::class)) {
     throw new \Exception('FleetOps cannot be loaded without `fleetbase/core-api` installed!');
 }
 

package/server/src/Support/Utils.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Support;
 
+use Fleetbase\FleetOps\Flow\Activity;
 use Fleetbase\Support\Utils as FleetbaseUtils;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Facades\DB;
@@ -1276,4 +1277,20 @@ class Utils extends FleetbaseUtils
 
         return $theta_deg;
     }
+
+    /**
+     * Determines if a given object is an instance of Activity.
+     *
+     * This static method is used to check if a provided object is an
+     * instance of the Activity class. This can be useful in contexts where
+     * there is a need to verify the type of a given resource or object.
+     *
+     * @param mixed $activity the object to check
+     *
+     * @return bool returns true if the provided object is an instance of Activity, false otherwise
+     */
+    public static function isActivity($activity)
+    {
+        return $activity && $activity instanceof Activity && !empty($activity->code);
+    }
 }

package/server/src/Traits/HasTrackingNumber.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Traits;
 
+use Fleetbase\FleetOps\Flow\Activity;
 use Fleetbase\FleetOps\Models\Proof;
 use Fleetbase\FleetOps\Models\TrackingNumber;
 use Fleetbase\FleetOps\Models\TrackingStatus;
@@ -47,16 +48,16 @@ trait HasTrackingNumber
     /**
      * Creates activity for this resource tracking number.
      *
-     * @param string                              $status   the short status update
-     * @param string                              $details  the detailed update
      * @param array|Point                         $location the location of the update, can be either [lat, lng] or a \Fleetbase\LaravelMysqlSpatial\Types\Point instance
-     * @param string                              $code     the onew word status code
      * @param \Fleetbase\Models\Proof|string|null $proof    resolvable proof of delivery/activity
      *
      * @return \Fleetbase\Models\TrackingStatus
      */
-    public function createActivity(string $status, string $details = '', $location = [], string $code = '', $proof = null): TrackingStatus
+    public function createActivity(Activity $activity, $location = [], $proof = null): TrackingStatus
     {
+        $status   = $activity->get('status');
+        $details  = $activity->get('details');
+        $code     = $activity->get('code');
         $proof    = static::resolveProof($proof);
         $activity = TrackingStatus::create([
             'company_uuid'         => data_get($this, 'company_uuid', session('company')),
@@ -82,14 +83,14 @@ trait HasTrackingNumber
     /**
      * Inserts activity for this resource tracking number.
      *
-     * @param string                              $status   the short status update
-     * @param string                              $details  the detailed update
      * @param array|Point                         $location the location of the update, can be either [lat, lng] or a \Fleetbase\LaravelMysqlSpatial\Types\Point instance
      * @param \Fleetbase\Models\Proof|string|null $proof    resolvable proof of delivery/activity
-     * @param string                              $code     the onew word status code
      */
-    public function insertActivity(string $status, string $details = '', $location = [], string $code = '', $proof = null): string
+    public function insertActivity(Activity $activity, $location = [], $proof = null): string
     {
+        $status     = $activity->get('status');
+        $details    = $activity->get('details');
+        $code       = $activity->get('code');
         $proof      = static::resolveProof($proof);
         $activityId = TrackingStatus::insertGetUuid([
             'company_uuid'         => data_get($this, 'company_uuid', session('company')),
@@ -158,7 +159,6 @@ trait HasTrackingNumber
         $this->status = $status;
 
         if ($andSave) {
-            // static::where('uuid', $this->uuid)->update(['status' => $status]);
             $this->save();
         }