2026-09-17 23:01:26 -07:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace App\Models;
|
|
|
|
|
|
2026-09-18 15:34:35 -07:00
|
|
|
use App\TodoStatus;
|
2026-09-17 23:01:26 -07:00
|
|
|
use Database\Factories\TodoFactory;
|
|
|
|
|
use Illuminate\Database\Eloquent\Attributes\Fillable;
|
|
|
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
|
|
|
use Illuminate\Database\Eloquent\Model;
|
|
|
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
|
|
|
use Illuminate\Support\Carbon;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* @property int $id
|
|
|
|
|
* @property int $user_id
|
|
|
|
|
* @property int $folder_id
|
|
|
|
|
* @property string $description
|
|
|
|
|
* @property string|null $notes
|
2026-09-18 15:34:35 -07:00
|
|
|
* @property TodoStatus $status
|
2026-09-17 23:01:26 -07:00
|
|
|
* @property Carbon|null $due_date
|
|
|
|
|
* @property Carbon|null $completed_at
|
|
|
|
|
* @property Folder $folder
|
|
|
|
|
* @property Carbon|null $created_at
|
|
|
|
|
* @property Carbon|null $updated_at
|
|
|
|
|
*/
|
2026-09-18 15:34:35 -07:00
|
|
|
#[Fillable(['user_id', 'folder_id', 'description', 'notes', 'status', 'due_date', 'completed_at'])]
|
2026-09-17 23:01:26 -07:00
|
|
|
class Todo extends Model
|
|
|
|
|
{
|
|
|
|
|
/** @use HasFactory<TodoFactory> */
|
|
|
|
|
use HasFactory;
|
|
|
|
|
|
|
|
|
|
/** @return BelongsTo<User, $this> */
|
|
|
|
|
public function user(): BelongsTo
|
|
|
|
|
{
|
|
|
|
|
return $this->belongsTo(User::class);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** @return BelongsTo<Folder, $this> */
|
|
|
|
|
public function folder(): BelongsTo
|
|
|
|
|
{
|
|
|
|
|
return $this->belongsTo(Folder::class);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Get the attributes that should be cast.
|
|
|
|
|
*
|
|
|
|
|
* @return array<string, string>
|
|
|
|
|
*/
|
|
|
|
|
protected function casts(): array
|
|
|
|
|
{
|
|
|
|
|
return [
|
|
|
|
|
'due_date' => 'date',
|
|
|
|
|
'completed_at' => 'datetime',
|
2026-09-18 15:34:35 -07:00
|
|
|
'status' => TodoStatus::class,
|
2026-09-17 23:01:26 -07:00
|
|
|
];
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope the query to todos owned by the given user.
|
|
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeForUser(Builder $query, User|int $user): Builder
|
|
|
|
|
{
|
|
|
|
|
return $query->where('user_id', $user instanceof User ? $user->id : $user);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope the query to todos that have not been completed.
|
|
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeIncomplete(Builder $query): Builder
|
|
|
|
|
{
|
|
|
|
|
return $query->whereNull('completed_at');
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope the query to todos that have been completed.
|
|
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeCompleted(Builder $query): Builder
|
|
|
|
|
{
|
|
|
|
|
return $query->whereNotNull('completed_at');
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
2026-09-18 15:34:35 -07:00
|
|
|
* Scope the query to todos that still need attention: not completed
|
|
|
|
|
* and not cancelled or deferred.
|
|
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeActive(Builder $query): Builder
|
|
|
|
|
{
|
|
|
|
|
return $query->incomplete()->whereNotIn('status', [
|
|
|
|
|
TodoStatus::Cancelled->value,
|
|
|
|
|
TodoStatus::Deferred->value,
|
|
|
|
|
]);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Scope the query to active todos whose due date has already passed.
|
2026-09-17 23:01:26 -07:00
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeOverdue(Builder $query): Builder
|
|
|
|
|
{
|
2026-09-18 15:34:35 -07:00
|
|
|
return $query->active()->whereDate('due_date', '<', now());
|
2026-09-17 23:01:26 -07:00
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
2026-09-18 15:34:35 -07:00
|
|
|
* Scope the query to active todos due today.
|
2026-09-17 23:01:26 -07:00
|
|
|
*
|
|
|
|
|
* @param Builder<Todo> $query
|
|
|
|
|
* @return Builder<Todo>
|
|
|
|
|
*/
|
|
|
|
|
public function scopeDueToday(Builder $query): Builder
|
|
|
|
|
{
|
2026-09-18 15:34:35 -07:00
|
|
|
return $query->active()->whereDate('due_date', today());
|
2026-09-17 23:01:26 -07:00
|
|
|
}
|
|
|
|
|
}
|