Documents

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

- **ステータス:** 採用
- **決定日:** 2026-08-20
- **関連:** BILL-218、PR #106

## コンテキスト

請求書のPDF生成には最大45秒かかることがある。同期的に生成すると、処理中にAPI接続が切断される可能性があるため、利用者への応答とPDF生成処理を同じリクエスト内で完了させる方式は安定しない。

## 決定

請求書のPDF生成はキューに投入して非同期で処理する。APIはPDFそのものではなく、受付IDを返す。利用者またはクライアントは受付IDを使って処理状況を確認し、生成完了後にPDFを取得する。

## 選択しなかった案

### 同期生成

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

## 影響

### 利点

- 長時間のPDF生成によるAPI接続切断の影響を抑えられる。
- APIは受付処理を短時間で完了できる。
- PDF生成処理をキューのワーカーで独立して処理できる。

### 欠点・利用者への影響

- API応答時点ではPDFは完成していない。
- 利用者はPDFの完成まで待つ必要がある。
- クライアントには、受付IDによる状況確認と、完了後のPDF取得処理が必要になる。

## 未決事項

- 生成失敗時の再試行回数の上限は未決定である。運用・障害影響を確認したうえで別途決定する。
- 完成通知、状態確認API、受付IDの有効期限などの詳細仕様は実装時に確定する。

## 進捗メモ

原資料の作業メモでは、本対応の進捗は70%と記録されている。