Redmineの設定

概要¶

claude-search システムのインポート機能（手動・JSONファイル）を完全実装

親チケット¶

#384 claude-search 残存問題調査・バグ修正 - Phase3-2

特定された未実装機能¶

1. 手動インポート機能¶

現状: 「手動インポート機能は準備中です。」アラート表示のみ
実装内容:

• フォーム入力値のバリデーション
• API /api/v2/conversations への POST リクエスト
• 成功・失敗時の適切なフィードバック表示
• フォームのクリア処理

2. JSONファイルアップロード機能¶

現状: ファイル選択ダイアログのみ動作
実装内容:

• JSON ファイルの読み込み・解析
• Claude会話形式のJSONバリデーション
• バルクインポート処理
• 進捗表示・結果サマリー

3. ユーザビリティ改善¶

実装内容:

• 検索結果が少ない場合の説明文追加
• エラーメッセージの改善
• ローディング状態の表示

技術仕様¶

手動インポート API実装¶

// POST /api/v2/conversations
{
    "title": "会話タイトル",
    "content": "会話内容",
    "source": "manual_input"
}

JSONインポート処理¶

// Claude会話JSON形式の対応
{
    "conversations": [
        {
            "title": "...",
            "messages": [
                {"role": "user", "content": "..."},
                {"role": "assistant", "content": "..."}
            ]
        }
    ]
}

エラーハンドリング¶

• バリデーションエラー
• ネットワークエラー
• サーバーエラー
• ファイル形式エラー

実装手順¶

1. 手動インポート機能: フォーム処理とAPI連携
2. JSONアップロード機能: ファイル読み込みと解析処理
3. UI/UX改善: ユーザーガイダンスと状態表示
4. テスト: 全機能の動作確認

成功基準¶

• 手動で会話を追加できる
• JSONファイルから会話をインポートできる
• 適切なエラーメッセージが表示される
• ユーザーフレンドリーなインターフェース

工数¶

約2-3時間