init

app/Http/Controllers/Site/GuideController.php

@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Site;
+
+use App\Http\Controllers\Controller;
+use App\Models\AiModel;
+use App\Models\Category;
+use App\Models\Guide;
+use App\Models\Tool;
+use App\Support\MarkdownRenderer;
+use Illuminate\Contracts\View\View;
+use Illuminate\Http\Request;
+
+class GuideController extends Controller
+{
+    public function __construct(
+        private readonly MarkdownRenderer $markdownRenderer,
+    ) {
+    }
+
+    public function index(Request $request): View
+    {
+        $builder = Guide::query()->published()->with('category');
+
+        if ($request->filled('q')) {
+            $builder->whereFullText(['title', 'excerpt', 'body'], (string) $request->string('q'));
+        }
+
+        if ($request->filled('difficulty')) {
+            $builder->where('difficulty', (string) $request->string('difficulty'));
+        }
+
+        return view('public.guides.index', [
+            'items' => $builder->latest('published_at')->paginate(15)->withQueryString(),
+            'categories' => Category::query()->where('type', 'guide')->where('is_active', true)->orderBy('name')->get(),
+            'filters' => $request->only(['q', 'difficulty']),
+            'sidebarTools' => Tool::published()->latest('published_at')->limit(6)->get(),
+            'sidebarModels' => AiModel::published()->orderByDesc('total_score')->limit(6)->get(),
+        ]);
+    }
+
+    public function byTopic(string $slug, Request $request): View
+    {
+        $request->merge(['difficulty' => $slug]);
+
+        return $this->index($request);
+    }
+
+    public function show(string $slug): View
+    {
+        /** @var Guide $guide */
+        $guide = Guide::query()
+            ->published()
+            ->with('category')
+            ->where('slug', $slug)
+            ->firstOrFail();
+
+        return view('public.guides.show', [
+            'item' => $guide,
+            'bodyHtml' => $this->markdownRenderer->render($guide->body),
+        ]);
+    }
+}