per-board study setup (restructure columns, reset, arm RecoReco) via Integrations (v0.3.0)

2026-07-11 15:34:39 -03:00
parent e7e2b930f3
commit 9247057179
5 changed files with 208 additions and 3 deletions
--- a/Controller/QualKardController.php
+++ b/Controller/QualKardController.php
@@ -0,0 +1,99 @@
+<?php
+
+namespace Kanboard\Plugin\QualKard\Controller;
+
+use Kanboard\Controller\BaseController;
+use Kanboard\Core\Controller\AccessForbiddenException;
+use Kanboard\Plugin\QualKard\Helper\QualKardHelper;
+
+/**
+ * QualKard board actions, posted from the project Integrations page: set up the study board, reset
+ * all cards, or disable. Project-manager gated (the restructure is destructive).
+ */
+class QualKardController extends BaseController
+{
+    /**
+     * Turn this project into a study board: rename the first 7 columns to the standard names (create
+     * or delete to reach exactly 7), move every card to Drafts, store the column roles, reset all
+     * cards to unread + armed-inert, and enable. Once-per-conversion, explicit + confirmed.
+     */
+    public function setup()
+    {
+        $project = $this->authorize();
+        $helper = new QualKardHelper($this->container);
+
+        $names = array('Drafts', 'Study', 'Hairy', 'Hard', 'Medium', 'Easy', 'Done');
+        $columns = $this->columnModel->getAll($project['id']); // position-ordered rows
+        $ids = array();
+
+        for ($i = 0; $i < 7; $i++) {
+            if (isset($columns[$i])) {
+                $this->columnModel->update($columns[$i]['id'], $names[$i]);
+                $ids[$i] = (int) $columns[$i]['id'];
+            } else {
+                $ids[$i] = (int) $this->columnModel->create($project['id'], $names[$i]);
+            }
+        }
+
+        // Move every card to Drafts BEFORE deleting extras -- remove() is a raw DELETE (tasks cascade).
+        foreach ($this->taskFinderModel->getAll($project['id']) as $task) {
+            $this->taskPositionModel->movePosition($project['id'], $task['id'], $ids[0], 1, $task['swimlane_id'], false);
+        }
+
+        for ($i = 7, $n = count($columns); $i < $n; $i++) {
+            $this->columnModel->remove($columns[$i]['id']);
+        }
+
+        $roles = array('draft', 'study', 'hairy', 'hard', 'medium', 'easy', 'done');
+        foreach ($roles as $k => $role) {
+            $this->projectMetadataModel->save($project['id'], array('qualkard_col_'.$role => $ids[$k]));
+        }
+
+        $helper->resetAll($project['id']);
+        $this->projectMetadataModel->save($project['id'], array('qualkard_enabled' => 1));
+
+        $this->flash->success(t('QualKard study board is ready.'));
+        $this->redirectToIntegrations($project);
+    }
+
+    /**
+     * Reset every card on the board: unread, moved to Drafts, armed-inert. Keeps the columns.
+     */
+    public function reset()
+    {
+        $project = $this->authorize();
+        (new QualKardHelper($this->container))->resetAll($project['id']);
+        $this->flash->success(t('All cards reset.'));
+        $this->redirectToIntegrations($project);
+    }
+
+    /**
+     * Disable QualKard on this board (non-destructive: leaves columns and cards as they are).
+     */
+    public function disable()
+    {
+        $project = $this->authorize();
+        $this->projectMetadataModel->save($project['id'], array('qualkard_enabled' => 0));
+        $this->flash->success(t('QualKard disabled on this board.'));
+        $this->redirectToIntegrations($project);
+    }
+
+    // Project-manager gate + CSRF, shared by every action.
+    private function authorize()
+    {
+        $project = $this->getProject();
+
+        if (! $this->helper->user->hasProjectAccess('ProjectEditController', 'edit', $project['id'])) {
+            throw new AccessForbiddenException();
+        }
+
+        $this->checkCSRFForm();
+
+        return $project;
+    }
+
+    private function redirectToIntegrations(array $project)
+    {
+        $this->response->redirect($this->helper->url->to('ProjectViewController', 'integrations', array('project_id' => $project['id'])));
+    }
+}