Add HL3D branding, Etsy Live/Draft paging and Projects lifecycle

Replace the old touchmark/PNG identity with the supplied lockup and monogram, segmented role-aware navigation, Live/Draft listing filters with generation-based cache invalidation, and admin Projects covering immutable file revisions, listing live pointers, and exact-decimal filament/packaging/shipping costing. Additive schema only; no Etsy publication. Isolated clone tests: 301 tests, 1162 assertions.
2026-11-08 12:50:56 +00:00
parent c8c5822166
commit d4928789c4
83 changed files with 5808 additions and 84 deletions
@@ -0,0 +1,112 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Project;
+use App\Models\ProjectEvent;
+use App\Services\ProjectCosting;
+use App\Support\ProjectLifecycle;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\Validation\Rule;
+use Illuminate\View\View;
+
+class ProjectController extends Controller
+{
+    public function index(Request $request): View
+    {
+        abort_unless($request->user()->can('viewAny', Project::class), 403);
+
+        $query = Project::query()->with('creator')->withCount(['revisions', 'listingLinks']);
+        if ($request->filled('stage') && in_array($request->string('stage')->toString(), Project::STAGES, true)) {
+            $query->where('stage', $request->string('stage')->toString());
+        }
+        if ($request->filled('search')) {
+            $term = '%'.$request->string('search')->toString().'%';
+            $query->where(fn ($q) => $q->where('title', 'like', $term)->orWhere('reference', 'like', $term));
+        }
+
+        return view('projects.index', [
+            'projects' => $query->orderByDesc('created_at')->paginate(20)->withQueryString(),
+            'stages' => Project::STAGES,
+        ]);
+    }
+
+    public function create(Request $request): View
+    {
+        abort_unless($request->user()->can('create', Project::class), 403);
+
+        return view('projects.create');
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        abort_unless($request->user()->can('create', Project::class), 403);
+        $data = $request->validate([
+            'reference' => ['required', 'string', 'max:64', 'unique:projects,reference'],
+            'title' => ['required', 'string', 'max:255'],
+            'notes' => ['nullable', 'string'],
+            'currency' => ['required', 'string', 'size:3', Rule::in(ProjectCosting::ALLOWED_CURRENCIES)],
+        ]);
+
+        $project = Project::create($data + ['created_by' => $request->user()->id]);
+        ProjectEvent::record($project->id, 'created', $request->user()->id);
+
+        return redirect()->route('projects.show', $project)->with('status', 'Project created.');
+    }
+
+    public function show(Request $request, Project $project): View
+    {
+        abort_unless($request->user()->can('view', $project), 403);
+        $project->load([
+            'revisions' => fn ($q) => $q->orderByDesc('revision_number'),
+            'revisions.files', 'revisions.creator', 'revisions.approver',
+            'listingLinks' => fn ($q) => $q->orderByDesc('created_at'),
+            'listingLinks.liveRelease.revision', 'listingLinks.liveRelease.costSnapshot',
+            'costSnapshots' => fn ($q) => $q->orderByDesc('recorded_at'),
+            'costSnapshots.lines', 'costSnapshots.revision',
+            'events.actor',
+        ]);
+
+        return view('projects.show', ['project' => $project]);
+    }
+
+    public function edit(Request $request, Project $project): View
+    {
+        abort_unless($request->user()->can('update', $project), 403);
+
+        return view('projects.edit', ['project' => $project]);
+    }
+
+    public function update(Request $request, Project $project): RedirectResponse
+    {
+        abort_unless($request->user()->can('update', $project), 403);
+        $data = $request->validate([
+            'title' => ['sometimes', 'string', 'max:255'],
+            'notes' => ['sometimes', 'nullable', 'string'],
+            'stage' => ['sometimes', Rule::in(Project::STAGES)],
+        ]);
+
+        if (($data['stage'] ?? null) === 'live' && ! ProjectLifecycle::canMoveToLive($project)) {
+            return back()->withErrors(['stage' => 'A project can only move to Live once a listing mapping has an active release.']);
+        }
+
+        $fromStage = $project->stage;
+        $project->update($data);
+
+        if (isset($data['stage']) && $data['stage'] !== $fromStage) {
+            ProjectEvent::record($project->id, 'stage_changed', $request->user()->id, metadata: ['from' => $fromStage, 'to' => $data['stage']]);
+        }
+
+        return redirect()->route('projects.show', $project)->with('status', 'Project updated.');
+    }
+
+    public function archive(Request $request, Project $project): RedirectResponse
+    {
+        abort_unless($request->user()->can('archive', $project), 403);
+        $project->update(['archived_at' => now()]);
+        ProjectEvent::record($project->id, 'archived', $request->user()->id);
+
+        return redirect()->route('projects.show', $project)->with('status', 'Project archived.');
+    }
+}