# システム概要 (System Overview)

## 1. 目的と位置づけ

**TelosDB** は、プライバシーを重視したローカル専用の**意味検索（セマンティック検索）基盤**です。データは一切クラウドに送らず、Windows 上で完結します。

- **プライバシー**: 文書・ベクトルはローカルのみ。外部 API 不要。
- **2 エディション**: **Community 版**（LSA・モデル不要）と **Pro 版**（日本語埋め込みモデル・高精度検索）を同一リポジトリからビルドで切り替え。
- **MCP 対応**: Model Context Protocol に準拠し、Cursor や Claude Desktop 等から「ツール」として利用可能。

## 2. エディション

| 項目 | Community 版 | Pro 版 |
|------|--------------|--------|
| **ベクトル化** | LSA（50 次元、SVD）。モデルファイル不要。 | 埋め込みモデル（768 次元、ONNX）。sentence-BERT 系日本語モデル。 |
| **検索** | キーワード＋意味検索。短い語句・自然文どちらも可。 | 同上。言い回しの違いに強い。 |
| **起動** | `npm run dev` / インストーラ `TelosDB-Community_*` | `npm run dev:pro` / インストーラ `TelosDB-Pro_*`（要 `embedding_model/`） |
| **依存** | 軽量（LSA のみ）。GPU 不要。 | ONNX 実行系（tract または ort）。GPU 不要。 |

## 3. 主要機能

- **セマンティック検索**: クエリをベクトル化し、類似度でランキング。結果は文書単位で結合して返すオプションあり。
- **MCP サーバー**: ポート 3001 で SSE。`search_text`・`add_item_text`・`update_item`・`delete_item`・`get_item_by_id`・`list_documents`・`list_categories`・`get_document_count`・`get_document`・`delete_document`・`lsa_retrain`（RE-INDEX）等。
- **セルフヒーリング**: テキストと FTS/ベクトルの不整合を検出し、起動時・手動 heal で同期。
- **常駐 UI**: システムトレイ常駐。検索・文書管理・設定。エディション表示（Community / Pro）。

## 4. 動作環境

- **OS**: Windows 10/11 (64-bit)
- **CPU**: 一般的な PC。GPU 不要。
- **Pro 版**: `embedding_model/` に `model_quantized.onnx` と `vocab.txt` を配置（sentence-BERT 系）。

## 5. 関連仕様

- アーキテクチャ・プロセス構成: **02_architecture_design.md**
- データベース・検索アルゴリズム: **03_database_specification.md**
- MCP・API 詳細: **04_mcp_api_specification.md**
- ビルド・開発: **05_development_guide.md**
- Pro 埋め込みの技術詳細: **07_embedding_tract.md**
