Samochody firmowe

Krok po kroku

1. 1

   Lista pojazdów floty

   Klik kafelka Samochody firmowe → /samochody-firmowe/lista z filtrowaniem i wyszukiwaniem.

2. 2

   Terminarz jazd

   Klik Terminarz jazd → /samochody-firmowe/kalendarz — kalendarz rezerwacji floty z kotwicami czasu (handedOverAt/returnedAt po wydaniu/powrocie).

3. 3

   Uszkodzenia pojazdów

   Klik Uszkodzenia pojazdów → /samochody-firmowe/uszkodzenia — globalna lista zgłoszonych uszkodzeń z workflow REPORTED → REPAIR_REQUESTED → REPAIRED.

4. 4

   Ewidencja przebiegów

   Klik Ewidencja przebiegów → /samochody-firmowe/raporty — lista wpisów cross-vehicle (zakończone rezerwacje). W bottom barze drugi tab Raporty miesięczne prowadzi na osobną podstronę z raportami per pojazd × miesiąc dla urzędu.

Krok po kroku

1. 1

   Otwórz kartę pojazdu

   Z listy floty (/samochody-firmowe/lista) lub kalendarza.

2. 2

   Ustaw aktualny stan

   W sekcji Czystość klik picker → wybierz nowy stan (CLEAN / SLIGHTLY_DIRTY / DIRTY / VERY_DIRTY). Zapis natychmiastowy, idzie do historii.

3. 3

   Auto-zapis przy powrocie

   Formularz powrotu pojazdu ma osobne pole Stan czystości — wpis trafia do tej samej historii (źródło: RETURN).

4. 4

   Przejrzyj historię

   Sekcja Historia czystości — chronologicznie kto i kiedy zmienił stan (manual vs auto z powrotu).

Krok po kroku

1. 1

   Zgłoś uszkodzenie

   Karta pojazdu → Dodaj uszkodzenie lub /samochody-firmowe/[id]/uszkodzenie/nowe — wpisz opis, lokalizację, opcjonalne zdjęcie. Wymaga flt_damage_ADD. Status startowy: REPORTED.

2. 2

   Zgłoś naprawę

   Gdy uszkodzenie zostanie naprawione, osoba z flt_damage_REPAIR_REQUEST klika Zgłoś naprawione — status REPORTED → REPAIR_REQUESTED. Push do osoby decyzyjnej.

3. 3

   Potwierdź lub odrzuć naprawę

   Osoba z flt_damage_REPAIR_CONFIRM widzi przycisk Potwierdź naprawę (→ REPAIRED) lub Odrzuć z powodem (→ z powrotem do REPORTED + zapis repairRejectionReason).

4. 4

   Read-only po REPAIRED

   Naprawione uszkodzenia są zamknięte — bez dalszych akcji, widoczne w historii pojazdu.

Krok po kroku

1. 1

   Wybierz wiersz

   Sekcja Trwa → pojazdy wydane. Sekcja Oczekuje → planowane na 14 dni naprzód.

2. 2

   Wydaj pojazd / Przyjmij powrót

   Główny przycisk wiersza prowadzi do istniejącego protokołu (/samochody-firmowe/[carId]/(wydanie|powrot)/[taskId]). Pełny flow — formularz, podpisy, opcjonalne wyjście służbowe.

3. 3

   Drukuj umowę (opcjonalnie)

   Drugi przycisk Drukuj umowę (gdy umowa już wystawiona) — otwiera PDF w nowej karcie z auditem.

4. 4

   Klik w treść wiersza

   Otwiera stronę-agregator rezerwacji z pełną historią akcji (zatwierdzenia, korekty, anulacje, SMS, skan).

Krok po kroku

1. 1

   Wybierz pojazd

   Combobox wyszukuje po VIN i numerze rejestracyjnym (min. 2 znaki). Jeśli pojazdu nie ma w kartotece — najpierw dodaj go w /kartoteki/pojazdy.

2. 2

   Data i przebieg przyjęcia

   Przebieg startowy = stan licznika przy przyjęciu do floty (zostaje zapisany jako pierwszy odczyt w globalnej tabeli przebiegów).

3. 3

   Dozwolone typy użytkowania

   Zaznacz tylko te typy, dla których pojazd jest fizycznie odpowiedni (np. nowy demo dla TEST_DRIVE, stary zastępczy dla RENTAL).

4. 4

   Opcjonalnie: pierwszy kontrakt

   Bez kontraktu pojazd trafia do sekcji Nieprzypisane i po 24h generuje RE — najlepiej od razu utworzyć kontrakt.

Krok po kroku

1. 1

   Dodaj kontrakt

   Na karcie pojazdu kliknij Dodaj kontrakt. Wybierz rodzaj, datę startu i przebieg startowy (sugerowany = stan z ostatniego kontraktu).

2. 2

   Edytuj kontrakt aktywny / w wypowiedzeniu

   Na karcie aktywnego kontraktu kliknij Edytuj (gate flt_contracts_EDIT). Zmień notatkę lub odepnij powiązane zgłoszenie i zapisz. Kontrakty ENDED są zablokowane.

3. 3

   Zakończ natychmiast (data ≤ dziś)

   Na karcie pojazdu w sekcji Aktywny kontrakt kliknij Zakończ kontrakt. Pozostaw datę dzisiejszą (lub wstaw datę przeszłą), wpisz Przebieg końcowy (≥ startowego) i opcjonalnie powód — kontrakt przechodzi do ENDED i emituje odczyt licznika.

4. 4

   Wypowiedzenie (data w przyszłości)

   Zmień datę zakończenia na przyszłą — pojawi się żółty banner Tryb wypowiedzenia i pole przebiegu znika. Po zapisaniu kontrakt ma status NOTICE i pozostaje dostępny do wybranego dnia. Cron 02:00 codziennie sprawdza i finalizuje wypowiedzenia, których termin upłynął.

5. 5

   Zmiana / cofnięcie wypowiedzenia

   Dopóki kontrakt jest w NOTICE, w nagłówku karty widnieje Zmień datę zakończenia — można skrócić wypowiedzenie (np. do dnia dzisiejszego = natychmiastowe zamknięcie z wpisaniem przebiegu) lub wydłużyć je na późniejszą datę.

Krok po kroku

1. 1

   Wybierz typ użytkowania

   Tylko z listy dozwolonych dla pojazdu (checkboxy w detalu). Po wyborze formularz pokazuje pola wymagane dla tego typu i pre-dobiera tryb (jazda testowa = pojedynczy, najem/użyczenie = wielodniowy).

2. 2

   Wybierz tryb rezerwacji

   Pojedynczy zakres godzinowy — jeden datetime start + koniec. Wielodniowa — datetime wydania i powrotu osobno, długości bloków doradcy (15–480 min, domyślnie 30) i opcjonalnie osobny doradca powrotu.

3. 3

   Wypełnij wymagane pola

   TEST_DRIVE/LOAN/RENTAL: klient (combobox), doradca (TEST_DRIVE), pojawia się info o wymaganych dokumentach (DL, dowód). EMPLOYEE/PRIVATE/BUSINESS: pracownik biorący.

4. 4

   Sprawdź konflikty

   Jeśli system wykryje konflikt na pojeździe (overlap z inną rezerwacją) — czerwony banner. Konflikt z pojazdem jest twardy (bez override musisz zmienić termin); konflikt z doradcą w trybie wielodniowym sprawdzany jest tylko w oknach wydania/powrotu.

Krok po kroku

1. 1

   Otwórz kolejkę

   Sider → Zatwierdzenia rezerwacji.

2. 2

   Sprawdź szczegóły

   Klik nazwy pojazdu prowadzi do detalu. Zobacz klienta, doradcę, czas, typ.

3. 3

   Zatwierdź lub odrzuć

   Zatwierdzenie automatycznie zmienia approvalStatus → APPROVED. Odrzucenie wymaga powodu (zapisywany w Task.outcomeNote).

Krok po kroku

1. 1

   Sprawdź dokumenty klienta

   Strona pokazuje warningi gdy brakuje DL/dowodu lub gdy DL wygasa przed końcem rezerwacji.

2. 2

   Uzupełnij dane do umowy

   PESEL (gwiazdka — wymagany) i adres (ulica, nr domu, kod pocztowy, miejscowość — wszystkie wymagane). Pola prefillowane z kartoteki klienta, zmiany zapisują się w kartotece przy submit. Dla TEST_DRIVE pola zagwiazdkowane (edycja w kartotece).

3. 3

   Wpisz protokół

   Przebieg start (pre-fill z ostatniego odczytu, walidacja że >= ostatni), stan paliwa w %, opcjonalna trasa, stan pojazdu i uwagi.

4. 4

   Wybierz tryb podpisu umowy

   SMS+e-mail (signed link — PR-7 cd.), papier (drukowane, skan później), w aplikacji (PRIVATE/BUSINESS bez PDF).

5. 5

   Zatwierdź wydanie

   Klik Wydaj pojazd → atomowo: tworzy FltAgreement + FltHandover + opt. BusinessExit + wpis przebiegu + zmiana statusu zadania na IN_PROGRESS.

Krok po kroku

1. 1

   Wpisz przebieg końcowy

   Walidacja >= przebiegu startowego. System automatycznie liczy ile km przejechane (różnica).

2. 2

   Pozostały zasięg w baku

   Ile km zasięgu zostało wg komputera pojazdu (zapisywane w protokole).

3. 3

   Uszkodzenia i uwagi

   Czy pojawiły się nowe rysy/odpryski/wgniecenia? Stan czystości? Brakujące wyposażenie?

4. 4

   Zatwierdź powrót

   Atomowo: tworzy FltReturn + zamyka BusinessExit (jeśli był) + wpis przebiegu + status zadania DONE.

Krok po kroku

1. 1

   Otwórz rezerwację z kalendarza

   Klik kolorowy pasek rezerwacji → strona agregatora. Pasek pokazuje faktyczny okres używania (po wydaniu start z handedOverAt, po powrocie koniec z returnedAt) — nie planowany.

2. 2

   Sprawdź panel *Akcje*

   Prawa kolumna — przyciski są zsynchronizowane ze statusem i uprawnieniami (PENDING approval, IN_PROGRESS, DONE itd.).

3. 3

   Karta *Umowa*

   Drukuj PDF, wyślij SMS klientowi (SMS_EMAIL/IN_APP), wgraj scan podpisanej papierowej umowy (PAPER_SCAN → status automatycznie SIGNED).

Krok po kroku

1. 1

   Otwórz rezerwację

   Z kalendarza floty lub listy na karcie pojazdu.

2. 2

   Klik *Koryguj umowę*

   Przycisk widoczny w panelu Akcje po wydaniu (IN_PROGRESS) i po zakończeniu (DONE). Otwiera formularz wydania w trybie korekty — sekcje Kierowca/klient i Dokumenty są zablokowane (już ustawione przy wydaniu).

3. 3

   Popraw wybrane pola

   Godzina wydania (datetime-local), przebieg startowy, zasięg paliwa, trasa (dla TEST_DRIVE ze słownika), notatki o stanie, tryb podpisu (SMS / papier / w aplikacji).

4. 4

   Wpisz *Powód korekty*

   Wymagany (min. 3 znaki). Trafia do historii korekt — widoczny zarówno na stronie rezerwacji jak i w audycie.

5. 5

   Zapisz korektę

   System aktualizuje FltHandover, FltAgreement (zmieniony tryb podpisu = reset signatureStatus), Task.startedAt, odczyt przebiegu. Po sukcesie wracasz do strony rezerwacji.

6. 6

   Koryguj godzinę powrotu (opcjonalnie, po DONE)

   Osobny przycisk Koryguj godzinę powrotu — krótki modal: nowa godzina + powód. Synchronizuje FltReturn.returnedAt, Task.completedAt, odczyt przebiegu i BusinessExit.

Krok po kroku

1. 1

   Otwórz *Raporty miesięczne*

   Z bottom baru Ewidencja przebiegów przejdź na drugi tab → osobna podstrona /samochody-firmowe/raporty/miesieczne.

2. 2

   Wygeneruj DRAFT

   Klik Generuj raport (prawy górny róg) → wybierz pojazd i miesiąc. System pre-fillowuje wiersze. Idempotentnie — nie tworzy duplikatów.

3. 3

   Edytuj wiersze

   Każda komórka inline-editable (data, godzina, cel, trasa, kierowca, przebieg). Możesz dodawać i usuwać wiersze. Kilometry liczone automatycznie.

4. 4

   Zapisz zmiany

   Przycisk Zapisz (gate flt_mileage_report_EDIT). Po zapisaniu można zatwierdzić.

5. 5

   Zatwierdź raport

   Przycisk Zatwierdź (zielony, gate flt_mileage_report_APPROVE). Status DRAFT → APPROVED, kto+kiedy zapisywane. Po zatwierdzeniu wiersze read-only.

6. 6

   Korekta po zatwierdzeniu

   Jeśli urząd zgłosił uwagi — przycisk Korekta tworzy nowy raport z parentReportId (chain). Wymaga ponownego APPROVE.