# Zmiana terminu awizacji w przypadku opóźnienia

## Opis funkcjonalności

W przypadku opóźnienia statusu w transporcie o wskazaną wartość:

![Ustawienia\_statusu](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/checkpoint-settings.png>)

> Uwaga !
>
> Status musi mieć zaznaczony checkbox
>
> ![Ustawienia\_statusu\_checkbox](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/checkpoint-settings-box.png>)

Awizacja zostanie przeniesiona na pierwszą wolną godzinę w danej strefie magazynowej. Jeśli platforma nie znajdzie żadnego wolnego miejsca tego samego dnia, zacznie wyszukiwać w dniu kolejnym, aż do skutku:

![Jak\_powinny\_przesuwać\_się\_okna](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/move-window-example.png>)

## Setting

Dodaliśmy nowy setting, w którym jest zapisana ilość czasu opóźnienia, po upływie którego platforma powinna przenieść okno na najbliższe możliwe okno.  
`DELAY_TIME_TO_MOVE_TIME_WINDOW_TO_NEXT_FREE_SPOT`

## Nowa flaga w etapie transportu

Dodaliśmy dwie nowe flagę w etapie (task):

![Nowa flaga w tasku](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/task-flag.png>)

oraz w magazynie (warehouse):

![Nowa\_flaga\_w\_magazynie](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/warehouse-flag.png>)

## Konfiguracja

Aby włączyć tę funkcjonalność, muszą być włączone obie wyżej wymienione flagi oraz setting dla danego pryncypała.

## Konfiguracja RabbitMQ

Aby uniknąć problemów z konkurencyjnośćią, funkcjonalnośc przenoszenia okien kolejkuje zapytania w `MoveTransportWindowIfCheckpointDelayedJob.queue` w RabitMQ:

![Nowa\_kolejka](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/rabbit-queue.png>)

Z technicznego punktu widzenia działa to tak, że gdy platforma znajdzie opóźniony status spełniający warunki do przesunięcia, to zaplanuje job na date powstałą z sumowania planowanej daty zatwierdzenia statusu oraz interwału czasu określonego w ustawieniu `DELAY_TIME_TO_MOVE_TIME_WINDOW_TO_NEXT_FREE_SPOT`. O wyznaczonej godzinie, odpali się job, który wyśle do wyżej opisanej kolejki wiadomość:

```
{
  "transportId": <id_transportu>,
  "checkpointId": <id_checkpointu>
}
```

Gdy tylko jakakolwiek wiadomość pojawi się w tej kolejce, apollo pobierze ją, i rozpocznie proces przesuwania dla opisanego w wiadomości transportu i statusu.

Konfiguracja kolejki powinna znajdujdować się w pliku `application.external.yml` w apollo. Dzięki temu aplikacja przy starcie sama sprawdzi, czy odpowiednia kolejka istnieje, a w przeciwnym wypadku automatycznie utworzy ją w RabbitMQ. Przykładowa konfiguracja:

```
rabbitmq:
  (...)
  exchanges:
    - name: jobs
      type: topic
      durable: true
  queues:
    - name: MoveTransportWindowIfCheckpointDelayedJob.queue
      durable: true
      exchange: jobs
      binding: 'jobs.MoveTransportWindowIfCheckpointDelayedJob'
```

## Symbol automatycznego przeniesienia okna

W ramach zadania dodaliśmy nowe pole `was_moved_automatically` w oknie czasowe. Odpowiada m.in. za to aby wyświetlić odpowiedni symbol przy transporcie oraz oknie czasowym w harmonogramie.

### Symbol w oknie czasowym

![Symbol w oknie czasowym](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/time-window-icon.png>)

(komunikat wyświetla się po najechaniu kursorem na symbol)

### Symbol w tabeli transportu

Symbol wyświetla się w kolumnie "rozładunek".

![Symbol w tabeli transportu](<https://docs.logintegra.com/apollo-backend/static/Transports/special-features/automatically-move-advice-on-delay/transport-icon.png>)
