PART 04 — 帳票処理
NASをなくしてS3で設計する

【アップロード】
クライアント → Apache → Tomcat（マルチパートを受信）→ NAS に格納

【帳票生成】
リクエスト → Java（JasperReports / iText で生成）→ NASの /tmp に一時保存 → レスポンス

【ダウンロード】
クライアント → Apache → NASのファイルをストリームして返す

S3Presigner presigner = S3Presigner.create();

// アップロード用 presigned URL（PUT）
PutObjectRequest putReq = PutObjectRequest.builder()
    .bucket("my-documents")
    .key("uploads/" + userId + "/" + fileId)
    .contentType("application/pdf")
    .build();

PresignedPutObjectRequest presignedPut = presigner.presignPutObject(
    PutObjectPresignRequest.builder()
        .signatureDuration(Duration.ofMinutes(15))  // 15分有効
        .putObjectRequest(putReq)
        .build()
);

String uploadUrl = presignedPut.url().toString();

// ダウンロード用 presigned URL（GET）
GetObjectRequest getReq = GetObjectRequest.builder()
    .bucket("my-documents")
    .key("reports/" + reportId + "/output.pdf")
    .build();

PresignedGetObjectRequest presignedGet = presigner.presignGetObject(
    GetObjectPresignRequest.builder()
        .signatureDuration(Duration.ofMinutes(30))  // 30分有効
        .getObjectRequest(getReq)
        .build()
);

String downloadUrl = presignedGet.url().toString();

【パターンA：Java経由アップロード（シンプル構成）】

クライアント → ALB → Java → S3.putObject()

適用：小〜中規模ファイル（数MB以下）、認可チェックが複雑なケース

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【パターンB：S3直接アップロード（大規模向け・推奨）】

① クライアント → Java：presigned PUT URL の発行を依頼
② Java → S3 SDK：presigned URL を生成してクライアントに返す
③ クライアント → S3：presigned URL を使って直接 PUT

APサーバーのメモリ・スレッド消費ゼロ
大容量ファイル（数百MB）でもタイムアウト不要
ECS コンテナの帯域を消費しない

【同期生成：即時応答（小規模帳票向け）】

リクエスト → Java（JasperReports で生成）→ S3 に格納
                                            → presigned URL をレスポンスで返す

適用：数秒以内で生成完了する単純な帳票

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【非同期生成：大規模帳票・時間がかかる処理向け】

① リクエスト → Java → SQS に「帳票生成ジョブ」を登録
② Java → クライアントへ「受付完了（jobId）」を即時応答
③ （バックグラウンド）SQS → ECS Worker が受信
④ ECS Worker が帳票生成 → S3 に格納
⑤ 完了通知：SNS → メール or WebSocket → クライアント

適用：数十秒以上かかる大量データの帳票・複数帳票の一括生成

s3://myapp-documents/
    ├── uploads/
    │     └── {userId}/{yyyy-MM}/{fileId}/original.pdf
    │           ← ユーザーアップロードファイル
    │
    ├── reports/
    │     └── {jobId}/{timestamp}/output.pdf
    │           ← 生成済み帳票
    │
    └── temp/
          └── {uuid}/work.pdf
                ← 処理中の一時ファイル（Lifecycle: 1日で自動削除）

バケットポリシー：
  ・パブリックアクセス：完全にブロック
  ・ECSタスクロール（IAM）からのみ操作許可
  ・presigned URL経由のアクセスのみ外部に公開

ライフサイクルルール：
  ・temp/ : 1日後に自動削除
  ・reports/ : 90日後にGlacierへ移行
  ・uploads/ : 1年後に自動削除（要件に応じて調整）