dust-temporal

Step-by-step guide for creating Temporal workflows in Dust. Use when adding background jobs, async processing, durable workflows, or task queues.

1. Utwórz katalog dla nowej kolejki w strukturze temporal/nazwa_kolejki/ — będzie zawierać wszystkie pliki konfiguracyjne i implementacyjne przepływu pracy.

2. Stwórz plik config.ts definiujący nazwę kolejki i wersję — użyj konwencji nazwa-kolejki-v1 aby ułatwić zarządzanie wersjami i aktualizacjami.

3. Zaimplementuj helper makeYourWorkflowId() w pliku helpers.ts — funkcja musi być deterministyczna, czyli dla tych samych wejść zawsze zwraca ten sam identyfikator, co gwarantuje idempotencję przepływu pracy.

4. Zdefiniuj aktywności w activities.ts — są to funkcje wykonujące operacje z efektami ubocznymi (zapytania do bazy danych, wywołania API). Każda aktywność powinna obsługiwać błędy, na przykład gdy zasób nie zostanie znaleziony.

5. Utwórz orkiestrację w workflows.ts — przepływ pracy jest deterministyczną funkcją koordynującą sekwencję aktywności i decyzji logicznych bez efektów ubocznych.

6. Skonfiguruj worker w worker.ts i funkcje uruchamiające w client.ts — worker nasłuchuje na kolejce zadań, a client dostarcza interfejs do uruchamiania nowych instancji przepływu pracy z unikalnym ID.