# Phase 1: Brain 本文全文保存 — Synology 側 実施手順（コピペ用） **目的**: Reader から送られた本文を Brain API が受け取り DB に保存し、AI 分析で本文を使うようにする。 **前提**: Synology NAS に SSH で接続できること。Brain API と PostgreSQL がすでに動いていること。 **補足**: Synology の「Container Manager」は従来の「Docker」パッケージの後継です。中身は同じなので、SSH では `docker` コマンドが使えます。 --- ## あなたの環境（docker ps の結果）について | コンテナ名 | イメージ | 用途の目安 | |---------------|-----------------|--------------------| | **posimai_api** | node:20-slim (8090) | **Brain API** の可能性が高い | | **gitea_db** | postgres:15 | **Gitea 用** PostgreSQL（Brain 用ではない） | | その他 | gitea, mcp_server, uptime-kuma 等 | - | **Brain 専用の PostgreSQL コンテナは一覧にありません。** - **posimai_api** が Brain API で、その中で **SQLite** や **別の DB** を使っている場合は、手順 1 の「PostgreSQL に接続」は**そのままでは使えません**。 - まず **posimai_api（Brain API）のコードや設定**を確認し、「どの DB に接続しているか」を把握する必要があります。 **進め方の目安** 1. **Brain 用に PostgreSQL を別コンテナで用意している場合** → そのコンテナ名で手順 1 の「1-3. PostgreSQL に接続」を実行し、手順 1 → 2 の順で実施。 2. **Brain が SQLite など PostgreSQL 以外を使っている場合** → **手順 1 はいったん飛ばし、手順 2（API のコード修正）だけ先に実施**してください。 保存処理で `full_text` を扱うようにし、使っている DB のスキーマに `full_text` カラム（または相当の項目）を後から追加する形になります。 （SQLite なら、posimai_api のプロジェクト内のマイグレーションや、DB ファイルを開いて `ALTER TABLE` する方法などがあります。） 3. **どこに DB があるか分からない場合** posimai_api の設定ファイル（例: `.env` / `config.js` / 環境変数）や、ソース内の `pool` / `createPool` / `sqlite` などの記述を確認すると、接続先が分かります。 --- ## 手順 1: データベースにカラムを追加する（Brain が PostgreSQL を使っている場合のみ） ### 1-1. Synology に SSH 接続 ```bash ssh admin@posimai-lab.tail72e846.ts.net ``` （パスワードを聞かれたら入力。ユーザー名が `mai` の場合は `ssh mai@posimai-lab.tail72e846.ts.net`） ### 1-2. コンテナ名を確認する（重要） 手順書の `posimai-brain-postgres` は**例**です。お使いの環境ではコンテナ名が違う場合があります。 **方法A: コマンドで一覧を表示** ```bash docker ps ``` 表示された一覧の「NAMES」列で、PostgreSQL のコンテナ名を確認してください（例: `postgres` / `brain-postgres` / `synology-postgres` など）。 **方法B: DSM の Container Manager で確認** 1. DSM にログイン → **Container Manager** を開く 2. 「コンテナ」一覧で、PostgreSQL または Brain 用 DB のコンテナを探す 3. コンテナ名（名前の列）をメモする **次の 1-3 で使うコマンドの `コンテナ名` を、上で確認した名前に置き換えてください。** ### 1-3. PostgreSQL に接続 **Container Manager（Docker）で PostgreSQL を動かしている場合:** ```bash docker exec -it コンテナ名 psql -U brain_user -d brain_db ``` - `コンテナ名` を 1-2 で確認した名前に置き換えます。 - 例: コンテナ名が `postgres` なら `docker exec -it postgres psql -U brain_user -d brain_db` - ユーザー名・DB 名（`brain_user` / `brain_db`）が違う場合は、実際の設定に合わせて変更してください。 **PostgreSQL を Docker 以外で動かしている場合（NAS に直接インストール等）:** ```bash psql -U brain_user -d brain_db ``` ### 1-4. 以下の SQL をそのままコピーして貼り付け、Enter で実行 ```sql -- full_text カラムを追加（本文全文） ALTER TABLE articles ADD COLUMN IF NOT EXISTS full_text TEXT; -- オプション: 画像用（将来用） ALTER TABLE articles ADD COLUMN IF NOT EXISTS images TEXT[]; -- 更新日時用 ALTER TABLE articles ADD COLUMN IF NOT EXISTS updated_at TIMESTAMP DEFAULT NOW(); -- 確認（articles の構造が表示されればOK） \d articles ``` `\d articles` の結果に `full_text` が含まれていれば成功です。 ### 1-5. PostgreSQL を終了 ```bash \q ``` --- ## 手順 2: Brain API のコードを修正する **posimai_api** が Brain API の場合、そのコンテナで動いているコード（NAS 上でマウントしているフォルダ内の `server.js` など）を編集します。 Brain API の `server.js`（またはルーターを定義しているファイル）を編集します。 **編集する場所の目安:** - `POST /save` または `POST /brain/api/save` を処理しているブロック - `GET /articles` または `GET /brain/api/articles` を処理しているブロック ### 2-1. POST /save の置き換え **いまの `post('/save', ...)` ～ そのブロックの終わりまで** を、以下で**まるごと置き換え**してください。 ```javascript // POST /save — Reader から url, title, content, source を受け取り本文を保存 app.post('/save', authMiddleware, async (req, res) => { const { url, title, content, source } = req.body || {}; if (!url || !title) { return res.status(400).json({ error: 'Missing required fields: url and title' }); } try { let fullText = content || null; let meta = {}; if (!fullText || fullText.trim().length === 0) { meta = await fetchOGP(url); // 既存の OGP 取得関数 fullText = meta.desc || ''; } else { meta = await fetchOGP(url); } const ai = await analyzeWithGemini(title, fullText, url); // 第2引数を fullText に変更 const result = await pool.query(` INSERT INTO articles (user_id, url, title, full_text, summary, topics, source, reading_time, favicon, og_image, status, created_at, updated_at) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, 'inbox', NOW(), NOW()) ON CONFLICT (user_id, url) DO UPDATE SET title = EXCLUDED.title, full_text = EXCLUDED.full_text, summary = EXCLUDED.summary, topics = EXCLUDED.topics, reading_time = EXCLUDED.reading_time, favicon = EXCLUDED.favicon, og_image = EXCLUDED.og_image, updated_at = NOW() RETURNING id `, [req.userId, url, title, fullText, ai.summary, ai.topics, source || 'reader', ai.readingTime, meta.favicon || null, meta.ogImage || null]); const articleId = result.rows[0].id; return res.json({ success: true, articleId, fullTextSaved: !!fullText, textLength: fullText?.length || 0 }); } catch (error) { console.error('[Brain API] Save failed:', error); return res.status(500).json({ error: 'Failed to save article', message: error.message }); } }); ``` **あわせて確認すること:** - `analyzeWithGemini` の**第2引数**を、これまでの「短い説明」ではなく **本文全文（fullText）** に変更する。 - `fetchOGP` はそのまま利用して問題ありません。 ### 2-2. GET /articles の置き換え **いまの `get('/articles', ...)` ～ そのブロックの終わりまで** を、以下で**まるごと置き換え**してください。 ```javascript // GET /articles — 一覧取得時に full_text も返す（Brain UI で本文表示するため） app.get('/articles', authMiddleware, async (req, res) => { try { const { rows } = await pool.query(` SELECT id, url, title, full_text, summary, topics, source, reading_time, favicon, og_image, status, created_at, updated_at FROM articles WHERE user_id = $1 ORDER BY created_at DESC `, [req.userId]); return res.json({ articles: rows.map(row => ({ id: row.id, url: row.url, title: row.title, fullText: row.full_text, summary: row.summary, topics: row.topics, source: row.source, readingTime: row.reading_time, favicon: row.favicon, ogImage: row.og_image, status: row.status, createdAt: row.created_at, updatedAt: row.updated_at })) }); } catch (error) { console.error('[Brain API] Failed to fetch articles:', error); return res.status(500).json({ error: 'Failed to fetch articles', message: error.message }); } }); ``` **注意:** お使いのコードが `app` ではなく `router` の場合は、上記の `app.post` / `app.get` を `router.post` / `router.get` に読み替えてください。 --- ## 手順 3: API サーバーを再起動する **Docker で Brain API を動かしている場合:** ```bash docker restart posimai-brain-api docker logs -f posimai-brain-api ``` ログにエラーが出ていなければ成功です。`Ctrl+C` でログ表示を終了できます。 **Docker を使っていない場合:** Brain API を起動している方法（systemd や手動実行など）に合わせて再起動してください。 --- ## 手順 4: 動作確認 1. **Reader** で記事を開き、「Brainに保存」を押す。 2. ブラウザの開発者ツール（F12）の「ネットワーク」で、`/save` へのレスポンスを確認する。 - `fullTextSaved: true` かつ `textLength` が数百以上なら、本文が送れて保存されています。 3. **Brain** の一覧を開き、該当記事の「本文を読む」が出ていれば、API と DB の対応は問題ありません。 --- ## うまくいかないとき - **「column full_text does not exist」** → 手順 1 の SQL が実行されていないか、別の DB を見ている可能性があります。もう一度 1-2～1-4 を実行してください。 - **「analyzeWithGemini is not a function」** → `analyzeWithGemini` の定義で、第2引数が「本文」になるように変更してください（従来の短い説明用引数を fullText に変更）。 - **Reader から保存しても Brain に反映されない** → Synology の Brain API のログ（`docker logs posimai-brain-api`）でエラーが出ていないか確認してください。 --- **次のステップ:** Brain のフロント（Vercel など）は、すでに「本文を読む」で保存済み本文を表示できるように修正済みです。Synology 側の上記対応が完了すれば Phase 1 は完了です。