Skip to main content

Lifecycle Β· Article 2.6

Status: Voorschot betaald β€” werk kan beginnen

Het voorschot is ontvangen (Stripe-webhook of handmatige bevestiging). Clozo schakelt de status, zet de voorschot-bon-PDF in de wachtrij en start een achtergrondtaak om de eindafrekening voor te renderen. U kunt het werk beginnen.

Where this fits in the lifecycle

Tap any card to open its detail article.

Voor de meeste freelancers is dit het moment waarop het project officieel begint. U heeft ondertekend papier, voorschotgeld op de bank en uw klant is gebonden. De UI van Clozo verschuift subtiel: de dashboardbanner zegt nu "Voorschot betaald β€” werk in uitvoering", het actiepaneel toont knoppen relevant voor de werkfase (mijlpalen markeren, eindafrekening uitsturen, markeren als voltooid) en herinneringsplanningen zijn gepauzeerd.

Step by step

  1. Voorschot bevestigd.

    Ofwel Stripe-webhook arriveert (automatisch, ~2 sec na kaartbetaling) of u klikt op Voorschot handmatig als betaald markeren voor SEPA / contant / buiten het systeem (u wordt gevraagd om een referentienoot en datum).

  2. Status schakelt naar Voorschot betaald.

    Tijdlijngebeurtenis vastgelegd met betaalmethode en bedrag. Bon (BON-) gegenereerd en automatisch gemaild.

  3. Achtergrond: eindafrekening wordt voorgerenderd.

    Geen UI-indicatie nodig; u ziet het resultaat wanneer u op Eindafrekening uitsturen klikt.

  4. Status gaat automatisch over naar In uitvoering.

    Zodra prepare_final_invoice slaagt, gaat de status verder. Als het 5 keer mislukt, blijft de status op Voorschot betaald en verschijnt een herstelknop.

  5. Begin het werk.

    Registreer tijd, haal mijlpalen, communiceer met de klant. Clozo registreert niet het werk-in-uitvoering (we zijn geen projectmanagementtool); als u klaar bent, klik op Markeren als voltooid en eindafrekening uitsturen.

Amberkleurige badge Voorschot betaald gaat automatisch over naar amberkleurige In uitvoering. Tijdlijn toont: voorschot-betaalgebeurtenis, bon-gegenereerd-gebeurtenis, eindafrekening-voorgerenderd-gebeurtenis, statuswijzigingsgebeurtenis. Actiepaneel transformeert: voorschot-gerelateerde knoppen verdwijnen, werkfase-knoppen verschijnen (Eindafrekening uitsturen, Markeren als voltooid, Tijd bijhouden voor dit project).

Why this works this way

Er is een asynchrone stroom die hier op gang komt die de meeste gebruikers niet opmerken. Op het moment dat de voorschot-betaald-gebeurtenis vuurt, plaatst Clozo een Celery-taak prepare_final_invoice.delay() in de wachtrij die de eindafrekening-PDF (Schlussrechnung) op de achtergrond rendert en opslaat in R2. Waarom voorrenderen? Omdat wanneer u later op Eindafrekening uitsturen klikt en de e-mail verstuurd moet worden, de zware PDF-generatie al klaar is β€” de e-mailtaak voegt eenvoudig het voorgerenderde bestand bij. Dit voorkomt een vertraging van 30-60 seconden (en mogelijke Gotenberg-storingen) op het moment dat de klant op de e-mail wacht.

Als prepare_final_invoice mislukt (bijv. Gotenberg-fout), probeert het 5 keer opnieuw met exponentiΓ«le vertraging. Als alle vijf mislukken, blijft de offerte op Voorschot betaald (in plaats van automatisch over te gaan naar In uitvoering) en verschijnt een knop Eindafrekening opnieuw proberen in het menu Acties. Sentry stuurt ook een alert naar ops.

Troubleshooting

Keep reading

Status: Voorschot betaald β€” werk kan beginnen Β· Help Β· Clozo