
# 🐳 Synology NAS 構築ガイド (Phase 2A: AI Factory Setup)

このドキュメントは、「Ponshu Room」開発環境をSynology NAS上に構築するための手順書です。
**共同開発者（インフラ担当）向け** の内容となっています。

## 🎯 目標 (Phase 2A)
1.  **Gitea** の構築（ローカルGitサーバー）
2.  **PostgreSQL** の構築（Gitea用DB）
3.  **MCP Server** の枠組み構築（AIエージェント接続用）

---

## 🛠️ 事前準備 (Prerequisites)
以下のアプリがSynology NASにインストールされていることを確認してください。
*   **Container Manager** (旧 Docker)
*   **Text Editor** (設定ファイル修正用)
*   **File Station**

## 📂 デプロイ手順

### Step 1: ファイルの配置
File Stationを使用し、以下のディレクトリ構造を作成・配置してください。
推奨パス: `/docker/ponshu_factory`

```
/docker/ponshu_factory/
├── docker-compose.yml  <-- リポジトリ内の tools/synology/docker-compose.yml をコピー
├── gitea/              <-- 自動作成されます（空でOK）
├── postgres/           <-- 自動作成されます（空でOK）
└── mcp/                <-- 自動作成されます（空でOK）
```

### Step 2: docker-compose.yml の確認
`docker-compose.yml` を開き、以下の環境変数を必要に応じて変更してください。
特にパスワードは強固なものに変更することを推奨します。

```yaml
services:
  gitea:
    environment:
       - GITEA__database__PASSWD=your_secure_password # <--- 変更推奨
  
  db:
    environment:
       - POSTGRES_PASSWORD=your_secure_password       # <--- Giteaと同じにする
```

### Step 3: コンテナの起動
Synology **Container Manager** を開きます。
1.  **プロジェクト** タブを選択
2.  **作成** ボタンをクリック
3.  **プロジェクト名**: `ponshu_factory`
4.  **パス**: `/docker/ponshu_factory` を選択
5.  **「docker-compose.ymlを使用してプロジェクトを作成」** を選択し、次へ
6.  設定を確認して **完了** をクリック

### Step 4: 初期設定 (Gitea)
コンテナ起動後、ブラウザで以下にアクセスします。
`http://[NASのIPアドレス]:3000`

1.  初期設定画面が表示されます。
2.  **データベース設定**:
    *   タイプ: `PostgreSQL`
    *   ホスト: `db:5432`
    *   ユーザー: `gitea`
    *   パスワード: (Step 2で設定したもの)
    *   データベース名: `gitea`
3.  **一般設定**:
    *   SSHサーバーのドメイン: `[NASのIPアドレス]`
    *   GiteaのベースURL: `http://[NASのIPアドレス]:3000/`
4.  **管理者アカウントの設定**:
    *   任意の管理者ユーザーを作成してください（例: `admin`）。
5.  **「Giteaをインストール」** をクリック。

---

## 🔒 外部アクセス設定 (Phase 2B準拠)
現在の構成はローカルネットワーク内のみアクセス可能です。
外部（開発者のPC）から安全にアクセスするため、**Cloudflare Tunnel** の導入を推奨します。

### 推奨設定 (Cloudflare Tunnel)
1.  Synology上で `cloudflared` コンテナを追加（または既存のTunnelを使用）。
2.  Tunnel設定で以下をマッピング:
    *   `git.ponshu.room` -> `http://gitea:3000`

---

## 🤝 開発フローへの接続
環境構築が完了したら、以下の情報を開発者（Ponshu Roomチーム）に共有してください。

1.  **Gitea URL**: (例: `http://192.168.1.50:3000` またはTunnel URL)
2.  **管理者アカウント情報**: (安全なチャネルで共有)

これで「AI工場」の基盤は完成です！🚀
