initial_commit

docs/architecture.md

@@ -0,0 +1,49 @@
+# アーキテクチャ概要
+
+## 全体構成
+
+```
+フロントエンド (Vue 3 + TypeScript + Vite, port 5173)
+        ↕ REST / SSE
+バックエンド (FastAPI + Python, port 8000)
+        ↕
+   SQLite (playchat.db)
+        ↕
+   LiteLLM → OpenAI / Anthropic / Ollama (任意のLLM)
+```
+
+## バックエンド
+
+### エントリーポイント
+`app/main.py` — FastAPI インスタンス作成、CORS 設定、DB 初期化、ルーター登録。
+
+### ルーター
+| ファイル | エンドポイント | 役割 |
+|---|---|---|
+| `app/api/chat.py` | `POST /chat/stream` | SSE でストリーミング応答 |
+| `app/api/chat.py` | `GET /chat/sessions` | セッション一覧 |
+| `app/api/chat.py` | `DELETE /chat/sessions/{id}` | セッション削除 |
+| `app/api/memory.py` | `GET /memory/{session_id}` | メモリ一覧 |
+| `app/api/memory.py` | `DELETE /memory/{id}` | メモリ削除 |
+
+### メモリ機構
+- **短期メモリ**: セッション内のすべてのメッセージをコンテキストとして送信
+- **長期メモリ**: メッセージ数が `MEMORY_SUMMARIZE_THRESHOLD`(デフォルト20) を超えると古い半分をLLMで要約し `memories` テーブルに保存
+- 要約はシステムメッセージとして次回以降のコンテキスト先頭に注入される
+
+### LLM 接続
+`app/core/llm.py` が LiteLLM を薄くラップ。モデル名は `DEFAULT_MODEL` 環境変数で制御。
+ローカルの Ollama は `ollama/llama3` のように `ollama/` プレフィックスで指定。
+
+## フロントエンド
+
+### 状態管理
+`src/stores/chat.ts` (Pinia) が全状態を保持:
+- `sessions` — バックエンドから取得したセッション一覧
+- `messages` — 現在セッションの表示用メッセージ配列
+- `isStreaming` — SSE 受信中フラグ
+- `selectedModel` — UI で選択中のモデル
+
+### SSE ストリーミング
+`src/api/client.ts` の `streamChat()` が fetch + ReadableStream で SSE を受信。
+チャンクは3種類: `session_id`（新規セッションID通知）、`chunk`（テキスト断片）、`done`（完了）。