refs #113 Added search to docs

* добавление функционала по поиску

* Changed detect `sections`, Changed UI

---------

Co-authored-by: agoalofalife <[email protected]>
Co-authored-by: tabuna <[email protected]>

Author: tabuna

.env.example

@@ -71,3 +71,5 @@ QUIZ_STATUS=false
 TELEGRAM_BOT_TOKEN=
 TELEGRAM_CHAT_ID=
 TELEGRAM_CHANNEL_ID=
+
+SCOUT_DRIVER=

app/Console/Commands/CompareDocument.php

@@ -42,7 +42,7 @@ protected function updateVersion(string $version): void
     {
         Docs::every($version)->each(function (Docs $docs) {
             try {
-                $docs->update();
+                dispatch(fn () => $docs->update());
             } catch (\Exception $exception) {
                 // Log a warning if an error occurs during update
                 $this->warn("Failed to update document: {$exception->getMessage()} {$exception->getFile()} {$exception->getLine()}");

app/Docs.php

@@ -349,14 +349,13 @@ public function isOlderVersion()
      */
     public function update()
     {
-
         $this->getModel()->fill([
             'behind'         => $this->fetchBehind(),
             'last_commit'    => $this->fetchLastCommit(),
             'current_commit' => $this->variables('git'),
         ])->save();
 
-        // $this->updateSections();
+        $this->updateSections();
     }
 
     /**
@@ -366,44 +365,61 @@ public function update()
      */
     public function getSections(): Collection
     {
+        $content = Str::of($this->content());
+
         // Разбиваем HTML содержимое на разделы по заголовкам
-        preg_match_all('/<h(\d)>(.+)<\/h\d>(.*)/sU', $this->content(), $matches, PREG_SET_ORDER);
+        preg_match_all('/<h(\d)>(.+)<\/h\d>(.*)/sU', $content->toString(), $matches, PREG_SET_ORDER);
 
         // Массив для хранения разделов
         $sections = collect();
-        $prevEnd = 0;
+        $titlePage = $this->title();
 
         foreach ($matches as $index => $match) {
+            $tag = $match[0];
+            $level = (int) $match[1];
             $sectionTitle = $match[2];
 
-            // Получаем начальную и конечную позицию текущего заголовка в тексте
-            $startPos = strpos($this->content(), $match[0], $prevEnd);
+            if ($level === 1) {
+                $titlePage = $sectionTitle;
+            }
+
+            $sectionContent = $content->after($tag);
 
-            // Получаем текст между текущим и предыдущим заголовком
-            if ($index > 0) {
-                $prevMatch = $matches[$index - 1];
-                $prevEnd = strpos($this->content(), $prevMatch[0]) + strlen($prevMatch[0]);
-                $sectionContent = substr($this->content(), $prevEnd, $startPos - $prevEnd);
-            } else {
-                $sectionContent = substr($this->content(), 0, $startPos);
+            // Если есть следующий заголовок - обрезаем контент до него
+            if (isset($matches[$index + 1])) {
+                $sectionContent = $sectionContent->before($matches[$index + 1][0]);
             }
 
             $sections->push([
-                'title'   => $sectionTitle,
-                'slug'    => Str::of($sectionTitle)->slug()->toString(),
-                'content' => $sectionContent,
-                'file'    => $this->file,
-                'version' => $this->version,
-                'id'      => Str::uuid(),
+                'title_page' => $titlePage,
+                'title'      => $sectionTitle,
+                'slug'       => Str::of($sectionTitle)->slug()->toString(),
+                'content'    => $sectionContent,
+                'file'       => $this->file,
+                'version'    => $this->version,
+                'id'         => Str::uuid(),
+                'level'      => $level,
+                'created_at' => now(),
+                'updated_at' => now(),
             ]);
         }
 
         return $sections;
     }
 
+    /**
+     * @return void
+     */
     public function updateSections()
     {
-        // DocumentationSection::where('file', $this->file)->where('version', $this->version)->delete();
-        // DocumentationSection::insert($this->getSections()->toArray());
+        if ($this->file === 'documentation.md') {
+            return;
+        }
+
+        DocumentationSection::where('file', $this->file)
+            ->where('version', $this->version)
+            ->delete();
+
+        DocumentationSection::insert($this->getSections()->toArray());
     }
 }

app/Http/Controllers/DocsController.php

@@ -4,6 +4,8 @@
 
 use App\Docs;
 use App\Models\Document;
+use App\Models\DocumentationSection;
+use Illuminate\Http\Request;
 
 class DocsController extends Controller
 {
@@ -58,4 +60,27 @@ public function status(string $version = Docs::DEFAULT_VERSION)
             'documents' => $documents,
         ]);
     }
+
+    /**
+     * @param string                   $version
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return \HotwiredLaravel\TurboLaravel\Http\MultiplePendingTurboStreamResponse|\HotwiredLaravel\TurboLaravel\Http\PendingTurboStreamResponse
+     */
+    public function search(string $version, Request $request)
+    {
+        $searchOffers = [];
+
+        if ($request->filled('text')) {
+            $searchOffers = DocumentationSection::search($request->text)
+                ->where('version', $version)
+                ->orderBy('level')
+                ->get()
+                ->take(6);
+        }
+
+        return turbo_stream()->replace('found_candidates', view('docs._search_lines', [
+            'searchOffer' => $searchOffers,
+        ]));
+    }
 }

app/Models/DocumentationSection.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Casts\Attribute;
+use Illuminate\Database\Eloquent\Concerns\HasUuids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Laravel\Scout\Searchable;
+
+class DocumentationSection extends Model
+{
+    use HasFactory, HasUuids, Searchable;
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'id',
+        'title',
+        'title_page',
+        'slug',
+        'version',
+        'file',
+        'content',
+        'level',
+    ];
+
+    /**
+     * @return \Illuminate\Database\Eloquent\Casts\Attribute
+     */
+    protected function fileForUrl(): Attribute
+    {
+        return Attribute::make(
+            get: fn (mixed $value, array $attributes) => str_replace('.md', '', $attributes['file']),
+        );
+    }
+
+    /**
+     * @return array
+     */
+    public function toSearchableArray()
+    {
+        return [
+            'title'   => $this->title,
+            'content' => $this->content,
+            'level'   => $this->level,
+        ];
+    }
+}

app/Services/TelegramBot.php

@@ -129,7 +129,7 @@ public static function notificationToTelegram(\Throwable $exception): void
                 ->line('*💪 Не сдавайтесь!*')
                 ->line('Каждая ошибка - это шанс стать лучше. Давайте использовать этот момент, чтобы улучшить наш код и стать еще сильнее. Удачи!')
                 ->send();
-        } catch (\Exception|Throwable) {
+        } catch (\Exception|\Throwable) {
             // without recursive
         }
     }

composer.lock

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('documentation_sections', function (Blueprint $table) {
+            $table->uuid('id')->primary();
+            $table->string('title_page')->comment('Заголовок всей страницы');
+            $table->string('title');
+            $table->integer('level')->nullable()->comment('Уровень заголовка');
+            $table->string('slug');
+            $table->string('version');
+            $table->string('file');
+            $table->text('content');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('documentation_sections');
+    }
+};