feat: Kanban Board MVP — column CRUD + board view

appinfo/routes.php

@@ -10,6 +10,12 @@
         ['name' => 'settings#create', 'url' => '/api/settings', 'verb' => 'POST'],
         ['name' => 'settings#load',  'url' => '/api/settings/load', 'verb' => 'POST'],
 
+        // Column CRUD endpoints.
+        ['name' => 'column#index',   'url' => '/api/columns',      'verb' => 'GET'],
+        ['name' => 'column#create',  'url' => '/api/columns',      'verb' => 'POST'],
+        ['name' => 'column#update',  'url' => '/api/columns/{id}', 'verb' => 'PATCH'],
+        ['name' => 'column#destroy', 'url' => '/api/columns/{id}', 'verb' => 'DELETE'],
+
         // Prometheus metrics endpoint.
         ['name' => 'metrics#index', 'url' => '/api/metrics', 'verb' => 'GET'],
         // Health check endpoint.

lib/Controller/ColumnController.php

@@ -0,0 +1,289 @@
+<?php
+
+/**
+ * Planix Column Controller
+ *
+ * Controller for managing kanban board columns per project.
+ *
+ * @category Controller
+ * @package  OCA\Planix\Controller
+ *
+ * @author    Conduction Development Team <dev@conductio.nl>
+ * @copyright 2026 Conduction B.V.
+ * @license   EUPL-1.2 https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12
+ *
+ * @version GIT: <git-id>
+ *
+ * @link https://conduction.nl
+ */
+
+declare(strict_types=1);
+
+namespace OCA\Planix\Controller;
+
+use OCA\Planix\AppInfo\Application;
+use OCA\Planix\Service\ColumnService;
+use OCP\AppFramework\Controller;
+use OCP\AppFramework\Http;
+use OCP\AppFramework\Http\JSONResponse;
+use OCP\IRequest;
+
+/**
+ * Controller for managing kanban board columns.
+ */
+class ColumnController extends Controller
+{
+    /**
+     * Constructor for the ColumnController.
+     *
+     * @param IRequest      $request       The request object
+     * @param ColumnService $columnService The column service
+     *
+     * @return void
+     */
+    public function __construct(
+        IRequest $request,
+        private ColumnService $columnService,
+    ) {
+        parent::__construct(appName: Application::APP_ID, request: $request);
+    }//end __construct()
+
+    /**
+     * List columns for a project, ordered by position.
+     *
+     * @NoAdminRequired
+     *
+     * @return JSONResponse
+     */
+    public function index(): JSONResponse
+    {
+        $projectId = $this->request->getParam('projectId');
+
+        if (empty($projectId) === true) {
+            return new JSONResponse(
+                ['error' => 'The projectId query parameter is required.'],
+                Http::STATUS_BAD_REQUEST
+            );
+        }
+
+        $project = $this->columnService->findProject($projectId);
+        if ($project === null) {
+            return new JSONResponse(
+                ['error' => 'Project not found.'],
+                Http::STATUS_NOT_FOUND
+            );
+        }
+
+        if ($this->columnService->isProjectMember($projectId, $project) === false) {
+            return new JSONResponse(
+                ['error' => 'You are not a member of this project.'],
+                Http::STATUS_FORBIDDEN
+            );
+        }
+
+        $columns = $this->columnService->listColumns($projectId);
+
+        return new JSONResponse($columns);
+
+    }//end index()
+
+    /**
+     * Create a new column.
+     *
+     * @NoAdminRequired
+     *
+     * @return JSONResponse
+     */
+    public function create(): JSONResponse
+    {
+        $data      = $this->request->getParams();
+        $projectId = $data['project'] ?? ($data['projectId'] ?? null);
+
+        if (empty($projectId) === true) {
+            return new JSONResponse(
+                ['error' => 'The project field is required.'],
+                Http::STATUS_BAD_REQUEST
+            );
+        }
+
+        $project = $this->columnService->findProject($projectId);
+        if ($project === null) {
+            return new JSONResponse(
+                ['error' => 'Project not found.'],
+                Http::STATUS_NOT_FOUND
+            );
+        }
+
+        if ($this->columnService->isProjectMember($projectId, $project) === false) {
+            return new JSONResponse(
+                ['error' => 'You are not a member of this project.'],
+                Http::STATUS_FORBIDDEN
+            );
+        }
+
+        $title = $data['title'] ?? '';
+        if (empty($title) === true) {
+            return new JSONResponse(
+                ['error' => 'The title field is required.'],
+                Http::STATUS_BAD_REQUEST
+            );
+        }
+
+        $allowedTypes = ['active', 'done'];
+        $type         = $data['type'] ?? 'active';
+        if (in_array($type, $allowedTypes, true) === false) {
+            return new JSONResponse(
+                ['error' => 'Invalid type. Allowed values: active, done.'],
+                Http::STATUS_BAD_REQUEST
+            );
+        }
+
+        $wipLimit = null;
+        if (isset($data['wipLimit']) === true) {
+            $wipLimit = (int) $data['wipLimit'];
+        }
+
+        $columnData = [
+            'title'    => $title,
+            'project'  => $projectId,
+            'order'    => (int) ($data['order'] ?? ($data['position'] ?? 0)),
+            'wipLimit' => $wipLimit,
+            'color'    => $data['color'] ?? null,
+            'type'     => $type,
+        ];
+
+        $column = $this->columnService->createColumn($columnData, $project);
+
+        return new JSONResponse($column, Http::STATUS_CREATED);
+
+    }//end create()
+
+    /**
+     * Update an existing column.
+     *
+     * @param string $id The column UUID
+     *
+     * @NoAdminRequired
+     *
+     * @return JSONResponse
+     */
+    public function update(string $id): JSONResponse
+    {
+        $column = $this->columnService->findColumn($id);
+        if ($column === null) {
+            return new JSONResponse(
+                ['error' => 'Column not found.'],
+                Http::STATUS_NOT_FOUND
+            );
+        }
+
+        $projectId = $column['project'] ?? '';
+        if ($this->columnService->isProjectMember($projectId) === false) {
+            return new JSONResponse(
+                ['error' => 'You are not a member of this project.'],
+                Http::STATUS_FORBIDDEN
+            );
+        }
+
+        $data       = $this->request->getParams();
+        $updateData = [];
+
+        if (isset($data['title']) === true) {
+            $updateData['title'] = $data['title'];
+        }
+
+        if (isset($data['order']) === true || isset($data['position']) === true) {
+            $updateData['order'] = (int) ($data['order'] ?? $data['position']);
+        }
+
+        if (array_key_exists('wipLimit', $data) === true) {
+            if ($data['wipLimit'] !== null) {
+                $updateData['wipLimit'] = (int) $data['wipLimit'];
+            } else {
+                $updateData['wipLimit'] = null;
+            }
+        }
+
+        if (isset($data['color']) === true) {
+            $updateData['color'] = $data['color'];
+        }
+
+        if (isset($data['type']) === true) {
+            $allowedTypes = ['active', 'done'];
+            if (in_array($data['type'], $allowedTypes, true) === false) {
+                return new JSONResponse(
+                    ['error' => 'Invalid type. Allowed values: active, done.'],
+                    Http::STATUS_BAD_REQUEST
+                );
+            }
+
+            $updateData['type'] = $data['type'];
+        }
+
+        if (empty($updateData) === true) {
+            return new JSONResponse(
+                ['error' => 'No valid fields provided for update.'],
+                Http::STATUS_BAD_REQUEST
+            );
+        }
+
+        try {
+            $updated = $this->columnService->updateColumn($id, $updateData);
+        } catch (\RuntimeException $e) {
+            return new JSONResponse(
+                ['error' => 'Failed to update column.'],
+                Http::STATUS_INTERNAL_SERVER_ERROR
+            );
+        }
+
+        return new JSONResponse($updated);
+
+    }//end update()
+
+    /**
+     * Delete a column. Tasks in this column are moved to the backlog.
+     *
+     * @param string $id The column UUID
+     *
+     * @NoAdminRequired
+     *
+     * @return JSONResponse
+     */
+    public function destroy(string $id): JSONResponse
+    {
+        $column = $this->columnService->findColumn($id);
+        if ($column === null) {
+            return new JSONResponse(
+                ['error' => 'Column not found.'],
+                Http::STATUS_NOT_FOUND
+            );
+        }
+
+        $projectId = $column['project'] ?? '';
+        if ($this->columnService->isProjectMember($projectId) === false) {
+            return new JSONResponse(
+                ['error' => 'You are not a member of this project.'],
+                Http::STATUS_FORBIDDEN
+            );
+        }
+
+        try {
+            $deleted = $this->columnService->deleteColumn($id);
+        } catch (\RuntimeException $e) {
+            return new JSONResponse(
+                ['error' => 'Failed to delete column.'],
+                Http::STATUS_INTERNAL_SERVER_ERROR
+            );
+        }
+
+        if ($deleted === false) {
+            return new JSONResponse(
+                ['error' => 'Failed to delete column.'],
+                Http::STATUS_INTERNAL_SERVER_ERROR
+            );
+        }
+
+        return new JSONResponse(null, Http::STATUS_NO_CONTENT);
+
+    }//end destroy()
+}//end class