Merge pull request 'Implement ticket creation and backlog' (#9) from codex/0.1-kanban-foundation/06-ticket-creation-and-backlog into main

Reviewed-on: OpenSource/KanbanGit#9

app/Actions/Tickets/CreateProjectTicket.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Actions\Tickets;
+
+use App\Models\Project;
+use App\Models\Ticket;
+use Illuminate\Support\Facades\DB;
+
+class CreateProjectTicket
+{
+    /**
+     * @param  array{
+     *     acceptance_criteria: string|null,
+     *     description: string|null,
+     *     ticket_priority_id: int,
+     *     ticket_type_id: int,
+     *     title: string
+     * }  $attributes
+     */
+    public function handle(Project $project, array $attributes): Ticket
+    {
+        return DB::transaction(function () use ($attributes, $project): Ticket {
+            $nextSequenceNumber = (int) Ticket::query()
+                ->where('project_id', $project->id)
+                ->max('sequence_number') + 1;
+
+            return Ticket::query()->create([
+                'acceptance_criteria' => $attributes['acceptance_criteria'],
+                'board_column_id' => null,
+                'description' => $attributes['description'],
+                'project_id' => $project->id,
+                'sequence_number' => $nextSequenceNumber,
+                'ticket_key' => "{$project->key}-{$nextSequenceNumber}",
+                'ticket_priority_id' => $attributes['ticket_priority_id'],
+                'ticket_type_id' => $attributes['ticket_type_id'],
+                'title' => $attributes['title'],
+            ]);
+        });
+    }
+}

app/Http/Controllers/ProjectBacklogController.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Actions\ProjectPermissions\ProjectPermissionService;
+use App\Actions\Tickets\CreateProjectTicket;
+use App\Http\Requests\StoreProjectTicketRequest;
+use App\Models\Project;
+use App\Models\Ticket;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class ProjectBacklogController extends Controller
+{
+    public function __construct(
+        private readonly CreateProjectTicket $createProjectTicket,
+        private readonly ProjectPermissionService $projectPermissionService,
+    ) {}
+
+    public function index(Request $request, Project $project): Response
+    {
+        abort_unless(
+            $this->projectPermissionService->userCanViewProject($request->user(), $project),
+            403,
+        );
+
+        return Inertia::render('projects/Backlog', [
+            'canCreateTickets' => $this->projectPermissionService->userHasPermission($request->user(), $project, 'create'),
+            'project' => $project,
+            'status' => session('status'),
+            'ticketPriorities' => $project->ticketPriorities()->get(),
+            'ticketTypes' => $project->ticketTypes()->get(),
+            'tickets' => Ticket::query()
+                ->with(['ticketPriority', 'ticketType'])
+                ->where('project_id', $project->id)
+                ->whereNull('board_column_id')
+                ->orderByDesc('sequence_number')
+                ->get(),
+        ]);
+    }
+
+    public function store(StoreProjectTicketRequest $request, Project $project): RedirectResponse
+    {
+        abort_unless(
+            $this->projectPermissionService->userHasPermission($request->user(), $project, 'create'),
+            403,
+        );
+
+        $ticket = $this->createProjectTicket->handle($project, $request->validated());
+
+        return to_route('projects.backlog.index', $project)
+            ->with('status', "{$ticket->ticket_key} was added to the backlog.");
+    }
+}

app/Http/Requests/StoreProjectTicketRequest.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Models\Project;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StoreProjectTicketRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return $this->user() !== null;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        /** @var Project $project */
+        $project = $this->route('project');
+
+        return [
+            'acceptance_criteria' => ['nullable', 'string'],
+            'description' => ['nullable', 'string'],
+            'ticket_priority_id' => [
+                'required',
+                'integer',
+                Rule::exists('ticket_priorities', 'id')->where('project_id', $project->id),
+            ],
+            'ticket_type_id' => [
+                'required',
+                'integer',
+                Rule::exists('ticket_types', 'id')->where('project_id', $project->id),
+            ],
+            'title' => ['required', 'string', 'max:255'],
+        ];
+    }
+}

app/Models/Project.php

@@ -46,4 +46,10 @@ class Project extends Model
         return $this->hasMany(TicketType::class)
             ->orderBy('position');
     }
+
+    public function tickets(): HasMany
+    {
+        return $this->hasMany(Ticket::class)
+            ->orderByDesc('sequence_number');
+    }
 }

app/Models/Ticket.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Models;
+
+use Database\Factories\TicketFactory;
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+#[Fillable([
+    'acceptance_criteria',
+    'board_column_id',
+    'description',
+    'project_id',
+    'sequence_number',
+    'ticket_key',
+    'ticket_priority_id',
+    'ticket_type_id',
+    'title',
+])]
+class Ticket extends Model
+{
+    /** @use HasFactory<TicketFactory> */
+    use HasFactory;
+
+    public function boardColumn(): BelongsTo
+    {
+        return $this->belongsTo(BoardColumn::class);
+    }
+
+    public function project(): BelongsTo
+    {
+        return $this->belongsTo(Project::class);
+    }
+
+    public function ticketPriority(): BelongsTo
+    {
+        return $this->belongsTo(TicketPriority::class);
+    }
+
+    public function ticketType(): BelongsTo
+    {
+        return $this->belongsTo(TicketType::class);
+    }
+}

database/factories/TicketFactory.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Models\Project;
+use App\Models\Ticket;
+use App\Models\TicketPriority;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Ticket>
+ */
+class TicketFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'acceptance_criteria' => fake()->paragraph(),
+            'board_column_id' => null,
+            'description' => fake()->paragraphs(2, true),
+            'sequence_number' => 1,
+            'ticket_key' => 'TEST-1',
+            'title' => fake()->sentence(4),
+        ];
+    }
+
+    public function configure(): static
+    {
+        return $this->afterMaking(function (Ticket $ticket): void {
+            if ($ticket->project_id !== null && $ticket->ticket_type_id !== null && $ticket->ticket_priority_id !== null) {
+                return;
+            }
+
+            $project = Project::factory()->create([
+                'key' => fake()->unique()->lexify('????'),
+            ]);
+
+            app(InitializeProjectTicketMetadata::class)->handle($project);
+
+            $priority = TicketPriority::factory()->for($project)->create([
+                'name' => 'Medium',
+                'position' => 1,
+            ]);
+
+            $ticket->project_id = $project->id;
+            $ticket->ticket_type_id = $project->ticketTypes()->firstOrFail()->id;
+            $ticket->ticket_priority_id = $priority->id;
+            $ticket->sequence_number = 1;
+            $ticket->ticket_key = "{$project->key}-1";
+        });
+    }
+}

database/migrations/2026_03_25_004100_create_tickets_table.php

@@ -0,0 +1,38 @@
+<?php
+
+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('tickets', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('project_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('ticket_type_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('ticket_priority_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('board_column_id')->nullable()->constrained()->nullOnDelete();
+            $table->unsignedInteger('sequence_number');
+            $table->string('ticket_key')->unique();
+            $table->string('title');
+            $table->text('description')->nullable();
+            $table->text('acceptance_criteria')->nullable();
+            $table->timestamps();
+
+            $table->unique(['project_id', 'sequence_number']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('tickets');
+    }
+};

database/seeders/DatabaseSeeder.php

@@ -17,6 +17,7 @@ class DatabaseSeeder extends Seeder
             ProjectSeeder::class,
             BoardColumnSeeder::class,
             ProjectTicketMetadataSeeder::class,
+            TicketSeeder::class,
             TeamSeeder::class,
             ProjectAccessSeeder::class,
         ]);

database/seeders/TicketSeeder.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Database\Seeders;
+
+use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Actions\Tickets\CreateProjectTicket;
+use App\Models\Project;
+use App\Models\TicketPriority;
+use Illuminate\Database\Seeder;
+
+class TicketSeeder extends Seeder
+{
+    /**
+     * Run the database seeds.
+     */
+    public function run(): void
+    {
+        $createProjectTicket = app(CreateProjectTicket::class);
+        $initializeProjectTicketMetadata = app(InitializeProjectTicketMetadata::class);
+
+        Project::query()
+            ->orderBy('id')
+            ->get()
+            ->each(function (Project $project) use ($createProjectTicket, $initializeProjectTicketMetadata): void {
+                $initializeProjectTicketMetadata->handle($project);
+
+                $priority = $project->ticketPriorities()->first();
+
+                if ($priority === null) {
+                    $priority = TicketPriority::factory()->for($project)->create([
+                        'name' => 'Medium',
+                        'position' => 1,
+                    ]);
+                }
+
+                $defaultType = $project->ticketTypes()->firstOrFail();
+
+                $createProjectTicket->handle($project, [
+                    'acceptance_criteria' => 'The seeded ticket should be visible in the backlog list.',
+                    'description' => 'Seeded backlog item for demonstrating the first ticket workflow.',
+                    'ticket_priority_id' => $priority->id,
+                    'ticket_type_id' => $defaultType->id,
+                    'title' => 'Seed backlog item',
+                ]);
+
+                $createProjectTicket->handle($project, [
+                    'acceptance_criteria' => 'Duplicate titles must be allowed for project-local ticket keys.',
+                    'description' => 'Second seeded backlog item using the same title on purpose.',
+                    'ticket_priority_id' => $priority->id,
+                    'ticket_type_id' => $defaultType->id,
+                    'title' => 'Seed backlog item',
+                ]);
+            });
+    }
+}

docs/missing-features.md

@@ -4,6 +4,8 @@
 
 - general:
   - new skill, user resources
+  - ueberall $array['''] ersetzen durch Arr::get()
+  - (mehr über middlewares steuern)
 
 - 02:
   - Delete Projekt as Admin
@@ -25,8 +27,15 @@
   - Made ticket priority more static(change to has one) in ticket, but only show if there are more than one configured.
   - made story points more static(change to table field in table), but only show if checked in project settings → new value on Project: hasStoryPoints
   - more ticket field types (string, string array, boolean)
-
-
+- 06
+  - add Ticket Status
+    - ticketstatus can have one or more board columns
+    - one board cloumn cant be in two or more ticket statuses
+    - replace board_colum_id on ticket with ticket status id
+    - ticket status has an n:m relation in which relatin the ticket can switch
+      - (ui friendly example all following or select)
+    - change Project Backlog Controller → Project Controller
+    - remove store from project board controller and route projects/{project}/backlog, change to ticket controller, create
 
 
 - later:

resources/js/pages/projects/Backlog.vue

@@ -0,0 +1,265 @@
+<script setup lang="ts">
+import { Form, Head, Link } from '@inertiajs/vue3';
+import ProjectBacklogController from '@/actions/App/Http/Controllers/ProjectBacklogController';
+import Heading from '@/components/Heading.vue';
+import InputError from '@/components/InputError.vue';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import {
+    Card,
+    CardContent,
+    CardDescription,
+    CardHeader,
+    CardTitle,
+} from '@/components/ui/card';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import AppLayout from '@/layouts/AppLayout.vue';
+import { index as backlogIndex } from '@/routes/projects/backlog';
+import { index, show } from '@/routes/projects';
+import { metadata as metadataSettings } from '@/routes/projects/settings';
+import type { BreadcrumbItem, ProjectBacklogPageProps } from '@/types';
+
+const props = defineProps<ProjectBacklogPageProps>();
+
+const breadcrumbs: BreadcrumbItem[] = [
+    {
+        title: 'Projects',
+        href: index(),
+    },
+    {
+        title: props.project.name,
+        href: show(props.project.id),
+    },
+    {
+        title: 'Backlog',
+        href: backlogIndex(props.project.id),
+    },
+];
+
+const hasTicketMetadata =
+    props.ticketTypes.length > 0 && props.ticketPriorities.length > 0;
+</script>
+
+<template>
+    <AppLayout :breadcrumbs="breadcrumbs">
+        <Head :title="`${project.name} backlog`" />
+
+        <div class="flex flex-1 flex-col gap-6 p-4">
+            <div
+                class="flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between"
+            >
+                <div class="space-y-3">
+                    <Badge variant="outline" class="px-3 py-1">
+                        {{ project.key }}
+                    </Badge>
+                    <Heading
+                        :title="`${project.name} backlog`"
+                        description="All newly created tickets start here before they move onto the board."
+                    />
+                </div>
+
+                <Button as-child variant="outline">
+                    <Link :href="show(project.id)">Back to project</Link>
+                </Button>
+            </div>
+
+            <div
+                v-if="status"
+                class="rounded-xl border border-emerald-200 bg-emerald-50 px-4 py-3 text-sm text-emerald-900 dark:border-emerald-900/70 dark:bg-emerald-950/40 dark:text-emerald-100"
+            >
+                {{ status }}
+            </div>
+
+            <Card v-if="canCreateTickets && hasTicketMetadata">
+                <CardHeader>
+                    <CardTitle>Create ticket</CardTitle>
+                    <CardDescription>
+                        New tickets receive the next immutable project key and
+                        automatically enter backlog.
+                    </CardDescription>
+                </CardHeader>
+
+                <CardContent>
+                    <Form
+                        v-bind="ProjectBacklogController.store.form(project.id)"
+                        class="grid gap-6"
+                        v-slot="{ errors, processing }"
+                    >
+                        <div class="grid gap-2">
+                            <Label for="title">Title</Label>
+                            <Input
+                                id="title"
+                                name="title"
+                                required
+                                autofocus
+                                placeholder="Implement repository sync"
+                            />
+                            <InputError :message="errors.title" />
+                        </div>
+
+                        <div class="grid gap-2 md:grid-cols-2 md:gap-6">
+                            <div class="grid gap-2">
+                                <Label for="ticket_type_id">Type</Label>
+                                <select
+                                    id="ticket_type_id"
+                                    name="ticket_type_id"
+                                    class="rounded-md border border-input bg-background px-3 py-2 text-sm shadow-xs transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
+                                >
+                                    <option
+                                        v-for="ticketType in ticketTypes"
+                                        :key="ticketType.id"
+                                        :value="ticketType.id"
+                                    >
+                                        {{ ticketType.name }}
+                                    </option>
+                                </select>
+                                <InputError :message="errors.ticket_type_id" />
+                            </div>
+
+                            <div class="grid gap-2">
+                                <Label for="ticket_priority_id">
+                                    Priority
+                                </Label>
+                                <select
+                                    id="ticket_priority_id"
+                                    name="ticket_priority_id"
+                                    class="rounded-md border border-input bg-background px-3 py-2 text-sm shadow-xs transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
+                                >
+                                    <option
+                                        v-for="ticketPriority in ticketPriorities"
+                                        :key="ticketPriority.id"
+                                        :value="ticketPriority.id"
+                                    >
+                                        {{ ticketPriority.name }}
+                                    </option>
+                                </select>
+                                <InputError
+                                    :message="errors.ticket_priority_id"
+                                />
+                            </div>
+                        </div>
+
+                        <div class="grid gap-2">
+                            <Label for="description">Description</Label>
+                            <textarea
+                                id="description"
+                                name="description"
+                                rows="4"
+                                class="rounded-md border border-input bg-background px-3 py-2 text-sm shadow-xs transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
+                                placeholder="Describe the expected behavior and relevant context."
+                            />
+                            <InputError :message="errors.description" />
+                        </div>
+
+                        <div class="grid gap-2">
+                            <Label for="acceptance_criteria">
+                                Acceptance criteria
+                            </Label>
+                            <textarea
+                                id="acceptance_criteria"
+                                name="acceptance_criteria"
+                                rows="4"
+                                class="rounded-md border border-input bg-background px-3 py-2 text-sm shadow-xs transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50"
+                                placeholder="List the conditions that must be true before this ticket is done."
+                            />
+                            <InputError :message="errors.acceptance_criteria" />
+                        </div>
+
+                        <div class="flex items-center gap-3">
+                            <Button type="submit" :disabled="processing">
+                                Create ticket
+                            </Button>
+                        </div>
+                    </Form>
+                </CardContent>
+            </Card>
+
+            <Card v-else-if="canCreateTickets">
+                <CardContent class="flex flex-col gap-4 p-6 text-sm">
+                    <p class="text-muted-foreground">
+                        Ticket creation needs at least one type and one
+                        priority.
+                    </p>
+                    <div>
+                        <Button as-child variant="outline">
+                            <Link :href="metadataSettings(project.id)">
+                                Open ticket settings
+                            </Link>
+                        </Button>
+                    </div>
+                </CardContent>
+            </Card>
+
+            <Card class="gap-0 overflow-hidden">
+                <CardHeader class="border-b">
+                    <CardTitle>Backlog tickets</CardTitle>
+                    <CardDescription>
+                        Tickets remain here until they are moved into a board
+                        column.
+                    </CardDescription>
+                </CardHeader>
+
+                <CardContent class="p-0">
+                    <div
+                        v-if="tickets.length === 0"
+                        class="p-6 text-sm text-muted-foreground"
+                    >
+                        No backlog tickets exist yet.
+                    </div>
+
+                    <div v-else class="overflow-x-auto">
+                        <table
+                            class="min-w-full divide-y divide-border text-sm"
+                        >
+                            <thead
+                                class="bg-muted/40 text-left text-muted-foreground"
+                            >
+                                <tr>
+                                    <th class="px-4 py-3 font-medium">Key</th>
+                                    <th class="px-4 py-3 font-medium">Title</th>
+                                    <th class="px-4 py-3 font-medium">Type</th>
+                                    <th class="px-4 py-3 font-medium">
+                                        Priority
+                                    </th>
+                                </tr>
+                            </thead>
+                            <tbody class="divide-y divide-border">
+                                <tr
+                                    v-for="ticket in tickets"
+                                    :key="ticket.id"
+                                    class="bg-background"
+                                >
+                                    <td class="px-4 py-4">
+                                        <Badge variant="outline">
+                                            {{ ticket.ticket_key }}
+                                        </Badge>
+                                    </td>
+                                    <td class="px-4 py-4">
+                                        <div
+                                            class="font-medium text-foreground"
+                                        >
+                                            {{ ticket.title }}
+                                        </div>
+                                        <div
+                                            v-if="ticket.description"
+                                            class="mt-1 line-clamp-2 text-muted-foreground"
+                                        >
+                                            {{ ticket.description }}
+                                        </div>
+                                    </td>
+                                    <td class="px-4 py-4 text-muted-foreground">
+                                        {{ ticket.ticket_type.name }}
+                                    </td>
+                                    <td class="px-4 py-4 text-muted-foreground">
+                                        {{ ticket.ticket_priority.name }}
+                                    </td>
+                                </tr>
+                            </tbody>
+                        </table>
+                    </div>
+                </CardContent>
+            </Card>
+        </div>
+    </AppLayout>
+</template>

resources/js/pages/projects/Show.vue

@@ -13,6 +13,7 @@ import {
 } from '@/components/ui/card';
 import AppLayout from '@/layouts/AppLayout.vue';
 import { access, index, show } from '@/routes/projects';
+import { index as backlogIndex } from '@/routes/projects/backlog';
 import {
     board as boardSettings,
     metadata as metadataSettings,
@@ -72,9 +73,17 @@ const projectAreas = [
                     />
                 </div>
 
-                <Button as-child variant="outline">
-                    <Link :href="index()">Back to projects</Link>
-                </Button>
+                <div class="flex flex-wrap gap-3">
+                    <Button as-child variant="outline">
+                        <Link :href="backlogIndex(project.id)">
+                            Open backlog
+                        </Link>
+                    </Button>
+
+                    <Button as-child variant="outline">
+                        <Link :href="index()">Back to projects</Link>
+                    </Button>
+                </div>
             </div>
 
             <div v-if="canManageAccess" class="flex flex-wrap gap-3">

resources/js/types/models/ticket-model.ts

@@ -0,0 +1,20 @@
+import type { TicketPriorityModel } from '@/types/models/ticket-priority-model';
+import type { TicketTypeModel } from '@/types/models/ticket-type-model';
+
+export type TicketModel = {
+    id: number;
+    acceptance_criteria: string | null;
+    board_column_id: number | null;
+    description: string | null;
+    project_id: number;
+    sequence_number: number;
+    ticket_key: string;
+    ticket_priority: TicketPriorityModel;
+    ticket_priority_id: number;
+    ticket_type: TicketTypeModel;
+    ticket_type_id: number;
+    title: string;
+    created_at: string;
+    updated_at: string;
+    [key: string]: unknown;
+};

resources/js/types/page-props.ts

@@ -2,6 +2,7 @@ import type { BoardColumnModel } from '@/types/models/board-column-model';
 import type { ProjectModel } from '@/types/models/project-model';
 import type { TeamModel } from '@/types/models/team-model';
 import type { TicketFieldDefinitionModel } from '@/types/models/ticket-field-definition-model';
+import type { TicketModel } from '@/types/models/ticket-model';
 import type { TicketPriorityModel } from '@/types/models/ticket-priority-model';
 import type { TicketTypeModel } from '@/types/models/ticket-type-model';
 import type { UserModel } from '@/types/models/user-model';
@@ -60,3 +61,12 @@ export type ProjectTicketMetadataSettingsPageProps = {
     ticketPriorities: TicketPriorityModel[];
     ticketTypes: TicketTypeModel[];
 };
+
+export type ProjectBacklogPageProps = {
+    canCreateTickets: boolean;
+    project: ProjectModel;
+    status?: string | null;
+    ticketPriorities: TicketPriorityModel[];
+    tickets: TicketModel[];
+    ticketTypes: TicketTypeModel[];
+};

routes/web.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Http\Controllers\Admin\UserManagementController;
+use App\Http\Controllers\ProjectBacklogController;
 use App\Http\Controllers\ProjectBoardSettingsController;
 use App\Http\Controllers\ProjectController;
 use App\Http\Controllers\ProjectTicketMetadataSettingsController;
@@ -24,6 +25,10 @@ Route::middleware(['auth', 'verified'])->group(function () {
         ->name('projects.permissions.users.update');
     Route::patch('projects/{project}/permissions/teams/{team}', [ProjectController::class, 'updateTeamPermissions'])
         ->name('projects.permissions.teams.update');
+    Route::get('projects/{project}/backlog', [ProjectBacklogController::class, 'index'])
+        ->name('projects.backlog.index');
+    Route::post('projects/{project}/backlog', [ProjectBacklogController::class, 'store'])
+        ->name('projects.backlog.store');
 
     Route::scopeBindings()->group(function (): void {
         Route::get('projects/{project}/settings/board', [ProjectBoardSettingsController::class, 'show'])

tests/Feature/Models/ProjectTest.php

@@ -7,6 +7,7 @@ use App\Models\Project;
 use Database\Seeders\BoardColumnSeeder;
 use Database\Seeders\ProjectSeeder;
 use Database\Seeders\ProjectTicketMetadataSeeder;
+use Database\Seeders\TicketSeeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Tests\TestCase;
 
@@ -121,4 +122,23 @@ class ProjectTest extends TestCase
             $coreProject->ticketFieldDefinitions->pluck('label')->all(),
         );
     }
+
+    /**
+     * Ensure projects expose tickets ordered by descending sequence number.
+     */
+    public function test_projects_expose_tickets_ordered_by_sequence_number_desc(): void
+    {
+        $this->seed([
+            ProjectSeeder::class,
+            ProjectTicketMetadataSeeder::class,
+            TicketSeeder::class,
+        ]);
+
+        $coreProject = Project::query()->where('key', 'CORE')->firstOrFail();
+
+        $this->assertSame(
+            ['CORE-2', 'CORE-1'],
+            $coreProject->tickets->pluck('ticket_key')->all(),
+        );
+    }
 }

tests/Feature/Models/TicketTest.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Tests\Feature\Models;
+
+use App\Models\Project;
+use App\Models\Ticket;
+use Database\Seeders\BoardColumnSeeder;
+use Database\Seeders\ProjectSeeder;
+use Database\Seeders\ProjectTicketMetadataSeeder;
+use Database\Seeders\TicketSeeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class TicketTest extends TestCase
+{
+    use RefreshDatabase;
+
+    /**
+     * Ensure the ticket factory creates backlog tickets with immutable keys.
+     */
+    public function test_ticket_factory_creates_backlog_tickets(): void
+    {
+        $ticket = Ticket::factory()->create();
+
+        $this->assertNull($ticket->board_column_id);
+        $this->assertStringContainsString('-', $ticket->ticket_key);
+        $this->assertSame(1, $ticket->sequence_number);
+    }
+
+    /**
+     * Ensure the ticket seeder creates duplicate titles with project-local keys.
+     */
+    public function test_ticket_seeder_creates_backlog_tickets_with_project_local_keys(): void
+    {
+        $this->seed([
+            ProjectSeeder::class,
+            BoardColumnSeeder::class,
+            ProjectTicketMetadataSeeder::class,
+            TicketSeeder::class,
+        ]);
+
+        $coreProject = Project::query()->where('key', 'CORE')->firstOrFail();
+
+        $this->assertDatabaseHas('tickets', [
+            'project_id' => $coreProject->id,
+            'ticket_key' => 'CORE-1',
+            'title' => 'Seed backlog item',
+            'board_column_id' => null,
+        ]);
+
+        $this->assertDatabaseHas('tickets', [
+            'project_id' => $coreProject->id,
+            'ticket_key' => 'CORE-2',
+            'title' => 'Seed backlog item',
+            'board_column_id' => null,
+        ]);
+    }
+}

tests/Feature/Projects/ProjectBacklogControllerTest.php

@@ -0,0 +1,137 @@
+<?php
+
+namespace Tests\Feature\Projects;
+
+use App\Actions\ProjectPermissions\ProjectPermissionService;
+use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Models\Project;
+use App\Models\Ticket;
+use App\Models\TicketPriority;
+use App\Models\User;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Inertia\Testing\AssertableInertia as Assert;
+use Tests\TestCase;
+
+class ProjectBacklogControllerTest extends TestCase
+{
+    use RefreshDatabase;
+
+    /**
+     * Ensure users with project view access can open the backlog page.
+     */
+    public function test_users_with_view_permission_can_view_a_projects_backlog(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'AUTH',
+        ]);
+
+        app(InitializeProjectTicketMetadata::class)->handle($project);
+
+        $priority = TicketPriority::factory()->for($project)->create([
+            'name' => 'Medium',
+            'position' => 1,
+        ]);
+
+        $ticket = Ticket::factory()->create([
+            'project_id' => $project->id,
+            'ticket_priority_id' => $priority->id,
+            'ticket_type_id' => $project->ticketTypes()->firstOrFail()->id,
+            'ticket_key' => 'AUTH-1',
+            'sequence_number' => 1,
+            'title' => 'Seed backlog item',
+        ]);
+
+        app(ProjectPermissionService::class)->syncUserPermissions($project, $user, ['view']);
+
+        $this->actingAs($user)
+            ->get(route('projects.backlog.index', $project))
+            ->assertOk()
+            ->assertInertia(fn (Assert $page) => $page
+                ->component('projects/Backlog')
+                ->where('project.id', $project->id)
+                ->where('tickets.0.ticket_key', $ticket->ticket_key)
+                ->where('canCreateTickets', false),
+            );
+    }
+
+    /**
+     * Ensure creating tickets requires the project create permission.
+     */
+    public function test_creating_tickets_requires_project_create_permission(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create();
+
+        app(InitializeProjectTicketMetadata::class)->handle($project);
+
+        $priority = TicketPriority::factory()->for($project)->create([
+            'name' => 'Medium',
+            'position' => 1,
+        ]);
+
+        app(ProjectPermissionService::class)->syncUserPermissions($project, $user, ['view']);
+
+        $this->actingAs($user)
+            ->post(route('projects.backlog.store', $project), [
+                'title' => 'New ticket',
+                'description' => 'Description',
+                'acceptance_criteria' => 'Criteria',
+                'ticket_type_id' => $project->ticketTypes()->firstOrFail()->id,
+                'ticket_priority_id' => $priority->id,
+            ])
+            ->assertForbidden();
+    }
+
+    /**
+     * Ensure project-local keys increment and backlog accepts duplicate titles.
+     */
+    public function test_users_with_create_permission_can_add_duplicate_titled_tickets_to_backlog(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'AUTH',
+        ]);
+
+        app(InitializeProjectTicketMetadata::class)->handle($project);
+
+        $priority = TicketPriority::factory()->for($project)->create([
+            'name' => 'High',
+            'position' => 1,
+        ]);
+
+        app(ProjectPermissionService::class)->syncUserPermissions($project, $user, ['create', 'view']);
+
+        $payload = [
+            'title' => 'Same title',
+            'description' => 'Description',
+            'acceptance_criteria' => 'Criteria',
+            'ticket_type_id' => $project->ticketTypes()->firstOrFail()->id,
+            'ticket_priority_id' => $priority->id,
+        ];
+
+        $this->actingAs($user)
+            ->post(route('projects.backlog.store', $project), $payload)
+            ->assertRedirect(route('projects.backlog.index', $project))
+            ->assertSessionHas('status', 'AUTH-1 was added to the backlog.');
+
+        $this->actingAs($user)
+            ->post(route('projects.backlog.store', $project), $payload)
+            ->assertRedirect(route('projects.backlog.index', $project))
+            ->assertSessionHas('status', 'AUTH-2 was added to the backlog.');
+
+        $this->assertDatabaseHas('tickets', [
+            'project_id' => $project->id,
+            'ticket_key' => 'AUTH-1',
+            'title' => 'Same title',
+            'board_column_id' => null,
+        ]);
+
+        $this->assertDatabaseHas('tickets', [
+            'project_id' => $project->id,
+            'ticket_key' => 'AUTH-2',
+            'title' => 'Same title',
+            'board_column_id' => null,
+        ]);
+    }
+}