Lifecycle · Article 2.1
Cykl życia propozycji od początku do końca
Każda propozycja przechodzi przez maksymalnie dziewięć przejść statusów, z dwoma aktorami (Tobą i klientem) przekazującymi sobie kontrolę po drodze. Oto kanoniczna mapa.
To najczęściej zapisywana w zakładkach strona w dokumentacji Clozo. Gdy nie jesteś pewien, gdzie znajduje się propozycja, dlaczego akcja nie jest dostępna lub jaki e-mail właśnie wyszedł, znajdź aktualny status na poniższym diagramie i kliknij, aby przejść do szczegółowego artykułu. Każda plakietka statusu jest głębokim linkiem.
Quick visual tour
Step 1: Każda propozycja zaczyna się tutaj. Osiem statusów przed nami, dwa zjazdy awaryjne.
Step 2: Status 1: Draft. Widzisz go tylko Ty. Edytuj swobodnie.
Step 3: Status w trakcie: klient podpisał, zaliczka zapłacona, jesteś w pracy.
Step 4: Faktura końcowa rozliczona. Pieniądze trafiają na Twoje konto.
Step 5: Osiągasz Completed — propozycja jest zamknięta i zarchiwizowana.
Step 6: Istnieją dwa zjazdy awaryjne: Declined (klient mówi nie) i Expired (90 dni ciszy).
Plakietka statusu na każdej propozycji w pulpicie, oś czasu na stronie szczegółów propozycji oraz baner u góry strony („Awaiting client signature", „Payment received" itp.), który podaje jednozdaniowe podsumowanie statusu w prostym języku.
Why this works this way
Cykl życia jest zaimplementowany jako automat skończony w backendzie (backend/apps/proposals/models.py:Proposal.STATUS_*). Pole status jest źródłem prawdy — każdy element UI, wyzwalacz e-maila, widoczność przycisku i handler webhooka odczytuje z niego. Ujawniamy przejścia w diagramie, abyś mógł przewidzieć, co nadejdzie, bez uczenia się implementacji.
Format dwuaktorowych torów (swimlane) wyraźnie pokazuje, które przejścia możesz uruchomić Ty, a które uruchamia klient. Większość dokumentacji narzędzi dla freelancerów zwija to w pojedynczy liniowy przepływ, co zaciemnia kluczowy fakt: od Sent przez Signed czekasz na klienta; nie masz przycisku, aby przesunąć stan. Niektóre statusy (np. Viewed) może uruchomić tylko klient.
Troubleshooting
Keep reading
Lifecycle
Status: Draft — the only status where you can edit everything
A draft is a proposal you've started but not yet sent. It's editable in every field; nothing has been emailed, no invoice exists, no audit trail beyond your edits.
Lifecycle
Status: Sent — the proposal is in your client's inbox
You've clicked `Send`. The PDF is rendered, the email is on its way, the proposal number is assigned, and the audit trail starts here. Now you wait — until the client opens it (`Viewed`) or signs (`Signed`).
Lifecycle
Status: Signed — legally binding, audit trail captured
The client clicked Sign. Clozo collects an eIDAS-compliant evidence stack, generates the signed Service Agreement PDF, fires confirmation emails to both parties, and queues the deposit invoice. The proposal is now a contract.
Lifecycle
Status: Awaiting final payment, then Paid
You've issued the final invoice. The client now owes the remaining balance (full amount minus the deposit they already paid). When the money lands, status flips to `Paid` and the final receipt is generated.
Lifecycle
Timeline events: every event type explained
The Timeline component on every proposal detail page records 21+ event types. This is the canonical list with descriptions and triggers, useful when auditing what happened on a proposal.