[Intum](https://intum.fr/aide.md) / [Organizacja](https://intum.fr/aide/organizacja.md)

# [Projekty w Sugesterze: Twoje centrum dowodzenia i efektywnej pracy](https://intum.fr/aide/organizacja/projekt.md) | [API](#api)

Zarządzanie wieloma zadaniami i komunikacją nie musi być wyzwaniem. Funkcja **Projektów** w Sugesterze pozwala zebrać w jednym miejscu wszystkie elementy układanki: maile, zadania, dokumenty i klientów. Dzięki temu zyskujesz pełną kontrolę nad procesami w firmie i pewność, że nic nie umknie Twojej uwadze.

### Co zyskujesz dzięki Projektom?
- **Porządek w komunikacji:** Wszystkie maile powiązane z danym tematem trafiają do jednego folderu.
- **Szybki dostęp do plików:** Dokumenty i załączniki są zawsze pod ręką, przypisane do konkretnego celu.
- **Przejrzysty podział obowiązków:** Widzisz, kto odpowiada za dany etap i jaki jest status prac.
- **Łatwe rozliczanie:** Monitorujesz czas pracy poświęcony na konkretny projekt.

### Jak stworzyć nowy Projekt? (Krok po kroku)
Zacznij działać w kilku prostych krokach:
1. Wejdź w **4 kropki -> Organizacja -> Projekty**.
2. Kliknij przycisk **"+"** **Dodaj projekt**.
3. Wypełnij najważniejsze dane:
    - **Nazwa:** krótka i zrozumiała dla zespołu.
    - **Klient:** przypisz projekt do konkretnej firmy z bazy, aby mieć pełną historię relacji.
    - **Użytkownicy:** wskaż osoby z Twojego zespołu, które będą zaangażowane w prace.
    - **Opis:** dodaj kluczowe założenia, aby każdy wiedział, co jest do zrobienia.
4. Zatwierdź przyciskiem **Zapisz**.

### Zaawansowane funkcje, które ułatwią Ci życie
Projekty w Sugesterze to coś więcej niż tylko lista zadań. Wykorzystaj ich pełny potencjał:
- **Łączenie z wiadomościami e-mail:** Każdą wiadomość w skrzynce odbiorczej możesz przypisać do projektu. Dzięki temu nowi pracownicy wdrożą się w temat błyskawicznie, mając wgląd w całą historię ustaleń.
- **Zadania wewnątrz projektu:** Twórz listę konkretnych kroków (to-do). Każde zadanie może mieć swój termin, priorytet i osobę odpowiedzialną.
- **Repozytorium dokumentów:** Dodawaj pliki bezpośrednio do projektu. Koniec z przeszukiwaniem dysków czy załączników w starych mailach.
- **Statusy i etapy:** Definiuj własne statusy (np. *W trakcie*, *Oczekuje na klienta*, *Zakończone*), aby jednym rzutem oka ocenić postęp prac.
- **Prywatność i uprawnienia:** Decyduj, kto ma wgląd w dany projekt. Możesz tworzyć projekty widoczne dla wszystkich lub tylko dla wybranych osób.

## Podprojekty

Projekt może zawierać podprojekty. Przy tworzeniu podprojektu wybierz **Projekt nadrzędny** lub użyj **+ Dodaj -> Podprojekt** z karty projektu (wtedy nadrzędny jest podpowiedziany). Pozwala to rozbić duże przedsięwzięcie na mniejsze części z osobnym śledzeniem postępów.

### Dlaczego warto korzystać z Projektów?
Zamiast tracić czas na szukanie informacji w różnych miejscach, zyskujesz **jeden, spójny widok**. Projekty w Sugesterze integrują CRM z zarządzaniem zadaniami, co przekłada się na lepszą organizację czasu, szybszy przepływ informacji i większą satysfakcję Twoich klientów.

## Ważne informacje

- Projekt z zadaniami lub podprojektami **nie może być usunięty** - trzeba najpierw przenieść lub usunąć zadania (albo użyć opcji przeniesienia z formularza usuwania)
- Projekt można dezaktywować (wtedy jest oznaczony ikoną ⌛)
- Nowe zadanie w projekcie dziedziczy **odpowiedzialnego** z projektu, jeśli nie wskazano innego
- Nazwa projektu musi być **unikalna** w ramach konta i projektu nadrzędnego
- Faktury i zamówienia tworzone z **+ Dodaj** automatycznie kopiują `client_id` z projektu - jeśli projekt nie ma klienta, wypełnisz go ręcznie w formularzu

**Zacznij porządkować swoje procesy już dziś!**

---

## 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/projects.json` | Lista projektów |
| GET | `/organize/projects/:id.json` | Pojedynczy projekt |
| POST | `/organize/projects.json` | Utworzenie projektu |
| PATCH | `/organize/projects/:id.json` | Aktualizacja projektu |
| DELETE | `/organize/projects/:id.json` | Usunięcie projektu |

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

## Pola projektu

| Pole | Typ | Wymagane | Opis |
|------|-----|----------|------|
| `name` | string | tak | Nazwa projektu (unikalna) |
| `description` | string | nie | Opis projektu (Markdown) |
| `team_id` | integer | nie | ID zespołu |
| `project_id` | integer | nie | ID projektu nadrzędnego (podprojekt) |
| `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 |
| `priority` | number | nie | Priorytet wyświetlania |
| `date_from` | string | nie | Data rozpoczęcia YYYY-MM-DD |
| `date_to` | string | nie | Data zakończenia YYYY-MM-DD |
| `color` | string | nie | Kolor projektu (hex, np. `#3B82F6`) |
| `code` | string | nie | Prefix numeracji zadań (np. PROJ) |
| `active` | boolean | nie | Czy aktywny (domyślnie true) |
| `user_setting_ids` | array | nie | ID członków projektu |

## Tworzenie projektu

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

```json
{
  "project": {
    "name": "Nowy projekt",
    "team_id": 1,
    "responsible_id": 5,
    "code": "NP",
    "color": "#3B82F6"
  }
}
```

## Aktualizacja projektu

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

Wysyłasz tylko zmieniane pola.

```json
{
  "project": {
    "name": "Zmieniona nazwa",
    "active": false
  }
}
```

## Błędy (422)

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

---

## Powiązane

- [Dopasuj widok projektów do swojego stylu pracy](https://intum.fr/aide/dopasuj-widok-projektow-do-swojego-stylu-pracy.md)