Oddziały (Plants)¶
Spis treści¶
- API - Endpointy
- Lista oddziałów
- Formularz nowego oddziału
- Walidacje formularza
- Formularz edycji oddziału
- Usuwanie oddziału
- 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¶
Lista oddziałów dla firmy¶
Pobierz oddział po 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ł¶
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.
¶
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ę
¶
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.

Usuwanie oddziału¶
Usuwanie odbywa się poprzez:
- Kliknięcie przycisku Usuń w liście oddziałów
- System wysyła żądanie
DELETEdo API - Po potwierdzeniu oddział jest usuwany z bazy danych
- 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.
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.
Ostatnia zmiana: 2026-01-02 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e