- Implement task management features: add endpoints for retrieving trashed, completed, and pending tasks;

- Update Task model to use soft deletes;
- Modify API request validation; enhance frontend with task management UI;
- Update tests for new functionality.

Author: Yaroslav Pohil

app/Http/Controllers/API/TasksController.php

@@ -76,4 +76,92 @@ public function destroy(Request $request, Task $task): JsonResponse
             'message' => 'Task deleted successfully'
         ]);
     }
+
+    /**
+     * Get all trashed tasks for the authenticated user.
+     *
+     * @param Request $request
+     * @return JsonResponse
+     */
+    public function trashed(Request $request): JsonResponse
+    {
+        if ($request->user()?->cannot('view', Task::class)) {
+            abort(403, 'Forbidden');
+        }
+
+        $tasks = Task::onlyTrashed()
+            ->where('user_id', $request->user()->id)
+            ->latest()
+            ->get();
+        
+        return response()->json([
+            'data' => $tasks
+        ]);
+    }
+
+    /**
+     * Get all completed tasks for the authenticated user.
+     *
+     * @param Request $request
+     * @return JsonResponse
+     */
+    public function completed(Request $request): JsonResponse
+    {
+        if ($request->user()?->cannot('view', Task::class)) {
+            abort(403, 'Forbidden');
+        }
+
+        $tasks = Task::where('user_id', $request->user()->id)
+            ->whereNotNull('completed_at')
+            ->orderBy('completed_at', 'desc')
+            ->get();
+        
+        return response()->json([
+            'data' => $tasks
+        ]);
+    }
+
+    /**
+     * Get all pending tasks for the authenticated user.
+     *
+     * @param Request $request
+     * @return JsonResponse
+     */
+    public function pending(Request $request): JsonResponse
+    {
+        if ($request->user()?->cannot('view', Task::class)) {
+            abort(403, 'Forbidden');
+        }
+
+        $tasks = Task::where('user_id', $request->user()->id)
+            ->whereNull('completed_at')
+            ->orderBy('created_at', 'desc')
+            ->get();
+        
+        return response()->json([
+            'data' => $tasks
+        ]);
+    }
+
+    /**
+     * Mark a task as completed.
+     *
+     * @param Request $request
+     * @param Task $task
+     * @return JsonResponse
+     */
+    public function complete(Request $request, Task $task): JsonResponse
+    {
+        if ($request->user()?->cannot('update', $task)) {
+            abort(403, 'Forbidden');
+        }
+
+        $task->completed_at = now();
+        $task->save();
+        
+        return response()->json([
+            'message' => 'Task completed successfully',
+            'data' => $task
+        ]);
+    }
 }

app/Http/Requests/TaskFormRequest.php

@@ -25,15 +25,7 @@ public function rules(): array
         return [
             'title' => 'required|string|max:255',
             'description' => 'required|string',
-            'status' => [
-                'sometimes',
-                'string',
-                'in:' . implode(',', [
-                    Task::STATUS_PENDING,
-                    Task::STATUS_IN_PROGRESS,
-                    Task::STATUS_COMPLETED
-                ])
-            ],
+            'completed_at' => 'nullable|datetime',
         ];
     }
 }

app/Models/Task.php

@@ -7,33 +7,27 @@
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Support\Carbon;
 use Database\Factories\TaskFactory;
+use Illuminate\Database\Eloquent\SoftDeletes;
 
 /**
  * Task model representing a task in the system.
  *
  * @property int $id
  * @property string $title
  * @property string|null $description
- * @property string $status One of pending, in_progress, completed
  * @property int $user_id
  * @property Carbon|null $completed_at
  * @property Carbon $created_at
  * @property Carbon $updated_at
- * 
+ *
  * @property-read User $user
- * 
+ *
  * @method static TaskFactory factory($count = null, $state = [])
  */
 class Task extends Model
 {
     use HasFactory;
-
-    /**
-     * Task status constants
-     */
-    public const STATUS_PENDING = 'pending';
-    public const STATUS_IN_PROGRESS = 'in_progress';
-    public const STATUS_COMPLETED = 'completed';
+    use SoftDeletes;
 
     /**
      * The attributes that are mass assignable.
@@ -43,7 +37,6 @@ class Task extends Model
     protected $fillable = [
         'title',
         'description',
-        'status',
         'user_id',
         'completed_at',
     ];
@@ -59,15 +52,4 @@ public function user(): BelongsTo
     {
         return $this->belongsTo(User::class);
     }
-
-    public static function boot()
-    {
-        parent::boot();
-
-        static::updating(function ($task) {
-            if ($task->isDirty('status') && $task->status === self::STATUS_COMPLETED) {
-                $task->completed_at = now();
-            }
-        });
-    }
 }

database/factories/TaskFactory.php

@@ -21,48 +21,16 @@ public function definition(): array
         return [
             'title' => fake()->sentence(4),
             'description' => fake()->paragraph(),
-            'status' => fake()->randomElement([
-                Task::STATUS_PENDING,
-                Task::STATUS_IN_PROGRESS,
-                Task::STATUS_COMPLETED
-            ]),
             'user_id' => User::factory(),
-            'completed_at' => function (array $attributes) {
-                return $attributes['status'] === Task::STATUS_COMPLETED ? now() : null;
-            },
-        ];
-    }
-    
-    /**
-     * Indicate that the task is pending.
-     */
-    public function pending(): static
-    {
-        return $this->state(fn (array $attributes) => [
-            'status' => Task::STATUS_PENDING,
-            'completed_at' => null,
-        ]);
-    }
-    
-    /**
-     * Indicate that the task is in progress.
-     */
-    public function inProgress(): static
-    {
-        return $this->state(fn (array $attributes) => [
-            'status' => Task::STATUS_IN_PROGRESS,
             'completed_at' => null,
-        ]);
+        ];
     }
-    
-    /**
-     * Indicate that the task is completed.
-     */
+
     public function completed(): static
     {
         return $this->state(fn (array $attributes) => [
-            'status' => Task::STATUS_COMPLETED,
             'completed_at' => now(),
         ]);
     }
+    
 }

database/migrations/2025_05_05_074028_create_tasks_table.php

@@ -14,9 +14,9 @@ public function up(): void
             $table->id();
             $table->string('title');
             $table->text('description')->nullable();
-            $table->enum('status', ['pending', 'in_progress', 'completed'])->default('pending');
             $table->foreignId('user_id')->constrained()->onDelete('cascade');
             $table->timestamp('completed_at')->nullable();
+            $table->softDeletes();
             $table->timestamps();
         });
     }