Organisation registration process implemented with configurable approval workflow

src/Database/Models/Organisation.php

@@ -151,6 +151,9 @@ class Organisation extends Model implements OrganisationInterface
         if ($hardDelete) {
             static::$ci->get('organisation.beforeDelete')($this);
 
+            // Remove all organisation tokens
+            $classMapper->getClassMapping('organisation_approval')::where('organisation_id', $this->id)->delete();
+
             // Remove all member associations
             $this->members()->detach();
 

src/Database/Models/OrganisationApproval.php

@@ -0,0 +1,116 @@
+<?php
+
+/*
+ * AVSDev UF Organisations (https://avsdev.uk)
+ *
+ * @link      https://git.avsdev.uk/avsdev/sprinkle-organisations
+ * @license   https://git.avsdev.uk/avsdev/sprinkle-organisations/blob/master/LICENSE.md (LGPL-3.0 License)
+ */
+
+namespace UserFrosting\Sprinkle\Organisations\Database\Models;
+
+use Illuminate\Database\Capsule\Manager as DB;
+use UserFrosting\Sprinkle\Core\Database\Models\Model;
+
+/**
+ * Organisation Approval Class.
+ *
+ * Represents a pending organisation approval request.
+ *
+ * @author Craig Williams (https://avsdev.uk)
+ *
+ * @property int      $requester_id
+ * @property int      $organisation_id
+ * @property hash     $token
+ * @property bool     $completed
+ * @property datetime $expires_at
+ * @property datetime $completed_at
+ * @property int      $approver_id
+ */
+
+class OrganisationApproval extends Model
+{
+    /**
+     * @var string The name of the table for the current model.
+     */
+    protected $table = 'organisation_approvals';
+
+    protected $fillable = [
+        'requester_id',
+        'organisation_id',
+        'hash',
+        'completed',
+        'expires_at',
+        'completed_at',
+        'approver_id,'
+    ];
+
+    /**
+     * @var bool Enable timestamps for Verifications.
+     */
+    public $timestamps = true;
+
+    /**
+     * @var string Stores the raw (unhashed) token when created, so that it can be emailed out to the user.  NOT persisted.
+     */
+    protected $token;
+
+    /**
+     * @return string
+     */
+    public function getToken()
+    {
+        return $this->token;
+    }
+
+    /**
+     * @param string $value
+     *
+     * @return self
+     */
+    public function setToken($value)
+    {
+        $this->token = $value;
+
+        return $this;
+    }
+
+    /**
+     * Get the user associated with this request of this approval.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function requester()
+    {
+        /** @var \UserFrosting\Sprinkle\Core\Util\ClassMapper $classMapper */
+        $classMapper = static::$ci->classMapper;
+
+        return $this->belongsTo($classMapper->getClassMapping('user'), 'requester_id');
+    }
+
+    /**
+     * Get the organisation associated with this approval request.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\belongsTo
+     */
+    public function organisation()
+    {
+        /** @var \UserFrosting\Sprinkle\Core\Util\ClassMapper $classMapper */
+        $classMapper = static::$ci->classMapper;
+
+        return $this->belongsTo($classMapper->getClassMapping('organisation'), 'organisation_id');
+    }
+
+    /**
+     * Get the user associated with this approval or rejection of this request.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\belongsTo
+     */
+    public function approver()
+    {
+        /** @var \UserFrosting\Sprinkle\Core\Util\ClassMapper $classMapper */
+        $classMapper = static::$ci->classMapper;
+
+        return $this->belongsTo($classMapper->getClassMapping('user'), 'approver_id');
+    }
+}