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

# [Ustawienia Organizacji](https://intum.pl/pomoc/organizacja/ustawienia-organizacji.md) | [API](#api)

Ustawienia modułu Organizacja znajdziesz w menu Organizacja > Ustawienia.

## Ustawienia konta i ustawienia osobiste

Strona ustawień dzieli się na dwie części:

**Twoje ustawienia** - dotyczą tylko Ciebie. Każdy użytkownik może je zmienić niezależnie od innych.

**Ustawienia zadań** - dotyczą całego konta. Zmienia je administrator i obowiązują wszystkich użytkowników (chyba że ktoś ustawił inaczej w swoich ustawieniach).

## Jak działa mechanizm domyślnych

Każde ustawienie z sekcji "Twoje ustawienia" ma wartość domyślną pobraną z ustawień konta. Jeśli nie zmieniasz nic w swoich ustawieniach, obowiązuje to co ustawił administrator.

Kiedy sam zmienisz któreś ustawienie, Twoja wartość ma pierwszeństwo - niezależnie od tego co później zmieni admin.

Żeby wrócić do wartości z konta, najedź na wiersz z ustawieniem i kliknij "przywróć domyślne". Od tego momentu znowu będziesz używać wartości ustawionej przez administratora.

## Wartości domyślne

Poniżej lista ustawień z ich domyślnymi wartościami - czyli co obowiązuje zanim ktokolwiek cokolwiek zmieni.

| Ustawienie | Domyślnie | Co robi |
|---|---|---|
| Przycisk Play (start_stop) | włączony | Przycisk Start/Stop w górnym menu do rejestracji czasu pracy. Jak wyłączysz, przycisk znika |
| ID zadania na liście (task_id_on_list) | wyłączony | Numer zadania (#42) obok tytułu na liście zadań. Przydatne gdy odwołujesz się do zadań po numerach |
| ID zadania na szczegółach (task_id_on_show) | wyłączony | Numer zadania na stronie szczegółów zadania |
| Rozwijane podtaski (subtasks_on_list) | włączony | Możliwość rozwijania podtasków bezpośrednio na liście - bez wchodzenia w zadanie |
| Tytuł i treść razem (merged_title) | włączony | Jedno pole na zadaniu - tytuł to pierwsza linia, reszta to treść. Wyłączenie daje osobne pole na tytuł i osobne na treść |
| Więcej opcji (more_options) | wyłączony | Formularz zadania pokazuje tylko tytuł, treść i przypisanego. Reszta pól (termin, projekt, priorytet) jest ukryta pod "pokaż więcej" |
| Format edytora (markup_lang) | github_markdown | Edytor treści zadań. Opcje: github_markdown (Markdown z podglądem), wysiwyg_html (edytor wizualny), auto_update_off (bez auto-zapisu) |
| Repozytoria Git (git_repos) | puste | Adresy repozytoriów GitHub/GitLab oddzielone przecinkiem. AI używa ich do generowania podsumowań workinfo z commitów |

## Dostępne ustawienia

### Twoje ustawienia (per użytkownik)

- **Przycisk Play** - pokazuje lub ukrywa przycisk Start/Stop do rejestracji czasu pracy w górnym menu
- **Pokazuj ID zadania na liście** - wyświetla numer zadania (np. #42) na liście zadań
- **Pokazuj ID zadania na widoku szczegółów** - wyświetla numer zadania na stronie zadania
- **Pokazuj rozwijane podtaski** - pozwala rozwijać podtaski bezpośrednio na liście zadań
- **Tytuł i treść w jednym polu** - domyślnie tytuł zadania jest wyciągany z pierwszej linii treści. Po wyłączeniu pojawia się osobne pole na tytuł

### Ustawienia zadań (per konto)

Te same opcje co wyżej, ale ustawiane przez admina jako domyślne dla całego konta. Dodatkowo:

- **Repozytoria Git** - adresy repozytoriów GitHub/GitLab do generowania workinfo przez AI


---

## 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**

## Odczyt aktualnych ustawień

```
GET /organize/settings.json
```

Zwraca aktualne ustawienia konta (z pola `fields`) oraz ustawienia zalogowanego użytkownika. Wartości w odpowiedzi uwzględniają cały łańcuch: user_setting > organize_setting > DEFAULT.

## Zmiana ustawień przez API

Ustawienia organizacji zmieniasz przez endpoint `POST /account/set_field`.

### Ustawienia konta (admin)

```
POST /account/set_field
Content-Type: application/x-www-form-urlencoded

target=organize_setting&key=organize.task.merged_title&value=false
```

Dostępne klucze:
- `organize.task.task_id_on_list` - true/false
- `organize.task.task_id_on_show` - true/false
- `organize.task.subtasks_on_list` - true/false
- `organize.task.merged_title` - true/false
- `organize.workinfo.git_repos` - string (URL-e oddzielone przecinkiem)

### Ustawienia użytkownika

```
POST /account/set_field

target=user_setting&key=organize.task.merged_title&value=true&skip_cleanup=true
```

Ważne: dodaj `skip_cleanup=true` przy zapisie ustawień użytkownika. Bez tego wartość identyczna z domyślną zostanie usunięta (fallback do ustawień konta).

### Przywrócenie domyślnych użytkownika

```
POST /account/set_field

target=user_setting&key=organize.task.merged_title&value=default
```

Wartość `default` usuwa klucz z ustawień użytkownika. Od tego momentu obowiązuje wartość z ustawień konta.

### Ustawienie przycisku Play

```
POST /account/set_field

target=user_setting&key=organize.workinfo.start_stop&value=false
```