'array', ]; protected $appends = [ 'account_name', 'admin_service_id_url', 'name_short', 'next_invoice', 'product_category', 'product_name', 'service_id', 'service_id_url', 'status', ]; protected $visible = [ 'account_name', 'admin_service_id_url', 'active', 'data_orig', 'id', 'name_short', 'next_invoice', 'product_category', 'product_name', 'service_id', 'service_id_url', 'status', ]; private $inactive_status = [ 'CANCELLED', 'ORDER-REJECTED', 'ORDER-CANCELLED', ]; /** * Valid status shows the applicable next status for an action on a service * Each status can be * + Approved, to proceed to the next valid status' * + Held, to a holding pattern status * + Rejected, reverted to an different status * + Cancel, to progress down a decomission route * + Updated, stay on the current status with new information * * @var array */ private $valid_status = [ // Order Submitted 'ORDER-SUBMIT' => ['approve'=>'ORDER-SENT','hold'=>'ORDER-HOLD','reject'=>'ORDER-REJECTED','cancel'=>'ORDER-CANCELLED'], // Order On Hold (Reason) 'ORDER-HOLD' => ['release'=>'ORDER-SUBMIT','update_reference'=>'ORDER-SENT'], // Order Rejected (Reason) 'ORDER-REJECTED' => [], // Order Cancelled 'ORDER-CANCELLED' => [], // Order Sent to Supplier 'ORDER-SENT' => ['update_reference'=>'ORDER-SENT','confirm'=>'ORDERED'], // Order Confirmed by Supplier 'ORDERED' => ['update_reference'=>'ORDER-SENT'], ]; /** * Account the service belongs to * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo */ public function account() { return $this->belongsTo(Account::class); } /** * Account that ordered the service * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo */ public function orderby() { return $this->belongsTo(Account::class); } /** * Tenant that the service belongs to * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo */ public function site() { return $this->belongsTo(Site::class); } /** * Product of the service * * @return \Illuminate\Database\Eloquent\Relations\BelongsTo */ public function product() { return $this->belongsTo(Product::class); } /** * Return a child model with details of the service * * @return \Illuminate\Database\Eloquent\Relations\MorphTo */ public function type() { return $this->morphTo(null,'model','id','service_id'); } /** SCOPES **/ /** * Only query active categories */ public function scopeActive($query) { return $query->where(function () use ($query) { $query->where('active',TRUE)->orWhereNotIn('order_status',$this->inactive_status); }); } /** * Find inactive services. * * @param $query * @return mixed */ public function scopeInActive($query) { return $query->where(function () use ($query) { $query->where('active',FALSE)->orWhereIn('order_status',$this->inactive_status); }); } /** ATTRIBUTES **/ /** * Name of the account for this service * * @return mixed */ public function getAccountNameAttribute(): string { return $this->account->name; } /** * @deprecated Use getUrlAdminAttribute() */ public function getAdminServiceIdUrlAttribute() { return $this->getUrlAdminAttribute(); } /** * Date the service expires, also represents when it is paid up to * * @return string */ public function getExpiresAttribute(): string { return 'TBA'; } /** * Services Unique Identifier * * @return string */ public function getSIDAttribute(): string { return sprintf('%02s-%04s.%05s',$this->site_id,$this->account_id,$this->id); } /** * Return the date for the next invoice * * @return null */ public function getInvoiceNextAttribute() { return $this->date_next_invoice ? $this->date_next_invoice->format('Y-m-d') : NULL; } /** * Return the short name for the service. * * EG: * For ADSL, this would be the phone number, * For Hosting, this would be the domain name, etc */ public function getNameShortAttribute(): string { return $this->model ? $this->type->name : 'NAME UNKNOWN'; } /** * @deprecated see getInvoiceNextAttribute() */ public function getNextInvoiceAttribute() { return $this->getInvoiceNextAttribute(); } /** * This function will present the Order Info Details */ public function getOrderInfoDetailsAttribute(): string { if (! $this->order_info) return ''; $result = ''; foreach ($this->order_info as $k=>$v) { if (in_array($k,['order_reference'])) continue; $result .= sprintf('%s: %s
',ucfirst($k),$v); } return $result; } /** * Get the Product's Category for this service * */ public function getProductCategoryAttribute(): string { return $this->product->category; } /** * Get the Product's Short Name for the service * * @return string */ public function getProductNameAttribute(): string { return $this->product->name($this->account->language); } /** * @deprecated see getServiceIdAttribute() */ public function getServiceIdAttribute() { return $this->getSIDAttribute(); } /** * @deprecated see getUrlUserAttribute() */ public function getServiceIdUrlAttribute() { return $this->getUrlUserAttribute(); } /** * @deprecated see getServiceIdAttribute() */ public function getServiceNumberAttribute() { return $this->getSIDAttribute(); } /** * Return the Service Status * * @return string */ public function getStatusAttribute(): string { if (! $this->order_status) return $this->active ? 'ACTIVE' : 'INACTIVE'; else return $this->order_status; } /** * Return the detailed order Status, with order reference numbers. * * @return string */ public function getStatusDetailAttribute(): string { return in_array($this->order_status,['ORDER-SENT','ORDER-HOLD','ORDERED']) ? sprintf('%s: #%s',$this->order_status,Arr::get($this->order_info,'order_reference','Unknown')) : ''; } /** * URL used by an admin to administer the record * * @return string */ public function getUrlAdminAttribute(): string { return sprintf('%s',$this->id,$this->service_id); } /** * URL used by an user to see the record * * @return string */ public function getUrlUserAttribute(): string { return sprintf('%s',$this->id,$this->service_id); } /** SETTERS **/ public function setDateOrigAttribute($value) { $this->attributes['date_orig'] = $value->timestamp; } public function setDateLastAttribute($value) { $this->attributes['date_last'] = $value->timestamp; } /** FUNCTIONS **/ /** * Determine if a service is active. It is active, if active=1, or the order_status is not in inactive_status[] * * @return bool * @todo Remove active and have order_status reflect whether active or not */ public function isActive(): bool { return $this->active OR ($this->order_status AND ! in_array($this->order_status,$this->inactive_status)); } /** * @todo * @param string $status * @return $this */ public function nextStatus(string $status) { if ($x=$this->validStatus($status)) { $this->order_status = $x; $this->save(); return $this; } abort(500,'Next Status not set up for:'.$this->order_status); } /** * This function will return the associated service model for the product type * @deprecated use $this->type */ private function ServicePlugin() { // @todo: All services should be linked to a product. This might require data cleaning for old services not linked to a product. if (! is_object($this->product)) return NULL; switch ($this->product->prod_plugin_file) { case 'ADSL': return $this->service_adsl; case 'DOMAIN': return $this->service_domain; case 'HOST': return $this->service_host; case 'SSL': return $this->service_ssl; case 'VOIP': return $this->service_voip; default: return NULL; } } /** * Return if the proposed status is valid. * * @param string $status * @return string | NULL */ private function testNextStatusValid(string $status) { return Arr::get(Arr::get($this->valid_status,$this->order_status,[]),$status,NULL); } /** * @deprecated use testNextStatusValid() */ public function validStatus(string $status) { return $this->testNextStatusValid($status); } }