feat: add categories

database/migrations/add_category_id_column_to_admin_kit_documents_table.php.stub

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        Schema::table('admin_kit_documents', function (Blueprint $table) {
+            $table->unsignedBigInteger('category_id')->nullable();
+        });
+    }
+
+    public function down()
+    {
+        Schema::table('admin_kit_documents', function (Blueprint $table) {
+            $table->dropColumn('category_id');
+        });
+    }
+};

database/migrations/create_admin_kit_document_categories_table.php.stub

@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        Schema::create('admin_kit_document_categories', function (Blueprint $table) {
+            $table->id();
+
+            $table->json('title')->default('{}');
+            $table->integer('sort')->nullable();
+
+            $table->timestamps();
+        });
+    }
+
+    public function down()
+    {
+        Schema::dropIfExists('admin_kit_document_categories');
+    }
+};

src/DocumentsServiceProvider.php

@@ -24,6 +24,8 @@ public function configurePackage(Package $package): void
             ->hasMigrations([
                 'create_admin_kit_documents_table',
                 'add_link_and_published_at_columns_to_admin_kit_documents_table',
+                'create_admin_kit_document_categories_table',
+                'add_category_id_column_to_admin_kit_documents_table',
             ])
             ->hasCommand(DocumentsCommand::class);
     }

src/FilamentPlugin.php

@@ -2,6 +2,7 @@
 
 namespace AdminKit\Documents;
 
+use AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource;
 use AdminKit\Documents\UI\Filament\Resources\DocumentResource;
 use Filament\Contracts\Plugin;
 use Filament\Panel;
@@ -17,6 +18,7 @@ public function register(Panel $panel): void
     {
         $panel->resources([
             DocumentResource::class,
+            DocumentCategoryResource::class,
         ]);
     }
 

src/Models/Document.php

@@ -7,6 +7,7 @@
 use Carbon\Carbon;
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Spatie\MediaLibrary\HasMedia;
 use Spatie\MediaLibrary\InteractsWithMedia;
 use Spatie\Translatable\HasTranslations;
@@ -29,6 +30,11 @@ class Document extends AbstractModel implements HasMedia
         'title',
     ];
 
+    public function category(): BelongsTo
+    {
+        return $this->belongsTo(DocumentCategory::class);
+    }
+
     public function scopeYear(Builder $query, $year): Builder
     {
         $date = Carbon::createFromDate($year);
@@ -38,6 +44,12 @@ public function scopeYear(Builder $query, $year): Builder
             ->where('published_at', '<=', $date->copy()->endOfYear());
     }
 
+    public function scopeCategoryId(Builder $query, $categoryId): Builder
+    {
+        return $query
+            ->whereHas('category', fn ($query) => $query->where('id', $categoryId));
+    }
+
     protected static function newFactory(): DocumentFactory
     {
         return new DocumentFactory();

src/Models/DocumentCategory.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace AdminKit\Documents\Models;
+
+use AdminKit\Core\Abstracts\Models\AbstractModel;
+use Spatie\Translatable\HasTranslations;
+
+class DocumentCategory extends AbstractModel
+{
+    use HasTranslations;
+
+    protected $table = 'admin_kit_document_categories';
+
+    protected $fillable = [
+        'title',
+    ];
+
+    protected $translatable = [
+        'title',
+    ];
+}

src/UI/API/Controllers/DocumentController.php

@@ -5,6 +5,7 @@
 namespace AdminKit\Documents\UI\API\Controllers;
 
 use AdminKit\Documents\Models\Document;
+use AdminKit\Documents\Models\DocumentCategory;
 use AdminKit\Documents\UI\API\Data\DocumentData;
 use Illuminate\Http\JsonResponse;
 use Spatie\LaravelData\PaginatedDataCollection;
@@ -18,6 +19,7 @@ public function index(): PaginatedDataCollection
         $documents = QueryBuilder::for(Document::class)
             ->allowedFilters([
                 AllowedFilter::scope('year'),
+                AllowedFilter::scope('category_id'),
             ])
             ->paginate();
 
@@ -35,4 +37,17 @@ public function years(): JsonResponse
 
         return response()->json($years);
     }
+
+    public function categories(): JsonResponse
+    {
+        $locale = app()->getLocale();
+
+        $categories = DocumentCategory::query()
+            ->selectRaw("id, title->'$locale' as title")
+            ->orderBy('sort')
+            ->get()
+            ->toArray();
+
+        return response()->json($categories);
+    }
 }

src/UI/API/Data/DocumentData.php

@@ -18,6 +18,7 @@ public function __construct(
         public ?string $link,
         public ?array $file,
         public ?string $publishedAt,
+        public ?array $category,
     ) {}
 
     public static function fromModel(Document $document): DocumentData
@@ -33,6 +34,7 @@ public static function fromModel(Document $document): DocumentData
                 'size' => $media->size,
             ] : null,
             publishedAt: $document->published_at,
+            category: $document->category->only('id', 'title'),
         );
     }
 }

src/UI/API/Routes/api.php

@@ -5,3 +5,4 @@
 
 Route::get('/documents', [DocumentController::class, 'index']);
 Route::get('/documents/years', [DocumentController::class, 'years']);
+Route::get('/documents/categories', [DocumentController::class, 'categories']);

src/UI/Filament/Resources/DocumentCategoryResource.php

@@ -0,0 +1,98 @@
+<?php
+
+namespace AdminKit\Documents\UI\Filament\Resources;
+
+use AdminKit\Core\Forms\Components\TranslatableTabs;
+use AdminKit\Documents\Models\DocumentCategory;
+use AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource\Pages;
+use Filament\Forms\Components\TextInput;
+use Filament\Forms\Form;
+use Filament\Resources\Resource;
+use Filament\Tables;
+use Filament\Tables\Table;
+
+class DocumentCategoryResource extends Resource
+{
+    protected static ?string $model = DocumentCategory::class;
+
+    protected static ?string $navigationIcon = 'heroicon-o-rectangle-stack';
+
+    public static function getModelLabel(): string
+    {
+        return 'Категория документов';
+    }
+
+    public static function getPluralModelLabel(): string
+    {
+        return 'Категории документов';
+    }
+
+    public static function getNavigationGroup(): ?string
+    {
+        return 'Документы';
+    }
+
+    public static function getTitleCaseModelLabel(): string
+    {
+        return self::getModelLabel();
+    }
+
+    public static function getTitleCasePluralModelLabel(): string
+    {
+        return self::getPluralModelLabel();
+    }
+
+    public static function form(Form $form): Form
+    {
+        return $form
+            ->schema([
+                TranslatableTabs::make(fn ($locale) => [
+                    TextInput::make("title.$locale")
+                        ->label('Наименование')
+                        ->required($locale === app()->getLocale()),
+                ])
+                    ->columnSpan(2),
+            ]);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return $table
+            ->columns([
+                Tables\Columns\TextColumn::make('title')
+                    ->label('Наименование')
+                    ->limit(30),
+                Tables\Columns\TextColumn::make('sort')
+                    ->label('Порядок'),
+            ])
+            ->filters([
+                //
+            ])
+            ->actions([
+                Tables\Actions\EditAction::make(),
+            ])
+            ->bulkActions([
+                Tables\Actions\BulkActionGroup::make([
+                    Tables\Actions\DeleteBulkAction::make(),
+                ]),
+            ])
+            ->reorderable('sort')
+            ->defaultSort('sort');
+    }
+
+    public static function getRelations(): array
+    {
+        return [
+            //
+        ];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => Pages\ListDocumentCategory::route('/'),
+            'create' => Pages\CreateDocumentCategory::route('/create'),
+            'edit' => Pages\EditDocumentCategory::route('/{record}/edit'),
+        ];
+    }
+}

src/UI/Filament/Resources/DocumentCategoryResource/Pages/CreateDocumentCategory.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource\Pages;
+
+use AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource;
+use Filament\Resources\Pages\CreateRecord;
+
+class CreateDocumentCategory extends CreateRecord
+{
+    protected static string $resource = DocumentCategoryResource::class;
+}

src/UI/Filament/Resources/DocumentCategoryResource/Pages/EditDocumentCategory.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource\Pages;
+
+use AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\EditRecord;
+
+class EditDocumentCategory extends EditRecord
+{
+    protected static string $resource = DocumentCategoryResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\DeleteAction::make(),
+        ];
+    }
+}

src/UI/Filament/Resources/DocumentCategoryResource/Pages/ListDocumentCategory.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource\Pages;
+
+use AdminKit\Documents\UI\Filament\Resources\DocumentCategoryResource;
+use Filament\Actions;
+use Filament\Resources\Pages\ListRecords;
+
+class ListDocumentCategory extends ListRecords
+{
+    protected static string $resource = DocumentCategoryResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            Actions\CreateAction::make(),
+        ];
+    }
+}