# Historia zlecenia

## Potrzebne uprawnienia

Jeśli użytkownik posiada uprawnienie `ROLE_SHOW_TRANSPORT_LOGS` ("Dostęp do historii zlecenia"), to w formularzu zlecenia widzi rozwijaną sekcję "Historia zmian":

![](<https://docs.logintegra.com/apollo-backend/static/Transports/form/history-section/%23index/history-section.png>)

## Obsługiwane pola

W historii zmian widoczne są zmiany z następujących tabel w bazie danych:

- `auction` - aukcje,
- `offer` - oferty do aukcji,
- `index` - indeksy,
- `advice` - awizacja,
- `file` - pliki (dokumenty dodawane do zlecenia),
- `note` - notatki,
- `step` - etapy transportu,
- `transaction` - transakcje,
- `transport` - transport,
- `time_window` - okna czasowe,
- `checkpoint` - statusy,
- `custom_field_value` - pola niestandardowe.

Śledzone są następujące operacje (przy czym: `INSERT` dotyczy tworzenia nowego wpisu w bazie, `UPDATE` edycji istniejącego, `DELETE` trwałemu usunięciu rekordu z bazy):

- `auction` - `INSERT`, `UPDATE`,
- `offer` - `INSERT`, `UPDATE`,
- `index` - `INSERT`, `UPDATE`,
- `advice` - `INSERT`, `UPDATE`, `DELETE`,
- `file` - `INSERT`, `UPDATE`, `DELETE`,
- `note` - `INSERT`, `UPDATE`,
- `step` - `UPDATE`, `DELETE`,
- `transaction` - `INSERT`, `UPDATE`,
- `transport` - `INSERT`, `UPDATE`, `DELETE`,
- `time_window` - `INSERT`, `UPDATE`,
- `checkpoint` - zatwierdzenie, cofnięcie, odrzucenie,
- `custom_field_value` - `INSERT`, `UPDATE`, `DELETE`.

Wyłączone z logowania są następujące kolumny w bazie danych:

- `transport` - referencja do transportu w powiązanych obiektach
- `version` - wersja obiektu,
- `companyGroup` - grupa uzytkowników przypisana do stepu,
- `patron` - opiekun przypisany do stepu,
- `assortmentGroup` - grupa asortymentowa,
- `warehouseZone` - strefa magazynowa,
- `createdBySms` - flaga oznaczająca transport utworzony poprzez SMS.

## Ograniczenia widoczności

Nie wszyscy mogą widzieć wszystkie zdarzenia w historii transportu. Przykładowo - przewoźnicy nie powinni widzieć stawek w aukcji dodawanych przez innych przewoźników.

Ograniczenia w widoczności wpisu w historii transportu definiuje tabela `role_group_property_exclusion`. Zawiera ona następujące kolumny:

- `id`,
- `version`,
- `role_group_id` - wskazanie grupy ról, której dotyczy,
- `class_name` - nazwy klasy,
- `property_name` - nazwę właściwości.

Jeśli dodamy tam następujący wpis:

```
    id    | version | class_name  | property_name | role_group_id 
----------+---------+-------------+---------------+---------------
 80174002 |       0 | Transaction | price         |      81657449
```

Będzie to oznaczać, że użytkownicy z rolą o id `81657449` nie będą widzieli w historii transportu zmian dotyczących pola `price` w tabeli `transaction` (czyli ceny, po której przekazano zlecenie do przewoźnika).

Jeśli dodamy wpis, w którym nie uzupełnimy pola `property_name`:

```
    id    | version | class_name  | property_name | role_group_id 
----------+---------+-------------+---------------+---------------
 80174002 |       0 | Transaction |               |      81657449
```

Będzie to oznaczać, że użytkownicy z rolą o id `81657449` nie będą widzieli **żadnych** zmian w polach tabeli `Transaction`.
