Add Filament Admin resources and feature tests for ReportBuilder module

Modules/ReportBuilder/Filament/Admin/Resources/ReportTemplateResource.php

@@ -0,0 +1,67 @@
+<?php
+
+namespace Modules\ReportBuilder\Filament\Admin\Resources;
+
+use BackedEnum;
+use Filament\Resources\Resource;
+use Filament\Schemas\Schema;
+use Filament\Support\Icons\Heroicon;
+use Filament\Tables\Table;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages\CreateReportTemplate;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages\DesignReportTemplate;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages\EditReportTemplate;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages\ListReportTemplates;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Schemas\ReportTemplateForm;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Tables\ReportTemplatesTable;
+use Modules\ReportBuilder\Models\ReportTemplate;
+
+class ReportTemplateResource extends Resource
+{
+    protected static ?string $model = ReportTemplate::class;
+
+    protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedDocumentText;
+
+    protected static ?string $navigationGroup = 'Reports';
+
+    protected static ?int $navigationSort = 10;
+
+    public static function getModelLabel(): string
+    {
+        return 'Report Template';
+    }
+
+    public static function getPluralModelLabel(): string
+    {
+        return 'Report Templates';
+    }
+
+    public static function getNavigationLabel(): string
+    {
+        return 'Report Templates';
+    }
+
+    public static function form(Schema $schema): Schema
+    {
+        return ReportTemplateForm::configure($schema);
+    }
+
+    public static function table(Table $table): Table
+    {
+        return ReportTemplatesTable::configure($table);
+    }
+
+    public static function getRelations(): array
+    {
+        return [];
+    }
+
+    public static function getPages(): array
+    {
+        return [
+            'index' => ListReportTemplates::route('/'),
+            'create' => CreateReportTemplate::route('/create'),
+            'edit' => EditReportTemplate::route('/{record}/edit'),
+            'design' => DesignReportTemplate::route('/{record}/design'),
+        ];
+    }
+}

Modules/ReportBuilder/Filament/Admin/Resources/ReportTemplateResource/Pages/CreateReportTemplate.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages;
+
+use Filament\Resources\Pages\CreateRecord;
+use Illuminate\Database\Eloquent\Model;
+use Modules\Core\Models\Company;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource;
+use Modules\ReportBuilder\Services\ReportTemplateService;
+
+class CreateReportTemplate extends CreateRecord
+{
+    protected static string $resource = ReportTemplateResource::class;
+
+    public function create(bool $another = false): void
+    {
+        $this->authorizeAccess();
+
+        $this->callHook('beforeValidate');
+        $data = $this->form->getState();
+        $this->callHook('afterValidate');
+
+        $data = $this->mutateFormDataBeforeCreate($data);
+        $this->callHook('beforeCreate');
+
+        $this->record = $this->handleRecordCreation($data);
+
+        $this->callHook('afterCreate');
+        $this->rememberData();
+
+        $this->getCreatedNotification()?->send();
+
+        if ($another) {
+            $this->form->model($this->getRecord()::class);
+            $this->record = null;
+            $this->fillForm();
+
+            return;
+        }
+
+        $this->redirect($this->getRedirectUrl());
+    }
+
+    protected function handleRecordCreation(array $data): Model
+    {
+        $company = Company::find(session('current_company_id'));
+        if (!$company) {
+            $company = auth()->user()->companies()->first();
+        }
+
+        return app(ReportTemplateService::class)->createTemplate(
+            $company,
+            $data['name'],
+            $data['template_type'],
+            []
+        );
+    }
+}

Modules/ReportBuilder/Filament/Admin/Resources/ReportTemplateResource/Pages/DesignReportTemplate.php

@@ -0,0 +1,160 @@
+<?php
+
+namespace Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages;
+
+use Filament\Resources\Pages\Page;
+use Illuminate\Support\Str;
+use Livewire\Attributes\On;
+use Modules\ReportBuilder\DTOs\BlockDTO;
+use Modules\ReportBuilder\DTOs\GridPositionDTO;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource;
+use Modules\ReportBuilder\Models\ReportTemplate;
+use Modules\ReportBuilder\Services\GridSnapperService;
+use Modules\ReportBuilder\Services\ReportTemplateService;
+use Modules\ReportBuilder\Transformers\BlockTransformer;
+
+class DesignReportTemplate extends Page
+{
+    protected static string $resource = ReportTemplateResource::class;
+
+    protected static string $view = 'reportbuilder::filament.admin.resources.report-template-resource.pages.design-report-template';
+
+    public ReportTemplate $record;
+
+    public array $blocks = [];
+
+    public string $selectedBlockId = '';
+
+    public function mount(ReportTemplate $record): void
+    {
+        $this->record = $record;
+        $this->loadBlocks();
+    }
+
+    protected function loadBlocks(): void
+    {
+        $service = app(ReportTemplateService::class);
+        $blockDTOs = $service->loadBlocks($this->record);
+
+        $this->blocks = [];
+        foreach ($blockDTOs as $blockDTO) {
+            $blockArray = BlockTransformer::toArray($blockDTO);
+            $this->blocks[$blockArray['id']] = $blockArray;
+        }
+    }
+
+    #[On('drag-block')]
+    public function updateBlockPosition(string $blockId, array $position): void
+    {
+        if (!isset($this->blocks[$blockId])) {
+            return;
+        }
+
+        $gridSnapper = app(GridSnapperService::class);
+        $positionDTO = new GridPositionDTO();
+        $positionDTO->setX($position['x'] ?? 0)
+            ->setY($position['y'] ?? 0)
+            ->setWidth($position['width'] ?? 1)
+            ->setHeight($position['height'] ?? 1);
+
+        if (!$gridSnapper->validate($positionDTO)) {
+            return;
+        }
+
+        $snappedPosition = $gridSnapper->snap($positionDTO);
+
+        $this->blocks[$blockId]['position'] = [
+            'x' => $snappedPosition->getX(),
+            'y' => $snappedPosition->getY(),
+            'width' => $snappedPosition->getWidth(),
+            'height' => $snappedPosition->getHeight(),
+        ];
+    }
+
+    #[On('add-block')]
+    public function addBlock(string $blockType): void
+    {
+        $blockId = 'block_' . $blockType . '_' . Str::random(8);
+
+        $position = new GridPositionDTO();
+        $position->setX(0)->setY(0)->setWidth(6)->setHeight(4);
+
+        $block = new BlockDTO();
+        $block->setId($blockId)
+            ->setType($blockType)
+            ->setPosition($position)
+            ->setConfig([])
+            ->setLabel(ucfirst(str_replace('_', ' ', $blockType)))
+            ->setIsCloneable(false)
+            ->setDataSource('custom')
+            ->setIsCloned(false)
+            ->setClonedFrom(null);
+
+        $this->blocks[$blockId] = BlockTransformer::toArray($block);
+    }
+
+    #[On('clone-block')]
+    public function cloneBlock(string $blockId): void
+    {
+        if (!isset($this->blocks[$blockId])) {
+            return;
+        }
+
+        $originalBlock = $this->blocks[$blockId];
+
+        if ($originalBlock['isCloned'] === false && $originalBlock['isCloneable'] === true) {
+            $newBlockId = 'block_' . $originalBlock['type'] . '_' . Str::random(8);
+
+            $position = new GridPositionDTO();
+            $position->setX($originalBlock['position']['x'] + 1)
+                ->setY($originalBlock['position']['y'] + 1)
+                ->setWidth($originalBlock['position']['width'])
+                ->setHeight($originalBlock['position']['height']);
+
+            $clonedBlock = new BlockDTO();
+            $clonedBlock->setId($newBlockId)
+                ->setType($originalBlock['type'])
+                ->setPosition($position)
+                ->setConfig($originalBlock['config'])
+                ->setLabel($originalBlock['label'] . ' (Clone)')
+                ->setIsCloneable(false)
+                ->setDataSource($originalBlock['dataSource'])
+                ->setIsCloned(true)
+                ->setClonedFrom($blockId);
+
+            $this->blocks[$newBlockId] = BlockTransformer::toArray($clonedBlock);
+        }
+    }
+
+    #[On('delete-block')]
+    public function deleteBlock(string $blockId): void
+    {
+        if (!isset($this->blocks[$blockId])) {
+            return;
+        }
+
+        unset($this->blocks[$blockId]);
+    }
+
+    #[On('edit-config')]
+    public function updateBlockConfig(string $blockId, array $config): void
+    {
+        if (!isset($this->blocks[$blockId])) {
+            return;
+        }
+
+        $this->blocks[$blockId]['config'] = array_merge(
+            $this->blocks[$blockId]['config'] ?? [],
+            $config
+        );
+    }
+
+    public function save(): void
+    {
+        $service = app(ReportTemplateService::class);
+        $service->persistBlocks($this->record, $this->blocks);
+
+        $this->dispatch('blocks-saved');
+        $this->redirect(static::getResource()::getUrl('index'));
+    }
+}

Modules/ReportBuilder/Filament/Admin/Resources/ReportTemplateResource/Pages/EditReportTemplate.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages;
+
+use Filament\Actions\DeleteAction;
+use Filament\Resources\Pages\EditRecord;
+use Illuminate\Database\Eloquent\Model;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource;
+use Modules\ReportBuilder\Services\ReportTemplateService;
+
+class EditReportTemplate extends EditRecord
+{
+    protected static string $resource = ReportTemplateResource::class;
+
+    public function save(bool $shouldRedirect = true, bool $shouldSendSavedNotification = true): void
+    {
+        $this->authorizeAccess();
+
+        $this->callHook('beforeValidate');
+        $data = $this->form->getState();
+        $this->callHook('afterValidate');
+
+        $data = $this->mutateFormDataBeforeSave($data);
+        $this->callHook('beforeSave');
+
+        $this->record = $this->handleRecordUpdate($this->getRecord(), $data);
+
+        $this->callHook('afterSave');
+
+        if ($shouldSendSavedNotification) {
+            $this->getSavedNotification()?->send();
+        }
+
+        if ($shouldRedirect) {
+            $this->redirect($this->getRedirectUrl());
+        }
+    }
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            DeleteAction::make()
+                ->visible(fn () => !$this->record->is_system)
+                ->action(function () {
+                    app(ReportTemplateService::class)->deleteTemplate($this->record);
+                }),
+        ];
+    }
+
+    protected function handleRecordUpdate(Model $record, array $data): Model
+    {
+        $record->update([
+            'name' => $data['name'],
+            'description' => $data['description'] ?? null,
+            'template_type' => $data['template_type'],
+            'is_active' => $data['is_active'] ?? true,
+        ]);
+
+        return $record;
+    }
+}

Modules/ReportBuilder/Filament/Admin/Resources/ReportTemplateResource/Pages/ListReportTemplates.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource\Pages;
+
+use Filament\Actions\Action;
+use Filament\Actions\CreateAction;
+use Filament\Resources\Pages\ListRecords;
+use Modules\Core\Models\Company;
+use Modules\ReportBuilder\Filament\Admin\Resources\ReportTemplateResource;
+use Modules\ReportBuilder\Services\ReportTemplateService;
+
+class ListReportTemplates extends ListRecords
+{
+    protected static string $resource = ReportTemplateResource::class;
+
+    protected function getHeaderActions(): array
+    {
+        return [
+            CreateAction::make()
+                ->action(function (array $data) {
+                    $company = Company::find(session('current_company_id'));
+                    if (!$company) {
+                        $company = auth()->user()->companies()->first();
+                    }
+
+                    app(ReportTemplateService::class)->createTemplate(
+                        $company,
+                        $data['name'],
+                        $data['template_type'],
+                        []
+                    );
+                })
+                ->modalWidth('full'),
+        ];
+    }
+}