リファクタリング調査サマリー
作成日: 2026-05-26 ステータス: 調査完了・実装待ち トラッカー: docs/リファクタリング調査_tracker.md
調査概要
全37エリア（Routes 17 + Services 11 + Models 1 + Utils 12 + Agents 5 + Config 1 + Templates 1 + Tests 1 + Architecture 1）を調査。 合計約260件の改善点を特定。
ユーザー判断結果
| # | 項目 | 決定 |
|---|---|---|
| Q1 | SSRF対策 | スキーム制限のみ（https://のみ許可） |
| Q2 | CSRF_exempt API | カスタムヘッダーCSRF |
| Q3 | エラーメッセージ | STAGEで切替 |
| Q4 | ページネーション | 50件/ページ |
| Q5 | Enum化 | Python str Enumのみ |
| Q6 | 表示層移動 | テンプレートフィルタ |
| Q7 | 非同期基盤 | 今回は導入しない（バックログP1） |
| Q8 | logging.basicConfig | 削除 |
| Q9 | chat_history保存 | 保持期間7日 |
| Q10 | コストテーブル | 現状維持 |
| Q11 | NotificationService | Flask拡張パターン |
| Q12 | テスト修正 | 各フェーズで同時 |
横断的トップ3問題
- SSRF — URL検証なし（S03/S06/S07）
- 同期ブロック — Playwright/LLM/スクレイパーがFlaskワーカーを占有
- datetime.utcnow — 全モデルで非推奨
実行フェーズ
- Phase 0: 共通インフラ（timezone.py, validation.py, errors.py）
- Phase 1: セキュリティ修正（~15件）
- Phase 2: バグ修正（~20件）
- Phase 3: 横断的クリーンアップ（~30件）
- Phase 4: 品質向上（~15件）
- Phase 5: 将来（Celery導入・テストカバレッジ・アクセシビリティ）
詳細調査ファイル（SSOT）
全て obsidian-ssot/01_DECISIONS/atelier-kyo-manager/2026-05-26_リファクタリング調査_*.md に保存。
関連
- 実行計画（確定版）: ~/.claude/plans/cosmic-spinning-pearl.md
- 非同期基盤ガイド: docs/非同期基盤実装ガイド.md
- トラッカー: docs/リファクタリング調査_tracker.md