検索

一言でいうと

search は backend 専用モジュールで、frontend に対応する app/modules/search/ は存在しない。ドキュメント・レコードを横断する 全文検索（Postgres の tsvector ベース、同期的・即時）と セマンティック検索（pgvector + HNSW インデックスによるベクトル類似検索、非同期・週次バッチ）の2系統を提供し、frontend 側はヘッダー検索やAI エージェントの MCP tool から都度呼び出すクライアントの立場になる。

主要ドメイン概念

Backend 構造

• api/controller/: SearchController（POST /api/v1/search — 認証済みユーザー向け全文+セマンティック検索）、SearchPublicController / SearchFileUploadPublicController（公開デモ用の検索・ファイルアップロード API）、EmbeddingController（POST /reindex・/reindex/workspace・/reindex/folder — 管理者向け手動再インデックス）
• domain/service/: SearchService（FullTextSearchPort を各エンティティソースに委譲し、結果をデデュープ・権限フィルタしてマージする）、SemanticSearchService（ベクトル類似検索）、DocumentEmbeddingService / EmbeddingIndexingService（埋め込み生成・キュー処理）
• domain/model/: DocumentEmbedding・EmbeddingIndexQueueEntry・SearchModels
• domain/port/: FullTextSearchPort
• infrastructure/listener/: DocumentCreatedEnqueueListener（DocumentNodeChangedEvent の CREATED/CONTENT_CHANGED を購読し、親ワークスペースの semantic_search_enabled が真ならエンキューするだけ。LLM 呼び出しはしない）
• infrastructure/scheduler/: EmbeddingQueueWorker（既定は週次 cron でキューを消化し実際に埋め込みを生成。BudgetEnforcer でテナントごとのAI予算に従う）、DemoSearchCleanupScheduler

Frontend からの呼び出し元

frontend 専用モジュールはなく、以下のように各所から POST /api/v1/search を直接叩く。

• foundation/composables/navigation/useHeaderSearch.ts → layouts/components/header/HeaderSearch.vue（ヘッダーのグローバル検索。searchContent（本文全文検索）はデフォルトOFFで、ONにすると RECORD タイプのヒットが有効になる）
• AI エージェント側は MCP tool 経由で検索を呼ぶ（core/mcp/infrastructure/tools/SearchMcpTools.kt・SemanticSearchMcpTools.kt）— チャット中の「〜を探して」に相当する操作はここを通る

他モジュールとの辺

• editor: DocumentCreatedEnqueueListener がドキュメントツリーの変更イベントを購読し、セマンティック検索インデックスをエンキューする
• ai: セマンティック検索の埋め込み生成には BudgetEnforcer（AI予算管理）が絡み、MCP tool 経由でAIエージェントから呼ばれる
• workspace: セマンティック検索はワークスペース単位の opt-in（semantic_search_enabled）