osb/app/Models/User.php

512 lines
11 KiB
PHP
Raw Normal View History

2017-11-03 05:26:07 +00:00
<?php
2021-06-29 03:18:52 +00:00
namespace App\Models;
2017-11-03 05:26:07 +00:00
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Support\Collection;
use Illuminate\Database\Eloquent\Collection as DatabaseCollection;
use Illuminate\Support\Facades\Cache;
2020-07-21 06:39:23 +00:00
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Session;
2018-07-13 04:53:44 +00:00
use Laravel\Passport\HasApiTokens;
use Leenooks\Traits\ScopeActive;
2018-07-13 04:53:44 +00:00
use Leenooks\Traits\UserSwitch;
2017-11-03 05:26:07 +00:00
use App\Interfaces\IDs;
2020-07-21 06:39:23 +00:00
use App\Notifications\ResetPassword as ResetPasswordNotification;
use App\Traits\{QueryCacheableConfig,SiteID};
/**
* Class User
*
* Attributes for users:
* + role : User's role
*/
class User extends Authenticatable implements IDs
2017-11-03 05:26:07 +00:00
{
use HasFactory,HasApiTokens,Notifiable,UserSwitch,QueryCacheableConfig,SiteID,ScopeActive;
private const CACHE_TIME = 3600;
2020-02-10 11:07:46 +00:00
2020-02-08 11:51:50 +00:00
protected $dates = [
'created_at',
'updated_at',
'last_access'
];
/**
* The attributes that are mass assignable.
*
* @var array
*/
protected $fillable = [
'name',
'email',
'password',
2020-02-08 11:51:50 +00:00
];
/**
* The attributes that should be hidden for arrays.
*
* @var array
*/
protected $hidden = [
'password',
'remember_token',
];
2020-04-18 22:33:41 +00:00
/**
* Role hierarchy order
*
2020-04-18 22:33:41 +00:00
* @var array
*/
public const role_order = [
2020-04-18 22:33:41 +00:00
'wholesaler',
'reseller',
'customer',
];
/* OVERRIDES */
/**
* Users password reset email notification
*
* @param string $token
*/
public function sendPasswordResetNotification($token)
{
$this->notify((new ResetPasswordNotification($token))->onQueue('high'));
}
/* INTERFACES */
public function getLIDAttribute(): string
{
return sprintf('#%04s',$this->id);
}
public function getSIDAttribute(): string
{
return sprintf('%02s-%s',$this->site_id,$this->getLIDAttribute());
}
/* RELATIONS */
2020-02-08 11:51:50 +00:00
/**
* The accounts that this user manages
*
* @return \Illuminate\Database\Eloquent\Relations\HasMany
* @note This cannot be loaded with "with"?
2020-02-08 11:51:50 +00:00
*/
2018-07-17 04:10:40 +00:00
public function accounts()
2020-02-08 11:51:50 +00:00
{
return $this->hasMany(Account::class)
->orWhereIn('id',$this->rtm_accounts()->pluck('id'))
->active()
->with(['services']);
2020-02-08 11:51:50 +00:00
}
2018-05-20 12:53:14 +00:00
2020-02-08 11:51:50 +00:00
/**
* This users invoices
2020-02-08 11:51:50 +00:00
*
* @return \Illuminate\Database\Eloquent\Relations\HasManyThrough
2020-02-08 11:51:50 +00:00
*/
public function invoices()
{
return $this->hasManyThrough(Invoice::class,Account::class)
->active();
2018-07-13 04:53:44 +00:00
}
2020-02-08 11:51:50 +00:00
/**
* This users language configuration
*
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
*/
2018-08-01 07:09:38 +00:00
public function language()
{
2021-06-29 03:18:52 +00:00
return $this->belongsTo(Language::class);
2018-08-01 07:09:38 +00:00
}
2020-02-08 11:51:50 +00:00
/**
* The payments this user has made
*
* @return \Illuminate\Database\Eloquent\Relations\HasManyThrough
*/
2018-07-13 04:53:44 +00:00
public function payments()
{
2021-06-29 03:18:52 +00:00
return $this->hasManyThrough(Payment::class,Account::class);
2018-07-13 04:53:44 +00:00
}
/**
* Return the routes to market account for this user
*
* @return \Illuminate\Database\Eloquent\Relations\HasOneThrough
*/
public function rtm()
{
return $this->hasOneThrough(Rtm::class,Account::class);
}
2020-02-08 11:51:50 +00:00
/**
* THe services this user has
*
* @return \Illuminate\Database\Eloquent\Relations\HasManyThrough
*/
2018-07-13 04:53:44 +00:00
public function services()
{
2021-06-29 06:36:34 +00:00
return $this->hasManyThrough(Service::class,Account::class)
->with(['product.type'])
2021-06-29 06:36:34 +00:00
->active();
2018-07-13 04:53:44 +00:00
}
/* ATTRIBUTES */
2018-07-13 04:53:44 +00:00
2020-02-08 11:51:50 +00:00
/**
* This is an alias method, as it is used by the framework
2020-02-08 11:51:50 +00:00
*
* @return string
2020-02-08 11:51:50 +00:00
*/
public function getNameAttribute(): string
2018-08-08 23:33:51 +00:00
{
return $this->getFullNameAttribute();
2018-08-08 23:33:51 +00:00
}
2018-07-06 06:57:49 +00:00
/**
* Logged in users full name
*
* @return string
*/
2020-02-08 11:51:50 +00:00
public function getFullNameAttribute(): string
2018-07-06 06:57:49 +00:00
{
return sprintf('%s %s',$this->firstname,$this->lastname);
}
/**
* Return my accounts
*
* @return Collection
*/
public function getMyAccountsAttribute(): Collection
{
return $this->accounts->where('user_id',$this->id);
}
/**
* Return a friendly string of this persons role
* @return string
*/
public function getRoleAttribute(): string
{
return ucfirst($this->role());
}
2018-08-09 14:10:51 +00:00
public function getSurFirstNameAttribute()
2018-08-08 23:33:51 +00:00
{
2018-08-09 14:10:51 +00:00
return sprintf('%s, %s',$this->lastname,$this->firstname);
2018-08-08 23:33:51 +00:00
}
/* SCOPES */
2018-08-09 14:10:51 +00:00
/**
* Search for a record
*
2020-02-08 11:51:50 +00:00
* @param $query
* @param string $term
*/
public function scopeSearch($query,string $term)
{
// Build our where clause
// First Name, Last name
if (preg_match('/\ /',$term)) {
2020-04-14 07:40:47 +00:00
[$fn,$ln] = explode(' ',$term,2);
$query->where(function($query1) use ($fn,$ln,$term) {
$query1->where(function($query2) use ($fn,$ln) {
return $query2
->where('firstname','like','%'.$fn.'%')
->where('lastname','like','%'.$ln.'%');
});
});
} elseif (is_numeric($term)) {
$query->where('id','like','%'.$term.'%');
} elseif (preg_match('/\@/',$term)) {
$query->where('email','like','%'.$term.'%');
} else {
$query
->Where('firstname','like','%'.$term.'%')
->orWhere('lastname','like','%'.$term.'%');
}
return $query;
}
/* METHODS */
2020-04-14 07:40:47 +00:00
/**
* Show this user's clients with service movements
*
* A service movement, is an active service where the status is not ACTIVE
*
* @return DatabaseCollection
*/
public function client_service_movements(): DatabaseCollection
{
return Service::active()
->serviceUserAuthorised($this)
2020-04-14 07:40:47 +00:00
->where('order_status','!=','ACTIVE')
->with(['account','product'])
->get();
}
/**
* Determine if the user is an admin of the user with $id
*
* @param User|null $user
* @return bool
*/
public function isAdmin(User $user=NULL): bool
{
return $user->exists AND $this->isReseller() AND $this->accounts->pluck('user_id')->contains($user->id);
}
2018-08-09 14:10:51 +00:00
/**
* Determine if the logged in user is a reseller or wholesaler
*
* @return bool
*/
2020-02-08 11:51:50 +00:00
public function isReseller(): bool
2018-08-09 14:10:51 +00:00
{
return in_array($this->role(),['wholesaler','reseller']);
}
2020-02-08 11:51:50 +00:00
/**
* Determine if the logged in user is a wholesaler
*
* @return bool
*/
public function isWholesaler(): bool
2018-08-23 05:17:26 +00:00
{
return in_array($this->role(),['wholesaler']);
}
2020-02-08 11:51:50 +00:00
/**
* Get all the items for the next invoice
*
2020-04-14 07:40:47 +00:00
* @param bool $future
* @return DatabaseCollection
2020-02-08 11:51:50 +00:00
*/
public function next_invoice_items(bool $future=FALSE): DatabaseCollection
{
$result = new DatabaseCollection;
2022-06-14 06:51:18 +00:00
$this->services->load(['invoice_items.taxes']);
2020-02-08 11:51:50 +00:00
foreach ($this->services as $o) {
if ($future) {
if ($o->invoice_next->subDays(config('app.invoice_inadvance'))->isPast())
continue;
} else {
if ($o->invoice_next->subDays(config('app.invoice_inadvance'))->isFuture())
continue;
}
2020-02-12 10:32:57 +00:00
foreach ($o->next_invoice_items($future) as $oo)
2020-02-08 11:51:50 +00:00
$result->push($oo);
}
$result->load([
'product.description',
2020-02-08 11:51:50 +00:00
'service.type',
]);
return $result;
}
2020-07-21 06:39:23 +00:00
/**
* Return an SQL query that will return a list of invoices
*
* @return \Illuminate\Database\Query\Builder
*/
private function query_invoice_items()
{
return DB::table('invoice_items')
2020-07-21 06:39:23 +00:00
->select([
'invoice_id',
DB::raw('invoice_items.id AS invoice_item_id'),
DB::raw('IFNULL(invoice_items.discount_amt,0) AS discount'),
2020-07-21 06:39:23 +00:00
DB::raw('ROUND(CAST(quantity*price_base AS decimal(8,2)),2) AS base'),
DB::raw('ROUND(invoice_item_taxes.amount,2) AS tax'),
2020-07-21 06:39:23 +00:00
])
->leftjoin('invoice_item_taxes',['invoice_item_taxes.invoice_item_id'=>'invoice_items.id'])
2020-07-21 06:39:23 +00:00
->where('active',TRUE);
}
/**
* Return an SQL query that will return payment summaries by invoices.
*
* @return \Illuminate\Database\Query\Builder
*/
private function query_payment_items()
{
return DB::table('payment_items')
2020-07-21 06:39:23 +00:00
->select([
'payment_id',
'invoice_id',
2022-04-22 05:23:08 +00:00
DB::raw('SUM(amount) AS allocate'),
2020-07-21 06:39:23 +00:00
])
2022-04-22 05:23:08 +00:00
->where('amount','>',0)
2020-07-21 06:39:23 +00:00
->groupBy(['invoice_id','payment_id']);
}
/**
* Return an SQL query that will summarise invoices with payments
*
* @return \Illuminate\Database\Query\Builder
2021-06-29 06:36:34 +00:00
* @todo change this to just return outstanding invoices as a collection.
2020-07-21 06:39:23 +00:00
*/
public function query_invoice_summary()
{
$invoices = (new Invoice)
->select([
'invoice_id',
DB::raw('SUM(discount) AS discount'),
DB::raw('SUM(base) AS base'),
DB::raw('SUM(tax) AS tax'),
DB::raw('ROUND(SUM(base)+SUM(tax)-SUM(discount),2) AS total'),
DB::raw('false AS payments'),
DB::raw('false AS payment_fees'),
])
->from($this->query_invoice_items(),'II')
->join('invoices',['invoices.id'=>'II.invoice_id'])
->whereIN('account_id',$this->accounts->pluck('id'))
->where('invoices.active',TRUE)
2020-07-21 06:39:23 +00:00
->groupBy(['invoice_id']);
$payments = (new Payment)
->select([
'invoice_id',
DB::raw('false AS discount'),
DB::raw('false AS base'),
DB::raw('false AS tax'),
DB::raw('false AS total'),
DB::raw('SUM(allocate) AS payments'),
DB::raw('SUM(fees_amt) AS payment_fees'),
])
->from($this->query_payment_items(),'PI')
->join('payments',['payments.id'=>'PI.payment_id'])
->whereIN('account_id',$this->accounts->pluck('id'))
//->where('payments.active',TRUE) // @todo To implement
2020-07-21 06:39:23 +00:00
->groupBy(['invoice_id']);
$summary = (new Invoice)
->select([
'invoice_id',
DB::raw('SUM(discount) AS discount'),
DB::raw('SUM(base) AS invoice_base'),
DB::raw('SUM(tax) AS invoice_tax'),
DB::raw('SUM(total) AS invoice_total'),
DB::raw('SUM(payments) AS payments'),
DB::raw('SUM(payment_fees) AS payment_fees'),
])
->from($invoices->unionAll($payments),'invoices')
->groupBy(['invoice_id']);
return (new Invoice)
2020-07-21 06:39:23 +00:00
->select([
'account_id',
'id',
'due_at',
'created_at',
2020-07-21 06:39:23 +00:00
'discount',
'invoice_base',
'invoice_tax',
'invoice_total',
'payments',
'payment_fees',
DB::raw('ROUND(invoice_total-payments,2) AS balance'),
])
->join('invoices',['invoices.id'=>'invoice_id'])
->with(['items.taxes'])
2020-07-21 06:39:23 +00:00
->from($summary,'summary');
}
/**
* Determine what the logged in user's role is
* + Wholesaler - aka Super User
* + Reseller - services accounts on behalf of their customers
* + Customer - end user customer
*
* @return string
*/
2018-07-06 06:57:49 +00:00
public function role()
{
// Cache our role for this session
$cache_key = sprintf('%s:%s:%s',$this->id,__METHOD__,Session::getId());
return Cache::remember($cache_key,self::CACHE_TIME,function() {
// Get the RTM for our accounts
$rtms = Rtm::whereIn('account_id',$this->accounts->pluck('id'))->get();
// If I have no parent, I am the wholesaler
if ($rtms->whereNull('parent_id')->count())
return 'wholesaler';
// If I exist in the RTM table, I'm a reseller
else if ($rtms->count())
return 'reseller';
// Otherwise a client
else
return 'customer';
});
}
/**
* Return the accounts that this user can manage
* This method is a helper to User::accounts() - use $user->accounts instead
*
* @return Collection
*/
private function rtm_accounts(): Collection
{
return Account::whereIn('rtm_id',$this->rtm_list()->pluck('id'))
->get();
}
/**
* Return the RTM hierarchy that this user can manage
*
* @param Rtm|null $rtm
* @return Collection
*/
public function rtm_list(Rtm $rtm=NULL): Collection
{
// If this user doesnt manage any accounts
if (! $this->exists || ! $this->rtm)
return collect();
$list = collect();
// Add this RTM to the list
if (! $rtm) {
$list->push($this->rtm);
$children = $this->rtm->children;
} else {
$list->push($rtm);
$children =$rtm->children;
}
2018-07-06 06:57:49 +00:00
// Capture any children
foreach ($children as $child)
$list->push($this->rtm_list($child));
2018-07-06 06:57:49 +00:00
return $rtm ? $list : $list->flatten()->unique(function($item) { return $item->id; });
2018-07-06 06:57:49 +00:00
}
}