Skip to main content

Lifecycle · Article 2.6

Status: Zaliczka opłacona — praca może się rozpocząć

Zaliczka wpłynęła (webhook Stripe lub ręczne potwierdzenie). Clozo zmienia status, kolejkuje PDF potwierdzenia zaliczki i uruchamia zadanie w tle do wstępnego renderowania faktury końcowej. Możesz rozpocząć pracę.

Where this fits in the lifecycle

Tap any card to open its detail article.

Dla większości freelancerów to jest moment, gdy projekt oficjalnie się zaczyna. Masz podpisane dokumenty, pieniądze zaliczki na koncie bankowym i zaangażowanego klienta. Interfejs Clozo zmienia się subtelnie: baner pulpitu mówi teraz „Zaliczka opłacona — praca w toku", panel akcji pokazuje przyciski istotne dla fazy roboczej (zaznacz kamienie milowe, wystaw fakturę końcową, oznacz jako ukończone), a harmonogramy przypomnień są wstrzymane.

Step by step

  1. Zaliczka potwierdzona.

    Albo webhook Stripe dociera (automatycznie, ~2 sekundy po sukcesie karty), albo klikasz Oznacz zaliczkę jako opłaconą ręcznie dla SEPA / gotówki / poza systemem (zostaniesz zapytany o notatkę referencyjną i datę).

  2. Status zmienia się na Zaliczka opłacona.

    Zdarzenie na Osi Czasu rejestrowane z metodą płatności i kwotą. Potwierdzenie (REC-) generowane i wysyłane e-mailem automatycznie.

  3. W tle: faktura końcowa wstępnie się renderuje.

    Nie potrzeba żadnej wskazówki w interfejsie; efekt zobaczysz, gdy następnie klikniesz Wystaw fakturę końcową.

  4. Status automatycznie przechodzi do W pracy.

    Gdy prepare_final_invoice się powiedzie, status postępuje. Jeśli zawiedzie 5 razy, status pozostaje przy Zaliczka opłacona i pojawia się przycisk odtworzenia.

  5. Rozpocznij pracę.

    Śledź czas, realizuj kamienie milowe, komunikuj się z klientem. Clozo nie śledzi pracy w toku (nie jesteśmy narzędziem do zarządzania projektami); gdy skończysz, kliknij Oznacz jako ukończone i wystaw fakturę końcową.

Bursztynowa odznaka Zaliczka opłacona automatycznie przechodzi do bursztynowej W pracy. Oś Czasu pokazuje: zdarzenie płatności zaliczki, zdarzenie wygenerowania potwierdzenia, zdarzenie wstępnego renderowania faktury końcowej, zdarzenie zmiany statusu. Panel akcji się przekształca: przyciski związane z zaliczką znikają, pojawiają się przyciski fazy roboczej (Wystaw fakturę końcową, Oznacz jako ukończone, Śledź czas dla tego projektu).

Why this works this way

Uruchamia się tu asynchroniczny przepływ, którego większość użytkowników nie zauważa. W momencie gdy zdarzenie zaliczki-opłaconej zostaje wyzwolone, Clozo kolejkuje zadanie Celery prepare_final_invoice.delay(), które renderuje PDF faktury końcowej (Schlussrechnung) w tle i przechowuje go w R2. Dlaczego wstępne renderowanie? Ponieważ gdy później klikniesz Wystaw fakturę końcową i e-mail musi zostać wysłany, ciężkie generowanie PDF jest już gotowe — zadanie e-mail po prostu dołącza wstępnie wyrenderowany plik. Unika to opóźnienia 30–60 sekund (i możliwych awarii Gotenberg) w momencie, gdy klient czeka na e-mail.

Jeśli prepare_final_invoice się nie powiedzie (np. chwilowa awaria Gotenberg), ponawia 5 razy z wykładniczym cofnięciem. Jeśli wszystkie pięć się nie powiedzie, oferta pozostaje w stanie Zaliczka opłacona (zamiast automatycznie przejść do W pracy), a w menu Akcje pojawia się przycisk Ponów fakturę końcową. Sentry wysyła też alert do działu operacyjnego.

Troubleshooting

Keep reading

Status: Zaliczka opłacona — praca może się rozpocząć · Help · Clozo