セットアップチェックリスト（人間がやること）

MVPを動かすために人間が手動で設定・準備する必要がある項目の一覧。

1. サーバー環境変数

server/.env を作成する（server/.env.example をコピーして編集）。

DATABASE_URL=postgres://user:password@host:5432/dbname
JWT_SECRET=ランダムな長い文字列（openssl rand -hex 32 等で生成）
LINE_CHANNEL_ID=LINEデベロッパーコンソールのチャネルID
LINE_CHANNEL_SECRET=LINEデベロッパーコンソールのチャネルシークレット
LINE_CALLBACK_URL=https://your-frontend-url.com/auth/line/callback

変数	説明
`DATABASE_URL`	PostgreSQL 接続 URL
`JWT_SECRET`	JWT 署名キー（必ず秘密にする）32バイト以上推奨
`LINE_CHANNEL_ID`	LINE Login チャネルID
`LINE_CHANNEL_SECRET`	LINE Login チャネルシークレット
`LINE_CALLBACK_URL`	LINE からのリダイレクト先（フロントエンドの `/auth/line/callback`）

2. フロントエンド環境変数

ローカル開発

web/.env を作成する（web/.env.example をコピーして編集）。

VITE_API_URL=/api
VITE_LINE_CHANNEL_ID=LINEデベロッパーコンソールのチャネルID
VITE_LINE_CALLBACK_URL=http://tanomu.localhost:1355/auth/line/callback

ローカル開発では VITE_API_URL=/api とすることで Vite の開発サーバープロキシ経由で API に接続する（web/vite.config.ts のプロキシ設定を参照）。

本番（Cloudflare Pages）

Cloudflare Pages のダッシュボードで以下の環境変数を設定する。

変数	説明
`VITE_API_URL`	バックエンド API のベース URL（例: `https://api.tanomu.example.com`）
`VITE_LINE_CHANNEL_ID`	LINE Login チャネルID
`VITE_LINE_CALLBACK_URL`	本番フロントエンドの `/auth/line/callback` URL

LINE Developers コンソール（https://developers.line.biz/）で設定する。

LINE Login チャネルを作成
「コールバック URL」に LINE_CALLBACK_URL と同じ URL を登録
チャネルを公開状態にする

4. データベースのセットアップ

PostgreSQL サーバーを用意し、スキーマを適用する。

# スキーマ適用（初回・変更時）
cd server && bun run db:push

推奨ホスティング: Supabase、Neon、Railway

5. AIエージェント向け API キー発行

MVP では API キーは手動発行。DB に直接 INSERT する。

-- 1. エージェントを登録
INSERT INTO agents (id, name) VALUES (gen_random_uuid(), 'My Agent');

-- 2. API キーを生成（例: ランダム文字列）
-- キーは `tanomu_` プレフィックスを推奨

-- 3. キーを SHA-256 ハッシュして登録
-- ハッシュ計算例（Node.js）:
-- const hash = createHash('sha256').update('YOUR_RAW_KEY').digest('hex');

INSERT INTO api_keys (id, agent_id, key_hash)
VALUES (gen_random_uuid(), '<agent_id>', '<sha256_hash_of_key>');

発行したキーをエージェント開発者に渡す（平文キーは一度しか表示できないので記録しておく）。

6. バックエンドのホスティング

Hono + Bun のサーバーをホストする。

推奨:

Fly.io — Dockerfile があれば簡単デプロイ
Railway — DB と一緒に管理しやすい
Render

フロントエンドは Cloudflare Pages で自動デプロイ済み。

7. 確認済み・不要な設定

項目	状況
Cloudflare Pages（フロントエンド）	CI で自動デプロイ済み
SPA ルーティング（_redirects）	設定済み
PWA マニフェスト	設定済み（`vite-plugin-pwa`）
DB スキーマ設計	実装済み（`server/src/db/schema.ts`）
JWT 認証（worker）	実装済み
API キー認証（agent）	実装済み
LINE Login 認証フロー	実装済み