Documents

# 請求書PDF生成を非同期キュー処理にする

- 状態: 採用
- 決定日: 2026-08-20

## 背景

請求書のPDF生成には最大45秒かかる。同期生成では、その間に接続が切れるため、APIの応答を完了まで維持できない。

## 決定

請求書のPDF生成はキューで非同期に処理する。APIは生成完了を待たず、受付IDを返す。利用者は、PDFが完成するまで待つ必要がある。

## 決定理由

同期生成では、最大45秒の処理中に接続が切れるため採用しない。非同期処理なら、PDF生成とAPIの受付を分離できるため、生成処理の完了までAPIの接続を維持する必要がない。

## 影響

利用者はAPIの応答だけではPDFを受け取れず、受付IDに対応する生成結果が完成するまで待つ必要がある。保守者は、受付IDとキュー処理を前提に、生成中と生成完了後の扱いを実装・運用する必要がある。

再試行の上限は未決定である。再試行処理を追加・変更する場合は、この上限を決めたうえで、キュー処理の設計と整合させる。

## 代替案

同期生成は、最大45秒の処理中に接続が切れるため不採用とした。