[PDF インポート 2/3] backend: PDF テキスト抽出 + 構造化出力エンドポイント

[yusuke0610]

背景（#517）

PDF インポート ADR（前段 issue）に従い、backend のエンドポイントを実装する。

作業内容（PR 1本）

• PDF テキスト抽出（ADR で選定したライブラリ）。依存追加 → uv lock 再生成・backend/uv.lock コミット
• テキスト埋め込み有無の判定。スキャン PDF は messages.json の日本語メッセージで非対応エラーを返す
• services/agent/ 配下に抽出サービスを実装:
  • 構造化出力で Resume スキーマ互換の payload を返す（Haiku）
  • Agent の不変条件を継承: 機械制約はスキーマ / 品質制約はプロンプト（プロンプトは app/prompts/）、リトライ 1 回、LLMError / パース失敗は 502 の日本語エラー契約
  • DB 非更新: レスポンスは payload のみ。保存はユーザがフォームから実行
• エンドポイント追加（multipart upload）。ファイルサイズ上限・PDF 以外の拒否のバリデーション
• レート制限（[Agent 整理 2/4] ユーザ単位レート制限の導入（課金撤去の前提） #521）の対象に組み込む
• 決定論部分（テキスト前処理・判定ロジック）は TDD 対象
• make codegen-types 再生成・コミット

受け入れ条件

• make ci green
• テキスト PDF で Resume 互換 payload が返り、スキャン PDF・非 PDF・サイズ超過がそれぞれ日本語エラーで区別される
• 作業前に .claude/rules/backend/agent.md を読むこと（Agent 変更時の必須ルール）

[yusuke0610]

PR #538 で main にマージ済み。同期エンドポイント POST /api/agent/resume-import/pdf を追加（pypdf 抽出 + スキャン判定 → Claude Haiku 構造化 → Resume 互換 payload・DB 非更新）。text_extract は TDD（mutmut 対象）、統合テストで正常/非対応/スキャン/LLM失敗/パース失敗/レート制限/未認証を網羅。レビュー指摘（pypdf の例外捕捉拡張）も対応済み。完了につきクローズ。