# Gitea API トークン設定ガイド

**作成日**: 2026-02-23
**対象**: Ponshu Room APK自動配布システム

---

## 🎯 **目的**

Gitea APIトークンを発行し、APKビルド後に自動でGiteaリリースを作成する仕組みを構築する。

---

## 📋 **設定手順**

### **Step 1: Gitea設定画面を開く**

1. ブラウザで `http://100.76.7.3:3000` にアクセス
2. ログイン (maita)
3. 右上のアイコンをクリック → **「設定」**
4. 左サイドバーから **「アプリケーション」** をクリック

---

### **Step 2: 新しいトークンを生成**

**アクセストークンの管理** セクションで:

#### **1. トークン名を入力**

```
トークン名: ponshu-deploy
```

**理由**:
- 既存の `cursor-deploy` とは別に管理
- 日本酒アプリ専用のトークン
- セキュリティの原則: 最小権限

#### **2. リポジトリと組織へのアクセス**

```
● すべて（公開、プライベート、限定）
```

**選択理由**:
- `ponshu_room_lite` リポジトリにアクセスするため
- 今後、プライベートリポジトリに変更する可能性があるため

#### **3. 許可の選択**

**「▶ 許可の選択」をクリックして展開**

以下の権限**のみ**を有効化:

| カテゴリ | 権限 | 理由 |
|---------|------|------|
| **repository** | **読み取り・書き込み** ✅ | リリース作成・APKアップロードに必須 |
| issue | なし ❌ | 不要 |
| package | なし ❌ | 不要 |
| organization | なし ❌ | 不要 |
| notification | なし ❌ | 不要 |
| user | なし ❌ | 不要 |
| misc | なし ❌ | 不要 |

**セキュリティ上の理由**:
- `repository: 書き込み` だけで、以下が可能:
  - リリースの作成
  - APKファイルのアップロード
  - リリースノートの編集
- 他の権限は不要 → 最小権限の原則

---

### **Step 3: トークンを生成してコピー**

1. **「トークンを生成」ボタンをクリック**

2. **画面に表示されるトークンをコピー**
   ```
   例: gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   ```

⚠️ **重要**:
- このトークンは**一度しか表示されません**
- 必ずコピーしてください
- 紛失した場合は、トークンを削除して再発行が必要

---

### **Step 4: トークンを .env に保存**

1. プロジェクトルートの `.env` ファイルを開く
   ```
   C:\Users\maita\posimai-project\ponshu_room_lite\.env
   ```

2. `GITEA_TOKEN` の値を、コピーしたトークンに置き換える
   ```bash
   # 変更前
   GITEA_TOKEN=YOUR_GITEA_TOKEN_HERE

   # 変更後 (実際のトークンを貼り付け)
   GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
   ```

3. 保存する

---

### **Step 5: 設定確認**

`.env` ファイルの内容を確認:

```bash
# Gitea API トークン
GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  # ← 実際のトークン

# Gitea サーバー設定
GITEA_URL=http://100.76.7.3:3000
GITEA_OWNER=maita
GITEA_REPO=ponshu_room_lite

# APKビルド設定
MAITA_API_KEY=AIzaSyDjPZGOHy-xAstpLks081SIbUdTyb_iJpU
EIJI_API_KEY=AIzaSyBEwmTa9_2aiRrwr1mXE7Qriw8mIg1xr0U
```

---

## 🔒 **セキュリティ注意事項**

### **1. .env ファイルの取り扱い**

✅ **安全**:
- `.env` は `.gitignore` に登録済み
- Gitにコミットされません
- ローカルPCにのみ保存

❌ **絶対にやってはいけないこと**:
- `.env` をGitにコミット
- トークンをSlack/メールで共有
- スクリーンショットに含める

### **2. トークンの管理**

**トークンを再発行する場合**:
1. Gitea → 設定 → アプリケーション
2. 古いトークンを削除
3. 新しいトークンを生成
4. `.env` を更新

**トークンが漏洩した場合**:
1. **即座に削除** (Gitea設定画面から)
2. 新しいトークンを再発行
3. `.env` を更新
4. 全てのビルドスクリプトを再実行

---

## 🧪 **動作確認**

### **PowerShellで確認**

```powershell
# .env ファイルが存在するか確認
Test-Path .env

# .env の内容を確認 (トークンが設定されているか)
Get-Content .env | Select-String "GITEA_TOKEN"
```

**期待される出力**:
```
GITEA_TOKEN=gta_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
```

---

## 📦 **次のステップ**

トークン設定が完了したら、Antigravityに実装を依頼してください:

```
トークンを .env に保存しました。

次の実装をお願いします:
1. build_all_apks.ps1 にGitea API連携を追加
2. ビルド完了後、自動でGiteaリリース作成
3. APKファイルを自動アップロード
4. 動作確認スクリプトの作成
```

---

## 🔄 **自動化フロー (完成後)**

```bash
# 1回のコマンドで全て完了
.\build_all_apks.ps1

# ↓ 自動実行される処理
# 1. APK 4本をビルド
# 2. Gitea にリリース作成 (例: v1.0.16)
# 3. APK 4本をリリースにアタッチ
# 4. リリースノートを自動生成
# 5. Vercel ダウンロードページが自動更新
```

---

## 📚 **関連ドキュメント**

- [DISTRIBUTION_SUMMARY_2026-02-23.md](./DISTRIBUTION_SUMMARY_2026-02-23.md) - 配布パッケージサマリー
- [FUTURE_DEVELOPMENT_STRATEGY_2026.md](./FUTURE_DEVELOPMENT_STRATEGY_2026.md) - 今後の開発構想
- [../web/download/DEPLOYMENT_GUIDE.md](../web/download/DEPLOYMENT_GUIDE.md) - Vercel配布ページガイド

---

## ❓ **トラブルシューティング**

### **問題1: トークンが見つからない**

**症状**: Gitea設定画面にトークンが表示されない

**解決策**:
```bash
# .env ファイルの内容を確認
cat .env

# GITEA_TOKEN が空の場合は、再度トークン生成
```

### **問題2: 権限エラー**

**症状**: `403 Forbidden` エラー

**原因**: トークンの権限不足

**解決策**:
- Gitea設定画面でトークンを確認
- `repository: 書き込み` が有効か確認
- 無効な場合は、トークンを削除して再発行

### **問題3: .env が読み込まれない**

**症状**: ビルドスクリプトでトークンが見つからない

**解決策**:
```powershell
# .env ファイルの場所を確認
Get-Location
# → C:\Users\maita\posimai-project\ponshu_room_lite であるべき

# .env ファイルの存在確認
Test-Path .env
# → True が返ってくるべき
```

---

**設定完了後、Antigravityに実装を依頼してください!** 🚀