Documents

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

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

### 背景

請求書のPDF生成には最大45秒かかる。同期処理ではAPIの接続が切れるため、利用者へ安定して処理結果を返せない。

### 決定

請求書のPDF生成はキューへ投入して非同期に処理する。受付時にAPIは受付IDを返し、利用者はその受付IDを使って生成状況や完成したPDFを確認する。

### 決定理由

同期生成中は、接続切断の可能性がある。キューを使った非同期処理なら、APIの受付とPDF生成を分離できる。45秒を超える生成時間でも、API接続を維持せずに済むためである。

### 代替案

同期生成は採用しない。最大45秒の処理中に接続が切れるためである。

### 結果

- APIはPDFそのものではなく、受付IDを返す。
- 利用者はPDFの完成まで待つ必要がある。
- PDF生成の処理状況と完成結果を、受付IDに関連付けて扱う必要がある。
- 再試行の上限は未決定であり、このADRでは定めない。