[Intum](https://intum.pl/pomoc.md) / [Organizacja](https://intum.pl/pomoc/organizacja.md)

# [Jak zapanować nad pracą zespołową? Poznaj „Listy zadań” w Sugesterze](https://intum.pl/pomoc/organizacja/listy-zadan.md) | [API](#api)

Czy zdarza Ci się gubić w natłoku codziennych obowiązków? Czy masz wrażenie, że ważne projekty utykają w martwym punkcie, a komunikacja w zespole wymaga uporządkowania? Moduł **Listy zadań ** to Twoje centrum dowodzenia, które pozwala przekuć chaos w uporządkowany proces poprzez grupowanie powiązanych zadań w logiczne zbiory.
Dzięki niemu nie tylko widzisz, co jest do zrobienia, ale wiesz dokładnie, kto nad czym pracuje i na jakim etapie jest realizacja każdego projektu. Co ważne, system jest niezwykle elastyczny - **jedno zadanie może należeć do wielu list jednocześnie**.

### Jak zacząć i stworzyć pierwszą listę?
Dostęp do modułu jest prosty i intuicyjny:
1. Kliknij **ikonę czterech kropek -> sekcja Organizacja -> Listy zadań**
2. Kliknij przycisk **+ (Nowa lista)**.
3. Wypełnij parametry listy:
    - **Nazwa** - wymagana, np. *Zadania wrzesień*).
    - **Rodzaj** - *Sprint, Milestone, Lista* lub *Cykl*).
    - **Zespół** oraz **Dział**  - przypisanie do konkretnej struktury w firmie).
    - **Osoba odpowiedzialna** - kto czuwa nad realizacją całej listy).
    - **Ramy czasowe** - Data rozpoczęcia i zakończenia).
    - **Projekt / Klient CRM** - opcjonalne powiązanie z bazą klientów).
4. Kliknij **Zapisz**.

### Rodzaje list zadań - dopasuj narzędzie do typu projektu
Podczas tworzenia nowej listy wybierasz jej rodzaj (*kind*), który wpływa na jej przeznaczenie i sposób działania w systemie:
- **Lista:** Ogólna, klasyczna lista zadań bez ograniczeń czasowych. Idealna jako stały kontener na zadania, np. *„Backlog”*, *„Do omówienia”* czy *„Pomysły”*.
- **Sprint:** Iteracja czasowa (np. 1- lub 2-tygodniowa). Służy do zwinnego planowania pracy na konkretny okres. Posiada sztywne daty ramowe, a po jego zakończeniu pomaga w sprawnym rozliczeniu etapu.
- **Milestone (Kamień milowy):** Oznacza kluczowy punkt zwrotny lub docelowy w projekcie (np. *„Wersja 2.0”*, *„Launch strony”*). Grupuje wszystkie zadania niezbędne do osiągnięcia tego konkretnego celu.
- **Cykl:** Powtarzalny okres pracy. Działa podobnie do sprintu, ale kładzie nacisk na regularność i automatyczną powtarzalność procesów (np. *„Zamknięcie miesiąca”*).

### Jak dodawać zadania do list?
Możesz to robić na 3 wygodne sposoby, w zależności od bieżących potrzeb:
1. **Podczas tworzenia lub edycji zadania:** Wystarczy uzupełnić dedykowane pole *„Listy zadań”*.
2. **Bezpośrednio z poziomu konkretnej listy:** Korzystając z wewnętrznego przycisku szybkiego dodawania zadań.
3. **Poprzez operacje zbiorcze:** Zaznaczając wiele zadań na głównej liście w systemie i masowo przypisując je do wybranej listy.

### Do czego służą listy zadań

**Organizacja sprintów** - grupowanie zadań do realizacji w danym okresie
**Backlog** - lista zadań oczekujących na realizację
**Planowanie **- przygotowanie zestawu zadań do omówienia na spotkaniu
**Kontekst klienta** - lista zadań powiązanych z konkretnym klientem
P**rzenoszenie zadań** - przy zamykaniu listy otwarte zadania mogą zostać automatycznie przeniesione do nowej listy

### Dopasuj widok do swojego stylu pracy
W górnym menu każdej listy znajdziesz zakładki, które pozwalają błyskawicznie przełączać sposób prezentacji danych i filtrować je po zespole, projekcie, statusie czy kliencie:
- **Klasyczna Lista:** Przejrzyste rzędy, idealne do szczegółowej pracy, masowej edycji i szybkiego zarządzania priorytetami.
- **Kanban:** Wizualna tablica procesowa. Zadania dzielą się na kolumny odpowiadające statusom. Idealna do natychmiastowej oceny, co utknęło w miejscu, a co posuwa się do przodu.
- **Lista użytkowników / właścicieli / zespołów:** Perspektywa menedżerska. Pozwala „prześwietlić” listę pod kątem obciążenia konkretnych osób lub całych działów. Widzisz, kto odpowiada za poszczególne elementy układanki, co zapobiega zatorom (tzw. wąskim gardłom).

### Dlaczego Twój zespół pokocha Listy zadań?
- **Pełen wgląd (Licznik zadań):** Każda lista posiada automatyczny licznik zadań (*tasklist_tasks_count*) oraz procentowy pasek postępu, co pozwala natychmiast ocenić stan zaawansowania prac.
- **Transparentność:** Każdy wie, do jakiego zbioru należy jego zadanie i kto za nie odpowiada. Unikasz chaosu i dublowania obowiązków.
- **Pełna historia zmian:** Każda zmiana statusu, komentarz czy przepięcie zadania są rejestrowane, co gwarantuje pełną przewidywalność działań.

Zacznij porządkować swoje projekty za pomocą List zadań już dziś i zobacz, jak praca zespołowa staje się prostsza i efektywniejsza!

---

## API

### Ogólne API

# Intum API

Dokumentacja API platformy [Intum](https://intum.pl) - system operacyjny firmy.

## Host

Host jest zawsze taki sam jak adres konta: `xxxx.intum.com` lub `xxx.intum.pl` (w zależności od ustawień konta)

## Autoryzacja

Wszystkie requesty API wymagają `api_token`:
- header: `Authorization: Bearer TOKEN`

Token możesz wygenerować w **Ustawienia Konta** → **Tokeny API**

## Endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/organize/tasklists.json` | Lista list zadań |
| GET | `/organize/tasklists/:id.json` | Pojedyncza lista zadań |
| POST | `/organize/tasklists.json` | Utworzenie listy zadań |
| PATCH | `/organize/tasklists/:id.json` | Aktualizacja listy zadań |
| DELETE | `/organize/tasklists/:id.json` | Usunięcie listy zadań |

**Autoryzacja:** `Authorization: Bearer TOKEN` (uprawnienie: **organize**)

## Pola listy zadań

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa listy (np. "Sprint 5") |
| `description` | string | nie | Opis listy (Markdown) |
| `team_id` | integer | nie | ID zespołu |
| `project_id` | integer | nie | ID projektu |
| `responsible_id` | integer | nie | ID osoby odpowiedzialnej |
| `status_id` | integer | nie | ID statusu |
| `client_id` | integer | nie | ID klienta (CRM) |
| `department_id` | integer | nie | ID działu |
| `closed` | boolean | nie | Czy lista zamknięta |
| `date_from` | string | nie | Data rozpoczęcia YYYY-MM-DD |
| `date_to` | string | nie | Data zakończenia YYYY-MM-DD |
| `code` | string | nie | Kod/prefix listy |
| `kind` | string | nie | Typ listy |
| `task_ids` | array | nie | ID zadań do przypisania |
| `previous_tasklist_id` | integer | nie | ID poprzedniej listy |
| `close_previous_tasklist` | boolean | nie | Zamknij poprzednią listę |
| `copy_open_tasks` | boolean | nie | Przenieś otwarte zadania z poprzedniej listy |

## Tworzenie listy zadań

```
POST /organize/tasklists.json
Authorization: Bearer TOKEN
```

```json
{
  "tasklist": {
    "name": "Sprint 5",
    "team_id": 1,
    "project_id": 10,
    "date_from": "2026-03-01",
    "date_to": "2026-03-14",
    "task_ids": [100, 101, 102]
  }
}
```

## Aktualizacja listy

```
PATCH /organize/tasklists/:id.json
```

```json
{
  "tasklist": {
    "closed": true,
    "copy_open_tasks": true,
    "previous_tasklist_id": 5
  }
}
```

## Dodatkowe endpointy

| Metoda | Ścieżka | Opis |
|--------|---------|------|
| GET | `/organize/tasklists/find.json?name=Sprint` | Wyszukiwanie listy po nazwie |

## Błędy (422)

```json
{"name": ["nie może być puste"]}
```

---

## Powiązane

- [Jak delegować i organizować pracę w zespole? Przydzielanie zadań w Sugesterze](https://intum.pl/pomoc/organizacja/przydzielanie-zadan.md)