From 8355d57fc46baf7cc1fbd5458e59520fabd841c7 Mon Sep 17 00:00:00 2001
From: James Shiffer <jshiffer@linux.ucla.edu>
Date: Wed, 5 Nov 2025 02:18:59 -0800
Subject: [PATCH] Boilerplate for Listing resource

---
 app/Http/Controllers/ListingController.php    | 66 +++++++++++++++++++
 app/Http/Requests/StoreListingRequest.php     | 28 ++++++++
 app/Http/Requests/UpdateListingRequest.php    | 28 ++++++++
 app/Models/Listing.php                        | 12 ++++
 app/Policies/ListingPolicy.php                | 66 +++++++++++++++++++
 database/factories/ListingFactory.php         | 23 +++++++
 ...025_11_05_094705_create_listings_table.php | 33 ++++++++++
 database/seeders/ListingSeeder.php            | 17 +++++
 routes/api.php                                |  3 +
 9 files changed, 276 insertions(+)
 create mode 100644 app/Http/Controllers/ListingController.php
 create mode 100644 app/Http/Requests/StoreListingRequest.php
 create mode 100644 app/Http/Requests/UpdateListingRequest.php
 create mode 100644 app/Models/Listing.php
 create mode 100644 app/Policies/ListingPolicy.php
 create mode 100644 database/factories/ListingFactory.php
 create mode 100644 database/migrations/2025_11_05_094705_create_listings_table.php
 create mode 100644 database/seeders/ListingSeeder.php

diff --git a/app/Http/Controllers/ListingController.php b/app/Http/Controllers/ListingController.php
new file mode 100644
index 0000000..19db2ce
--- /dev/null
+++ b/app/Http/Controllers/ListingController.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\StoreListingRequest;
+use App\Http\Requests\UpdateListingRequest;
+use App\Models\Listing;
+
+class ListingController extends Controller
+{
+    /**
+     * Display a listing of the resource.
+     */
+    public function index()
+    {
+        // 
+    }
+
+    /**
+     * Show the form for creating a new resource.
+     */
+    public function create()
+    {
+        //
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(StoreListingRequest $request)
+    {
+        //
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(Listing $listing)
+    {
+        //
+    }
+
+    /**
+     * Show the form for editing the specified resource.
+     */
+    public function edit(Listing $listing)
+    {
+        //
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(UpdateListingRequest $request, Listing $listing)
+    {
+        //
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(Listing $listing)
+    {
+        //
+    }
+}
diff --git a/app/Http/Requests/StoreListingRequest.php b/app/Http/Requests/StoreListingRequest.php
new file mode 100644
index 0000000..02b64fd
--- /dev/null
+++ b/app/Http/Requests/StoreListingRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreListingRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Http/Requests/UpdateListingRequest.php b/app/Http/Requests/UpdateListingRequest.php
new file mode 100644
index 0000000..a3b58e3
--- /dev/null
+++ b/app/Http/Requests/UpdateListingRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateListingRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return false;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/app/Models/Listing.php b/app/Models/Listing.php
new file mode 100644
index 0000000..d61b376
--- /dev/null
+++ b/app/Models/Listing.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class Listing extends Model
+{
+    /** @use HasFactory<\Database\Factories\ListingFactory> */
+    use HasFactory;
+}
diff --git a/app/Policies/ListingPolicy.php b/app/Policies/ListingPolicy.php
new file mode 100644
index 0000000..a0c4e43
--- /dev/null
+++ b/app/Policies/ListingPolicy.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Policies;
+
+use App\Models\Listing;
+use App\Models\User;
+use Illuminate\Auth\Access\Response;
+
+class ListingPolicy
+{
+    /**
+     * Determine whether the user can view any models.
+     */
+    public function viewAny(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can view the model.
+     */
+    public function view(User $user, Listing $listing): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can create models.
+     */
+    public function create(User $user): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can update the model.
+     */
+    public function update(User $user, Listing $listing): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can delete the model.
+     */
+    public function delete(User $user, Listing $listing): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can restore the model.
+     */
+    public function restore(User $user, Listing $listing): bool
+    {
+        return false;
+    }
+
+    /**
+     * Determine whether the user can permanently delete the model.
+     */
+    public function forceDelete(User $user, Listing $listing): bool
+    {
+        return false;
+    }
+}
diff --git a/database/factories/ListingFactory.php b/database/factories/ListingFactory.php
new file mode 100644
index 0000000..e72f48a
--- /dev/null
+++ b/database/factories/ListingFactory.php
@@ -0,0 +1,23 @@
+<?php
+
+namespace Database\Factories;
+
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Listing>
+ */
+class ListingFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            //
+        ];
+    }
+}
diff --git a/database/migrations/2025_11_05_094705_create_listings_table.php b/database/migrations/2025_11_05_094705_create_listings_table.php
new file mode 100644
index 0000000..e5cf3a5
--- /dev/null
+++ b/database/migrations/2025_11_05_094705_create_listings_table.php
@@ -0,0 +1,33 @@
+<?php
+
+use App\Models\User;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('listings', function (Blueprint $table) {
+            $table->id();
+            $table->timestamps();
+            $table->text('title')->nullable(false);
+            $table->text('description')->nullable(false);
+            $table->text('location')->nullable(false);
+            $table->decimal('price')->default(0.0);
+            $table->foreignIdFor(User::class)->nullable(false);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('listings');
+    }
+};
diff --git a/database/seeders/ListingSeeder.php b/database/seeders/ListingSeeder.php
new file mode 100644
index 0000000..0ae1bf7
--- /dev/null
+++ b/database/seeders/ListingSeeder.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace Database\Seeders;
+
+use Illuminate\Database\Console\Seeds\WithoutModelEvents;
+use Illuminate\Database\Seeder;
+
+class ListingSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        //
+    }
+}
diff --git a/routes/api.php b/routes/api.php
index ccc387f..d32fba2 100644
--- a/routes/api.php
+++ b/routes/api.php
@@ -1,8 +1,11 @@
 <?php
 
+use App\Http\Controllers\ListingController;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
 Route::get('/user', function (Request $request) {
     return $request->user();
 })->middleware('auth:sanctum');
+
+Route::resource('/listing', ListingController::class);