Merge branch 'epic/kan-3' into staging

app/Actions/Notifications/BuildProjectNotificationSettingsPayload.php

@@ -2,6 +2,8 @@
 
 namespace App\Actions\Notifications;
 
+use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Actions\Projects\ResolveProjectTemplateState;
 use App\Enums\DiscordAllowedMentionType;
 use App\Enums\NotificationChannel;
 use App\Enums\NotificationEventType;
@@ -15,6 +17,7 @@ class BuildProjectNotificationSettingsPayload
 {
     public function __construct(
         private readonly ListProjectNotificationActions $listProjectNotificationActions,
+        private readonly ResolveProjectTemplateState $resolveProjectTemplateState,
     ) {}
 
     /**
@@ -33,6 +36,9 @@ class BuildProjectNotificationSettingsPayload
             )->resolve(),
             'project' => ProjectResource::make($project)->resolve(),
             'status' => $status,
+            'templateState' => $this->resolveProjectTemplateState->handle($project, [
+                DuplicateProjectConfiguration::COPY_NOTIFICATION_ACTIONS,
+            ]),
             'templateVariables' => $this->templateVariables(),
         ];
     }

app/Actions/Projects/BuildProjectBoardSettingsPayload.php

@@ -9,6 +9,10 @@ use App\Models\Project;
 
 class BuildProjectBoardSettingsPayload
 {
+    public function __construct(
+        private readonly ResolveProjectTemplateState $resolveProjectTemplateState,
+    ) {}
+
     /**
      * @return array<string, mixed>
      */
@@ -27,6 +31,9 @@ class BuildProjectBoardSettingsPayload
             )->resolve(),
             'project' => ProjectResource::make($project)->resolve(),
             'status' => $status,
+            'templateState' => $this->resolveProjectTemplateState->handle($project, [
+                DuplicateProjectConfiguration::COPY_BOARD_WORKFLOW,
+            ]),
             'ticketStatuses' => TicketStatusResource::collection(
                 $project->ticketStatuses()
                     ->with(['allowedTargetStatuses.boardColumn', 'boardColumn'])

app/Actions/Projects/BuildProjectTicketMetadataSettingsPayload.php

@@ -13,6 +13,10 @@ use App\Models\TicketFieldDefinition;
 
 class BuildProjectTicketMetadataSettingsPayload
 {
+    public function __construct(
+        private readonly ResolveProjectTemplateState $resolveProjectTemplateState,
+    ) {}
+
     /**
      * @return array<string, mixed>
      */
@@ -23,6 +27,13 @@ class BuildProjectTicketMetadataSettingsPayload
             'project' => ProjectResource::make($project)->resolve(),
             'error' => $error,
             'status' => $status,
+            'templateState' => $this->resolveProjectTemplateState->handle($project, [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+                DuplicateProjectConfiguration::COPY_TICKET_PRIORITIES,
+                DuplicateProjectConfiguration::COPY_TICKET_FIELDS,
+                DuplicateProjectConfiguration::COPY_TICKET_LINK_TYPES,
+            ]),
             'ticketFieldDefinitions' => TicketFieldDefinitionResource::collection($project->ticketFieldDefinitions()->get())->resolve(),
             'ticketLinkTypes' => TicketLinkTypeResource::collection($project->ticketLinkTypes()->get())->resolve(),
             'ticketPriorities' => TicketPriorityResource::collection($project->ticketPriorities()->get())->resolve(),

app/Actions/Projects/CreateProject.php

@@ -27,40 +27,55 @@ class CreateProject
     {
         return DB::transaction(function () use ($attributes, $actor): Project {
             $project = Project::query()->create(Arr::only($attributes, ['key', 'name']));
+            $creationMode = Arr::get($attributes, 'creation_mode', 'scratch');
+            $sourceTemplateId = Arr::get($attributes, 'source_template_id');
+            $baseTemplate = null;
+            $sourceTemplate = null;
+
+            if ($creationMode === 'template' && $sourceTemplateId !== null) {
+                $sourceTemplate = ProjectTemplate::query()
+                    ->published()
+                    ->findOrFail((int) $sourceTemplateId);
+
+                $project->forceFill([
+                    'project_template_id' => $sourceTemplate->id,
+                ])->save();
+            } else {
+                $baseTemplate = $this->createProjectBaseTemplate->handle($project);
+
+                $project->forceFill([
+                    'project_template_id' => $baseTemplate->id,
+                ])->save();
+            }
+
+            $project = $project->fresh() ?? $project;
 
             $this->initializeProjectTicketMetadata->handle($project);
             $this->permissionService->grant($actor, Permission::ProjectAdmin, $project);
 
-            $creationMode = $attributes['creation_mode'] ?? 'scratch';
-
-            if ($creationMode === 'duplicate' && isset($attributes['source_project_id'])) {
-                $sourceProject = Project::query()->findOrFail((int) $attributes['source_project_id']);
+            if ($creationMode === 'duplicate' && Arr::get($attributes, 'source_project_id') !== null) {
+                $sourceProject = Project::query()->findOrFail((int) Arr::get($attributes, 'source_project_id'));
 
                 $this->duplicateProjectConfiguration->handle(
                     $sourceProject,
                     $project,
-                    array_values($attributes['copy_areas'] ?? []),
+                    array_values(Arr::get($attributes, 'copy_areas', [])),
                 );
             }
 
-            if ($creationMode === 'template' && isset($attributes['source_template_id'])) {
-                $template = ProjectTemplate::query()->findOrFail((int) $attributes['source_template_id']);
-
+            if ($creationMode === 'template' && $sourceTemplate !== null) {
                 $this->duplicateProjectConfiguration->apply(
-                    $project,
-                    $template->configuration_snapshot ?? [],
+                    $project->fresh() ?? $project,
+                    $sourceTemplate->configuration_snapshot ?? [],
                 );
-
-                $project->forceFill([
-                    'project_template_id' => $template->id,
-                ])->save();
             }
 
-            if ($project->project_template_id === null) {
-                $baseTemplate = $this->createProjectBaseTemplate->handle($project->fresh() ?? $project);
-
-                $project->forceFill([
-                    'project_template_id' => $baseTemplate->id,
+            if ($baseTemplate !== null) {
+                $baseTemplate->forceFill([
+                    'configuration_snapshot' => $this->duplicateProjectConfiguration->export(
+                        $project->fresh() ?? $project,
+                        DuplicateProjectConfiguration::copyableAreas(),
+                    ),
                 ])->save();
             }
 

app/Actions/Projects/ResolveProjectTemplateState.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Actions\Projects;
+
+use App\Models\Project;
+use App\Models\ProjectTemplate;
+
+class ResolveProjectTemplateState
+{
+    public function __construct(
+        private readonly DuplicateProjectConfiguration $duplicateProjectConfiguration,
+    ) {}
+
+    /**
+     * @param  list<string>|null  $areas
+     * @return array<string, mixed>|null
+     */
+    public function handle(Project $project, ?array $areas = null): ?array
+    {
+        $project->loadMissing('projectTemplate');
+
+        /** @var ProjectTemplate|null $projectTemplate */
+        $projectTemplate = $project->projectTemplate;
+
+        if ($projectTemplate === null) {
+            return null;
+        }
+
+        $selectedAreas = $areas === null
+            ? DuplicateProjectConfiguration::copyableAreas()
+            : $this->duplicateProjectConfiguration->normalizeCopyAreas($areas);
+
+        $templateConfiguration = collect($projectTemplate->configuration_snapshot ?? [])
+            ->only($selectedAreas)
+            ->all();
+        $currentConfiguration = $this->duplicateProjectConfiguration->export($project, $selectedAreas);
+
+        $overriddenAreas = [];
+        $inheritedAreas = [];
+
+        foreach ($selectedAreas as $area) {
+            $label = $this->labelForArea($area);
+            $hasTemplateValue = array_key_exists($area, $templateConfiguration);
+            $hasCurrentValue = array_key_exists($area, $currentConfiguration);
+
+            if (! $hasTemplateValue && ! $hasCurrentValue) {
+                continue;
+            }
+
+            if ($hasTemplateValue && $hasCurrentValue && $currentConfiguration[$area] === $templateConfiguration[$area]) {
+                $inheritedAreas[] = [
+                    'label' => $label,
+                    'value' => $area,
+                ];
+
+                continue;
+            }
+
+            $overriddenAreas[] = [
+                'label' => $label,
+                'value' => $area,
+            ];
+        }
+
+        $overriddenAreaValues = array_flip(array_column($overriddenAreas, 'value'));
+        $inheritedAreaValues = array_flip(array_column($inheritedAreas, 'value'));
+
+        return [
+            'effectiveConfiguration' => array_replace($templateConfiguration, array_intersect_key($currentConfiguration, $overriddenAreaValues)),
+            'inheritedAreas' => $inheritedAreas,
+            'inheritedConfiguration' => array_intersect_key($templateConfiguration, $inheritedAreaValues),
+            'inheritsFromTemplate' => $projectTemplate->is_published,
+            'overriddenAreas' => $overriddenAreas,
+            'overriddenConfiguration' => array_intersect_key($currentConfiguration, $overriddenAreaValues),
+            'templateConfiguration' => $templateConfiguration,
+            'templateId' => $projectTemplate->id,
+            'templateName' => $projectTemplate->name,
+            'templateSlug' => $projectTemplate->slug,
+        ];
+    }
+
+    private function labelForArea(string $area): string
+    {
+        foreach (DuplicateProjectConfiguration::copyAreaOptions() as $option) {
+            if ($option['value'] === $area) {
+                return $option['label'];
+            }
+        }
+
+        return $area;
+    }
+}

app/Actions/Projects/UpdateProjectTemplate.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Actions\Projects;
+
+use App\Models\ProjectTemplate;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Facades\DB;
+
+class UpdateProjectTemplate
+{
+    public function __construct(
+        private readonly DuplicateProjectConfiguration $duplicateProjectConfiguration,
+    ) {}
+
+    /**
+     * @param  array{name: string, copy_areas?: array<int, string>}  $attributes
+     */
+    public function handle(ProjectTemplate $projectTemplate, array $attributes): ProjectTemplate
+    {
+        $projectTemplate->loadMissing('sourceProject', 'linkedProjects.projectTemplate');
+
+        $sourceProject = $projectTemplate->sourceProject;
+        abort_if($sourceProject === null, 422, 'This template cannot be edited because the source project is missing.');
+
+        $copyAreas = array_values(Arr::get($attributes, 'copy_areas', []));
+        $normalizedCopyAreas = $this->duplicateProjectConfiguration->normalizeCopyAreas($copyAreas);
+        $previousConfiguration = $projectTemplate->configuration_snapshot ?? [];
+        $nextConfiguration = $this->duplicateProjectConfiguration->export($sourceProject, $normalizedCopyAreas);
+        $affectedAreas = array_values(array_unique([
+            ...array_keys($previousConfiguration),
+            ...array_keys($nextConfiguration),
+        ]));
+
+        DB::transaction(function () use ($projectTemplate, $attributes, $normalizedCopyAreas, $nextConfiguration, $previousConfiguration, $affectedAreas): void {
+            $projectTemplate->forceFill([
+                'name' => $attributes['name'],
+                'copy_areas' => $normalizedCopyAreas,
+                'configuration_snapshot' => $nextConfiguration,
+            ])->save();
+
+            foreach ($projectTemplate->linkedProjects as $linkedProject) {
+                $currentConfiguration = $this->duplicateProjectConfiguration->export($linkedProject->fresh(), $affectedAreas);
+                $replacementConfiguration = [];
+
+                foreach ($nextConfiguration as $area => $configuration) {
+                    $isNewTemplateArea = ! array_key_exists($area, $previousConfiguration);
+                    $matchesPreviousTemplate = array_key_exists($area, $previousConfiguration)
+                        && array_key_exists($area, $currentConfiguration)
+                        && $currentConfiguration[$area] === $previousConfiguration[$area];
+
+                    if ($isNewTemplateArea || $matchesPreviousTemplate) {
+                        $replacementConfiguration[$area] = $configuration;
+                    }
+                }
+
+                if ($replacementConfiguration === []) {
+                    continue;
+                }
+
+                $this->duplicateProjectConfiguration->apply($linkedProject->fresh(), $replacementConfiguration);
+            }
+        });
+
+        return $projectTemplate->fresh(['sourceProject'])->loadCount('linkedProjects');
+    }
+}

app/Actions/Projects/UpdateProjectTemplateLink.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Actions\Projects;
+
+use App\Models\Project;
+use App\Models\ProjectTemplate;
+use Illuminate\Support\Facades\DB;
+
+class UpdateProjectTemplateLink
+{
+    public function __construct(
+        private readonly DuplicateProjectConfiguration $duplicateProjectConfiguration,
+    ) {}
+
+    public function switch(Project $project, ProjectTemplate $template): void
+    {
+        DB::transaction(function () use ($project, $template): void {
+            $project->forceFill([
+                'project_template_id' => $template->id,
+            ])->save();
+
+            $this->duplicateProjectConfiguration->apply(
+                $project->fresh(),
+                $template->configuration_snapshot ?? [],
+            );
+        });
+    }
+
+    public function reset(Project $project): void
+    {
+        $template = $project->projectTemplate;
+
+        if ($template === null) {
+            return;
+        }
+
+        DB::transaction(function () use ($project, $template): void {
+            $this->duplicateProjectConfiguration->apply(
+                $project->fresh(),
+                $template->configuration_snapshot ?? [],
+            );
+        });
+    }
+}

app/Actions/Repositories/BuildProjectRepositorySettingsPayload.php

@@ -4,6 +4,8 @@ namespace App\Actions\Repositories;
 
 use App\Actions\Git\Data\GitRepository;
 use App\Actions\Git\GitProviderManager;
+use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Actions\Projects\ResolveProjectTemplateState;
 use App\Http\Resources\AvailableGitRepositorySourceResource;
 use App\Http\Resources\ProjectResource;
 use App\Http\Resources\RepositoryConnectionResource;
@@ -18,6 +20,7 @@ class BuildProjectRepositorySettingsPayload
 {
     public function __construct(
         private readonly GitProviderManager $gitProviderManager,
+        private readonly ResolveProjectTemplateState $resolveProjectTemplateState,
     ) {}
 
     /**
@@ -41,6 +44,9 @@ class BuildProjectRepositorySettingsPayload
             'project' => ProjectResource::make($project)->resolve(),
             'repositoryConnections' => RepositoryConnectionResource::collection($repositoryConnections)->resolve(),
             'status' => $status,
+            'templateState' => $this->resolveProjectTemplateState->handle($project, [
+                DuplicateProjectConfiguration::COPY_REPOSITORY_CONNECTIONS,
+            ]),
         ];
     }
 

app/Actions/Tickets/CreateProjectTicket.php

@@ -47,9 +47,13 @@ class CreateProjectTicket
             $nextSequenceNumber = (int) Ticket::query()
                 ->where('project_id', $project->id)
                 ->max('sequence_number') + 1;
-            $ticketStatus = TicketStatus::query()
-                ->where('project_id', $project->id)
-                ->findOrFail(Arr::get($attributes, 'ticket_status_id'));
+            $ticketStatusQuery = TicketStatus::query()
+                ->where(
+                    $project->project_template_id === null ? 'project_id' : 'project_template_id',
+                    $project->project_template_id ?? $project->id,
+                );
+
+            $ticketStatus = $ticketStatusQuery->findOrFail(Arr::get($attributes, 'ticket_status_id'));
 
             $ticket = Ticket::query()->create([
                 'assignee_user_id' => Arr::get($attributes, 'assignee_user_id'),

app/Http/Controllers/ProjectController.php

@@ -8,17 +8,21 @@ use App\Actions\Projects\CreateProject;
 use App\Actions\Projects\DeleteProject;
 use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Actions\Projects\ListVisibleProjects;
+use App\Actions\Projects\ResolveProjectTemplateState;
+use App\Actions\Projects\UpdateProjectTemplateLink;
 use App\Enums\Permission;
 use App\Http\Requests\DeleteProjectRequest;
+use App\Http\Requests\ResetProjectTemplateRequest;
 use App\Http\Requests\StoreProjectRequest;
+use App\Http\Requests\SwitchProjectTemplateRequest;
 use App\Http\Requests\SyncProjectPermissionsRequest;
 use App\Http\Resources\PermissionOptionResource;
 use App\Http\Resources\ProjectResource;
 use App\Http\Resources\ProjectTemplateResource;
-use App\Models\ProjectTemplate;
 use App\Http\Resources\TeamResource;
 use App\Http\Resources\UserResource;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\Team;
 use App\Models\User;
 use Illuminate\Http\RedirectResponse;
@@ -35,6 +39,8 @@ class ProjectController extends Controller
         private readonly DeleteProject $deleteProject,
         private readonly ListVisibleProjects $listVisibleProjects,
         private readonly PermissionService $permissionService,
+        private readonly ResolveProjectTemplateState $resolveProjectTemplateState,
+        private readonly UpdateProjectTemplateLink $updateProjectTemplateLink,
     ) {}
 
     public function index(Request $request): Response
@@ -92,6 +98,7 @@ class ProjectController extends Controller
         return Inertia::render('projects/Show', [
             'canManageAccess' => $this->permissionService->allows($user, Permission::ProjectAdmin, $project),
             'project' => ProjectResource::make($project)->resolve(),
+            'templateState' => $this->resolveProjectTemplateState->handle($project),
         ]);
     }
 
@@ -114,10 +121,44 @@ class ProjectController extends Controller
     {
         return Inertia::render('projects/settings/General', [
             'project' => ProjectResource::make($project)->resolve(),
+            'sourceTemplates' => ProjectTemplateResource::collection(
+                ProjectTemplate::query()
+                    ->published()
+                    ->with('sourceProject')
+                    ->orderBy('name')
+                    ->get(),
+            )->resolve(),
             'status' => session('status'),
+            'templateState' => $this->resolveProjectTemplateState->handle($project),
         ]);
     }
 
+    public function switchTemplate(SwitchProjectTemplateRequest $request, Project $project): RedirectResponse
+    {
+        $template = ProjectTemplate::query()
+            ->published()
+            ->findOrFail($request->integer('source_template_id'));
+
+        $this->updateProjectTemplateLink->switch($project, $template);
+
+        return to_route('projects.settings.general', $project)
+            ->with('status', "{$project->name} now uses the {$template->name} template.");
+    }
+
+    public function resetTemplate(ResetProjectTemplateRequest $request, Project $project): RedirectResponse
+    {
+        $request->validated();
+
+        $template = $project->projectTemplate;
+
+        abort_if($template === null, 422, 'This project has no linked template to reset.');
+
+        $this->updateProjectTemplateLink->reset($project->load('projectTemplate'));
+
+        return to_route('projects.settings.general', $project)
+            ->with('status', "{$project->name} was reset to the {$template->name} template baseline.");
+    }
+
     public function access(Request $request, Project $project): Response
     {
         $user = $request->user();

app/Http/Controllers/ProjectTemplateController.php

@@ -4,7 +4,9 @@ namespace App\Http\Controllers;
 
 use App\Actions\Projects\CreateProjectTemplate;
 use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Actions\Projects\UpdateProjectTemplate;
 use App\Http\Requests\StoreProjectTemplateRequest;
+use App\Http\Requests\UpdateProjectTemplateRequest;
 use App\Http\Resources\ProjectResource;
 use App\Http\Resources\ProjectTemplateResource;
 use App\Models\Project;
@@ -18,6 +20,7 @@ class ProjectTemplateController extends Controller
 {
     public function __construct(
         private readonly CreateProjectTemplate $createProjectTemplate,
+        private readonly UpdateProjectTemplate $updateProjectTemplate,
     ) {}
 
     public function index(Request $request): Response
@@ -28,12 +31,25 @@ class ProjectTemplateController extends Controller
                 ProjectTemplate::query()
                     ->published()
                     ->with('sourceProject')
+                    ->withCount('linkedProjects')
                     ->orderBy('name')
                     ->get(),
             )->resolve(),
         ]);
     }
 
+    public function edit(ProjectTemplate $projectTemplate): Response
+    {
+        abort_if(! $projectTemplate->is_published, 404);
+
+        $projectTemplate->load('sourceProject')->loadCount('linkedProjects');
+
+        return Inertia::render('project-templates/Edit', [
+            'copyAreaOptions' => DuplicateProjectConfiguration::copyAreaOptions(),
+            'template' => ProjectTemplateResource::make($projectTemplate)->resolve(),
+        ]);
+    }
+
     public function create(Project $project): Response
     {
         return Inertia::render('project-templates/Create', [
@@ -50,6 +66,16 @@ class ProjectTemplateController extends Controller
             ->with('status', "Template {$template->name} was created.");
     }
 
+    public function update(UpdateProjectTemplateRequest $request, ProjectTemplate $projectTemplate): RedirectResponse
+    {
+        abort_if(! $projectTemplate->is_published, 404);
+
+        $template = $this->updateProjectTemplate->handle($projectTemplate, $request->validated());
+
+        return to_route('project-templates.index')
+            ->with('status', "Template {$template->name} was updated.");
+    }
+
     public function destroy(ProjectTemplate $projectTemplate): RedirectResponse
     {
         abort_if(! $projectTemplate->is_published, 404);

app/Http/Requests/Api/MoveProjectTicketRequest.php

@@ -24,12 +24,17 @@ class MoveProjectTicketRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'ticket_status_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_statuses', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_statuses', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
         ];
     }

app/Http/Requests/DestroyProjectTicketTypeRequest.php

@@ -29,12 +29,17 @@ class DestroyProjectTicketTypeRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'replacement_ticket_type_id' => [
                 'nullable',
                 'integer',
-                Rule::exists('ticket_types', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_types', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
         ];
     }

app/Http/Requests/MoveProjectTicketRequest.php

@@ -29,12 +29,17 @@ class MoveProjectTicketRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'ticket_status_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_statuses', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_statuses', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'redirect_to' => ['required', 'string', Rule::in(['backlog', 'board'])],
         ];

app/Http/Requests/ResetProjectTemplateRequest.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Models\Project;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class ResetProjectTemplateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        /** @var Project $project */
+        $project = $this->route('project');
+
+        return [
+            'confirmation_key' => [
+                'required',
+                'string',
+                Rule::in([$project->key]),
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'confirmation_key.in' => 'Enter the exact project key to reset this project to its template baseline.',
+        ];
+    }
+}

app/Http/Requests/StoreProjectTicketBranchRequest.php

@@ -2,8 +2,10 @@
 
 namespace App\Http\Requests;
 
+use App\Models\Project;
 use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
 
 class StoreProjectTicketBranchRequest extends FormRequest
 {
@@ -22,9 +24,21 @@ class StoreProjectTicketBranchRequest extends FormRequest
      */
     public function rules(): array
     {
+        /** @var Project $project */
+        $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
+
         return [
             'branch_name' => ['required', 'string', 'max:255'],
-            'repository_connection_id' => ['required', 'integer', 'exists:repository_connections,id'],
+            'repository_connection_id' => [
+                'required',
+                'integer',
+                Rule::exists('repository_connections', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
+            ],
         ];
     }
 }

app/Http/Requests/StoreProjectTicketRequest.php

@@ -48,6 +48,9 @@ class StoreProjectTicketRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'acceptance_criteria' => ['nullable', 'array'],
@@ -66,17 +69,23 @@ class StoreProjectTicketRequest extends FormRequest
             'ticket_priority_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_priorities', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_priorities', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'ticket_status_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_statuses', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_statuses', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'ticket_type_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_types', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_types', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'story_points' => ['nullable', 'integer', 'min:0'],
             'title' => ['required', 'string', 'max:255'],

app/Http/Requests/StoreTicketLinkRequest.php

@@ -28,6 +28,9 @@ class StoreTicketLinkRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'linked_ticket_id' => [
@@ -38,7 +41,9 @@ class StoreTicketLinkRequest extends FormRequest
             'ticket_link_type_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_link_types', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_link_types', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
         ];
     }

app/Http/Requests/StoreTicketStatusRequest.php

@@ -26,12 +26,17 @@ class StoreTicketStatusRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'board_column_id' => [
                 'nullable',
                 'integer',
-                Rule::exists('board_columns', 'id')->where('project_id', $project->id),
+                Rule::exists('board_columns', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'name' => ['required', 'string', 'max:255'],
         ];

app/Http/Requests/SwitchProjectTemplateRequest.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Models\Project;
+use App\Models\ProjectTemplate;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class SwitchProjectTemplateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        /** @var Project $project */
+        $project = $this->route('project');
+
+        return [
+            'confirmation_key' => [
+                'required',
+                'string',
+                Rule::in([$project->key]),
+            ],
+            'source_template_id' => [
+                'required',
+                'integer',
+                Rule::exists(ProjectTemplate::class, 'id')->where('is_published', true),
+                Rule::notIn(array_filter([$project->project_template_id])),
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'confirmation_key.in' => 'Enter the exact project key to confirm the template switch.',
+            'source_template_id.not_in' => 'Choose a different published template to switch this project.',
+        ];
+    }
+}

app/Http/Requests/UpdateProjectTemplateRequest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Models\ProjectTemplate;
+use Illuminate\Contracts\Validation\ValidationRule;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdateProjectTemplateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return $this->user()?->can('create-project') ?? false;
+    }
+
+    /**
+     * @return array<string, ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        /** @var ProjectTemplate|null $projectTemplate */
+        $projectTemplate = $this->route('projectTemplate');
+        $requiresImpactConfirmation = $projectTemplate?->linkedProjects()->exists() ?? false;
+
+        return [
+            'name' => ['required', 'string', 'max:255'],
+            'copy_areas' => ['required', 'array', 'min:1'],
+            'copy_areas.*' => ['string', Rule::in(DuplicateProjectConfiguration::copyableAreas())],
+            'confirm_linked_projects_update' => [
+                Rule::requiredIf($requiresImpactConfirmation),
+                'accepted',
+            ],
+        ];
+    }
+
+    /**
+     * @return array<string, string>
+     */
+    public function messages(): array
+    {
+        return [
+            'confirm_linked_projects_update.accepted' => 'Acknowledge the linked project warning before saving template changes.',
+        ];
+    }
+}

app/Http/Requests/UpdateProjectTicketRequest.php

@@ -51,6 +51,9 @@ class UpdateProjectTicketRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'acceptance_criteria' => ['nullable', 'array'],
@@ -68,7 +71,9 @@ class UpdateProjectTicketRequest extends FormRequest
             'field_values.*.ticket_field_definition_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_field_definitions', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_field_definitions', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'field_values.*.value_number' => ['nullable', 'numeric'],
             'field_values.*.value_user_id' => ['nullable', 'integer', Rule::exists('users', 'id')],
@@ -81,12 +86,16 @@ class UpdateProjectTicketRequest extends FormRequest
             'ticket_priority_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_priorities', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_priorities', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'ticket_type_id' => [
                 'required',
                 'integer',
-                Rule::exists('ticket_types', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_types', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
             'title' => ['required', 'string', 'max:255'],
             'story_points' => ['nullable', 'integer', 'min:0'],
@@ -141,7 +150,7 @@ class UpdateProjectTicketRequest extends FormRequest
 
                 $requestedTicketTypeId = Arr::get($validated, 'ticket_type_id');
                 $requestedTicketType = TicketType::query()
-                    ->where('project_id', $project->id)
+                    ->where($project->project_template_id === null ? 'project_id' : 'project_template_id', $project->project_template_id ?? $project->id)
                     ->find($requestedTicketTypeId);
 
                 if (

app/Http/Requests/UpdateTicketStatusTransitionsRequest.php

@@ -29,12 +29,17 @@ class UpdateTicketStatusTransitionsRequest extends FormRequest
     {
         /** @var Project $project */
         $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
 
         return [
             'allowed_ticket_status_ids' => ['nullable', 'array'],
             'allowed_ticket_status_ids.*' => [
                 'integer',
-                Rule::exists('ticket_statuses', 'id')->where('project_id', $project->id),
+                Rule::exists('ticket_statuses', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
             ],
         ];
     }

app/Http/Requests/ValidateProjectTicketBranchRequest.php

@@ -2,8 +2,10 @@
 
 namespace App\Http\Requests;
 
+use App\Models\Project;
 use Illuminate\Contracts\Validation\ValidationRule;
 use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
 
 class ValidateProjectTicketBranchRequest extends FormRequest
 {
@@ -22,9 +24,21 @@ class ValidateProjectTicketBranchRequest extends FormRequest
      */
     public function rules(): array
     {
+        /** @var Project $project */
+        $project = $this->route('project');
+        $projectTemplateId = $project->project_template_id;
+        $ownershipColumn = $projectTemplateId === null ? 'project_id' : 'project_template_id';
+        $ownershipValue = $projectTemplateId ?? $project->id;
+
         return [
             'branch_name' => ['required', 'string', 'max:255'],
-            'repository_connection_id' => ['required', 'integer', 'exists:repository_connections,id'],
+            'repository_connection_id' => [
+                'required',
+                'integer',
+                Rule::exists('repository_connections', 'id')->where(
+                    fn ($query) => $query->where($ownershipColumn, $ownershipValue),
+                ),
+            ],
         ];
     }
 }

app/Http/Resources/ProjectResource.php

@@ -2,8 +2,10 @@
 
 namespace App\Http\Resources;
 
+use App\Actions\Projects\ResolveProjectTemplateState;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Support\Arr;
 
 class ProjectResource extends JsonResource
 {
@@ -14,11 +16,32 @@ class ProjectResource extends JsonResource
      */
     public function toArray(Request $request): array
     {
+        $this->resource->loadMissing('projectTemplate');
+
+        $templateState = app(ResolveProjectTemplateState::class)->handle($this->resource);
+
         return [
             'id' => $this->id,
             'name' => $this->name,
             'key' => $this->key,
             'project_template_id' => $this->project_template_id,
+            'project_template' => $this->projectTemplate === null
+                ? null
+                : ProjectTemplateResource::make($this->projectTemplate)->resolve(),
+            'template_state' => $templateState === null
+                ? null
+                : [
+                    'effective_configuration' => Arr::get($templateState, 'effectiveConfiguration', []),
+                    'inherited_areas' => Arr::get($templateState, 'inheritedAreas', []),
+                    'inherited_configuration' => Arr::get($templateState, 'inheritedConfiguration', []),
+                    'inherits_from_template' => Arr::get($templateState, 'inheritsFromTemplate', false),
+                    'overridden_areas' => Arr::get($templateState, 'overriddenAreas', []),
+                    'overridden_configuration' => Arr::get($templateState, 'overriddenConfiguration', []),
+                    'template_configuration' => Arr::get($templateState, 'templateConfiguration', []),
+                    'template_id' => Arr::get($templateState, 'templateId'),
+                    'template_name' => Arr::get($templateState, 'templateName'),
+                    'template_slug' => Arr::get($templateState, 'templateSlug'),
+                ],
             'show_author' => $this->show_author,
             'show_story_points' => $this->show_story_points,
             'created_at' => $this->created_at?->toISOString(),

app/Http/Resources/ProjectTemplateResource.php

@@ -28,6 +28,8 @@ class ProjectTemplateResource extends JsonResource
                 'slug' => $this->slug,
                 'is_published' => $this->is_published,
                 'copy_areas' => $this->copy_areas ?? [],
+                'configuration_snapshot' => $this->configuration_snapshot ?? [],
+                'linked_project_count' => $this->whenCounted('linkedProjects'),
                 'created_at' => $this->created_at?->toISOString(),
                 'updated_at' => $this->updated_at?->toISOString(),
             ];
@@ -42,6 +44,8 @@ class ProjectTemplateResource extends JsonResource
             'slug' => Arr::get($this->resource, 'slug'),
             'is_published' => Arr::get($this->resource, 'is_published', true),
             'copy_areas' => Arr::get($this->resource, 'copy_areas', []),
+            'configuration_snapshot' => Arr::get($this->resource, 'configuration_snapshot', []),
+            'linked_project_count' => Arr::get($this->resource, 'linked_project_count'),
             'created_at' => Arr::get($this->resource, 'created_at'),
             'updated_at' => Arr::get($this->resource, 'updated_at'),
         ];

app/Models/BoardColumn.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\BoardColumnFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -10,11 +11,19 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 
-#[Fillable(['name', 'position', 'project_id'])]
+#[Fillable(['name', 'position', 'project_id', 'project_template_id'])]
 class BoardColumn extends Model
 {
     /** @use HasFactory<BoardColumnFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $boardColumn): void {
+            $boardColumn->syncProjectTemplateOwnership();
+        });
+    }
 
     public function project(): BelongsTo
     {

app/Models/Concerns/SyncsProjectTemplateOwnership.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace App\Models\Concerns;
+
+use App\Models\Project;
+use App\Models\ProjectTemplate;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+trait SyncsProjectTemplateOwnership
+{
+    protected function syncProjectTemplateOwnership(): void
+    {
+        $projectTemplateId = $this->getAttribute('project_template_id');
+        $projectId = $this->getAttribute('project_id');
+
+        if ($projectTemplateId === null && $projectId !== null) {
+            $projectTemplateId = Project::query()
+                ->whereKey($projectId)
+                ->value('project_template_id');
+
+            if ($projectTemplateId !== null) {
+                $this->setAttribute('project_template_id', $projectTemplateId);
+            }
+        }
+
+        if ($projectId === null && $projectTemplateId !== null) {
+            $projectId = ProjectTemplate::query()
+                ->whereKey($projectTemplateId)
+                ->value('project_id');
+
+            if ($projectId !== null) {
+                $this->setAttribute('project_id', $projectId);
+            }
+        }
+    }
+
+    public function projectTemplate(): BelongsTo
+    {
+        return $this->belongsTo(ProjectTemplate::class);
+    }
+}

app/Models/NotificationAction.php

@@ -4,6 +4,7 @@ namespace App\Models;
 
 use App\Enums\NotificationChannel;
 use App\Enums\NotificationEventType;
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\NotificationActionFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Attributes\Hidden;
@@ -23,12 +24,14 @@ use Illuminate\Database\Eloquent\Relations\HasMany;
     'message_template',
     'name',
     'project_id',
+    'project_template_id',
 ])]
 #[Hidden(['delivery_url'])]
 class NotificationAction extends Model
 {
     /** @use HasFactory<NotificationActionFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
 
     /**
      * @return array<string, string>
@@ -45,6 +48,13 @@ class NotificationAction extends Model
         ];
     }
 
+    protected static function booted(): void
+    {
+        static::saving(function (self $notificationAction): void {
+            $notificationAction->syncProjectTemplateOwnership();
+        });
+    }
+
     public function scopeEnabled(Builder $query): Builder
     {
         return $query->where('enabled', true);

app/Models/ProjectTemplate.php

@@ -4,10 +4,11 @@ namespace App\Models;
 
 use Database\Factories\ProjectTemplateFactory;
 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\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 
 #[Fillable(['project_id', 'source_project_id', 'name', 'slug', 'is_published', 'copy_areas', 'configuration_snapshot'])]
 class ProjectTemplate extends Model
@@ -38,4 +39,9 @@ class ProjectTemplate extends Model
     {
         return $this->belongsTo(Project::class, 'source_project_id');
     }
+
+    public function linkedProjects(): HasMany
+    {
+        return $this->hasMany(Project::class, 'project_template_id');
+    }
 }

app/Models/RepositoryConnection.php

@@ -4,6 +4,7 @@ namespace App\Models;
 
 use App\Actions\Git\Data\GitRepository;
 use App\Actions\Git\GitProviderKey;
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\RepositoryConnectionFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -14,6 +15,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
     'base_url',
     'owner_name',
     'project_id',
+    'project_template_id',
     'provider',
     'provider_repository_id',
     'repository_full_name',
@@ -24,6 +26,7 @@ class RepositoryConnection extends Model
 {
     /** @use HasFactory<RepositoryConnectionFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
 
     /**
      * @return array<string, string>
@@ -35,6 +38,13 @@ class RepositoryConnection extends Model
         ];
     }
 
+    protected static function booted(): void
+    {
+        static::saving(function (self $repositoryConnection): void {
+            $repositoryConnection->syncProjectTemplateOwnership();
+        });
+    }
+
     public function project(): BelongsTo
     {
         return $this->belongsTo(Project::class);

app/Models/TicketFieldDefinition.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\TicketFieldDefinitionFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -9,7 +10,7 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
-#[Fillable(['field_type', 'label', 'position', 'project_id'])]
+#[Fillable(['field_type', 'label', 'position', 'project_id', 'project_template_id'])]
 class TicketFieldDefinition extends Model
 {
     /**
@@ -22,6 +23,14 @@ class TicketFieldDefinition extends Model
 
     /** @use HasFactory<TicketFieldDefinitionFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $ticketFieldDefinition): void {
+            $ticketFieldDefinition->syncProjectTemplateOwnership();
+        });
+    }
 
     public function project(): BelongsTo
     {

app/Models/TicketLinkType.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\TicketLinkTypeFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -9,11 +10,19 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
-#[Fillable(['label', 'counterpart_label', 'position', 'project_id'])]
+#[Fillable(['label', 'counterpart_label', 'position', 'project_id', 'project_template_id'])]
 class TicketLinkType extends Model
 {
     /** @use HasFactory<TicketLinkTypeFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $ticketLinkType): void {
+            $ticketLinkType->syncProjectTemplateOwnership();
+        });
+    }
 
     public function counterpartLabel(): string
     {

app/Models/TicketPriority.php

@@ -2,17 +2,26 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\TicketPriorityFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
-#[Fillable(['name', 'position', 'project_id'])]
+#[Fillable(['name', 'position', 'project_id', 'project_template_id'])]
 class TicketPriority extends Model
 {
     /** @use HasFactory<TicketPriorityFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $ticketPriority): void {
+            $ticketPriority->syncProjectTemplateOwnership();
+        });
+    }
 
     public function project(): BelongsTo
     {

app/Models/TicketStatus.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\TicketStatusFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -11,15 +12,23 @@ use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Support\Str;
 
-#[Fillable(['board_column_id', 'name', 'position', 'project_id', 'slug'])]
+#[Fillable(['board_column_id', 'name', 'position', 'project_id', 'project_template_id', 'slug'])]
 class TicketStatus extends Model
 {
     /** @use HasFactory<TicketStatusFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
 
     protected static function booted(): void
     {
         static::saving(function (self $ticketStatus): void {
+            if ($ticketStatus->project_template_id === null && $ticketStatus->board_column_id !== null) {
+                $ticketStatus->project_template_id = BoardColumn::query()
+                    ->whereKey($ticketStatus->board_column_id)
+                    ->value('project_template_id');
+            }
+
+            $ticketStatus->syncProjectTemplateOwnership();
             $ticketStatus->slug = Str::slug($ticketStatus->name);
         });
     }

app/Models/TicketType.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\Models\Concerns\SyncsProjectTemplateOwnership;
 use Database\Factories\TicketTypeFactory;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -9,11 +10,19 @@ use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 
-#[Fillable(['name', 'position', 'project_id', 'is_parent'])]
+#[Fillable(['name', 'position', 'project_id', 'project_template_id', 'is_parent'])]
 class TicketType extends Model
 {
     /** @use HasFactory<TicketTypeFactory> */
     use HasFactory;
+    use SyncsProjectTemplateOwnership;
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $ticketType): void {
+            $ticketType->syncProjectTemplateOwnership();
+        });
+    }
 
     protected function casts(): array
     {

database/migrations/2026_06_05_161500_move_project_metadata_to_project_templates.php

@@ -0,0 +1,116 @@
+<?php
+
+use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Models\Project;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Str;
+
+return new class extends Migration
+{
+    /**
+     * @var list<string>
+     */
+    private array $tables = [
+        'board_columns',
+        'ticket_field_definitions',
+        'ticket_link_types',
+        'ticket_priorities',
+        'ticket_statuses',
+        'ticket_types',
+        'repository_connections',
+        'notification_actions',
+    ];
+
+    public function up(): void
+    {
+        foreach ($this->tables as $table) {
+            Schema::table($table, function (Blueprint $table): void {
+                $table->foreignId('project_template_id')
+                    ->nullable()
+                    ->after('project_id')
+                    ->constrained('project_templates')
+                    ->nullOnDelete();
+            });
+        }
+
+        $projects = DB::table('projects')
+            ->leftJoin('project_templates', 'project_templates.id', '=', 'projects.project_template_id')
+            ->select([
+                'projects.id',
+                'projects.key',
+                'projects.name',
+                'projects.project_template_id',
+                'project_templates.project_id as template_project_id',
+            ])
+            ->get();
+
+        foreach ($projects as $project) {
+            $projectTemplateId = $project->project_template_id;
+
+            if ($projectTemplateId === null || (int) ($project->template_project_id ?? 0) !== (int) $project->id) {
+                $projectTemplateId = DB::table('project_templates')->insertGetId([
+                    'project_id' => $project->id,
+                    'source_project_id' => $project->id,
+                    'name' => $project->name.' base template',
+                    'slug' => Str::lower($project->key).'-base-template',
+                    'is_published' => false,
+                    'copy_areas' => json_encode([
+                        'project_settings',
+                        'board_workflow',
+                        'ticket_types',
+                        'ticket_priorities',
+                        'ticket_fields',
+                        'ticket_link_types',
+                        'repository_connections',
+                        'notification_actions',
+                    ], JSON_THROW_ON_ERROR),
+                    'configuration_snapshot' => json_encode([], JSON_THROW_ON_ERROR),
+                    'created_at' => now(),
+                    'updated_at' => now(),
+                ]);
+
+                DB::table('projects')
+                    ->where('id', $project->id)
+                    ->update([
+                        'project_template_id' => $projectTemplateId,
+                        'updated_at' => now(),
+                    ]);
+            }
+
+            foreach ($this->tables as $table) {
+                DB::table($table)
+                    ->where('project_id', $project->id)
+                    ->update(['project_template_id' => $projectTemplateId]);
+            }
+
+            $projectModel = Project::query()->find($project->id);
+
+            if ($projectModel !== null) {
+                DB::table('project_templates')
+                    ->where('id', $projectTemplateId)
+                    ->update([
+                        'configuration_snapshot' => json_encode(
+                            app(DuplicateProjectConfiguration::class)->export(
+                                $projectModel,
+                                DuplicateProjectConfiguration::copyableAreas(),
+                            ),
+                            JSON_THROW_ON_ERROR,
+                        ),
+                        'updated_at' => now(),
+                    ]);
+            }
+        }
+    }
+
+    public function down(): void
+    {
+        foreach (array_reverse($this->tables) as $table) {
+            Schema::table($table, function (Blueprint $table): void {
+                $table->dropConstrainedForeignId('project_template_id');
+            });
+        }
+    }
+};

resources/js/components/AppSidebar.vue

@@ -25,6 +25,7 @@ import {
 } from '@/components/ui/sidebar';
 import { dashboard } from '@/routes';
 import { index as adminUsers } from '@/routes/admin/users';
+import { index as projectTemplatesIndex } from '@/routes/project-templates';
 import { index as projectsIndex } from '@/routes/projects';
 import { index as teamsIndex } from '@/routes/teams';
 import type { NavItem } from '@/types';
@@ -48,7 +49,7 @@ const mainNavItems = computed<NavItem[]>(() => {
     if (page.props.auth.permissions.projectCreate) {
         items.push({
             title: 'Project templates',
-            href: '/project-templates',
+            href: projectTemplatesIndex(),
             icon: Layers3,
         });
     }

resources/js/pages/admin/users/Edit.vue

@@ -40,7 +40,7 @@ const form = useForm({
 });
 
 const submit = (): void => {
-    form.patch(save(props.user.id), {
+    form.patch(save.url(props.user.id), {
         preserveScroll: true,
     });
 };

resources/js/pages/project-templates/Create.vue

@@ -15,7 +15,11 @@ import {
 import { Input } from '@/components/ui/input';
 import { Label } from '@/components/ui/label';
 import AppLayout from '@/layouts/AppLayout.vue';
-import { show as projectShow } from '@/routes/projects/index';
+import { index as projectsIndex, show as projectShow } from '@/routes/projects/index';
+import {
+    create as projectTemplateCreate,
+    store as projectTemplateStore,
+} from '@/routes/projects/templates';
 import type { BreadcrumbItem, ProjectTemplatesCreatePageProps } from '@/types';
 
 const props = defineProps<ProjectTemplatesCreatePageProps>();
@@ -23,7 +27,7 @@ const props = defineProps<ProjectTemplatesCreatePageProps>();
 const breadcrumbs: BreadcrumbItem[] = [
     {
         title: 'Projects',
-        href: '/projects',
+        href: projectsIndex(),
     },
     {
         title: props.project.name,
@@ -31,7 +35,7 @@ const breadcrumbs: BreadcrumbItem[] = [
     },
     {
         title: 'Save as new template',
-        href: `/projects/${props.project.id}/templates/create`,
+        href: projectTemplateCreate(props.project.id),
     },
 ];
 
@@ -50,7 +54,7 @@ const copyAreasError = computed(() => {
 });
 
 const submit = (): void => {
-    form.post(`/projects/${props.project.id}/templates`, {
+    form.post(projectTemplateStore.url(props.project.id), {
         preserveScroll: true,
     });
 };

resources/js/pages/project-templates/Edit.vue

@@ -0,0 +1,175 @@
+<script setup lang="ts">
+import { Head, Link, useForm } from '@inertiajs/vue3';
+import { computed } from 'vue';
+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 {
+    edit as projectTemplatesEdit,
+    index as projectTemplatesIndex,
+    update as projectTemplatesUpdate,
+} from '@/routes/project-templates';
+import type { BreadcrumbItem, ProjectTemplatesEditPageProps } from '@/types';
+
+const props = defineProps<ProjectTemplatesEditPageProps>();
+
+const breadcrumbs: BreadcrumbItem[] = [
+    {
+        title: 'Project templates',
+        href: projectTemplatesIndex(),
+    },
+    {
+        title: props.template.name,
+        href: projectTemplatesEdit(props.template.id),
+    },
+];
+
+const form = useForm({
+    confirm_linked_projects_update: false,
+    copy_areas: [...props.template.copy_areas],
+    name: props.template.name,
+});
+
+const copyAreasError = computed(() => {
+    return (
+        form.errors.copy_areas ??
+        Object.entries(form.errors).find(([key]) => key.startsWith('copy_areas.'))?.[1] ??
+        ''
+    );
+});
+
+const linkedProjectCount = computed(() => props.template.linked_project_count ?? 0);
+
+const submit = (): void => {
+    form.patch(projectTemplatesUpdate.url(props.template.id), {
+        preserveScroll: true,
+    });
+};
+</script>
+
+<template>
+    <AppLayout :breadcrumbs="breadcrumbs">
+        <Head :title="`Edit ${template.name}`" />
+
+        <div class="mx-auto flex w-full max-w-3xl flex-1 flex-col gap-6 p-4">
+            <div class="space-y-3">
+                <div class="flex flex-wrap items-center gap-3">
+                    <Badge variant="outline" class="px-3 py-1">{{ template.slug }}</Badge>
+                    <Badge v-if="linkedProjectCount > 0" variant="secondary">
+                        {{ linkedProjectCount }} linked {{ linkedProjectCount === 1 ? 'project' : 'projects' }}
+                    </Badge>
+                </div>
+                <Heading
+                    :title="`Edit ${template.name}`"
+                    description="Refresh the template baseline from its source project while keeping immutable identifiers protected."
+                />
+            </div>
+
+            <Card>
+                <CardHeader>
+                    <CardTitle>Template details</CardTitle>
+                    <CardDescription>
+                        <template v-if="template.source_project">
+                            This template baseline is rebuilt from {{ template.source_project.name }} ({{ template.source_project.key }}) when you save.
+                        </template>
+                        <template v-else>
+                            This template baseline is rebuilt from its source project when you save.
+                        </template>
+                    </CardDescription>
+                </CardHeader>
+
+                <CardContent>
+                    <form class="space-y-6" @submit.prevent="submit">
+                        <div class="grid gap-2">
+                            <Label for="name">Template name</Label>
+                            <Input id="name" v-model="form.name" required placeholder="Foundation template" />
+                            <InputError :message="form.errors.name" />
+                        </div>
+
+                        <div class="grid gap-2">
+                            <Label for="slug">Template slug</Label>
+                            <Input id="slug" :model-value="template.slug" disabled />
+                            <p class="text-muted-foreground text-sm">
+                                The slug stays locked so existing template references remain stable.
+                            </p>
+                        </div>
+
+                        <div class="grid gap-3">
+                            <div>
+                                <Label>Configuration groups</Label>
+                                <p class="text-muted-foreground text-sm">
+                                    Saving rebuilds the selected groups from the current source-project configuration.
+                                </p>
+                            </div>
+
+                            <div class="grid gap-3">
+                                <Label
+                                    v-for="copyAreaOption in copyAreaOptions"
+                                    :key="copyAreaOption.value"
+                                    class="flex cursor-pointer items-start gap-3 rounded-xl border p-4"
+                                >
+                                    <input
+                                        v-model="form.copy_areas"
+                                        type="checkbox"
+                                        :value="copyAreaOption.value"
+                                        class="mt-1"
+                                    />
+                                    <div class="space-y-1">
+                                        <div class="font-medium">{{ copyAreaOption.label }}</div>
+                                        <p class="text-muted-foreground text-sm">
+                                            {{ copyAreaOption.description }}
+                                        </p>
+                                    </div>
+                                </Label>
+                            </div>
+                            <InputError :message="copyAreasError" />
+                        </div>
+
+                        <div
+                            v-if="linkedProjectCount > 0"
+                            class="space-y-3 rounded-xl border border-amber-300 bg-amber-50 p-4 text-amber-950 dark:border-amber-900/70 dark:bg-amber-950/40 dark:text-amber-100"
+                        >
+                            <div class="space-y-1">
+                                <div class="font-medium">Warning</div>
+                                <p class="text-sm">
+                                    Saving this template updates the baseline for {{ linkedProjectCount }} linked {{ linkedProjectCount === 1 ? 'project' : 'projects' }}.
+                                    Inherited areas will follow the new template version, while existing overrides stay untouched.
+                                </p>
+                            </div>
+
+                            <Label class="flex cursor-pointer items-start gap-3">
+                                <input v-model="form.confirm_linked_projects_update" type="checkbox" class="mt-1" />
+                                <span class="text-sm">
+                                    I understand that linked projects inheriting from this template will be affected.
+                                </span>
+                            </Label>
+
+                            <InputError :message="form.errors.confirm_linked_projects_update" />
+                        </div>
+
+                        <div class="flex items-center gap-3">
+                            <Button type="submit" :disabled="form.processing">
+                                Save template changes
+                            </Button>
+
+                            <Button as-child variant="outline">
+                                <Link :href="projectTemplatesIndex()">Cancel</Link>
+                            </Button>
+                        </div>
+                    </form>
+                </CardContent>
+            </Card>
+        </div>
+    </AppLayout>
+</template>

resources/js/pages/project-templates/Index.vue

@@ -11,6 +11,11 @@ import {
     CardTitle,
 } from '@/components/ui/card';
 import AppLayout from '@/layouts/AppLayout.vue';
+import {
+    destroy as projectTemplatesDestroy,
+    edit as projectTemplatesEdit,
+    index as projectTemplatesIndex,
+} from '@/routes/project-templates';
 import { create as projectsCreate, index as projectsIndex } from '@/routes/projects/index';
 import type { BreadcrumbItem, ProjectTemplatesIndexPageProps } from '@/types';
 
@@ -19,12 +24,12 @@ const props = defineProps<ProjectTemplatesIndexPageProps>();
 const breadcrumbs: BreadcrumbItem[] = [
     {
         title: 'Project templates',
-        href: '/project-templates',
+        href: projectTemplatesIndex(),
     },
 ];
 
 const removeTemplate = (templateId: number): void => {
-    router.delete(`/project-templates/${templateId}`, {
+    router.delete(projectTemplatesDestroy.url(templateId), {
         preserveScroll: true,
     });
 };
@@ -69,6 +74,9 @@ const removeTemplate = (templateId: number): void => {
                         <div class="flex flex-wrap items-center gap-2">
                             <CardTitle>{{ template.name }}</CardTitle>
                             <Badge variant="secondary">{{ template.slug }}</Badge>
+                            <Badge v-if="template.linked_project_count" variant="outline">
+                                {{ template.linked_project_count }} linked {{ template.linked_project_count === 1 ? 'project' : 'projects' }}
+                            </Badge>
                         </div>
                         <CardDescription>
                             <template v-if="template.source_project">
@@ -91,6 +99,12 @@ const removeTemplate = (templateId: number): void => {
                         </div>
 
                         <div class="flex flex-wrap gap-3">
+                            <Button as-child variant="secondary">
+                                <Link :href="projectTemplatesEdit(template.id)">
+                                    Edit
+                                </Link>
+                            </Button>
+
                             <Button as-child variant="outline">
                                 <Link :href="projectsCreate({ query: { template: template.id } })">
                                     Use template

resources/js/pages/projects/Create.vue

@@ -63,7 +63,7 @@ const submit = (): void => {
         form.source_template_id = '';
     }
 
-    form.post(ProjectController.store(), {
+    form.post(ProjectController.store.url(), {
         preserveScroll: true,
     });
 };

resources/js/pages/projects/Show.vue

@@ -22,6 +22,7 @@ import {
     notifications as notificationSettings,
     repositories as repositorySettings,
 } from '@/routes/projects/settings';
+import { create as projectTemplateCreate } from '@/routes/projects/templates';
 import type { BreadcrumbItem, ProjectShowPageProps } from '@/types';
 
 const props = defineProps<ProjectShowPageProps>();
@@ -99,7 +100,7 @@ const projectAreas = [
                         as-child
                         variant="outline"
                     >
-                        <Link :href="`/projects/${project.id}/templates/create`">
+                        <Link :href="projectTemplateCreate(project.id)">
                             Save as new template
                         </Link>
                     </Button>
@@ -110,6 +111,32 @@ const projectAreas = [
                 </div>
             </div>
 
+            <Card v-if="templateState?.inheritsFromTemplate">
+                <CardHeader>
+                    <CardTitle>
+                        Built from template {{ templateState.templateName }}
+                    </CardTitle>
+                    <CardDescription>
+                        This project keeps its template link. Inherited areas follow the template baseline; overridden areas were customized locally.
+                    </CardDescription>
+                </CardHeader>
+                <CardContent class="flex flex-wrap gap-2">
+                    <Badge
+                        v-for="area in templateState.inheritedAreas"
+                        :key="`inherited-${area.value}`"
+                        variant="outline"
+                    >
+                        {{ area.label }} · inherited
+                    </Badge>
+                    <Badge
+                        v-for="area in templateState.overriddenAreas"
+                        :key="`overridden-${area.value}`"
+                    >
+                        {{ area.label }} · overridden
+                    </Badge>
+                </CardContent>
+            </Card>
+
             <div v-if="canManageAccess" class="flex flex-wrap gap-3">
                 <Button as-child>
                     <Link :href="boardSettings(project.id)">

resources/js/pages/projects/settings/Board.vue

@@ -138,6 +138,32 @@ const statusAllowsTarget = (
                 {{ status }}
             </div>
 
+            <Card v-if="templateState?.inheritsFromTemplate">
+                <CardHeader>
+                    <CardTitle>
+                        Template inheritance: {{ templateState.templateName }}
+                    </CardTitle>
+                    <CardDescription>
+                        This project stays linked to its template. Sections below show whether the current configuration is still inherited or has local overrides.
+                    </CardDescription>
+                </CardHeader>
+                <CardContent class="flex flex-wrap gap-2">
+                    <Badge
+                        v-for="area in templateState.inheritedAreas"
+                        :key="`inherited-${area.value}`"
+                        variant="outline"
+                    >
+                        {{ area.label }} · inherited
+                    </Badge>
+                    <Badge
+                        v-for="area in templateState.overriddenAreas"
+                        :key="`overridden-${area.value}`"
+                    >
+                        {{ area.label }} · overridden
+                    </Badge>
+                </CardContent>
+            </Card>
+
             <Card>
                 <CardHeader>
                     <CardTitle>Workflow model</CardTitle>

resources/js/pages/projects/settings/General.vue

@@ -43,20 +43,73 @@ const breadcrumbs: BreadcrumbItem[] = [
     },
 ];
 
+const switchTemplateForm = useForm({
+    confirmation_key: '',
+    source_template_id: props.sourceTemplates.find(
+        (template) => template.id !== props.project.project_template_id,
+    )?.id,
+});
+
+const resetTemplateForm = useForm({
+    confirmation_key: '',
+});
+
 const deleteForm = useForm({
     confirmation_key: '',
 });
 
+const availableSwitchTemplates = computed(() =>
+    props.sourceTemplates.filter(
+        (template) => template.id !== props.project.project_template_id,
+    ),
+);
+
+const currentTemplate = computed(() => props.project.project_template ?? null);
+
+const isSwitchConfirmationValid = computed(
+    () => switchTemplateForm.confirmation_key === props.project.key,
+);
+
+const canSwitchTemplate = computed(
+    () =>
+        isSwitchConfirmationValid.value &&
+        switchTemplateForm.source_template_id !== undefined,
+);
+
+const isResetConfirmationValid = computed(
+    () => resetTemplateForm.confirmation_key === props.project.key,
+);
+
 const isDeleteConfirmationValid = computed(
     () => deleteForm.confirmation_key === props.project.key,
 );
 
+const submitSwitchTemplate = (): void => {
+    if (!canSwitchTemplate.value) {
+        return;
+    }
+
+    switchTemplateForm.post(ProjectController.switchTemplate.url(props.project.id), {
+        preserveScroll: true,
+    });
+};
+
+const submitResetTemplate = (): void => {
+    if (!isResetConfirmationValid.value) {
+        return;
+    }
+
+    resetTemplateForm.post(ProjectController.resetTemplate.url(props.project.id), {
+        preserveScroll: true,
+    });
+};
+
 const submitDelete = (): void => {
     if (!isDeleteConfirmationValid.value) {
         return;
     }
 
-    deleteForm.submit(ProjectController.destroy(props.project.id), {
+    deleteForm.delete(ProjectController.destroy.url(props.project.id), {
         preserveScroll: true,
     });
 };
@@ -152,6 +205,139 @@ const submitDelete = (): void => {
                 </CardContent>
             </Card>
 
+            <Card>
+                <CardHeader>
+                    <CardTitle>Template baseline</CardTitle>
+                    <CardDescription>
+                        Switch this project to another published template or reset it back to the currently linked template baseline. Both actions can overwrite local configuration.
+                    </CardDescription>
+                </CardHeader>
+
+                <CardContent class="space-y-6">
+                    <div class="grid gap-4 md:grid-cols-2">
+                        <div class="border-border/70 rounded-xl border p-4">
+                            <p class="text-muted-foreground text-xs font-semibold uppercase tracking-[0.18em]">
+                                Current linked template
+                            </p>
+                            <p class="text-foreground mt-2 text-sm font-semibold">
+                                {{ currentTemplate?.name ?? 'No linked template' }}
+                            </p>
+                            <p class="text-muted-foreground mt-2 text-sm">
+                                {{
+                                    templateState?.inheritsFromTemplate
+                                        ? 'Inherited and overridden areas stay visible after switching or resetting.'
+                                        : 'This project currently behaves like a standalone baseline.'
+                                }}
+                            </p>
+                        </div>
+
+                        <div class="border-border/70 rounded-xl border p-4">
+                            <p class="text-muted-foreground text-xs font-semibold uppercase tracking-[0.18em]">
+                                Warning
+                            </p>
+                            <p class="text-foreground mt-2 text-sm font-medium">
+                                Template changes can replace board workflow, ticket metadata, repositories, and notifications for copied areas.
+                            </p>
+                            <p class="text-muted-foreground mt-2 text-sm">
+                                Confirm each action with the exact project key to avoid accidental overwrites.
+                            </p>
+                        </div>
+                    </div>
+
+                    <div class="grid gap-6 xl:grid-cols-2">
+                        <form class="space-y-4 rounded-xl border p-4" @submit.prevent="submitSwitchTemplate">
+                            <div class="space-y-1">
+                                <h3 class="text-sm font-semibold">Switch to another template</h3>
+                                <p class="text-muted-foreground text-sm">
+                                    Applying a different template replaces the copied areas with that template's current baseline.
+                                </p>
+                            </div>
+
+                            <div class="grid gap-2">
+                                <Label for="source_template_id">Published template</Label>
+                                <select
+                                    id="source_template_id"
+                                    v-model="switchTemplateForm.source_template_id"
+                                    :disabled="switchTemplateForm.processing || availableSwitchTemplates.length === 0"
+                                    class="border-input bg-background shadow-xs focus-visible:border-ring focus-visible:ring-ring/50 rounded-md border px-3 py-2 text-sm outline-none transition-[color,box-shadow] focus-visible:ring-[3px]"
+                                >
+                                    <option :value="undefined" disabled>
+                                        Select a template
+                                    </option>
+                                    <option
+                                        v-for="template in availableSwitchTemplates"
+                                        :key="template.id"
+                                        :value="template.id"
+                                    >
+                                        {{ template.name }}
+                                    </option>
+                                </select>
+                                <InputError :message="switchTemplateForm.errors.source_template_id" />
+                            </div>
+
+                            <div class="grid gap-2">
+                                <Label for="switch_confirmation_key">Confirmation key</Label>
+                                <Input
+                                    id="switch_confirmation_key"
+                                    v-model="switchTemplateForm.confirmation_key"
+                                    :disabled="switchTemplateForm.processing"
+                                    placeholder="Type the project key exactly"
+                                />
+                                <InputError :message="switchTemplateForm.errors.confirmation_key" />
+                            </div>
+
+                            <div class="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+                                <p class="text-muted-foreground text-sm">
+                                    Existing project-specific configuration in copied areas may be replaced or removed.
+                                </p>
+
+                                <Button
+                                    type="submit"
+                                    variant="outline"
+                                    :disabled="switchTemplateForm.processing || !canSwitchTemplate"
+                                >
+                                    Switch template
+                                </Button>
+                            </div>
+                        </form>
+
+                        <form class="space-y-4 rounded-xl border p-4" @submit.prevent="submitResetTemplate">
+                            <div class="space-y-1">
+                                <h3 class="text-sm font-semibold">Reset to current template baseline</h3>
+                                <p class="text-muted-foreground text-sm">
+                                    Re-apply the currently linked template and clear local divergence inside copied areas.
+                                </p>
+                            </div>
+
+                            <div class="grid gap-2">
+                                <Label for="reset_confirmation_key">Confirmation key</Label>
+                                <Input
+                                    id="reset_confirmation_key"
+                                    v-model="resetTemplateForm.confirmation_key"
+                                    :disabled="resetTemplateForm.processing || !currentTemplate"
+                                    placeholder="Type the project key exactly"
+                                />
+                                <InputError :message="resetTemplateForm.errors.confirmation_key" />
+                            </div>
+
+                            <div class="flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+                                <p class="text-muted-foreground text-sm">
+                                    This restores the current template baseline for copied areas and rewinds project-level overrides there.
+                                </p>
+
+                                <Button
+                                    type="submit"
+                                    variant="outline"
+                                    :disabled="resetTemplateForm.processing || !isResetConfirmationValid || !currentTemplate"
+                                >
+                                    Reset to baseline
+                                </Button>
+                            </div>
+                        </form>
+                    </div>
+                </CardContent>
+            </Card>
+
             <Card
                 class="border-red-200/80 bg-red-50/60 dark:border-red-900/60 dark:bg-red-950/20"
             >

resources/js/pages/projects/settings/Metadata.vue

@@ -115,6 +115,32 @@ const replacementTicketTypes = (ticketTypeId: number) =>
                 {{ status }}
             </div>
 
+            <Card v-if="templateState?.inheritsFromTemplate">
+                <CardHeader>
+                    <CardTitle>
+                        Template inheritance: {{ templateState.templateName }}
+                    </CardTitle>
+                    <CardDescription>
+                        Inherited sections stay synced with the template baseline. Local edits in these settings are treated as project-specific overrides.
+                    </CardDescription>
+                </CardHeader>
+                <CardContent class="flex flex-wrap gap-2">
+                    <Badge
+                        v-for="area in templateState.inheritedAreas"
+                        :key="`inherited-${area.value}`"
+                        variant="outline"
+                    >
+                        {{ area.label }} · inherited
+                    </Badge>
+                    <Badge
+                        v-for="area in templateState.overriddenAreas"
+                        :key="`overridden-${area.value}`"
+                    >
+                        {{ area.label }} · overridden
+                    </Badge>
+                </CardContent>
+            </Card>
+
             <div class="grid gap-6 xl:grid-cols-2">
                 <Card class="gap-0 overflow-hidden">
                     <CardHeader class="border-b">

resources/js/pages/projects/settings/Notifications.vue

@@ -305,6 +305,32 @@ const notificationActionTimestamp = (
                 {{ status }}
             </div>
 
+            <Card v-if="templateState?.inheritsFromTemplate">
+                <CardHeader>
+                    <CardTitle>
+                        Template inheritance: {{ templateState.templateName }}
+                    </CardTitle>
+                    <CardDescription>
+                        Notification rules can remain inherited from the template or diverge here as project-level overrides.
+                    </CardDescription>
+                </CardHeader>
+                <CardContent class="flex flex-wrap gap-2">
+                    <Badge
+                        v-for="area in templateState.inheritedAreas"
+                        :key="`inherited-${area.value}`"
+                        variant="outline"
+                    >
+                        {{ area.label }} · inherited
+                    </Badge>
+                    <Badge
+                        v-for="area in templateState.overriddenAreas"
+                        :key="`overridden-${area.value}`"
+                    >
+                        {{ area.label }} · overridden
+                    </Badge>
+                </CardContent>
+            </Card>
+
             <div class="grid gap-6 xl:grid-cols-[24rem_minmax(0,1fr)]">
                 <div class="space-y-6">
                     <Card>

resources/js/pages/projects/settings/Repositories.vue

@@ -277,6 +277,32 @@ const submitUpdate = (): void => {
                 {{ status }}
             </div>
 
+            <Card v-if="templateState?.inheritsFromTemplate">
+                <CardHeader>
+                    <CardTitle>
+                        Template inheritance: {{ templateState.templateName }}
+                    </CardTitle>
+                    <CardDescription>
+                        Repository links can stay inherited from the template or be replaced with project-specific overrides.
+                    </CardDescription>
+                </CardHeader>
+                <CardContent class="flex flex-wrap gap-2">
+                    <Badge
+                        v-for="area in templateState.inheritedAreas"
+                        :key="`inherited-${area.value}`"
+                        variant="outline"
+                    >
+                        {{ area.label }} · inherited
+                    </Badge>
+                    <Badge
+                        v-for="area in templateState.overriddenAreas"
+                        :key="`overridden-${area.value}`"
+                    >
+                        {{ area.label }} · overridden
+                    </Badge>
+                </CardContent>
+            </Card>
+
             <Card>
                 <CardHeader>
                     <CardTitle>Personal Git access</CardTitle>

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

@@ -1,7 +1,11 @@
+import type { ProjectTemplateModel } from '@/types/models/project-template-model';
+
 export type ProjectModel = {
     id: number;
     name: string;
     key: string;
+    project_template_id?: number | null;
+    project_template?: ProjectTemplateModel | null;
     show_author: boolean;
     show_story_points: boolean;
     created_at: string;

resources/js/types/models/project-template-model.ts

@@ -9,6 +9,8 @@ export type ProjectTemplateModel = {
     name: string;
     slug: string;
     copy_areas: string[];
+    configuration_snapshot: Record<string, unknown>;
+    linked_project_count?: number;
     created_at: string | null;
     updated_at: string | null;
 };

resources/js/types/page-props.ts

@@ -61,9 +61,33 @@ export type ProjectTemplatesCreatePageProps = {
     project: ProjectModel;
 };
 
+export type ProjectTemplatesEditPageProps = {
+    copyAreaOptions: ProjectDuplicateCopyAreaOption[];
+    template: ProjectTemplateModel;
+};
+
+export type ProjectTemplateStateArea = {
+    label: string;
+    value: string;
+};
+
+export type ProjectTemplateState = {
+    effectiveConfiguration: Record<string, unknown>;
+    inheritedAreas: ProjectTemplateStateArea[];
+    inheritedConfiguration?: Record<string, unknown>;
+    inheritsFromTemplate: boolean;
+    overriddenAreas: ProjectTemplateStateArea[];
+    overriddenConfiguration?: Record<string, unknown>;
+    templateConfiguration?: Record<string, unknown>;
+    templateId: number;
+    templateName: string;
+    templateSlug: string;
+};
+
 export type ProjectShowPageProps = {
     canManageAccess: boolean;
     project: ProjectModel;
+    templateState?: ProjectTemplateState | null;
 };
 
 export type PermissionOption = {
@@ -95,12 +119,15 @@ export type ProjectBoardSettingsPageProps = {
     boardColumns: BoardColumnModel[];
     project: ProjectModel;
     status?: string | null;
+    templateState?: ProjectTemplateState | null;
     ticketStatuses: TicketStatusModel[];
 };
 
 export type ProjectGeneralSettingsPageProps = {
     project: ProjectModel;
+    sourceTemplates: ProjectTemplateModel[];
     status?: string | null;
+    templateState?: ProjectTemplateState | null;
 };
 
 export type ProjectBoardPageProps = {
@@ -121,6 +148,7 @@ export type ProjectTicketMetadataSettingsPageProps = {
     project: ProjectModel;
     error?: boolean;
     status?: string | null;
+    templateState?: ProjectTemplateState | null;
     ticketFieldDefinitions: TicketFieldDefinitionModel[];
     ticketLinkTypes: TicketLinkTypeModel[];
     ticketPriorities: TicketPriorityModel[];
@@ -132,6 +160,7 @@ export type ProjectRepositorySettingsPageProps = {
     project: ProjectModel;
     repositoryConnections: RepositoryConnectionModel[];
     status?: string | null;
+    templateState?: ProjectTemplateState | null;
 };
 
 export type ProjectNotificationSettingsPageProps = {
@@ -143,6 +172,7 @@ export type ProjectNotificationSettingsPageProps = {
     notificationActions: NotificationActionModel[];
     project: ProjectModel;
     status?: string | null;
+    templateState?: ProjectTemplateState | null;
     templateVariables: NotificationActionTemplateVariableModel[];
 };
 

routes/web/project-templates.php

@@ -8,5 +8,7 @@ Route::middleware('can:create-project')
     ->name('project-templates.')
     ->group(function (): void {
         Route::get('/', [ProjectTemplateController::class, 'index'])->name('index');
+        Route::get('{projectTemplate}/edit', [ProjectTemplateController::class, 'edit'])->name('edit');
+        Route::patch('{projectTemplate}', [ProjectTemplateController::class, 'update'])->name('update');
         Route::delete('{projectTemplate}', [ProjectTemplateController::class, 'destroy'])->name('destroy');
     });

routes/web/project/settings.php

@@ -8,6 +8,8 @@ use App\Http\Controllers\ProjectTicketMetadataSettingsController;
 use Illuminate\Support\Facades\Route;
 
 Route::get('general', [ProjectController::class, 'general'])->name('general');
+Route::post('general/switch-template', [ProjectController::class, 'switchTemplate'])->name('general.switch-template');
+Route::post('general/reset-template', [ProjectController::class, 'resetTemplate'])->name('general.reset-template');
 
 Route::get('board', [ProjectBoardSettingsController::class, 'show'])->name('board');
 

tests/Feature/Api/ProjectApiTest.php

@@ -2,8 +2,8 @@
 
 namespace Tests\Feature\Api;
 
-use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
 use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
 use App\Models\BoardColumn;
 use App\Models\Project;
 use App\Models\ProjectTemplate;
@@ -103,9 +103,88 @@ class ProjectApiTest extends TestCase
         $project->refresh();
 
         $this->assertSame($template->id, $project->project_template_id);
+        $this->assertDatabaseMissing('project_templates', [
+            'project_id' => $project->id,
+            'is_published' => false,
+        ]);
         $this->assertFalse($project->show_author);
         $this->assertFalse($project->show_story_points);
         $this->assertSame(['Spike'], $project->ticketTypes()->pluck('name')->all());
+        $this->assertDatabaseHas('ticket_types', [
+            'project_id' => $project->id,
+            'project_template_id' => $template->id,
+            'name' => 'Spike',
+        ]);
+    }
+
+    public function test_project_api_exposes_template_context_and_overrides(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'TMP1',
+            'name' => 'Template Driven Project',
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        $template = ProjectTemplate::factory()->create([
+            'name' => 'Workflow Template',
+            'slug' => 'workflow-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => true,
+                    'show_story_points' => true,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    [
+                        'name' => 'Bug',
+                        'position' => 1,
+                        'is_parent' => false,
+                    ],
+                    [
+                        'name' => 'Feature',
+                        'position' => 2,
+                        'is_parent' => false,
+                    ],
+                ],
+            ],
+        ]);
+
+        $project->update([
+            'project_template_id' => $template->id,
+        ]);
+        $project->ticketTypes()->delete();
+        TicketType::factory()->create([
+            'project_id' => $project->id,
+            'name' => 'Bug',
+            'position' => 1,
+            'is_parent' => false,
+        ]);
+        TicketType::factory()->create([
+            'project_id' => $project->id,
+            'name' => 'Feature',
+            'position' => 2,
+            'is_parent' => false,
+        ]);
+
+        $this->syncProjectPermissions($project, $user, ['view']);
+
+        $this->withApplicationKey($user)
+            ->getJson(route('api.projects.show', $project))
+            ->assertOk()
+            ->assertJsonPath('data.project_template.id', $template->id)
+            ->assertJsonPath('data.project_template.slug', 'workflow-template')
+            ->assertJsonPath('data.project_template.configuration_snapshot.project_settings.show_author', true)
+            ->assertJsonPath('data.template_state.inherits_from_template', true)
+            ->assertJsonPath('data.template_state.template_id', $template->id)
+            ->assertJsonPath('data.template_state.template_configuration.project_settings.show_author', true)
+            ->assertJsonPath('data.template_state.effective_configuration.ticket_types.0.name', 'Bug')
+            ->assertJsonPath('data.template_state.inherited_configuration.ticket_types.1.name', 'Feature')
+            ->assertJsonPath('data.template_state.overridden_configuration.project_settings.show_author', false)
+            ->assertJsonPath('data.template_state.overridden_areas.0.value', DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS);
     }
 
     public function test_users_can_duplicate_projects_via_api(): void

tests/Feature/Database/ProjectTemplateBaselineMigrationTest.php

@@ -2,6 +2,7 @@
 
 namespace Tests\Feature\Database;
 
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use Illuminate\Support\Facades\Artisan;
 use Illuminate\Support\Facades\DB;
 use Tests\TestCase;
@@ -70,4 +71,76 @@ class ProjectTemplateBaselineMigrationTest extends TestCase
         $this->assertSame(0, $template->is_published);
         $this->assertSame('lgcy-base-template', $template->slug);
     }
+
+    public function test_metadata_migration_moves_existing_configuration_to_the_project_template_and_preserves_snapshot(): void
+    {
+        Artisan::call('migrate:fresh', [
+            '--path' => [
+                'database/migrations/0001_01_01_000000_create_users_table.php',
+                'database/migrations/0001_01_01_000001_create_cache_table.php',
+                'database/migrations/0001_01_01_000002_create_jobs_table.php',
+                'database/migrations/2025_08_14_170933_add_two_factor_columns_to_users_table.php',
+                'database/migrations/2026_03_24_234007_create_projects_table.php',
+                'database/migrations/2026_03_24_234734_create_teams_table.php',
+                'database/migrations/2026_03_24_234735_create_team_user_table.php',
+                'database/migrations/2026_03_25_002100_create_board_columns_table.php',
+                'database/migrations/2026_03_25_003100_create_ticket_types_table.php',
+                'database/migrations/2026_03_25_003101_create_ticket_priorities_table.php',
+                'database/migrations/2026_03_25_003102_create_ticket_field_definitions_table.php',
+                'database/migrations/2026_03_25_004098_create_ticket_statuses_table.php',
+                'database/migrations/2026_03_25_004099_create_ticket_statuses_transitionstable.php',
+                'database/migrations/2026_03_25_004100_create_tickets_table.php',
+                'database/migrations/2026_03_25_065302_create_ticket_worklog_entries_table.php',
+                'database/migrations/2026_03_25_070706_create_ticket_field_values_table.php',
+                'database/migrations/2026_03_25_073715_create_ticket_links_table.php',
+                'database/migrations/2026_03_25_073715_create_ticket_link_types_table.php',
+                'database/migrations/2026_03_26_074522_create_user_git_connections_table.php',
+                'database/migrations/2026_03_26_075849_create_repository_connections_table.php',
+                'database/migrations/2026_04_12_120000_create_permission_assignments_table.php',
+                'database/migrations/2026_04_20_174556_create_user_applications_table.php',
+                'database/migrations/2026_04_20_194646_create_notification_actions_table.php',
+                'database/migrations/2026_04_20_194646_create_notification_delivery_logs_table.php',
+                'database/migrations/2026_04_24_194800_add_filters_to_notification_actions_table.php',
+                'database/migrations/2026_04_24_203500_create_acceptance_criteria_table.php',
+                'database/migrations/2026_05_19_230500_drop_acceptance_criteria_from_tickets_table.php',
+                'database/migrations/2026_05_22_124700_add_must_change_password_on_next_login_to_users_table.php',
+                'database/migrations/2026_05_23_101900_add_counterpart_label_to_ticket_link_types_table.php',
+                'database/migrations/2026_05_25_011500_create_project_templates_table.php',
+                'database/migrations/2026_05_25_013000_project_templates_as_project_baselines.php',
+            ],
+        ]);
+
+        DB::table('projects')->insert([
+            'name' => 'Legacy Project',
+            'key' => 'LGCY',
+            'show_author' => 0,
+            'show_story_points' => 1,
+            'project_template_id' => null,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $projectId = (int) DB::table('projects')->where('key', 'LGCY')->value('id');
+
+        DB::table('ticket_types')->insert([
+            'project_id' => $projectId,
+            'name' => 'Bug',
+            'position' => 1,
+            'is_parent' => 0,
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        Artisan::call('migrate', [
+            '--path' => 'database/migrations/2026_06_05_161500_move_project_metadata_to_project_templates.php',
+        ]);
+
+        $project = DB::table('projects')->where('id', $projectId)->first();
+        $template = DB::table('project_templates')->where('id', $project->project_template_id)->first();
+        $ticketType = DB::table('ticket_types')->where('project_id', $projectId)->first();
+        $snapshot = json_decode((string) $template->configuration_snapshot, true, 512, JSON_THROW_ON_ERROR);
+
+        $this->assertSame($project->project_template_id, $ticketType->project_template_id);
+        $this->assertSame(['Bug'], array_column($snapshot[DuplicateProjectConfiguration::COPY_TICKET_TYPES], 'name'));
+    }
 }

tests/Feature/Mcp/KanbanGitMcpTest.php

@@ -4,6 +4,7 @@ namespace Tests\Feature\Mcp;
 
 use App\Actions\Notifications\DeliverNotificationAction;
 use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Enums\NotificationDeliveryStatus;
 use App\Mcp\Servers\KanbanGitServer;
 use App\Mcp\Tools\GetTicket;
@@ -15,8 +16,10 @@ use App\Mcp\Tools\UpdateTicketDescription;
 use App\Models\BoardColumn;
 use App\Models\NotificationAction;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\Ticket;
 use App\Models\TicketStatus;
+use App\Models\TicketType;
 use App\Models\User;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Illuminate\Support\Facades\Queue;
@@ -207,6 +210,66 @@ class KanbanGitMcpTest extends TestCase
                 ->etc());
     }
 
+    public function test_get_ticket_exposes_project_template_context_and_overrides(): void
+    {
+        $user = User::factory()->create();
+        $project = $this->project('CORE', 'Core project');
+        $template = ProjectTemplate::factory()->create([
+            'name' => 'Agent Workflow Template',
+            'slug' => 'agent-workflow-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => true,
+                    'show_story_points' => true,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    [
+                        'name' => 'Bug',
+                        'position' => 1,
+                        'is_parent' => false,
+                    ],
+                ],
+            ],
+        ]);
+        $project->update([
+            'project_template_id' => $template->id,
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        $project->ticketTypes()->delete();
+        TicketType::factory()->create([
+            'project_id' => $project->id,
+            'name' => 'Bug',
+            'position' => 1,
+            'is_parent' => false,
+        ]);
+        $status = $project->ticketStatuses()->firstOrFail();
+        $ticket = $this->ticket($project, $status, [
+            'ticket_key' => 'CORE-1',
+            'title' => 'Template aware ticket',
+        ]);
+
+        $this->syncProjectPermissions($project, $user, ['view']);
+
+        KanbanGitServer::actingAs($user)
+            ->tool(GetTicket::class, [
+                'ticket_id' => $ticket->id,
+            ])
+            ->assertOk()
+            ->assertStructuredContent(fn (AssertableJson $json) => $json
+                ->where('data.project.project_template.id', $template->id)
+                ->where('data.project.project_template.slug', 'agent-workflow-template')
+                ->where('data.project.template_state.inherits_from_template', true)
+                ->where('data.project.template_state.template_configuration.project_settings.show_author', true)
+                ->where('data.project.template_state.overridden_configuration.project_settings.show_author', false)
+                ->where('data.project.template_state.effective_configuration.ticket_types.0.name', 'Bug')
+                ->etc());
+    }
+
     public function test_description_update_requires_write_permission_and_preserves_unrelated_fields(): void
     {
         $user = User::factory()->create();

tests/Feature/Projects/ProjectBoardSettingsControllerTest.php

@@ -3,8 +3,10 @@
 namespace Tests\Feature\Projects;
 
 use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Models\BoardColumn;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\Ticket;
 use App\Models\TicketStatus;
 use App\Models\User;
@@ -31,6 +33,15 @@ class ProjectBoardSettingsControllerTest extends TestCase
             'position' => 1,
         ]);
 
+        $template = ProjectTemplate::factory()->create([
+            'configuration_snapshot' => app(DuplicateProjectConfiguration::class)->export($project, [
+                DuplicateProjectConfiguration::COPY_BOARD_WORKFLOW,
+            ]),
+            'copy_areas' => [DuplicateProjectConfiguration::COPY_BOARD_WORKFLOW],
+            'name' => 'Starter Workflow',
+        ]);
+        $project->update(['project_template_id' => $template->id]);
+
         $this->syncProjectPermissions($project, $user, ['edit']);
 
         $this->actingAs($user)
@@ -41,7 +52,9 @@ class ProjectBoardSettingsControllerTest extends TestCase
                 ->where('project.id', $project->id)
                 ->where('backlogTicketStatuses.0.name', 'Backlog')
                 ->where('boardColumns.0.name', 'Todo')
-                ->where('ticketStatuses.0.name', 'Backlog'),
+                ->where('ticketStatuses.0.name', 'Backlog')
+                ->where('templateState.templateName', 'Starter Workflow')
+                ->where('templateState.inheritedAreas.0.value', DuplicateProjectConfiguration::COPY_BOARD_WORKFLOW),
             );
     }
 

tests/Feature/Projects/ProjectControllerTest.php

@@ -2,8 +2,8 @@
 
 namespace Tests\Feature\Projects;
 
-use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
 use App\Actions\Projects\DuplicateProjectConfiguration;
+use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
 use App\Models\BoardColumn;
 use App\Models\NotificationAction;
 use App\Models\Project;
@@ -286,10 +286,15 @@ class ProjectControllerTest extends TestCase
         $project->refresh();
 
         $this->assertSame($template->id, $project->project_template_id);
+        $this->assertDatabaseMissing('project_templates', [
+            'project_id' => $project->id,
+            'is_published' => false,
+        ]);
         $this->assertSame(false, $project->show_author);
         $this->assertSame(false, $project->show_story_points);
         $this->assertDatabaseHas('ticket_types', [
             'project_id' => $project->id,
+            'project_template_id' => $template->id,
             'name' => 'Bug',
             'position' => 1,
             'is_parent' => false,
@@ -590,6 +595,159 @@ class ProjectControllerTest extends TestCase
             );
     }
 
+    public function test_project_admins_can_switch_projects_to_another_template(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'CORE',
+            'name' => 'Core Platform',
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        $currentTemplate = ProjectTemplate::factory()->create([
+            'name' => 'Current Template',
+            'slug' => 'current-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => false,
+                    'show_story_points' => false,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    ['name' => 'Bug', 'position' => 1, 'is_parent' => false],
+                ],
+            ],
+        ]);
+        $newTemplate = ProjectTemplate::factory()->create([
+            'name' => 'Operations Template',
+            'slug' => 'operations-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => true,
+                    'show_story_points' => true,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    ['name' => 'Incident', 'position' => 1, 'is_parent' => false],
+                    ['name' => 'Maintenance', 'position' => 2, 'is_parent' => false],
+                ],
+            ],
+        ]);
+
+        $project->update(['project_template_id' => $currentTemplate->id]);
+        $project->ticketTypes()->delete();
+        TicketType::factory()->create(['project_id' => $project->id, 'name' => 'Bug', 'position' => 1, 'is_parent' => false]);
+
+        $this->syncProjectPermissions($project, $user, ['admin']);
+
+        $this->actingAs($user)
+            ->from(route('projects.settings.general', $project))
+            ->post(route('projects.settings.general.switch-template', $project), [
+                'confirmation_key' => 'CORE',
+                'source_template_id' => $newTemplate->id,
+            ])
+            ->assertRedirect(route('projects.settings.general', $project))
+            ->assertSessionHas('status', 'Core Platform now uses the Operations Template template.');
+
+        $project->refresh();
+
+        $this->assertSame($newTemplate->id, $project->project_template_id);
+        $this->assertTrue($project->show_author);
+        $this->assertTrue($project->show_story_points);
+        $this->assertSame(['Incident', 'Maintenance'], $project->ticketTypes()->pluck('name')->all());
+        $this->assertDatabaseHas('ticket_types', [
+            'project_id' => $project->id,
+            'project_template_id' => $newTemplate->id,
+            'name' => 'Incident',
+        ]);
+    }
+
+    public function test_project_admins_can_reset_projects_to_their_current_template_baseline(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'CORE',
+            'name' => 'Core Platform',
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        $template = ProjectTemplate::factory()->create([
+            'name' => 'Workflow Template',
+            'slug' => 'workflow-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => true,
+                    'show_story_points' => true,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    ['name' => 'Bug', 'position' => 1, 'is_parent' => false],
+                    ['name' => 'Feature', 'position' => 2, 'is_parent' => false],
+                ],
+            ],
+        ]);
+
+        $project->update(['project_template_id' => $template->id]);
+        $project->ticketTypes()->delete();
+        TicketType::factory()->create(['project_id' => $project->id, 'name' => 'Custom', 'position' => 1, 'is_parent' => false]);
+
+        $this->syncProjectPermissions($project, $user, ['admin']);
+
+        $this->actingAs($user)
+            ->from(route('projects.settings.general', $project))
+            ->post(route('projects.settings.general.reset-template', $project), [
+                'confirmation_key' => 'CORE',
+            ])
+            ->assertRedirect(route('projects.settings.general', $project))
+            ->assertSessionHas('status', 'Core Platform was reset to the Workflow Template template baseline.');
+
+        $project->refresh();
+
+        $this->assertSame($template->id, $project->project_template_id);
+        $this->assertTrue($project->show_author);
+        $this->assertTrue($project->show_story_points);
+        $this->assertSame(['Bug', 'Feature'], $project->ticketTypes()->pluck('name')->all());
+        $this->assertDatabaseHas('ticket_types', [
+            'project_id' => $project->id,
+            'project_template_id' => $template->id,
+            'name' => 'Bug',
+        ]);
+    }
+
+    public function test_project_template_switch_requires_exact_project_key_confirmation(): void
+    {
+        $user = User::factory()->create();
+        $project = Project::factory()->create([
+            'key' => 'CORE',
+        ]);
+        $project->update([
+            'project_template_id' => ProjectTemplate::factory()->create()->id,
+        ]);
+        $newTemplate = ProjectTemplate::factory()->create();
+
+        $this->syncProjectPermissions($project, $user, ['admin']);
+
+        $this->actingAs($user)
+            ->from(route('projects.settings.general', $project))
+            ->post(route('projects.settings.general.switch-template', $project), [
+                'confirmation_key' => 'core',
+                'source_template_id' => $newTemplate->id,
+            ])
+            ->assertRedirect(route('projects.settings.general', $project))
+            ->assertSessionHasErrors('confirmation_key');
+
+        $this->assertNotSame($newTemplate->id, $project->fresh()->project_template_id);
+    }
+
     /**
      * Ensure admins can delete projects and their dependent project-scoped data.
      */

tests/Feature/Projects/ProjectNotificationSettingsControllerTest.php

@@ -2,10 +2,12 @@
 
 namespace Tests\Feature\Projects;
 
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Enums\NotificationChannel;
 use App\Enums\NotificationEventType;
 use App\Models\NotificationAction;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\User;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use Inertia\Testing\AssertableInertia as Assert;
@@ -41,6 +43,15 @@ class ProjectNotificationSettingsControllerTest extends TestCase
                 ],
             ]);
 
+        $template = ProjectTemplate::factory()->create([
+            'configuration_snapshot' => app(DuplicateProjectConfiguration::class)->export($project, [
+                DuplicateProjectConfiguration::COPY_NOTIFICATION_ACTIONS,
+            ]),
+            'copy_areas' => [DuplicateProjectConfiguration::COPY_NOTIFICATION_ACTIONS],
+            'name' => 'Alert Template',
+        ]);
+        $project->update(['project_template_id' => $template->id]);
+
         $this->syncProjectPermissions($project, $user, ['edit']);
 
         $this->actingAs($user)
@@ -72,6 +83,8 @@ class ProjectNotificationSettingsControllerTest extends TestCase
                 ->where('templateVariables.6.value', '$actor_name')
                 ->where('templateVariables.7.value', '$assignee_from')
                 ->where('templateVariables.8.value', '$assignee_to')
+                ->where('templateState.templateName', 'Alert Template')
+                ->where('templateState.inheritedAreas.0.value', DuplicateProjectConfiguration::COPY_NOTIFICATION_ACTIONS)
                 ->missing('notificationActions.0.delivery_url'),
             );
     }

tests/Feature/Projects/ProjectRepositorySettingsControllerTest.php

@@ -3,7 +3,9 @@
 namespace Tests\Feature\Projects;
 
 use App\Actions\Git\GitProviderKey;
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\RepositoryConnection;
 use App\Models\User;
 use App\Models\UserGitConnection;
@@ -36,6 +38,15 @@ class ProjectRepositorySettingsControllerTest extends TestCase
             'repository_url' => 'https://git.example.test/core-team/kanbangit',
         ]);
 
+        $template = ProjectTemplate::factory()->create([
+            'configuration_snapshot' => app(DuplicateProjectConfiguration::class)->export($project, [
+                DuplicateProjectConfiguration::COPY_REPOSITORY_CONNECTIONS,
+            ]),
+            'copy_areas' => [DuplicateProjectConfiguration::COPY_REPOSITORY_CONNECTIONS],
+            'name' => 'Connected Template',
+        ]);
+        $project->update(['project_template_id' => $template->id]);
+
         $this->syncProjectPermissions($project, $user, ['edit']);
 
         $this->actingAs($user)
@@ -46,7 +57,9 @@ class ProjectRepositorySettingsControllerTest extends TestCase
                 ->where('project.id', $project->id)
                 ->where('repositoryConnections.0.repository_full_name', 'core-team/kanbangit')
                 ->where('repositoryConnections.0.has_personal_access', false)
-                ->where('availableRepositorySources', []),
+                ->where('availableRepositorySources', [])
+                ->where('templateState.templateName', 'Connected Template')
+                ->where('templateState.inheritedAreas.0.value', DuplicateProjectConfiguration::COPY_REPOSITORY_CONNECTIONS),
             );
     }
 

tests/Feature/Projects/ProjectTemplateControllerTest.php

@@ -57,6 +57,15 @@ class ProjectTemplateControllerTest extends TestCase
                 ->component('project-templates/Create')
                 ->where('project.id', $project->id)
                 ->has('copyAreaOptions', count(DuplicateProjectConfiguration::copyableAreas())));
+
+        $this->actingAs($user)
+            ->get(route('project-templates.edit', $template))
+            ->assertOk()
+            ->assertInertia(fn (Assert $page) => $page
+                ->component('project-templates/Edit')
+                ->where('template.id', $template->id)
+                ->where('template.slug', 'foundation-template')
+                ->has('copyAreaOptions', count(DuplicateProjectConfiguration::copyableAreas())));
     }
 
     public function test_users_can_save_and_delete_templates_from_projects(): void
@@ -148,5 +157,143 @@ class ProjectTemplateControllerTest extends TestCase
         $this->actingAs($user)
             ->delete(route('project-templates.destroy', $template))
             ->assertNotFound();
+
+        $this->actingAs($user)
+            ->get(route('project-templates.edit', $template))
+            ->assertNotFound();
+    }
+
+    public function test_updating_a_template_requires_warning_acknowledgement_when_projects_are_linked(): void
+    {
+        $user = User::factory()->create();
+        $sourceProject = Project::factory()->create();
+        $template = ProjectTemplate::factory()->create([
+            'source_project_id' => $sourceProject->id,
+        ]);
+        Project::factory()->create([
+            'project_template_id' => $template->id,
+        ]);
+
+        $this->syncGlobalPermissions($user, ['project:create']);
+
+        $this->actingAs($user)
+            ->patch(route('project-templates.update', $template), [
+                'name' => 'Updated Template',
+                'copy_areas' => [DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS],
+            ])
+            ->assertSessionHasErrors('confirm_linked_projects_update');
+    }
+
+    public function test_updating_a_template_refreshes_the_baseline_and_preserves_slug_and_overrides(): void
+    {
+        $user = User::factory()->create();
+        $sourceProject = Project::factory()->create([
+            'name' => 'Template Source',
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        TicketType::factory()->create([
+            'project_id' => $sourceProject->id,
+            'name' => 'Feature',
+            'position' => 1,
+            'is_parent' => false,
+        ]);
+
+        $template = ProjectTemplate::factory()->create([
+            'name' => 'Platform Template',
+            'slug' => 'platform-template',
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+            ],
+            'configuration_snapshot' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                    'show_author' => false,
+                    'show_story_points' => false,
+                ],
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                    [
+                        'name' => 'Bug',
+                        'position' => 1,
+                        'is_parent' => false,
+                    ],
+                ],
+            ],
+            'source_project_id' => $sourceProject->id,
+        ]);
+        $inheritingProject = Project::factory()->create([
+            'project_template_id' => $template->id,
+            'show_author' => false,
+            'show_story_points' => false,
+        ]);
+        $overriddenProject = Project::factory()->create([
+            'project_template_id' => $template->id,
+            'show_author' => true,
+            'show_story_points' => false,
+        ]);
+        TicketType::factory()->create([
+            'project_id' => $inheritingProject->id,
+            'name' => 'Bug',
+            'position' => 1,
+            'is_parent' => false,
+        ]);
+        TicketType::factory()->create([
+            'project_id' => $overriddenProject->id,
+            'name' => 'Custom',
+            'position' => 1,
+            'is_parent' => false,
+        ]);
+
+        $sourceProject->forceFill([
+            'show_author' => true,
+            'show_story_points' => true,
+        ])->save();
+
+        $this->syncGlobalPermissions($user, ['project:create']);
+
+        $this->actingAs($user)
+            ->patch(route('project-templates.update', $template), [
+                'name' => 'Platform Template v2',
+                'slug' => 'should-not-change',
+                'copy_areas' => [
+                    DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                    DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+                ],
+                'confirm_linked_projects_update' => true,
+            ])
+            ->assertRedirect('/project-templates');
+
+        $template->refresh();
+        $inheritingProject->refresh();
+        $overriddenProject->refresh();
+
+        $this->assertSame('Platform Template v2', $template->name);
+        $this->assertSame('platform-template', $template->slug);
+        $this->assertSame([
+            DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS => [
+                'show_author' => true,
+                'show_story_points' => true,
+            ],
+            DuplicateProjectConfiguration::COPY_TICKET_TYPES => [
+                [
+                    'name' => 'Feature',
+                    'position' => 1,
+                    'is_parent' => false,
+                ],
+            ],
+        ], $template->configuration_snapshot);
+
+        $this->assertTrue($inheritingProject->show_author);
+        $this->assertTrue($inheritingProject->show_story_points);
+        $this->assertSame(['Feature'], $inheritingProject->ticketTypes()->pluck('name')->all());
+        $this->assertDatabaseHas('ticket_types', [
+            'project_id' => $inheritingProject->id,
+            'project_template_id' => $template->id,
+            'name' => 'Feature',
+        ]);
+
+        $this->assertTrue($overriddenProject->show_author);
+        $this->assertFalse($overriddenProject->show_story_points);
+        $this->assertSame(['Custom'], $overriddenProject->ticketTypes()->pluck('name')->all());
     }
 }

tests/Feature/Projects/ProjectTicketMetadataSettingsControllerTest.php

@@ -3,7 +3,9 @@
 namespace Tests\Feature\Projects;
 
 use App\Actions\ProjectTicketMetadata\InitializeProjectTicketMetadata;
+use App\Actions\Projects\DuplicateProjectConfiguration;
 use App\Models\Project;
+use App\Models\ProjectTemplate;
 use App\Models\Ticket;
 use App\Models\TicketFieldDefinition;
 use App\Models\TicketLinkType;
@@ -37,6 +39,24 @@ class ProjectTicketMetadataSettingsControllerTest extends TestCase
             'position' => 1,
         ]);
 
+        $template = ProjectTemplate::factory()->create([
+            'configuration_snapshot' => app(DuplicateProjectConfiguration::class)->export($project, [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+                DuplicateProjectConfiguration::COPY_TICKET_LINK_TYPES,
+            ]),
+            'copy_areas' => [
+                DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS,
+                DuplicateProjectConfiguration::COPY_TICKET_TYPES,
+                DuplicateProjectConfiguration::COPY_TICKET_LINK_TYPES,
+            ],
+            'name' => 'Issue Tracker Template',
+        ]);
+        $project->update([
+            'project_template_id' => $template->id,
+            'show_story_points' => false,
+        ]);
+
         $this->syncProjectPermissions($project, $user, ['edit']);
 
         $this->actingAs($user)
@@ -45,12 +65,14 @@ class ProjectTicketMetadataSettingsControllerTest extends TestCase
             ->assertInertia(fn (Assert $page) => $page
                 ->component('projects/settings/Metadata')
                 ->where('project.show_author', true)
-                ->where('project.show_story_points', true)
+                ->where('project.show_story_points', false)
                 ->where('ticketTypes.0.name', 'Task')
                 ->where('ticketTypes.1.name', 'Release')
                 ->where('ticketTypes.1.is_parent', true)
                 ->where('ticketTypes.2.name', 'Bug')
-                ->where('ticketLinkTypes.0.label', 'Relates to'),
+                ->where('ticketLinkTypes.0.label', 'Relates to')
+                ->where('templateState.templateName', 'Issue Tracker Template')
+                ->where('templateState.overriddenAreas.0.value', DuplicateProjectConfiguration::COPY_PROJECT_SETTINGS),
             );
     }