osb/app/Models/Service.php

1328 lines
35 KiB
PHP
Raw Normal View History

2018-05-20 12:53:14 +00:00
<?php
namespace App\Models;
use Awobaz\Compoships\Compoships;
use Carbon\Carbon;
use Exception;
2021-09-29 04:57:25 +00:00
use Illuminate\Database\Eloquent\Casts\AsCollection;
use Illuminate\Database\Eloquent\Factories\HasFactory;
2018-05-20 12:53:14 +00:00
use Illuminate\Database\Eloquent\Model;
2020-02-05 04:47:24 +00:00
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use Illuminate\Database\Eloquent\Relations\MorphTo;
use Illuminate\Support\Arr;
use Illuminate\Support\Collection;
2020-04-18 22:33:41 +00:00
use Illuminate\Support\Facades\Auth;
use Symfony\Component\HttpKernel\Exception\HttpException;
use Leenooks\Carbon as LeenooksCarbon;
use App\Models\Scopes\SiteScope;
2021-06-29 06:36:34 +00:00
use App\Interfaces\IDs;
use App\Traits\ScopeServiceUserAuthorised;
use App\Traits\SiteID;
2018-05-20 12:53:14 +00:00
2021-06-29 06:36:34 +00:00
/**
* Class Service
* Services that belong to an account
*
* Attributes for services:
2022-04-19 07:07:39 +00:00
* + additional_cost : Pending additional charges for this service (excluding setup) //@todo check all these are still valid
* + billing_charge : Charge for this service each invoice period // @todo change to "charge"
* + billing_interval : The period that this service is billed for by default
* + billing_interval_string : The period that this service is billed for by default as a name
* + billed_to : When this service has been billed to // @todo rename all references to invoice_to
* + category : The type of service this is, eg: broadband, phone
* + category_name : The type of service this is, eg: Broadband, Telephone (in human friendly)
2023-05-03 08:09:29 +00:00
* + isChargedOverride : Has the price been overridden?
2022-04-19 07:07:39 +00:00
* + contract_term : The term that this service must be active
* + contract_end : The date that the contract ends for this service
2021-09-30 02:54:44 +00:00
* + name : Service short name with service address
* + name_short : Service Product short name, eg: phone number, domain name, certificate CN
2021-09-30 02:54:44 +00:00
* + name_detail : Service Detail, eg: service_address
* + product : Our product that is providing this service
* + sid : System ID for service
* + supplied : The model of the supplier's product used for this service.
2021-06-29 06:36:34 +00:00
*
2022-04-19 07:07:39 +00:00
* = Terminology:
* - Offering, what product we supply (we make offerings from supplier's supplied products) - in the DB these are products/*
* - Supplied, our supplier's product that is providing the service - in the DB these are supplier/*
* - Type, what service we are providing, made up of a product we supply - in the DB these are service/*
*
2021-06-29 06:36:34 +00:00
* @package App\Models
2022-04-19 07:07:39 +00:00
* @todo "Billing Start Date" = "connection date" for sub types??
2021-06-29 06:36:34 +00:00
*/
class Service extends Model implements IDs
2018-05-20 12:53:14 +00:00
{
use HasFactory,ScopeServiceUserAuthorised,SiteID,Compoships;
2018-08-11 05:09:41 +00:00
protected $casts = [
2021-09-29 04:57:25 +00:00
'order_info'=>AsCollection::class,
];
2022-04-19 07:07:39 +00:00
protected $dates = [
'invoice_last_at',
'invoice_next_at',
'start_at',
'stop_at',
];
2020-02-10 11:07:46 +00:00
protected $appends = [
'category_name',
'name_short',
];
protected $visible = [
// 'account_name',
// 'admin_service_id_url',
'active',
'category_name',
// 'billing_price',
// 'data_orig',
'id',
'name_short',
// 'next_invoice',
// 'product.name',
// 'service_id',
// 'service_id_url',
// 'status',
];
2020-02-10 11:07:46 +00:00
protected $with = [
2022-06-14 06:51:18 +00:00
//'invoice_items',
//'product.type.supplied',
//'type',
2020-02-10 11:07:46 +00:00
];
public const INACTIVE_STATUS = [
'CANCELLED',
'ORDER-REJECTED',
'ORDER-CANCELLED',
];
/**
* Valid status shows the applicable next status for an action on a service
* Each status can be
2021-09-29 04:57:25 +00:00
*
* The structure of each item is:
* <ORDER_STATUS> => [
* 'next' == next possible levels, initiated by who (array).
* who = 'role','system'
* 'enter_method' == the method run when we enter this stage - could be used to send email for example, if this method doesnt complete successfully, we dont enter this stage
* + If it returns NULL, An error condition
* + If it returns FALSE, the service cannot enter this stage
* + If it returns TRUE, the service has successfully changed to this stage
* + If it returns a VIEW/REDIRECT, that resulting page will handle the status change
* 'exit_method' == the method that determines that the order can leave this status (true = can, false = cant)
* + If it returns NULL, An error condition
* + If it returns FALSE, the service CANNOT leave this stage
* + If it returns TRUE, the service CAN leave this stage
* it will receive the next method as an argument
* 'title' == title shown on the menu, for the user to choose
* ]
* So when an order goes to the next state, the exit method will be tested immediately (if there is only 1 exit method for the user)
* to see if it can proceed further if not, it'll wait here for user/admin intervention
*
* @var array
* @todo This needs an overhaul, its not implemented correctly.
*/
2021-09-29 04:57:25 +00:00
private const ACTION_PROGRESS = [
// Order Submitted @todo redo
2020-04-18 22:33:41 +00:00
'ORDER-SUBMIT' => [
'fail'=>FALSE,
// Progress to next stages by who
'next'=>[
'ORDER-ACCEPT'=>['customer'],
'SETUP-PAYMENT-WAIT'=>['reseller','wholesaler']
],
// Manual or System moves to the next stage
'system'=>TRUE,
'method'=>'action_order_submit',
'title'=>'Order Submit',
],
2021-09-29 04:57:25 +00:00
// Client accepts order, if performed by RW @todo redo
2020-04-18 22:33:41 +00:00
'ORDER-ACCEPT' => [
'fail'=>FALSE,
'next'=>[
'SETUP-PAYMENT-WAIT'=>['customer'],
],
'system'=>FALSE,
'method'=>'action_order_accept',
'title'=>'Client Accept Order',
],
2021-09-29 04:57:25 +00:00
// If the product has a setup, collect payment information @todo redo
2020-04-18 22:33:41 +00:00
'SETUP-PAYMENT-WAIT' => [
'fail'=>FALSE,
'next'=>[
'PAYMENT-WAIT'=>['customer'],
],
'system'=>FALSE,
'method'=>'action_setup_payment_wait',
'title'=>'Setup Payment',
],
2021-09-29 04:57:25 +00:00
// @todo redo
2020-04-18 22:33:41 +00:00
'PAYMENT-WAIT' => [
'fail'=>FALSE,
'next'=>[
'PAYMENT-CHECK'=>['reseller','wholesaler'],
],
'system'=>FALSE,
'method'=>'action_payment_wait',
'title'=>'Service Payment',
],
2021-09-29 04:57:25 +00:00
// @todo redo
2020-04-18 22:33:41 +00:00
'PAYMENT-CHECK' => [
'fail'=>'ORDER-HOLD',
'next'=>[
2022-02-01 05:40:46 +00:00
'ORDER-SENT'=>['wholesaler'],
2020-04-18 22:33:41 +00:00
],
'system'=>TRUE,
'method'=>'action_payment_check',
'title'=>'Validate Payment Method',
],
2021-09-29 04:57:25 +00:00
// Order On Hold (Reason) @todo redo
2019-01-24 11:03:43 +00:00
'ORDER-HOLD' => ['release'=>'ORDER-SUBMIT','update_reference'=>'ORDER-SENT'],
2021-09-29 04:57:25 +00:00
// Order Rejected (Reason) @todo redo
2019-01-24 10:49:56 +00:00
'ORDER-REJECTED' => [],
2021-09-29 04:57:25 +00:00
// Order Cancelled @todo redo
2019-01-24 10:49:56 +00:00
'ORDER-CANCELLED' => [],
2021-09-29 04:57:25 +00:00
// Order Sent to Supplier @todo redo
2020-04-18 22:33:41 +00:00
'ORDER-SENT' => [
'fail'=>'ORDER-HOLD',
'next'=>[
'ORDERED'=>['wholesaler'],
],
'system'=>FALSE,
'method'=>'action_order_sent',
'title'=>'Send Order',
],
2021-09-29 04:57:25 +00:00
// Order Confirmed by Supplier @todo redo
'ORDERED' => [
'fail'=>false,
'next'=>[
'PROVISION-HOLD'=>['wholesaler'],
'PROVISION-PLANNED'=>['wholesaler'],
'PROVISIONED'=>['wholesaler'],
],
'system'=>FALSE,
'method'=>'action_ordered',
'title'=>'Service Ordered',
],
2021-09-29 04:57:25 +00:00
// Service confirmed by supplier, optional connection date @todo redo
'PROVISION-PLANNED' => [
'fail'=>false,
'next'=>[
'PROVISIONED'=>['wholesaler'],
],
'system'=>FALSE,
'method'=>'action_provision_planned',
'title'=>'Provision Planned',
],
2021-09-29 04:57:25 +00:00
// Service has been provisioned by supplier @todo redo
'PROVISIONED' => [
'fail'=>false,
'next'=>[
'ACTIVE'=>['wholesaler'],
],
'system'=>FALSE,
'method'=>'action_provisioned',
'title'=>'Provisioned',
],
// Service is Active
2020-04-22 12:54:05 +00:00
'ACTIVE' => [
'next'=>[
'CANCEL-REQUEST'=>['customer'],
2021-09-29 04:57:25 +00:00
'CHANGE-REQUEST'=>['customer'],
2020-04-22 12:54:05 +00:00
],
2021-09-29 04:57:25 +00:00
'exit'=>'action_active_exit',
2020-04-22 12:54:05 +00:00
'title'=>'Service Active',
],
// Service to be Upgraded
2021-09-29 04:57:25 +00:00
'CANCEL-CANCEL' => [
2020-04-22 12:54:05 +00:00
'next'=>[
2021-09-29 04:57:25 +00:00
'ACTIVE'=>['wholesaler'],
2020-04-22 12:54:05 +00:00
],
2021-09-29 04:57:25 +00:00
'enter_method'=>'action_cancel_cancel',
'title'=>'Cancel Cancellation Request',
2020-04-22 12:54:05 +00:00
],
// Service to be Cancelled
2020-04-22 12:54:05 +00:00
'CANCEL-REQUEST' => [
'next'=>[
2021-09-29 04:57:25 +00:00
'CANCEL-CANCEL'=>['wholesaler'],
'CANCEL-PENDING'=>['wholesaler'],
2020-04-22 12:54:05 +00:00
],
2021-09-29 04:57:25 +00:00
'enter_method'=>'action_request_enter_redirect',
'exit_method'=>'action_cancel_request_exit',
'title'=>'Cancel Request',
],
// Service Cancellation being processed
'CANCEL-PENDING' => [
'next'=>[
'CANCELLED'=>['wholesaler'],
],
'enter_method'=>'action_cancel_pending_enter',
'exit_method'=>'action_cancel_pending_exit',
'title'=>'Cancel Pending',
],
2022-08-03 05:47:09 +00:00
'CANCELLED'=> [
'title'=>'Service Cancelled',
'enter_method'=>'action_cancelled',
],
2021-09-29 04:57:25 +00:00
// Service to be Upgraded
'CHANGE-CANCEL' => [
'next'=>[
'ACTIVE'=>['wholesaler'],
],
'enter_method'=>'action_change_cancel',
'title'=>'Cancel Change Request',
],
// Service to be Upgraded
'CHANGE-REQUEST' => [
'next'=>[
'CHANGE-PENDING'=>['wholesaler'],
'CHANGE-CANCEL'=>['wholesaler'],
],
'enter_method'=>'action_request_enter_redirect',
'title'=>'Change Service',
2020-04-22 12:54:05 +00:00
],
2022-08-03 05:47:09 +00:00
// Service is waiting on a supplier to activate a change
'CHANGE-PENDING' => [
'next'=>[
'ACTIVE'=>['wholesaler'],
],
'enter_method'=>'action_request_enter_redirect',
'title'=>'Activate Change',
],
2018-08-11 05:09:41 +00:00
];
/* INTERFACES */
/**
* Service Local ID
*
* @return string
*/
public function getLIDattribute(): string
{
return sprintf('%05s',$this->id);
}
/**
* Services System ID
*
* @return string
*/
public function getSIDAttribute(): string
{
return sprintf('%02s-%04s.%s',$this->site_id,$this->account_id,$this->getLIDattribute());
}
/* RELATIONS */
2019-01-24 10:49:56 +00:00
/**
* Account the service belongs to
*
2020-02-05 04:47:24 +00:00
* @return BelongsTo
2019-01-24 10:49:56 +00:00
*/
2018-05-20 12:53:14 +00:00
public function account()
{
return $this->belongsTo(Account::class,['account_id','site_id'],['id','site_id'])
->withoutGlobalScope(SiteScope::class);
2018-05-20 12:53:14 +00:00
}
2020-02-05 04:47:24 +00:00
/**
* Return automatic billing details
*
* @return HasOne
*/
public function billing()
{
return $this->hasOne(AccountBilling::class);
}
2019-07-02 05:28:27 +00:00
/**
* Return Charges associated with this Service
*
2020-02-05 04:47:24 +00:00
* @return HasMany
2019-07-02 05:28:27 +00:00
*/
public function charges()
{
return $this->hasMany(Charge::class,['service_id','site_id'],['id','site_id'])
->withoutGlobalScope(SiteScope::class)
2019-07-02 05:28:27 +00:00
->where('active','=',TRUE)
2022-06-11 07:43:09 +00:00
->orderBy('created_at');
2019-07-02 05:28:27 +00:00
}
// @todo changed to invoiced_items
2019-06-29 00:14:12 +00:00
public function invoice_items($active=TRUE)
{
$query = $this->hasMany(InvoiceItem::class,['service_id','site_id'],['id','site_id'])
->withoutGlobalScope(SiteScope::class)
2019-07-02 05:28:27 +00:00
->where('item_type','=',0)
->orderBy('start_at');
2019-06-29 00:14:12 +00:00
2021-06-29 06:36:34 +00:00
// @todo Change to $query->active();
2019-06-29 00:14:12 +00:00
if ($active)
$query->where('active','=',TRUE);
return $query;
}
/**
* Invoices for this service
*/
public function invoices($active=TRUE)
{
$query = $this->hasManyThrough(Invoice::class,InvoiceItem::class,NULL,'id',NULL,'invoice_id')
->when($this->site_id,function($q) {
return $q->where('invoices.site_id', $this->site_id)
->withoutGlobalScope(SiteScope::class);
})
2019-06-29 00:14:12 +00:00
->distinct('id')
->where('invoices.site_id','=',$this->site_id)
->where('invoice_items.site_id','=',$this->site_id)
->orderBy('created_at')
->orderBy('due_at');
2019-06-29 00:14:12 +00:00
if ($active)
$query->where('invoice_items.active','=',TRUE)
->where('invoices.active','=',TRUE);
2019-06-29 00:14:12 +00:00
return $query;
}
2019-01-24 10:49:56 +00:00
/**
* Account that ordered the service
*
2020-02-05 04:47:24 +00:00
* @return BelongsTo
2019-01-24 10:49:56 +00:00
*/
2020-02-05 04:47:24 +00:00
public function orderedby()
{
return $this->belongsTo(Account::class,['ordered_by','site_id'],['id','site_id'])
->withoutGlobalScope(SiteScope::class);
}
2019-01-24 10:49:56 +00:00
/**
2019-06-29 00:14:12 +00:00
* Product of the service
2019-01-24 10:49:56 +00:00
*
2020-02-05 04:47:24 +00:00
* @return BelongsTo
2019-01-24 10:49:56 +00:00
*/
2019-06-29 00:14:12 +00:00
public function product()
{
return $this->belongsTo(Product::class,['product_id','site_id'],['id','site_id'])
->withoutGlobalScope(SiteScope::class);
}
/**
* Return a child model with details of the service
*
2020-02-05 04:47:24 +00:00
* @return MorphTo
*/
public function type()
{
return $this->morphTo(null,'model','id','service_id');
}
/* SCOPES */
2019-01-24 10:49:56 +00:00
/**
* Only query active categories
2019-01-24 10:49:56 +00:00
*/
public function scopeActive($query)
2018-05-20 12:53:14 +00:00
{
return $query->where(function () use ($query) {
2021-06-29 06:36:34 +00:00
$query->where($this->getTable().'.active',TRUE)
->orWhereNotIn('order_status',self::INACTIVE_STATUS);
});
2018-05-20 12:53:14 +00:00
}
2018-11-21 02:46:16 +00:00
/**
* Find inactive services.
*
* @param $query
* @return mixed
*/
public function scopeInActive($query)
{
return $query->where(function () use ($query) {
2021-06-29 06:36:34 +00:00
$query->where($this->getTable().'.active',FALSE)
->orWhereIn('order_status',self::INACTIVE_STATUS);
2018-11-21 02:46:16 +00:00
});
}
/**
* Enable to perform queries without eager loading
*
* @param $query
* @return mixed
*/
public function scopeNoEagerLoads($query){
return $query->setEagerLoads([]);
}
/**
* Search for a record
*
* @param $query
* @param string $term
* @return mixed
*/
public function scopeSearch($query,string $term)
{
2022-06-14 06:51:18 +00:00
$t = '%'.$term.'%';
return $query->select('services.*')
->where('services.id','like',$t)
->leftJoin('service_broadband',['service_broadband.service_id'=>'services.id'])
->orWhere('service_broadband.service_number','like',$t)
->orWhere('service_broadband.service_address','like',$t)
->orWhere('service_broadband.ipaddress','like',$t)
->leftJoin('service_phone',['service_phone.service_id'=>'services.id'])
->orWhere('service_phone.service_number','like',$t)
->orWhere('service_phone.service_address','like',$t)
->leftJoin('service_domain',['service_domain.service_id'=>'services.id'])
->orWhere('service_domain.domain_name','like',$t)
->leftJoin('service_email',['service_email.service_id'=>'services.id'])
->orWhere('service_email.domain_name','like',$t)
->leftJoin('service_host',['service_host.service_id'=>'services.id'])
->orWhere('service_host.domain_name','like',$t);
}
/* ATTRIBUTES */
/**
* How much do we charge for this service, base on the current recur schedule
2020-02-05 04:47:24 +00:00
*
* @return float
2020-02-05 04:47:24 +00:00
*/
public function getBillingChargeAttribute(): float
2019-06-29 00:14:12 +00:00
{
// @todo Temporary for services that dont have recur_schedule set.
if (is_null($this->recur_schedule) OR is_null($this->product->getBaseChargeAttribute($this->recur_schedule,$this->account->group)))
$this->price=0;
return $this->addTax(is_null($this->price) ? $this->product->getBaseChargeAttribute($this->recur_schedule,$this->account->group) : $this->price);
2019-06-29 00:14:12 +00:00
}
/**
2019-06-29 00:14:12 +00:00
* Return the service billing period
*
* @return int
*/
public function getBillingIntervalAttribute(): int
{
return $this->recur_schedule ?: $this->product->getBillingIntervalAttribute();
}
/**
* Return a human friendly name for the billing interval
*
* @return string
*/
public function getBillingIntervalStringAttribute(): string
{
return Invoice::billing_name($this->getBillingIntervalAttribute());
}
/**
* Determine a monthly price for a service, even if it is billed at a different frequency
*
* @return float
* @throws Exception
*/
public function getBillingMonthlyPriceAttribute(): float
{
return number_format($this->getBillingChargeAttribute()/Arr::get(Invoice::billing_periods,$this->recur_schedule.'.interval',1),2);
}
public function getCategoryAttribute(): string
{
return $this->product->category;
}
public function getCategoryNameAttribute(): string
{
return $this->product->category_name;
}
2022-04-19 07:07:39 +00:00
/**
* The date the contract ends
*
* Service contracts end the later of the start_date + contract_term or the expire date.
*
* @return Carbon
*/
public function getContractEndAttribute(): ?Carbon
2022-04-19 07:07:39 +00:00
{
// If we have no start date or expire date, then NULL;
if (! $this->start_at && ! $this->type->expire_at)
return NULL;
// If we dont have a start date, use the expire date
if (! $this->start_at)
return $this->type->expire_at;
$end = $this->start_at->addMonths($this->getContractTermAttribute());
// If we dont have an expire date, use the start date + contract_term
if (! $this->type->expire_at)
return $end;
// We have both, so it's the later of the two.
return ($end < $this->type->expire_at) ? $this->type->expire_at : $end;
}
/**
* This function will determine the minimum contract term for a service, which is the maximum of
* supplier->type->contract_term, or the product->type->contract_term;
*
* @return int
*/
public function getContractTermAttribute(): int
2018-06-05 11:13:57 +00:00
{
return $this->getSuppliedAttribute()->contract_term;
2018-06-05 11:13:57 +00:00
}
/**
2019-06-29 00:14:12 +00:00
* Date the service expires, also represents when it is paid up to
*
* @return string
2021-06-29 06:36:34 +00:00
* @todo
*/
2019-06-29 00:14:12 +00:00
public function getExpiresAttribute(): string
2018-08-01 07:09:38 +00:00
{
abort(500,'Not implemented');
2019-06-29 00:14:12 +00:00
return 'TBA';
2018-08-01 07:09:38 +00:00
}
/**
* Return the date for the next invoice
*
* @return LeenooksCarbon
*/
public function getInvoiceNextAttribute(): LeenooksCarbon
2018-11-21 03:37:17 +00:00
{
2019-06-29 00:14:12 +00:00
$last = $this->getInvoiceToAttribute();
return $last
2020-02-12 10:32:57 +00:00
? $last->addDay()
: ($this->invoice_next_at ? $this->invoice_next_at->clone() : ($this->start_at ?: LeenooksCarbon::now()));
}
/**
* We need to cast some dates to LeenooksCarbon to get access to startOfHalf()/endOfHalf() methods
*
* @param $value
* @return LeenooksCarbon|null
*/
public function getInvoiceNextAtAttribute($value): ?LeenooksCarbon
{
return $value ? LeenooksCarbon::create($value) : NULL;
2019-07-02 05:28:27 +00:00
}
/**
* Return the end date for the next invoice
*
* @return mixed
* @throws Exception
*/
2019-07-02 05:28:27 +00:00
public function getInvoiceNextEndAttribute()
{
switch ($this->recur_schedule) {
case Invoice::BILL_WEEKLY:
$date = $this->product->price_recur_strict
? $this->getInvoiceNextAttribute()->endOfWeek()
: $this->getInvoiceNextAttribute()->addWeek()->subDay();
break;
case Invoice::BILL_MONTHLY:
$date = $this->product->price_recur_strict
? $this->getInvoiceNextAttribute()->endOfMonth()
: $this->getInvoiceNextAttribute()->addMonth()->subDay();
break;
case Invoice::BILL_QUARTERLY:
$date = $this->product->price_recur_strict
? $this->getInvoiceNextAttribute()->endOfQuarter()
: $this->getInvoiceNextAttribute()->addQuarter()->subDay();
break;
case Invoice::BILL_SEMI_YEARLY:
$date = $this->product->price_recur_strict
? $this->getInvoiceNextAttribute()->endOfHalf()
: $this->getInvoiceNextAttribute()->addQuarter(2)->subDay();
break;
case Invoice::BILL_YEARLY:
$date = $this->product->price_recur_strict
? $this->getInvoiceNextAttribute()->endOfYear()
: $this->getInvoiceNextAttribute()->addYear()->subDay();
break;
case Invoice::BILL_TWOYEARS:
if (! $this->product->price_recur_strict) {
$date = $this->getInvoiceNextAttribute()->addYear(2)->subDay();
} else {
$date = $this->getInvoiceNextAttribute()->addYear(2)->subDay()->endOfYear();
if ($date->clone()->addDay()->year%2)
$date = $date->subYear();
}
break;
// NOTE: price_recur_strict ignored
case Invoice::BILL_THREEYEARS:
$date = $this->getInvoiceNextAttribute()->addYear(3)->subDay();
break;
// NOTE: price_recur_strict ignored
case Invoice::BILL_FOURYEARS:
$date = $this->getInvoiceNextAttribute()->addYear(4)->subDay();
break;
// NOTE: price_recur_strict ignored
case Invoice::BILL_FIVEYEARS:
$date = $this->getInvoiceNextAttribute()->addYear(5)->subDay();
break;
default:
throw new Exception('Unknown recur_schedule');
}
2020-04-22 12:54:05 +00:00
// If the invoice has an end date, our invoice period shouldnt be greater than that.
if ($this->stop_at AND $this->stop_at < $date)
$date = $this->stop_at;
2020-04-22 12:54:05 +00:00
return $date;
}
/**
* Determine how much quantity (at the charge rate) is required for the next invoice
*
* @return float
* @throws Exception
*/
public function getInvoiceNextQuantityAttribute(): float
{
// If we are not rounding to the first day of the cycle, then it is always a full cycle
if (! $this->product->price_recur_strict)
return 1;
$n = $this->invoice_next->diff($this->invoice_next_end)->days+1;
switch ($this->recur_schedule) {
case Invoice::BILL_WEEKLY:
$d = $this->invoice_next->addWeek()->startOfWeek()->diff($this->invoice_next_end->startOfWeek())->days;
break;
case Invoice::BILL_MONTHLY:
$d = $this->invoice_next->addMonth()->startOfMonth()->diff($this->invoice_next_end->startOfMonth())->days;
break;
case Invoice::BILL_QUARTERLY:
$d = $this->invoice_next->addQuarter()->startOfQuarter()->diff($this->invoice_next_end->startOfQuarter())->days;
break;
case Invoice::BILL_SEMI_YEARLY:
2020-07-06 06:13:53 +00:00
$d = $this->invoice_next->addQuarter(2)->startOfHalf()->diff($this->invoice_next_end->startOfHalf())->days;
break;
case Invoice::BILL_YEARLY:
$d = $this->invoice_next->addYear()->startOfYear()->diff($this->invoice_next_end->startOfYear())->days;
break;
case Invoice::BILL_TWOYEARS:
$d = $this->invoice_next->addYear(2)->startOfYear()->diff($this->invoice_next_end->subyear(2))->days-1;
break;
case Invoice::BILL_THREEYEARS:
$d = $this->invoice_next->addYear(3)->startOfYear()->diff($this->invoice_next_end->subyear(3))->days-1;
break;
case Invoice::BILL_FOURYEARS:
$d = $this->invoice_next->addYear(3)->startOfYear()->diff($this->invoice_next_end->subyear(4))->days-1;
break;
case Invoice::BILL_FIVEYEARS:
$d = $this->invoice_next->addYear(3)->startOfYear()->diff($this->invoice_next_end->subyear(5))->days-1;
break;
default:
throw new Exception('Unknown recur_schedule');
2019-07-02 05:28:27 +00:00
}
2019-06-29 00:14:12 +00:00
return round($n/$d,2);
2019-06-29 00:14:12 +00:00
}
/**
* Get the date that the service has been invoiced to
*
* @return LeenooksCarbon|null
2019-06-29 00:14:12 +00:00
*/
public function getInvoiceToAttribute(): ?LeenooksCarbon
2019-06-29 00:14:12 +00:00
{
return ($x=$this->invoice_items->filter(function($item) { return $item->item_type === 0;}))->count()
? $x->last()->stop_at
2020-04-01 12:35:06 +00:00
: NULL;
2018-11-21 03:37:17 +00:00
}
2021-06-29 06:36:34 +00:00
/**
* The full name for a service, comprised of the short name and the description
2021-06-29 06:36:34 +00:00
*
* @return string
*/
2019-07-02 05:28:27 +00:00
public function getNameAttribute(): string
{
2021-09-30 02:54:44 +00:00
return $this->getNameShortAttribute().(($x=$this->getNameDetailAttribute()) ? ': '.$x : '');
2019-07-02 05:28:27 +00:00
}
/**
* Return the short name for the service.
*
* EG:
2020-04-01 12:35:06 +00:00
* + For ADSL, this would be the phone number,
* + For Hosting, this would be the domain name, etc
*/
public function getNameShortAttribute()
{
2022-08-20 13:01:03 +00:00
return ($this->type && $this->type->getServiceNameAttribute()) ? $this->type->getServiceNameAttribute() : 'SID:'.$this->sid;
2021-09-30 02:54:44 +00:00
}
/**
* Return the service description.
* For:
* + Broadband, this is the service address
* + Domains, blank
* + Hosting, blank
* + SSL, blank
*
* @return string
*/
public function getNameDetailAttribute()
2018-06-05 11:13:57 +00:00
{
return ($this->type && ($this->type->getServiceDescriptionAttribute() !== NULL)) ? $this->type->getServiceDescriptionAttribute() : 'No Description';
}
2022-04-19 07:07:39 +00:00
/**
* The product we supply for this service
*
* @return Model
*/
public function getOfferingAttribute(): Model
{
return $this->product->type;
}
2020-04-18 22:33:41 +00:00
public function getOrderInfoNotesAttribute(): ?string
2019-01-24 03:40:33 +00:00
{
2020-04-18 22:33:41 +00:00
return $this->getOrderInfoValue('notes');
}
2019-01-24 03:40:33 +00:00
2020-04-18 22:33:41 +00:00
public function getOrderInfoReferenceAttribute(): ?string
{
return $this->getOrderInfoValue('reference');
2019-01-24 03:40:33 +00:00
}
2020-02-05 04:47:24 +00:00
/**
* Work out when this service has been paid to.
*
* @return Carbon|null
2020-02-05 04:47:24 +00:00
*/
public function getPaidToAttribute(): ?Carbon
2020-02-05 04:47:24 +00:00
{
if (! $this->invoices->count())
return NULL;
foreach ($this->invoices->reverse() as $o)
if ($o->due == 0)
break;
2020-02-05 04:47:24 +00:00
return $o->items
->filter(function($item) {
return $item->item_type === 0;
})
->last()
->stop_at;
2018-05-20 12:53:14 +00:00
}
/**
* Return the billing recurring configuration for this service
*
* @param $value
* @return int
*/
public function getRecurScheduleAttribute($value): int
{
// If recur_schedule not set, default to quarterly
return $value ?? Invoice::BILL_QUARTERLY;
2020-02-05 04:47:24 +00:00
}
/**
* We need to cast some dates to LeenooksCarbon to get access to startOfHalf()/endOfHalf() methods
*
* @param $value
* @return LeenooksCarbon
*/
public function getStartAtAttribute($value): LeenooksCarbon
{
return LeenooksCarbon::create($value);
}
/**
* Return the Service Status
*
* @return string
*/
public function getStatusAttribute(): string
2018-08-11 05:09:41 +00:00
{
if (! $this->order_status)
return $this->active ? 'ACTIVE' : 'INACTIVE';
else
return $this->order_status;
}
/**
* Return an HTML status box
2019-06-29 00:14:12 +00:00
*
* @return string
* @todo Add in the other status'
2019-06-29 00:14:12 +00:00
*/
public function getStatusHTMLAttribute(): string
{
$class = NULL;
if ($this->isPending())
$class = 'badge-warning';
else
switch ($this->status)
{
case 'ACTIVE':
$class = 'badge-success';
break;
case 'INACTIVE':
$class = 'badge-danger';
break;
}
return $class
? sprintf('<span class="badge %s">%s</span>',$class,$this->status)
: $this->status;
2019-06-29 00:14:12 +00:00
}
/**
* Return the product that supplies this service
* ie: product/*
*
* @return Model
*/
public function getSuppliedAttribute(): Model
{
return $this->getOfferingAttribute()->supplied;
2018-08-11 05:09:41 +00:00
}
2021-09-29 04:57:25 +00:00
/* METHODS */
2020-04-22 12:54:05 +00:00
/**
* Processing when service has been ordered.
*
* @return bool|null
2021-09-29 04:57:25 +00:00
* @todo Check
*/
private function action_ordered(): ?bool
{
// N/A
return TRUE;
}
2020-04-18 22:33:41 +00:00
/**
* Process for an order when status ORDER-ACCEPT stage.
* This method should have the client confirm/accept the order, if it was placed by a reseller/wholesaler.
*
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_order_accept(): ?bool
{
// @todo TO IMPLEMENT
return TRUE;
}
/**
* Action method when status ORDER_SENT
* This method redirects to a form, where updating the form will progress to the next stage.
2021-09-29 04:57:25 +00:00
*
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_order_sent(string $next)
2020-04-18 22:33:41 +00:00
{
// We can proceed to the ordered status
if ($next == 'ORDERED' AND $this->order_info_reference)
return TRUE;
2020-04-18 22:33:41 +00:00
throw new HttpException(301,url('r/service/update',$this->id));
}
/**
* Action method when status ORDER_SUBMIT
*
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_order_submit(): ?bool
{
// @todo TO IMPLEMENT
return TRUE;
}
/**
* Action when supplier has confirmed provisioning.
*
* @param string $next
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
*/
private function action_provision_planned(string $next)
{
throw new HttpException(301,url('r/service/update',$this->id));
}
2020-04-18 22:33:41 +00:00
/**
* Process for an order when status SETUP-PAYMENT-WAIT stage.
* This method should collect any setup fees payment.
*
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_setup_payment_wait(): ?bool
{
// @todo TO IMPLEMENT
return TRUE;
}
/**
* Process for an order when status PAYMENT-CHECK stage.
* This method should validate any payment details.
*
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_payment_check(): ?bool
{
// @todo TO IMPLEMENT
return TRUE;
}
/**
* Process for an order when status PAYMENT-WAIT stage.
* This method should collect any service payment details.
*
* @return bool
2021-09-29 04:57:25 +00:00
* @todo Check
2020-04-18 22:33:41 +00:00
*/
private function action_payment_wait(): ?bool
{
// @todo TO IMPLEMENT
return TRUE;
}
2021-09-29 04:57:25 +00:00
/**
* Work out the next applicable actions for this service status, taking into account the user's role
*
* @notes
* + Clients can only progress 1 step, if they are in the next step.
* + Resellers/Wholesales can progress to the next Reseller/Wholesaler and any steps in between.
* @return Collection
*/
public function actions(): Collection
{
$next = $this->getStageParameters($this->order_status)->get('next');
return $next
? $next->map(function($item,$key) {
$authorized = FALSE;
if ($x=Arr::get(self::ACTION_PROGRESS,$key))
foreach ($item as $role) {
if ($this->isAuthorised($role)) {
$authorized = TRUE;
break;
}
}
return $authorized ? $x['title'] : NULL;
})->filter()->sort()
: collect();
}
/**
* Add applicable tax to the cost
*
* @todo This needs to be calculated, not fixed at 1.1
* @todo move all tax calculations into product
* @param float $value
* @return float
*/
private function addTax(float $value): float
{
return round($value*1.1,2);
}
2020-04-18 22:33:41 +00:00
private function getOrderInfoValue(string $key): ?string
{
return $this->order_info ? $this->order_info->get($key) : NULL;
}
/**
2021-09-29 04:57:25 +00:00
* Get the stage parameters
2020-04-18 22:33:41 +00:00
*
* @param string $stage
2021-09-29 04:57:25 +00:00
* @return Collection
2020-04-18 22:33:41 +00:00
*/
2021-09-29 04:57:25 +00:00
public function getStageParameters(string $stage): Collection
2020-04-18 22:33:41 +00:00
{
2021-09-29 04:57:25 +00:00
$result = Arr::get(self::ACTION_PROGRESS,$stage);
$myrole = array_search(Auth::user()->role(),User::role_order);
2020-04-18 22:33:41 +00:00
// If we have no valid next stage, return an empty collection.
2021-09-29 04:57:25 +00:00
if (($myrole === FALSE) || (! $result))
return collect();
2020-04-18 22:33:41 +00:00
// Filter the result based on who we are
$next = collect();
2021-09-29 04:57:25 +00:00
if (array_key_exists('next',$result) && count($result['next'])) {
foreach ($result['next'] as $action => $roles) {
// Can the current user do this role?
$cando = FALSE;
2020-04-18 22:33:41 +00:00
2021-09-29 04:57:25 +00:00
foreach ($roles as $role) {
if ($myrole <= array_search($role,User::role_order)) {
2021-09-29 04:57:25 +00:00
$cando = TRUE;
2020-04-18 22:33:41 +00:00
2021-09-29 04:57:25 +00:00
break;
2020-04-18 22:33:41 +00:00
}
}
2021-09-29 04:57:25 +00:00
if ($cando)
$next->put($action,$roles);
2020-04-18 22:33:41 +00:00
}
2021-09-29 04:57:25 +00:00
$result['next'] = $next;
2020-04-18 22:33:41 +00:00
}
2021-09-29 04:57:25 +00:00
return collect($result);
2020-04-18 22:33:41 +00:00
}
/**
* Does this service have traffic data to be graphed
*
* @return bool
*/
public function hasUsage(): bool
{
return $this->product->hasUsage();
}
/**
* Determine if a service is active. It is active, if active=1, or the order_status is not in self::INACTIVE_STATUS[]
*
* @return bool
* @todo Remove active and have order_status reflect whether active or not
*/
public function isActive(): bool
2018-08-11 05:09:41 +00:00
{
return $this->active OR ($this->order_status AND ! in_array($this->order_status,self::INACTIVE_STATUS));
2018-08-11 05:09:41 +00:00
}
2021-09-29 04:57:25 +00:00
/**
* Determine if the current user has the role for this service
*
* @param string $role
* @return bool
* @todo Can we use the gates to achieve this?
2021-09-29 04:57:25 +00:00
*/
public function isAuthorised(string $role): bool
{
switch(Auth::user()->role()) {
// Wholesalers are site admins, they can see everything
case 'wholesaler':
return TRUE;
case 'reseller':
switch ($role) {
case 'wholesaler':
return FALSE;
// Check service is in the resellers/customers list
case 'reseller':
case 'customer':
2021-09-29 07:11:46 +00:00
return TRUE;
2021-09-29 04:57:25 +00:00
default:
abort(500,'Unknown role for reseller: '.$role);
}
case 'customer':
switch ($role) {
case 'reseller':
case 'wholesaler':
return FALSE;
// Check service is in the customers list
case 'customer':
2021-09-29 07:11:46 +00:00
return TRUE;
2021-09-29 04:57:25 +00:00
default:
abort(500,'Unknown role for customer: '.$role);
}
default:
abort(500,'Unknown user role: ',Auth::user()->role());
}
return FALSE;
}
/**
* Do we bill for this service
*
* @return bool
*/
public function isBilled(): bool
{
return ! ($this->external_billing || $this->suspend_billing || ($this->price === 0));
}
/**
* Should this service be invoiced soon
*
* @param int $days
* @return bool
*/
public function isInvoiceDueSoon($days=30): bool
2019-07-02 05:28:27 +00:00
{
return $this->isBilled() AND $this->getInvoiceNextAttribute()->lessThan(now()->addDays($days));
}
2019-07-02 05:28:27 +00:00
2020-02-05 04:47:24 +00:00
/**
* Identify if a service is being ordered, ie: not active yet nor cancelled
2020-02-05 04:47:24 +00:00
*
* @return bool
*/
public function isPending(): bool
{
return ! $this->active
AND ! is_null($this->order_status)
AND ! in_array($this->order_status,array_merge(self::INACTIVE_STATUS,['INACTIVE']));
2020-02-05 04:47:24 +00:00
}
2023-05-03 08:09:29 +00:00
public function isChargeOverriden(): bool
{
return (! is_null($this->price)) || (! is_null($this->price_override));
}
/**
* Generate a collection of invoice_item objects that will be billed for the next invoice
*
2020-04-01 12:35:06 +00:00
* @param bool $future Next item to be billed (not in the next x days)
* @param Carbon|null $billdate
* @return Collection
* @throws Exception
* @todo This query is expensive.
*/
public function next_invoice_items(bool $future,Carbon $billdate=NULL): Collection
{
if ($this->wasCancelled() OR (! $this->isBilled()) OR (! $future AND ! $this->active))
2020-02-12 10:32:57 +00:00
return collect();
if (is_null($billdate))
$billdate = Carbon::now()->addDays(30);
// If pending, add any connection charges
2020-02-12 10:32:57 +00:00
// Connection charges are only charged once
if ((! $this->invoice_items->filter(function($item) { return $item->item_type==4; })->sum('total'))
2020-04-01 12:35:06 +00:00
AND ($this->isPending() OR is_null($this->invoice_to))
AND $this->product->getSetupChargeAttribute($this->recur_schedule,$this->account->group))
2020-02-12 10:32:57 +00:00
{
$o = new InvoiceItem;
2020-02-12 10:32:57 +00:00
$o->active = TRUE;
$o->service_id = $this->id;
$o->product_id = $this->product_id;
2020-04-01 12:35:06 +00:00
$o->item_type = 4; // @todo change to const or something
$o->price_base = $this->product->getSetupChargeAttribute($this->recur_schedule,$this->account->group);
//$o->recurring_schedule = $this->recur_schedule;
$o->start_at = $this->invoice_next;
$o->stop_at = $this->invoice_next;
$o->quantity = 1;
2020-04-01 12:35:06 +00:00
$o->site_id = 1; // @todo
2020-02-08 11:51:50 +00:00
$o->addTaxes($this->account->country->taxes);
2020-02-12 10:32:57 +00:00
$this->invoice_items->push($o);
}
// If the service is active, there will be service charges
2020-02-20 11:54:28 +00:00
if ((! $this->invoice_items->filter(function($item) { return $item->item_type==0 AND ! $item->exists; })->count())
2020-04-01 12:35:06 +00:00
AND ($this->active OR $this->isPending())
2020-04-22 12:54:05 +00:00
AND (
(($future == TRUE) AND $this->invoice_next < $this->invoice_next_end) OR
(($future == FALSE) AND ($this->invoice_to < ($this->stop_at ?: $billdate)))
2020-04-22 12:54:05 +00:00
))
{
2020-02-12 10:32:57 +00:00
do {
$o = new InvoiceItem;
$o->active = TRUE;
$o->service_id = $this->id;
$o->product_id = $this->product_id;
$o->item_type = 0;
2020-04-01 12:35:06 +00:00
$o->price_base = is_null($this->price)
? (is_null($this->price_override) ? $this->product->getBaseChargeAttribute($this->recur_schedule,$this->account->group) : $this->price_override)
2020-04-01 12:35:06 +00:00
: $this->price; // @todo change to a method in this class
$o->recur_schedule = $this->recur_schedule;
$o->start_at = $this->invoice_next;
$o->stop_at = $this->invoice_next_end;
2020-02-12 10:32:57 +00:00
$o->quantity = $this->invoice_next_quantity;
2020-04-01 12:35:06 +00:00
$o->site_id = 1; // @todo
2020-02-12 10:32:57 +00:00
$o->addTaxes($this->account->country->taxes);
$this->invoice_items->push($o);
} while ($future == FALSE AND ($this->invoice_to < ($this->stop_at ?: $billdate)));
}
2020-04-01 12:35:06 +00:00
// Add additional charges
if ((($future == TRUE) OR (($future == FALSE) AND ($this->invoice_to >= $billdate)))
AND ! $this->invoice_items->filter(function($item) { return $item->module_id == 30 AND ! $item->exists; })->count())
{
2020-04-01 12:35:06 +00:00
foreach ($this->charges->filter(function($item) { return ! $item->processed; }) as $oo) {
$o = new InvoiceItem;
$o->active = TRUE;
$o->service_id = $oo->service_id;
$o->product_id = $this->product_id;
$o->quantity = $oo->quantity;
$o->item_type = $oo->type;
$o->price_base = $oo->amount;
$o->start_at = $oo->start_at;
$o->stop_at = $oo->stop_at;
2020-04-01 12:35:06 +00:00
$o->module_id = 30; // @todo This shouldnt be hard coded
$o->module_ref = $oo->id;
$o->site_id = 1; // @todo
$o->addTaxes($this->account->country->taxes);
$this->invoice_items->push($o);
}
}
2019-07-02 05:28:27 +00:00
2020-02-12 10:32:57 +00:00
return $this->invoice_items->filter(function($item) { return ! $item->exists; });
2019-07-02 05:28:27 +00:00
}
2020-02-12 10:32:57 +00:00
/**
* Service that was cancelled or never provisioned
*
* @return bool
*/
public function wasCancelled(): bool
{
return in_array($this->order_status,self::INACTIVE_STATUS);
2020-02-12 10:32:57 +00:00
}
}