# Limit użytkowników w firmie

Aplikacja pozwala na ograniczenie liczby użytkowników przypisanych do firmy. Limit użytkowników w firmie jest globalny, niezależny od partnerstw z pryncypałem - to oznacza, że jeśli firma może mieć maksymalnie trzech użytkowników, to mogą istnieć w bazie jedynie trzy wpisy w tabeli `person`, które mają w kolumnie `company_id` referencję do rzeczonej firmy oraz flagę `enabled` ustawioną na `true`, niezależnie od tego, ile ról i u ilu pryncypałów mają te osoby.

## Edycja limitu użytkowników w firmie

Pole z ilością kont dozwolonych dla firmy można znaleźć:

- w karcie kontrahenta (zakładka "Firmy", szczegóły wybranej firmy):  
  ![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/users-limit/contractor-card.png>)
- w sekcji "Dane główne" - w przypadku korzystania z weryfikacji zgłoszeń przewoźników ([więcej o zgłoszeniach](<https://docs.logintegra.com/apollo-backend/3. Users %26 Companies/applies/%23index/index.md>)):  
  ![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/users-limit/applies.png>)

### Możliwe wartości limitu użytkowników w firmie

Jeśli pole z limitem użytkowników w firmie jest puste, żaden limit nie obowiązuje - firma może mieć nieograniczoną liczbę kont.

Jeśli w polu jest wpisana liczba, określa ona liczbę kont, które mogą być przypisane do danej firmy.

**UWAGA!** Podczas edycji pola "Maksymalna liczba kont" nie sprawdzamy, ilu aktualnie aktywnych użytkowników ma dana firma. Można więc doprowadzić do takiej sytuacji:

- firma ma limit - maksymalnie 3 konta,
- firma ma trzech aktywnych użytkowników,
- edytujemy limit w szczegółach firmy - ustawiamy tam 2

W tej sytuacji firma będzie mogła mieć maksymalnie 2 konta, a jednak będzie miała 3 - nie jest to błąd, takie są założenia.

### Uprawnienia do widoczności i edycji pola "Maksymalna liczba kont"

Pole jest widoczne dla wszystkich użytkowników z dostępem do szczegółów firmy/szczegółów zgłoszenia.

Za możliwość edycji pola odpowiada uprawnienie `Authority.ROLE_MANAGE_MAX_COMPANY_ACCOUNT_NUMBER`.

## Blokowanie tworzenia większej ilości kont niż wskazuje limit

### Blokada podczas ręcznego dodawania użytkownika

(Aktualnie nie widzę możliwości ręcznego dodania użytkownika do firmy kontrahenta - ustawiłam więc limit użytkowników pryncypałowi na potrzeby screenów)

Jeśli firma posiada limit kont, a ktoś spróbuje dodać nowego użytkownika ponad ten limit (Użytkownicy -\> Dodaj użytkownika (wymagane uprawnienie `ROLE_CREATE_USER`)) przy próbie zapisuj wyświetli się komunikat walidacyjny:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/users-limit/manual-creation.png>)

### Blokada podczas wysyłania zaproszenia

Jeśli zapraszamy użytkownika do istniejącej firmy, a firma wykorzystała juz maksymalną możliwą liczbę kont, przy próbie wysłania zaproszenia pojawi się komunikat walidacyjny:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/users-limit/sending-invitation.png>)

> UWAGA! Jeśli użytkownik posiada uprawnienie do zapraszania ponad limit firmy (`ROLE_INVITE_AS_TEMPORARY_USER_WHEN_ACCOUNT_LIMIT_EXCEEDED` - "Zapraszanie użytkowników tymczasowych ponad limit firmy"), wówczas nawet jeśli firma wykorzystała już swój limit użytkowników, to użytkownik z takim uprawnieniem będzie mógł zaprosić kogoś do tej firmy. Spowoduje to utworzenie *konta tymczasowego*. Więcej o kontach tymczasowych można poczytać [TUTAJ](<https://docs.logintegra.com/apollo-backend/3. Users %26 Companies/users/temporary-account/index.md>).

### Blokada podczas akceptowania zaproszenia

Może się też zdarzyć taka sytuacja:

- firma ma limit kont równy 2,
- firma posiada jednego aktywnego użytkownika.

W tej sytuacji nie będziemy blokowali wysyłania zaproszeń - nie wiemy, czy zostaną zaakceptowane i czy będą skutkować założeniem nowego konta. Jeśli jednak w tej sytuacji wyślemy do tej firmy dwa zaproszenia:

- pierwsze, które zostanie zaakceptowane, powinno skutkować założeniem konta,
- akceptacja drugiego zaproszenia powinna już się nie udać - założenie kolejnego konta skutkować będzie przekroczeniem limitu dla firmy. Zatem podczas akceptacji takiego zaproszenia użytkownik powinien zobaczyć komunikat walidacyjny:

![](<https://docs.logintegra.com/apollo-backend/static/Users &amp; Companies/companies/users-limit/accepting-invitation.png>)
