Redmineの設定

作業内容¶

API エンドポイントを設計・実装し、フロントエンドと各バックエンドサービスの間の通信を確立します。

詳細タスク¶

1. API ルーターとコントローラーの実装

   • /api/routes/index.js - メインルーター
   • /api/controllers/chat.js - チャット関連コントローラー
   • /api/controllers/search.js - 検索関連コントローラー
   • /api/controllers/documents.js - ドキュメント関連コントローラー
   • /api/controllers/redmine.js - Redmine関連コントローラー

2. チャット API エンドポイントの実装

   • POST /api/chat - 新規メッセージ送信
   • GET /api/chat/:sessionId - 会話履歴取得
   • GET /api/chat/sessions - セッション一覧取得
   • ストリーミングレスポンス対応

3. 検索 API エンドポイントの実装

   • POST /api/search - ベクトル検索
   • GET /api/search/sources - ソース一覧取得
   • フィルターオプション対応
   • ページネーション

4. ドキュメント API エンドポイントの実装

   • POST /api/documents/upload - ドキュメントアップロード
   • GET /api/documents/:id - ドキュメント取得
   • GET /api/documents - ドキュメント一覧取得
   • ファイルアップロード処理

5. WebSocket/SSE 実装

   • /api/services/streaming/index.js - ストリーミングサービス
   • チャットレスポンスストリーミング
   • 処理状況通知
   • 接続管理

技術的指示¶

• Express.js ルーターを使用した構造化されたAPI設計
• 入力バリデーションは express-validator を使用
• API ドキュメントは OpenAPI/Swagger 形式で作成
• セキュリティヘッダーとCORS設定の適切な実装
• レート制限の実装（express-rate-limit）
• エラーハンドリングの統一化と明確なエラーレスポンス
• ストリーミングには SSE または Socket.io を使用

成果物¶

• API ルーターとコントローラー
• チャット API エンドポイント
• 検索 API エンドポイント
• ドキュメント API エンドポイント
• WebSocket/SSE 実装
• API ドキュメント（OpenAPI/Swagger）
• テスト用スクリプト

参考リソース¶

• Express.js API 設計ベストプラクティス
• RESTful API 設計ガイドライン
• Server-Sent Events (SSE) 実装パターン
• API セキュリティベストプラクティス