Przejdź do treści

Oddziały (Plants)

Spis treści

  1. API - Endpointy
  2. Lista oddziałów
  3. Formularz nowego oddziału
  4. Walidacje formularza
  5. Formularz edycji oddziału
  6. Usuwanie oddziału
  7. 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

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

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


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.

Ostatnia zmiana: 2026-01-02 · Dariusz Bąkowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e