Temporalを⽤いた Sagaの実践とプロセスモデリング

UPSIDERの請求基盤チームでは、債権・入金・消込・帳簿といった複数モジュールにまたがる複雑な処理を扱っており、分散環境におけるデータの整合性維持が極めて重要な課題です。 本セッションでは、これらの課題を解決するために採用したSagaパターンと、その基盤としてのTemporalの活用事例を解説します。単なるワークフローエンジンとしての利用に留まらず、請求・入金・督促といったLong Running Process（長期間実行プロセス）をいかにモデリングし、補償処理や処理順序の設計論点をどう整理したのか。実戦的な設計ノウハウを共有します。

Transcript

1. © UPSIDER, Inc. 1 Temporalを⽤いた Sagaの実践とプロセスモデリング 株式会社 UPSIDER Konn Temporal公式のZiggyを参考に、⾃分で描いたイラストです（以降のページも同様）。
2. © UPSIDER, Inc. 2 ⾃⼰紹介 • Konn ◦ 新卒でFintech業界を知る • 2024/11からUPSIDERにJoin ◦ 請求基盤チームの立ち上げメンバー • Gopher歴は5年ほど • Temporal歴1年半ほど • 夜は温泉とマリカ配信で1日をReset
3. © UPSIDER, Inc. 3 UPSIDERはAI化された総合金融機関へ 当社はこれまで決済事業に特化し、お客様の成長をサポートしてきました。しかし今後は総合金融機関として進化していきます。 挑戦者を応援する法人カード https://up-sider.com/ https://shi-harai.com/ https://breakthrough-grid.com/ https://ai-keiri.up-sider.com/ https://www.upsidercap.com/ https://president-card.com/ 請求書カード払いサービス ビジネスリーダー向けコミュニティ 経営者のための経理丸投げサービス 経営者の挑戦を支える法人カード グロースデットファンド 与信枠の増枠＆広告媒体 仕入れの後払いを実現 Adboost BUSINESS 提供サービス
4. © UPSIDER, Inc. 4 Today’s goal 請求基盤 という複雑かつデータ整合性が⼤切 なドメインで なぜTemporalを採⽤し、どう設計しているのか を知ってもらう
5. © UPSIDER, Inc. 5 1. SagaパターンとTemporal 2. プロセスモデリングとTemporal 3. まとめ ⽬次
6. © UPSIDER, Inc. 6 01.SagaパターンとTemporal
7. © UPSIDER, Inc. 7 請求書 債権 入金 消込 仕訳 サービス モジュールA モジュールB モジュールC DB データ整合性
8. © UPSIDER, Inc. 8 請求書 債権 入金 消込 仕訳 Service モジュールA モジュールB モジュールC DB DB DB データ整合性
9. © UPSIDER, Inc. 9 Transaction A Transaction B Transaction C Sagaは一連のローカルトランザクションの連鎖として実装する Success Sagaパターン
10. © UPSIDER, Inc. 10 Transaction A Transaction B Transaction C 一連のローカルトランザクションの連鎖として実装する Fail compensation B 失敗 compensation A Sagaパターン
11. © UPSIDER, Inc. 11 　 Activity Activity Activity Workflow Temporal Temporalがオーケストレーターとなる Saga = Workflow Transaction = Activity TemporalでSaga
12. © UPSIDER, Inc. 12 　 Activity Activity Activity Workflow Temporal Temporalのメリット Sagaの状態自動保存 失敗時の自動リトライ イベント履歴の記録 Sagaの再実行 状態保存、リトライなどは意識しなくて良い。 TemporalでSaga
13. © UPSIDER, Inc. 13 Temporal workflowにおいて補償処理はActivityの前に登録します 1. 補償登録 2. Activity実行 3. 補償実行 補償処理
14. © UPSIDER, Inc. 14 　 Activity A Workflow 補償処理自体の失敗は握りつぶして最後まで完遂することを優先する Activity B Activity C 失敗 　 Compensation Compensation B Compensation A fail 失敗 補償の失敗は無視 補償処理の失敗
15. © UPSIDER, Inc. 15 　 Workflow 実施するActivityの処理順序を工夫することで補償処理を楽に 失敗しやすい Activity 失敗しやすい Activity 決定点 リトライすれば良い Activity 補償 ワークフローは必ず最後まで 処理順序の最適化
16. © UPSIDER, Inc. 16 02.プロセスモデリングとTemporal
17. © UPSIDER, Inc. 17 💡請求基盤は長時間にわたるドメインを取り扱う 5/1 5/14 5/15 通知 5/16 … 消込 請求 督促 8/1 不良債権処理 Long Runninng Process
18. © UPSIDER, Inc. 18 Sleep処理、外部からのシグナル受け付けやタイマー処理など実装 5/1 5/14 5/15 5/16 … 8/1 Sleep Sleep Signal Long Runninng Process
19. © UPSIDER, Inc. 19 💡ワークフローをコラボレーションし、業務プロセスを実現 ※あくまでイメージです ビジネスプロセスモデリング
20. Temporalの特徴  Durable • 実行状態を失わない • ダウンタイム後も再開可能  Code-first • TypeScript / Go などで記述 • 複雑な業務ロジックを表現  Workflow Collaboration • 役割ごとに分割 • 他ワークフローに Signal送信 結果: 長期、複雑な業務プロセスを安全に表現できる © UPSIDER, Inc. 19
21. © UPSIDER, Inc. 21 03.まとめ
22.  データ整合性の担保 請求基盤チームでは、 Temporalを活用して複雑なドメインにおけるデータ整合性を担保し ている  業務プロセスの Workflow化 長期にわたる業務プロセスは Workflowとして表現し、状態管理と実行制御を行っている © UPSIDER, Inc. 22 まとめ
23. © UPSIDER, Inc. 23 UPSIDERでは一緒に働くエンジニアを募集しています We are hiring!