# TelosDB 開発ガイド (Development Guide)

## 日本語 (Japanese)

本ドキュメントは、TelosDB エンジンのビルド、拡張、および内部構造に関する技術的なガイドラインを提供します。

### 1. ディレクトリ構造

- `src/frontend/`: React/Vite ベースの UI コンポーネント。
- `src/backend/`: Rust/Tauri ベースのコアエンジンおよび MCP サーバー。
- `docs/specification/`: システム仕様書（DB、API、UIデザイン等）。
- `.agent/rules/`: AI エージェント用プロジェクト運用ルール。

### 2. バックエンド開発

- **データベース**: `sqlite-vec` を利用したベクトル検索および LSA による次元圧縮を実装しています。
- **MCP サーバー**: `mcp.rs` にて外部ツール（Claude 等）向けのインターフェースを定義しています。
- **次元圧縮 (LSA)**: `lsa.rs` にて SVD を用いたベクトルの次元圧縮を行い、検索の高速化と精度向上を実現しています。

### 3. フロントエンド開発

- **通信**: Tauri の `invoke` および `listen` を用いてバックエンドと非同期通信を行います。
- **UI コンポーネント**: Vanilla CSS および一部の現代的な CSS 手法を用いた、プレミアムな UI デザインを採用しています。

---

## English

This document provides technical guidelines for building, extending, and understanding the internal structure of the TelosDB engine.

### 1. Directory Structure

- `src/frontend/`: React/Vite-based UI components.
- `src/backend/`: Rust/Tauri-based core engine and MCP server.
- `docs/specification/`: System specifications (DB, API, UI design, etc.).
- `.agent/rules/`: Project operational rules for AI agents.

### 2. Backend Development

- **Database**: Implements vector search using `sqlite-vec` and dimensionality reduction via LSA (Latent Semantic Analysis).
- **MCP Server**: Defines interfaces for external tools (e.g., Claude) in `mcp.rs`.
- **Dimensionality Reduction (LSA)**: Performs vector compression using SVD in `lsa.rs` to improve search speed and accuracy.

### 3. Frontend Development

- **Communication**: Uses Tauri's `invoke` and `listen` for asynchronous communication with the backend.
- **UI Components**: Employs premium UI design utilizing Vanilla CSS and modern CSS techniques.
