# Grupowanie przewoźników

## Występowanie

Wszyscy przewoźnicy zarejestrowani poprzez formularz zgłoszeń mają możliwość przynależności do grup, na podstawie których będą przydzielane im aukcje do transportów.

Grupy wyświetlane są w szczegółach firmy przewoźnika w zakładce "Grupowanie" i dzielą się na następujące typy: ![groups.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/groups.png>)

## Typy grup

Typy grup dzielą się na:

```
SUPPORTED_VOIVODESHIPS
TERRITORIAL_DIVISION
ADR
AVAILABLE_VEHICLES
SUPPORTED_REGIONS
TYPES_OF_BUSINESS
TYPES_OF_TRANSPORT
PRIVATE
```

Dodawanie typów grup aktualnie odbywa się przez bazę i zmiany w kodzie, nie mamy aktualnie możliwości dodania tłumaczeń do nazw typów bez wprowadzania zmian w kodzie

!*UWAGA*! Podczas dodawania nowego typu należy pamiętać, aby dodać wpis do tabeli `principalContractorsGroupType`, ponieważ bez tego wpisu typ grupy nie będzie widoczny w apliakcji.

Typami grup możemy zarządzać w ustawieniach, dostęp do tych ustawień ma użytkownik, który ma nadane uprawnienie `ROLE_MANAGE_APPLIES_SETTINGS`

![group-types-settings.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/group-types-settings.png>)

W tych ustawieniach możemy zarządzać widocznością grupy w zgłoszeniach (1), wymagalnością zaznaczenia przynajmniej jednej grupy w typie(2), wymagalnością zaznaczenia tylko jednej grupy w typie (3) czy też przypisaniem grupy dla odpowieniego typu partnerstwa (4)

![settings.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/settings.png>)

## Grupy

Użytkownik z uprawnieniem `ROLE_ADD_CONTRACTOR_GROUP`, ma możliwość dodania nowej grupy w typie, aby tego dokonać, należy przejść do szczegółów przewoźnika, a następnie do zakładki grupowanie oraz kliknąć `+ Dodaj grupę`

![carriers-grouping.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/add-group.png>)

Pojawi się formularz dodawania grupy, po wypełnieniu należy kliknąć "Zapisz":

![add-group-form.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/add-group-form.png>)

Po zapisaniu grupa będzie widoczną w zakładce. W celu edycji grupy, użytkownik musi mieć nadane uprawnienie `ROLE_EDIT_CONTRACTOR_GROUP`, oraz kliknąć ikonę ołówka widoczną przy nazwie grupy

![edit-group.png](<https://docs.logintegra.com/apollo-backend/3. Users %26 Companies/companies/edit-group.png>)

Pojawi się ponownie formularz z danymi grupy, teraz wystrczy edytować pole, które należy zmienić i zapisać.

### Wybieranie przewoźników według grup w formularzu zapytania ofertowego

![img.png](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/carriers-grouping/group-selection.png>)

1. Zaznaczanie grupy - Po zaznaczeniu jednej z grup automatycznie powinny zaznaczyć się firmy z włączoną grupą.
2. Zaznaczenie wielu grup - Po zaznaczeniu wielu grup zaznaczamy firmy, które należą przynajmniej do jednej z zaznaczonych grup (suma zbiorów).
3. Odznaczenie grupy - Po odznaczeniu jednej grupy odznaczamy firmy, które należały, ale już nie należą do żadnej z grup. Zatem po odznaczeniu grupy zaznaczone powinny zostać tylko te firmy, które przynależą nadal do przynajmniej jednej z grup.
4. Zaznaczenie checkbox przy "Wybierz grupę firm transportowych" - Po zaznaczeniu zaznaczamy wszystkie dostępne grupy. Po odznaczeniu wyłączamy wszystkie grupy.
5. Zaznaczenie checkbox "Wybierz uczestników akcji" - Po zaznaczeniu zaznaczamy wszystkie dostępne firmy. Po odznaczeniu odznaczamy wszystkie firmy.
6. Jeżeli ktoś wybierze uczestników i później wybierze grupę to zostaną zaznaczone tylko te firmy, które mają włączoną grupę!
