initial_commit

docs/api.md

@@ -0,0 +1,39 @@
+# API リファレンス
+
+ベースURL: `http://localhost:8000`  
+Swagger UI: `http://localhost:8000/docs`
+
+## チャット
+
+### POST /chat/stream
+SSE でストリーミング応答を返す。
+
+**リクエストボディ**
+```json
+{
+  "message": "こんにちは",
+  "session_id": "uuid (省略時は新規セッション作成)",
+  "model": "gpt-4o (省略時は DEFAULT_MODEL)"
+}
+```
+
+**SSEイベント**
+```
+data: {"type":"session_id","value":"<uuid>"}   // 新規セッション時のみ
+data: {"type":"chunk","value":"テキスト断片"}
+data: {"type":"done"}
+```
+
+### GET /chat/sessions
+セッション一覧を `updated_at` 降順で返す。
+
+### DELETE /chat/sessions/{session_id}
+セッションと紐づくメッセージ・メモリをすべて削除。
+
+## メモリ
+
+### GET /memory/{session_id}
+セッションの長期メモリ（要約）一覧を返す。
+
+### DELETE /memory/{memory_id}
+特定のメモリエントリを削除。

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`（完了）。