UPP_21

Author: ManukMinasyan

resources/views/filament/pages/kanban-board-page.blade.php

@@ -2,6 +2,7 @@
     <div class="h-[calc(100vh-12rem)]">
         @livewire('relaticle.flowforge.livewire.kanban-board', [
             'adapter' => $this->getAdapter(),
+            'pageClass' => $this::class
         ])
     </div>
 </x-filament::page>

src/Adapters/AbstractKanbanAdapter.php

@@ -4,30 +4,158 @@
 
 namespace Relaticle\Flowforge\Adapters;
 
-use App\Models\Task;
 use Filament\Forms\Form;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Support\Collection;
 use Livewire\Wireable;
 use Relaticle\Flowforge\Config\KanbanConfig;
 use Relaticle\Flowforge\Contracts\KanbanAdapterInterface;
 
-/**
- * Abstract implementation of the Kanban adapter interface.
- *
- * This class provides shared functionality for all Eloquent-based Kanban adapters,
- * including configuration management and common form building logic.
- */
 abstract class AbstractKanbanAdapter implements KanbanAdapterInterface, Wireable
 {
+    /**
+     * The base Eloquent query builder.
+     *
+     * @var Builder
+     */
+    public Builder $baseQuery;
+
     /**
      * Create a new abstract Kanban adapter instance.
      */
     public function __construct(
-        protected readonly KanbanConfig $config
+        Builder $query,
+        public KanbanConfig $config
     ) {
     }
 
+    /**
+     * Get a new query builder, cloned from the base query.
+     */
+    protected function newQuery(): Builder
+    {
+        return clone $this->baseQuery;
+    }
+
+    /**
+     * Find a model by its ID.
+     *
+     * @param mixed $id The model ID
+     */
+    public function getModelById(mixed $id): ?Model
+    {
+        // Just find by ID without additional filters from the base query
+        // This ensures we can find models by ID regardless of the base query filters
+        return $this->baseQuery->getModel()::query()->find($id);
+    }
+
+    /**
+     * Get all items for the Kanban board.
+     */
+    public function getItems(): Collection
+    {
+        $query = $this->newQuery();
+        $orderField = $this->config->getOrderField();
+
+        if ($orderField !== null) {
+            $query->orderBy($orderField);
+        }
+
+        $models = $query->get();
+
+        return $this->formatCardsForDisplay($models);
+    }
+
+    /**
+     * Get items for a specific column with pagination.
+     *
+     * @param string|int $columnId The column ID
+     * @param int $limit The number of items to return
+     */
+    public function getItemsForColumn(string|int $columnId, int $limit = 10): Collection
+    {
+        $columnField = $this->config->getColumnField();
+        $orderField = $this->config->getOrderField();
+
+        $query = $this->newQuery()->where($columnField, $columnId);
+
+        if ($orderField !== null) {
+            $query->orderBy($orderField);
+        }
+
+        $models = $query->limit($limit)->get();
+
+        return $this->formatCardsForDisplay($models);
+    }
+
+    /**
+     * Get the total count of items for a specific column.
+     *
+     * @param string|int $columnId The column ID
+     */
+    public function getColumnItemsCount(string|int $columnId): int
+    {
+        $columnField = $this->config->getColumnField();
+
+        return $this->newQuery()
+            ->where($columnField, $columnId)
+            ->count();
+    }
+
+    /**
+     * Create a new card with the given attributes.
+     *
+     * @param array<string, mixed> $attributes The card attributes
+     */
+    public function createCard(array $attributes): ?Model
+    {
+        $model = $this->baseQuery->getModel()->newInstance();
+
+        // Apply any scopes from the base query if applicable
+        // For example, if the base query filters by user_id, we want to set that on the new model
+        $wheres = $this->baseQuery->getQuery()->wheres;
+
+        foreach ($wheres as $where) {
+            if (isset($where['column']) && isset($where['value']) && $where['type'] === 'Basic') {
+                // If the filter is a basic where clause, apply it to the new model
+                // This ensures models created through this adapter respect the base query conditions
+                $model->{$where['column']} = $where['value'];
+            }
+        }
+
+        $model->fill($attributes);
+
+        if ($model->save()) {
+            return $model;
+        }
+
+        return null;
+    }
+
+    /**
+     * Update an existing card with the given attributes.
+     *
+     * @param Model $card The card to update
+     * @param array<string, mixed> $attributes The card attributes to update
+     */
+    public function updateCard(Model $card, array $attributes): bool
+    {
+        $card->fill($attributes);
+
+        return $card->save();
+    }
+
+    /**
+     * Delete an existing card.
+     *
+     * @param Model $card The card to delete
+     */
+    public function deleteCard(Model $card): bool
+    {
+        return $card->delete();
+    }
+
     /**
      * Get the configuration for this adapter.
      */
@@ -44,17 +172,9 @@ public function getConfig(): KanbanConfig
      */
     public function getCreateForm(Form $form, mixed $activeColumn): Form
     {
-        // Check for custom create form callback
-        $createCallback = $this->config->getCreateFormCallback();
-
-        if ($createCallback !== null && is_callable($createCallback)) {
-            return $createCallback($form, $activeColumn);
-        }
-
         // Fall back to default create form implementation
         $titleField = $this->config->getTitleField();
         $descriptionField = $this->config->getDescriptionField();
-        $columnField = $this->config->getColumnField();
 
         $schema = KanbanConfig::getDefaultCreateFormSchema($titleField, $descriptionField);
 
@@ -74,20 +194,6 @@ public function getCreateForm(Form $form, mixed $activeColumn): Form
      */
     public function getEditForm(Form $form): Form
     {
-        // Check for custom edit form callback
-        $editCallback = $this->config->getEditFormCallback();
-
-        if ($editCallback !== null && is_callable($editCallback)) {
-            return $editCallback($form);
-        }
-
-        // Check for custom create form callback as a fallback
-        $createCallback = $this->config->getCreateFormCallback();
-
-        if ($createCallback !== null && is_callable($createCallback)) {
-            return $createCallback($form, null);
-        }
-
         // Fall back to default edit form implementation
         $titleField = $this->config->getTitleField();
         $descriptionField = $this->config->getDescriptionField();
@@ -182,4 +288,32 @@ public function updateCardsOrderAndColumn(string|int $columnId, array $cardIds):
 
         return $success;
     }
+
+
+    /**
+     * Convert the adapter to a Livewire-compatible array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toLivewire(): array
+    {
+        return [
+            'query' => \EloquentSerialize::serialize($this->baseQuery),
+            'config' => $this->config->toArray(),
+        ];
+    }
+
+    /**
+     * Create a new adapter instance from a Livewire-compatible array.
+     *
+     * @param array<string, mixed> $value The Livewire-compatible array
+     * @return static
+     */
+    public static function fromLivewire($value): static
+    {
+        $query = \EloquentSerialize::unserialize($value['query']);
+        $config = new KanbanConfig(...$value['config']);
+
+        return new static($query, $config);
+    }
 }