Redmineの設定

Phase D Step 2.4 実行: RAG UI完全統合・本番稼働・Document Management実装

目的¶

• Document Management UI (ファイルアップロード・管理・プレビュー)
• RAG API統合強化 (リアルAPI連携・WebSocket)
• UX/UI完善 (レスポンシブ・アクセシビリティ)
• Performance Optimization (バンドル最適化)

前提条件¶

✅ nginx-proxy統合完了 (チケット#274)
✅ RAGアドバイザーアプリ: ルート(/)配置完了
✅ API基盤: task2-api (healthy), PostgreSQL, Redis, Meilisearch

実装範囲¶

1. Document Management System (2時間)¶

• ファイルアップロード機能:

  • ドラッグ&ドロップ対応
  • 複数ファイル同時アップロード
  • プログレス表示・エラーハンドリング

• ファイル管理機能:

  • ファイル一覧・検索・フィルタリング
  • メタデータ管理 (タグ・カテゴリ・説明)
  • ファイル削除・移動・リネーム

• プレビュー機能:

  • PDF・画像・テキストファイル対応
  • インライン表示・モーダル表示
  • ダウンロード・共有機能

2. RAG API統合強化 (1.5時間)¶

• リアルAPI連携:

  • Claude API・OpenAI・DeepSeek統合
  • エラーハンドリング・フォールバック
  • レスポンス時間最適化

• WebSocket実装:

  • リアルタイム応答
  • ストリーミング表示
  • 接続状態管理

• ベクトル検索統合:

  • pgvector・Meilisearch連携
  • セマンティック検索
  • 関連度スコア表示

3. UX/UI完善 (1時間)¶

• レスポンシブデザイン:

  • Mobile First設計
  • タブレット・デスクトップ対応
  • タッチ操作最適化

• アクセシビリティ:

  • WCAG 2.1 AA準拠
  • キーボードナビゲーション
  • スクリーンリーダー対応

• ユーザビリティ向上:

  • ローディング状態表示
  • トースト通知
  • ショートカットキー

4. Performance Optimization (1時間)¶

• バンドル最適化:

  • Code Splitting
  • Tree Shaking
  • 動的インポート

• キャッシュ戦略:

  • Service Worker
  • ブラウザキャッシュ
  • API応答キャッシュ

• 監視・メトリクス:

  • パフォーマンス計測
  • エラー追跡
  • ユーザー行動分析

技術仕様¶

フロントエンド¶

• React 18: Functional Components + Hooks
• TypeScript: 完全型安全実装
• TailwindCSS: LINE Design System準拠
• Vite: 高速ビルド・HMR対応

バックエンド API拡張¶

// Document Management API
POST   /api/documents/upload    // ファイルアップロード
GET    /api/documents           // ファイル一覧
GET    /api/documents/:id       // ファイル詳細
PUT    /api/documents/:id       // メタデータ更新
DELETE /api/documents/:id       // ファイル削除

// RAG Analysis API  
POST   /api/rag/analyze         // ドキュメント解析
POST   /api/rag/query           // セマンティック検索
GET    /api/rag/history         // 解析履歴
WebSocket /ws/rag              // リアルタイム応答

データベース設計¶

-- Documents Table
CREATE TABLE documents (
    id SERIAL PRIMARY KEY,
    filename VARCHAR(255) NOT NULL,
    content_type VARCHAR(100),
    file_size BIGINT,
    upload_date TIMESTAMP DEFAULT NOW(),
    tags TEXT[],
    category VARCHAR(100),
    description TEXT,
    vector_embedding vector(1536)
);

-- RAG Sessions Table
CREATE TABLE rag_sessions (
    id SERIAL PRIMARY KEY,
    session_id UUID DEFAULT gen_random_uuid(),
    created_at TIMESTAMP DEFAULT NOW(),
    updated_at TIMESTAMP DEFAULT NOW()
);

品質指標¶

• Performance: Page Load < 1秒, Bundle < 250KB
• Security: CSP適用, XSS/CSRF対策
• Accessibility: WCAG 2.1 AA準拠
• Usability: モバイル対応, キーボード操作

成果物¶

• Document Management完全実装
• RAG API統合強化完了
• UX/UI完善・最適化完了
• Performance最適化完了

予定時間: 5.5時間
担当: Phase D実行チーム
優先度: 高 (Phase D完遂のため)