Úlohy (Kanban)
Modul pre správu úloh vo forme kanban boardu. Úlohy sú organizované v kategóriách (projektoch), kde každá kategória má vlastné stĺpce (stages) a úlohy sa presúvajú medzi nimi.
Kategórie (projekty)
Zoznam kategórií
GET /api/task/categories
Oprávnenie: TASK_LIST
Vráti zoznam všetkých kategórií (kanban boardov).
Stĺpce kategórie
GET /api/task/{category_uuid}/stages
Oprávnenie: TASK_LIST
Vráti zoznam stĺpcov (stages) pre danú kategóriu vrátane názvov, farieb a poradia.
Používatelia v kategórii
GET /api/task/{category_uuid}/users
Oprávnenie: TASK_LIST
Vráti zoznam používateľov priradených ku kategórii.
Úlohy v stĺpci
GET /api/task/stage/{stage_uuid}/tasks
Oprávnenie: TASK_LIST
Filtre:
| Parameter | Typ | Popis |
|---|---|---|
assigned_user_uuid |
string (uuid) | Filtrovať podľa priradeného používateľa |
per_page |
integer | Počet záznamov na stránku (default: 10) |
Odpoveď: Stránkovaný zoznam úloh v danom stĺpci.
Vytvorenie úlohy
POST /api/task/{category_uuid}
Oprávnenie: TASK_CREATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
title |
string | áno | Názov úlohy (max. 255 znakov) |
stage_uuid |
string (uuid) | nie | UUID stĺpca (ak nie je zadaný, použije sa predvolený) |
Detail úlohy
GET /api/task/{task_uuid}
Oprávnenie: TASK_DETAIL
Vráti kompletné údaje o úlohe vrátane:
- Priradený používateľ
- Prílohy (súbory)
- Počet komentárov
- Priradené podúlohy
- Rodičovská úloha
- Pokuty (fines)
- Stav deadlinu
Úprava názvu úlohy
PUT /api/task/{task_uuid}/title
Oprávnenie: TASK_UPDATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
title |
string | áno | Nový názov |
Úprava popisu úlohy
PUT /api/task/{task_uuid}/content
Oprávnenie: TASK_UPDATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
description |
string | nie | Text popisu úlohy |
Presunutie úlohy (kanban)
PUT /api/task/{task_uuid}/stage
Oprávnenie: TASK_UPDATE_POSITION
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
stage_uuid |
string (uuid) | áno | UUID cieľového stĺpca |
position |
integer | nie | Pozícia v stĺpci (min. 0) |
Priradenie používateľa
PUT /api/task/{task_uuid}/assign-user
Oprávnenie: TASK_ASSIGN_USER
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
user |
string (uuid) | nie | UUID používateľa (null = odstrániť priradenie) |
Priradenie podúlohy
PUT /api/task/{task_uuid}/assign-task
Oprávnenie: TASK_ASSIGN_TASK
Vytvorí novú úlohu a priradí ju ako podúlohu.
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
task_category_uuid |
string (uuid) | áno | UUID kategórie pre novú úlohu |
title |
string | áno | Názov podúlohy (max. 255 znakov) |
Nastavenie deadlinu
PUT /api/task/{task_uuid}/deadline
Oprávnenie: TASK_DEADLINE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
deadline_at |
string | nie | Deadline (formát: Y-m-d H:i, null = zrušiť deadline) |
Správa príloh
Pridanie súboru k úlohe
POST /api/task/{task_uuid}/file
Oprávnenie: TASK_UPDATE
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
file |
file | áno | Súbor na priloženie |
Stiahnutie ZIP archívu príloh
POST /api/task/{task_uuid}/file/zip
Oprávnenie: TASK_DETAIL
| Parameter | Typ | Povinný | Popis |
|---|---|---|---|
files |
array | áno | Zoznam UUID médií na stiahnutie |
files.* |
string (uuid) | áno | UUID média |
Odpoveď: ZIP súbor s vybranými prílohami.
Zmazanie prílohy
DELETE /api/task/{task_uuid}/file/{media_uuid}
Oprávnenie: TASK_UPDATE
Zmazanie úlohy
DELETE /api/task/{task_uuid}
Oprávnenie: TASK_DELETE