# Oddziały (Plants)

## Spis treści

1. [API - Endpointy](<#api-endpointy>)
2. [Lista oddziałów](<#lista-oddziałów>)
3. [Formularz nowego oddziału](<#formularz-nowego-oddziału>)
4. [Walidacje formularza](<#walidacje-formularza>)
5. [Formularz edycji oddziału](<#formularz-edycji-oddziału>)
6. [Usuwanie oddziału](<#usuwanie-oddziału>)
7. [Zabezpieczenia dostępu](<#zabezpieczenia-dostępu>)

---

## API - Endpointy

Bazowy URL: `http://localhost:8080/apollo/api`

- Nagłówka `Authorization: Bearer {token}`
- Nagłówka `Accept: application/json`

### Lista wszystkich oddziałów

```
GET /plants
```

### Lista oddziałów dla firmy

```
GET /plants?company={company_id}
```

### Pobierz oddział po ID

```
GET /plants/{id}
```

### Utwórz nowy oddział

```
POST /plants
Content-Type: application/json

{
  "company": 380485143,
  "address": 380485164,
  "alias": "PLANT-002",
  "name": "Plant Beta",
  "serialNumber": "SN-12345"
}
```

### Aktualizuj oddział

```
PUT /plants/{id}
Content-Type: application/json

{
  "company": 380485143,
  "address": 380485164,
  "alias": "PLANT-001-UPDATED",
  "name": "Plant Alpha - Updated",
  "serialNumber": "SN-12345"
}
```

### Usuń oddział

```
DELETE /plants/{id}
```

---

## Lista oddziałów

Widok listy wyświetla tabelę z kolumnami: - **Id** - Identyfikator oddziału - **Numer seryjny oddziału** - Numer seryjny - **Nazwa oddziału** - Nazwa - **Alias oddziału** - Alias - **Firma oddziału** - ID firmy - **Adres oddziału** - ID adresu

Każdy wiersz zawiera przyciski akcji: - **Edytuj** (niebieski) - przejście do formularza edycji - **Usuń** (czerwony) - usunięcie oddziału

Przycisk **\+ Utwórz nowy oddział** w prawym górnym rogu otwiera formularz tworzenia.

## ![plants-list.png](<https://docs.logintegra.com/apollo-backend/22. Plants/plants-list.png>)

## Formularz nowego oddziału

Formularz zawiera pola:

- **Alias**\* - Pole tekstowe (wymagane)
- **Nazwa**\* - Pole tekstowe (wymagane)
- **Numer seryjny**\* - Pole tekstowe (wymagane)
- **Adres(ID)**\* - Pole numeryczne (wymagane)
- **Firma**\* - Pole tekstowe (wymagane)

Przyciski: - **Zapisz** - zapisuje nowy oddział - **Anuluj** - anuluje operację

## ![create-plant-form.png](<https://docs.logintegra.com/apollo-backend/22. Plants/create-plant-form.png>)

## Walidacje formularza

Wszystkie pola oznaczone gwiazdką (\*) są **wymagane**:

- **Alias** - nie może być pusty
- **Nazwa** - nie może być pusta
- **Numer seryjny** - nie może być pusty
- **Adres(ID)** - musi być prawidłowym ID adresu
- **Firma** - musi być prawidłowym ID firmy

Brak wypełnienia któregokolwiek z tych pól uniemożliwia zapisanie formularza.

---

## Formularz edycji oddziału

Formularz edycji ma identyczną strukturę jak formularz tworzenia, ale pola są wypełnione aktualnymi wartościami oddziału:

- **Alias**\* - aktualna wartość aliasu
- **Nazwa**\* - aktualna nazwa
- **Numer seryjny**\* - aktualny numer
- **Adres(ID)**\* - aktualny ID adresu
- **Firma**\* - aktualne ID firmy

Po zapisaniu zmiany są aktualizowane w systemie. ![edit-plant-form.png](<https://docs.logintegra.com/apollo-backend/22. Plants/edit-plant-form.png>)

---

## Usuwanie oddziału

Usuwanie odbywa się poprzez:

1. Kliknięcie przycisku **Usuń** w liście oddziałów
2. System wysyła żądanie `DELETE` do API
3. Po potwierdzeniu oddział jest usuwany z bazy danych
4. Lista oddziałów jest odświeżana

**Uwaga**: Operacja jest nieodwracalna (hard delete).

---

## Zabezpieczenia dostępu

### Zabezpieczenie na poziomie firmy

Użytkownik widzi tylko oddziały należące do jego firmy. API automatycznie filtruje wyniki na podstawie parametru `company` w zapytaniu.

```
GET /plants?company={user_company_id}
```

### Zabezpieczenie uprawnień

Wszystkie operacje wymagają:

- **Autentykacji** - ważny token w nagłówku `Authorization`
- **Uprawnień dostępu** - użytkownik musi mieć przypisane odpowiednie uprawnienia:

  - Odczyt listy oddziałów
  - Tworzenie nowych oddziałów
  - Edycja istniejących oddziałów
  - Usuwanie oddziałów

Brak uprawnień skutkuje odmową dostępu (HTTP 403) lub brakiem widoczności danej funkcji w interfejsie.
