weseek__growi/apps/app/src/features/openai/docs/plan/README.md

GROWI エディターアシスタント改修計画 - クライアント・サーバー分離アーキテクチャ

このディレクトリには、現在のGROWIエディターアシスタントをroo-codeの方式に倣ってクライアント・サーバー分離アーキテクチャで再実装するための包括的な改修計画が含まれています。

📁 ファイル構成

📋 計画ドキュメント

editor-assistant-refactoring-plan.md

メイン計画書 - クライアント・サーバー分離による改修プロジェクト全体の概要

• 📊 現状分析（全サーバーサイド処理）と課題の特定
• 🎯 新アーキテクチャ目標とroo-code方式の適用
• 🔄 段階別実装計画（Phase 2A/2B分離）
• 📈 期待効果（パフォーマンス50%向上、ネットワーク80%削減）
• ✅ 進捗状況（Phase 1完了、Phase 2A実装中）

technical-implementation-details.md

技術実装詳細 - ハイブリッドアーキテクチャと具体的な実装方法

• 🏗️ クライアント・サーバー責務分離のフロー図
• 📦 新ファイル構成（client/server分離）
• 🔍 核心技術の配置（ClientFuzzyMatcher、EditorDiffApplicator等）
• 🎛️ ハイブリッド設定管理
• 🧪 分散テスト戦略
• 📈 ネットワーク・メモリ最適化

implementation-tasks.md

実装タスクリスト - クライアント・サーバー分離に基づく具体的なタスク

• ✅ Phase 1: スキーマ更新（完了済み）
• 🎯 Phase 2A: クライアントサイドエンジン実装（最優先・27時間）
• 🔄 Phase 2B: サーバーサイド最適化（12時間）
• 🔗 Phase 3: ハイブリッド統合（15時間）
• 📊 総工数92時間、22タスクの詳細管理

roo-code-investigation-supplement.md

roo-code調査レポート - VSCode拡張アーキテクチャの詳細分析

• 🧪 クライアントサイド処理パターンの調査
• 🛡️ ブラウザ環境でのエラーハンドリング
• 🎛️ リアルタイム設定管理とパフォーマンス
• 📝 文字正規化のブラウザ実装
• 📈 アーキテクチャ変更への反映（+11.5時間）

🚀 改修概要 - 新アーキテクチャ

現在の課題

• 全サーバーサイド処理: パフォーマンス・プライバシー・拡張性の制約
• 精度不足: 単純なreplaceのみで誤った箇所を変更するリスク
• ネットワーク負荷: 全コンテンツのサーバー送信
• リアルタイム性欠如: 処理中のフィードバック不足

改修後の実現機能（ハイブリッドアーキテクチャ）

🖥️ クライアントサイド処理

• Search/Replace Engine: ブラウザ内での高速Fuzzy Matching
• リアルタイム適用: エディターへの即座diff適用
• プレビュー機能: 変更前確認とキャンセル機能
• プライバシー強化: ユーザーコンテンツの非送信
• 複数diff処理: 一つのリクエストで複数箇所の変更
• 詳細エラー報告: 失敗原因と解決策の具体的な提示

📊 改修スコープ

影響範囲

apps/app/src/features/openai/
├── interfaces/editor-assistant/     # スキーマ更新
├── server/routes/edit/             # プロンプト・処理統合  
├── server/services/editor-assistant/ # 新処理エンジン
└── client/services/                # クライアント対応

🔧 サーバーサイド専門化

• LLM通信管理: OpenAI APIとの効率的ストリーミング
• プロンプト最適化: roo-code形式の指示生成
• セキュリティ: 認証・認可・レート制限
• ネットワーク効率: diff配列のみの転送

新規実装コンポーネント（分散配置）

クライアントサイド

• ClientFuzzyMatcher: ブラウザ内類似度計算
• EditorDiffApplicator: エディター直接統合
• ClientSearchReplaceProcessor: ローカル処理エンジン
  
• ClientErrorHandler: リアルタイムエラー表示

サーバーサイド

• LlmResponseProcessor: OpenAI専門パーサー
• PromptGenerator: roo-code形式生成
• ServerConfig: システム設定管理

🎯 実装優先順位 - 更新版

🔴 最高優先度 (Phase 2A - 27時間)

1. Client Fuzzy Matching Engine - ブラウザ内高速検索
   
2. Client Diff Application Engine - エディター直接統合
3. Client Main Processor - ローカル処理統合
4. Editor Integration - useEditorAssistantフック更新

🟡 中優先度 (Phase 2B, 3 - 27時間)

1. Server Optimization - LLM専門化・軽量化
2. Hybrid Integration - クライアント・サーバー連携
3. Real-time Feedback - 処理状況の即座表示

🟢 低優先度 (Phase 4, 5 - 34時間)

1. UI Enhancement - プレビュー・設定画面
2. Documentation - アーキテクチャ図・API仕様
3. Testing - 単体・統合・E2Eテスト

📈 期待効果 - 新アーキテクチャ

指標	現在	改修後	改善率
編集精度	60-70%	90-95%	+30-35%
レスポンス時間	2-3秒	0.5-1秒	50-70%
ネットワーク負荷	全コンテンツ	diff配列のみ	80%
サーバー負荷	高（全処理）	低（LLMのみ）	60%
プライバシー	全送信	最小限	大幅改善

📊 進捗状況

✅ 完了 (Phase 1 - 4時間)

• LlmEditorAssistantDiff スキーマ Search/Replace対応
• SseFinalizedSchema エラー詳細拡張
• 新型定義追加 (ProcessorConfig, DiffError等)

🔄 進行中 (アーキテクチャ見直し)

• サーバーサイドプロトタイプ → クライアント実装への移行
• 責務分離設計の確定

📋 次のアクション (Phase 2A)

• Client Fuzzy Matching Engine 実装開始
• fastest-levenshtein ブラウザ対応確認
• エディター統合テスト環境構築

🔗 参考資料

• roo-code GitHub Repository
• roo-code apply_diff implementation
• roo-code multi-search-replace strategy
• roo-prompts.md - roo-codeのプロンプト仕様

📝 使用方法

計画書の読み順（新アーキテクチャ対応）

1. まず: editor-assistant-refactoring-plan.md でクライアント・サーバー分離の全体概要を把握
2. 次に: implementation-tasks.md でPhase 2A（クライアント実装）の具体的なタスクを確認
3. 詳細: technical-implementation-details.md でハイブリッドアーキテクチャの技術詳細を理解
4. 背景: roo-code-investigation-supplement.md でアーキテクチャ変更の根拠を確認

実装開始時（更新版）

1. Phase 2Aから着手: クライアントサイドエンジンの実装を最優先
2. 段階的検証: Fuzzy Matching → Diff Application → 統合の順序で進行
3. 並行開発: Phase 2Aと2Bを部分的に並行実装可能
4. 進捗管理: implementation-tasks.md のチェックリストで管理

⚠️ 重要な注意事項

アーキテクチャ変更による影響

• 既存プロトタイプ: サーバーサイドファイルは参考用（後で削除予定）
• 依存関係: fastest-levenshteinのブラウザ対応要確認
• テスト環境: ブラウザ環境での単体テスト構築が必要
• パフォーマンス: クライアント処理のメモリ使用量監視が重要

開発時の注意点

• 段階的移行: 全機能を一度に移行せず、段階的な移行を推奨
• 後方互換性: 既存機能との共存を考慮した実装
• エラーハンドリング: クライアントサイドエラーの適切な処理
• セキュリティ: クライアント処理でもセキュリティ配慮が必要

---

最終更新: クライアント・サーバー分離アーキテクチャへの設計変更完了 次のマイルストーン: Phase 2A クライアントサイドエンジン実装開始

⚠️ 重要な注意事項

互換性

• 既存のエディターアシスタント機能との互換性を維持
• 段階的な移行でリスクを最小化
• フィーチャーフラグでの制御推奨

品質保証

• 各フェーズで十分なテストを実施
• パフォーマンス劣化の監視
• エラーハンドリングの検証

---

プロジェクト: GROWI エディターアシスタント改修
作成日: 2025-06-17
最終更新: 2025-06-17 (roo-code調査結果反映)
ステータス: 計画段階
総推定工数: 77時間 (約2-3週間) 総タスク数: 20個