# Priorytety ofert w cennikach

- \[[A-15240](<https://youtrack.logintegra.com/issue/A-15240>)\]

## Ustawienia funkcjonalności

### Konfiguracja priorytetyzacji w cennikach

Aby włączyć funkcjonalność priorytetów przewoźników, należy w ustawieniach cennika danego typu transportu włączyć flagę `carrier_priority_enabled`:

- **Polski:** Ustalanie priorytetu dla przewoźników na trasie
- **Angielski:** Setting priority for carriers on the route
- **Niemiecki:** Festlegen der Priorität für Frachtführer auf der Route
- **Włoski:** Impostazione della priorità per i vettori sul percorso
- **Hiszpański:** Configuración de la prioridad para los transportistas en la ruta
- **Czeski:** Nastavení priority pro dopravce na trase
- **Turecki:** Rota üzerindeki taşıyıcılar için öncelik ayarlama

### Uprawnienia

Aby móc zarządzać priorytetami przewoźników na trasach, rola użytkownika musi posiadać uprawnienie `ROLE_MANAGE_ROUTE_PARTNERSHIPS_PRIORITIES`:

**Etykiety uprawnienia:** - **Polski:** Ustawianie priorytetu przewoźnika na trasie - **Angielski:** Setting carrier priority on the route - **Niemiecki:** Festlegen der Frachtführerpriorität auf der Route - **Włoski:** Impostazione della priorità del vettore sul percorso - **Hiszpański:** Establecimiento de la prioridad del transportista en la ruta - **Czeski:** Nastavení priority dopravce na trase - **Turecki:** Rota üzerindeki taşıyıcının önceliğini ayarlama

Uprawnienie pozwala na: - Dodawanie nowych priorytetów dla przewoźników - Edycję istniejących priorytetów - Usuwanie priorytetów

## Funkcjonalność

### Interfejs zarządzania priorytetami

Po włączeniu flagi `carrierPriorityEnabled` w ustawieniach cennika, w formularzu edycji trasy pojawia się sekcja **"Priorytety przewoźników"**.

![priorities-section.png](<https://docs.logintegra.com/apollo-backend/static/Transports/price-table/carrier-priorities/priorities-section.png>) ![priorities-section.png](<https://docs.logintegra.com/apollo-backend/static/Transports/price-table/carrier-priorities/priorities-section-with-rows.png>)

Sekcja zawiera: - **Tabelę priorytetów** z kolumnami: - ID - identyfikator priorytetu - Przewoźnik - nazwa firmy przewoźnika - Priorytet - wartość priorytetu (1-4) - **Przyciski akcji** dla każdego wiersza: - **Edytuj** - modyfikacja priorytetu - **Usuń** - usunięcie priorytetu - **Przycisk "Dodaj"** - dodanie nowego priorytetu

### Dodawanie nowego priorytetu

Kliknięcie przycisku **"Dodaj"** otwiera modal dodawania priorytetu:

![add-priority-modal.png](<https://docs.logintegra.com/apollo-backend/static/Transports/price-table/carrier-priorities/add-priority-modal.png>)

Modal zawiera: - **Pole przewoźnika** - autocomplete z wyszukiwaniem firm typu "CARRIER" - **Pole priorytetu** - select z wartościami 1, 2, 3, 4 - **Przyciski akcji:** "Dodaj" i "Anuluj"

### Edycja priorytetu

Kliknięcie przycisku **"Edytuj"** otwiera modal edycji:

![edit-priority-modal.png](<https://docs.logintegra.com/apollo-backend/static/Transports/price-table/carrier-priorities/edit-priority-modal.png>)

Modal zawiera: - **Pole przewoźnika** - zablokowane (tylko do odczytu) - **Pole priorytetu** - select z wartościami 1, 2, 3, 4 - **Przyciski akcji:** "Zapisz" i "Anuluj"

## Walidacja

Zastosowane są następujące reguły walidacji:

1. **Unikalność przewoźnika na trasie** - jeden przewoźnik może mieć maksymalnie jeden priorytet w ramach jednej trasy
2. **Zakres priorytetów** - dozwolone wartości: 1, 2, 3, 4
3. **Wymagane pola** - wszystkie pola są obowiązkowe

## Algorytm sortowania ofert

Po wprowadzeniu priorytetów kolejność rozpatrywania ofert według następującego algorytmu:

### Kolejność ustalania najlepszej oferty:

1. Grupowanie według priorytetów - kilku przewoźników może mieć ten sam priorytet
2. Jeśli firma dodała ofertę ale nie ma ustalonego priorytetu, trafia do ostatniej grupy
3. Sortowanie ofert w grupach po stawkach LTL lub cenie - od najniższej

### Warunki uwzględniania ofert:

- Oferty muszą być **potwierdzone**
- Oferty muszą być **w terminie obowiązywania**
- Oferty spoza terminu lub niepotwierdzone są **pomijane**
