Lifecycle · Article 2.6
Status: Anzahlung bezahlt – Arbeit kann beginnen
Die Anzahlung ist eingegangen (Stripe-Webhook oder manuelle Bestätigung). Clozo setzt den Status, reiht die Erstellung der Anzahlungsquittung in die Warteschlange und startet einen Hintergrundauftrag zur Vorab-Generierung der Schlussrechnung. Sie können mit der Arbeit beginnen.
Where this fits in the lifecycle
Draft
Only you can see this. Edit anything.
Sent
Email landed in the client's inbox.
Viewed
Client opened the link — awaiting decision.
Signed
Legally binding. Audit trail captured.
Deposit paid
Money in escrow. You can start work.
In work
Project running. Final invoice ready when you're done.
Paid
Final invoice settled. Just one click left.
Completed
Closed. Archived. You did the thing.
Für die meisten Freiberufler ist dies der Moment, in dem das Projekt offiziell beginnt. Sie haben ein unterzeichnetes Dokument, die Anzahlung auf dem Konto und einen verbindlichen Kunden. Clozos Benutzeroberfläche ändert sich dezent: Das Dashboard-Banner zeigt jetzt „Anzahlung bezahlt – Arbeit läuft", das Aktionsbereich zeigt für die Arbeitsphase relevante Schaltflächen (Meilensteine markieren, Schlussrechnung ausstellen, Als abgeschlossen markieren), und Erinnerungsintervalle werden pausiert.
Step by step
Anzahlung bestätigt.
Entweder trifft der Stripe-Webhook ein (automatisch, ca. 2 Sekunden nach erfolgreicher Kartenzahlung) oder Sie klicken auf
Anzahlung manuell als bezahlt markierenfür SEPA / Bargeld / außerbörsliche Zahlung (dabei werden Sie nach einer Referenznotiz und einem Datum gefragt).Status wechselt zu
Anzahlung bezahlt.Timeline-Ereignis mit Zahlungsmethode und Betrag wird gespeichert. Quittung (REC-) wird generiert und automatisch versendet.
Im Hintergrund: Schlussrechnung wird vorab gerendert.
Keine UI-Anzeige erforderlich; das Ergebnis sehen Sie, wenn Sie das nächste Mal auf
Schlussrechnung ausstellenklicken.Status wechselt automatisch zu
In Arbeit.Sobald
prepare_final_invoiceerfolgreich ist, schreitet der Status voran. Bei fünf Fehlversuchen verbleibt der Status beiAnzahlung bezahltund eine Wiederherstellungsschaltfläche erscheint.Arbeit beginnen.
Zeit erfassen, Meilensteine setzen, mit dem Kunden kommunizieren. Clozo verfolgt keine laufenden Arbeiten (wir sind kein Projektmanagement-Tool); wenn Sie fertig sind, klicken Sie auf
Als abgeschlossen markieren und Schlussrechnung ausstellen.
Bernsteinfarbenes Anzahlung bezahlt-Badge wechselt automatisch zu bernsteinfarbenem In Arbeit. Timeline zeigt: Anzahlungsereignis, Quittung erstellt, Schlussrechnung vorab gerendert, Statuswechsel-Ereignis. Aktionsbereich wandelt sich: anzahlungsbezogene Schaltflächen verschwinden, arbeitsphase-relevante erscheinen (Schlussrechnung ausstellen, Als abgeschlossen markieren, Zeit für dieses Projekt erfassen).
Why this works this way
Hier startet ein asynchroner Ablauf, den die meisten Nutzer nicht bemerken. Sobald das Anzahlung-bezahlt-Ereignis ausgelöst wird, reiht Clozo einen Celery-Task prepare_final_invoice.delay() ein, der das Schlussrechnungs-PDF (Schlussrechnung) im Hintergrund rendert und in R2 speichert. Warum vorab rendern? Weil beim späteren Klick auf Schlussrechnung ausstellen die schwere PDF-Generierung bereits erledigt ist – der E-Mail-Task hängt einfach die vorab gerenderte Datei an. Das vermeidet eine 30–60-sekündige Verzögerung (und mögliche Gotenberg-Fehler) in dem Moment, in dem der Kunde auf die E-Mail wartet.
Wenn prepare_final_invoice fehlschlägt (z. B. Gotenberg-Fehler), wird bis zu fünfmal mit exponentiellem Backoff erneut versucht. Wenn alle fünf Versuche fehlschlagen, verbleibt das Angebot im Status Anzahlung bezahlt (anstatt automatisch zu In Arbeit zu wechseln), und im Aktionsmenü erscheint die Schaltfläche Schlussrechnung erneut versuchen. Sentry sendet außerdem eine Benachrichtigung an den Betrieb.
Troubleshooting
Keep reading
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: In work — deposit settled, project running, final invoice ready
You're between the deposit and the final payment. The final invoice is pre-rendered and ready to issue when you finish. Clozo doesn't track project progress here — you do — but it's listening for you to say `done`.
Proposals & Invoices
Marking a payment as paid manually — for SEPA, cash, wire, anything outside Stripe
When a payment lands outside the auto-detected channels (SEPA bank transfer, cash, foreign wire), use `Mark as paid manually` to record it. Clozo creates the receipt, fires confirmation emails, and preserves the audit trail.