105 lines
2.4 KiB
Markdown
105 lines
2.4 KiB
Markdown
|
# Ponshu Room AI Proxy Server
|
|||
|
|
|
|||
|
|
## 概要
|
|||
|
|
|
|||
|
|
Ponshu Room Liteアプリのバックエンドプロキシサーバー。Gemini APIへのリクエストを中継し、以下の機能を提供します：
|
|||
|
|
|
|||
|
|
### 主な機能
|
|||
|
|
|
|||
|
|
1. **APIキー保護**
|
|||
|
|
- アプリにAPIキーを埋め込まない
|
|||
|
|
- サーバー側で環境変数として管理
|
|||
|
|
|
|||
|
|
2. **デバイスID認証**
|
|||
|
|
- SHA256ハッシュ化されたデバイスIDで認証
|
|||
|
|
- 未登録デバイスのアクセスを制限可能（将来実装）
|
|||
|
|
|
|||
|
|
3. **レート制限**
|
|||
|
|
- 1デバイスあたり1日10回まで（Lite版）
|
|||
|
|
- Pro版では無制限に拡張可能
|
|||
|
|
|
|||
|
|
4. **使用状況ログ**
|
|||
|
|
- JSON形式で使用履歴を記録
|
|||
|
|
- 30日以上前のデータは自動削除
|
|||
|
|
|
|||
|
|
## 技術スタック
|
|||
|
|
|
|||
|
|
- **言語**: Python 3.11
|
|||
|
|
- **フレームワーク**: FastAPI
|
|||
|
|
- **HTTPクライアント**: httpx
|
|||
|
|
- **デプロイ**: Docker
|
|||
|
|
|
|||
|
|
## エンドポイント
|
|||
|
|
|
|||
|
|
### `GET /`
|
|||
|
|
ヘルスチェック
|
|||
|
|
|
|||
|
|
### `GET /health`
|
|||
|
|
詳細なヘルスチェック（APIキー設定状況など）
|
|||
|
|
|
|||
|
|
### `POST /analyze`
|
|||
|
|
日本酒ラベル画像を解析
|
|||
|
|
|
|||
|
|
**リクエスト:**
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"device_id": "sha256ハッシュ（64文字）",
|
|||
|
|
"images": ["base64エンコードされた画像1", "画像2", ...],
|
|||
|
|
"prompt": "カスタムプロンプト（オプション）"
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
**レスポンス:**
|
|||
|
|
```json
|
|||
|
|
{
|
|||
|
|
"success": true,
|
|||
|
|
"data": {
|
|||
|
|
"name": "獺祭 純米大吟醸",
|
|||
|
|
"brand": "旭酒造",
|
|||
|
|
"prefecture": "山口県",
|
|||
|
|
...
|
|||
|
|
},
|
|||
|
|
"usage": {
|
|||
|
|
"today": 3,
|
|||
|
|
"limit": 10
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### `GET /usage/{device_id}`
|
|||
|
|
デバイスの使用状況を取得
|
|||
|
|
|
|||
|
|
## 環境変数
|
|||
|
|
|
|||
|
|
| 変数名 | 説明 | デフォルト |
|
|||
|
|
|--------|------|-----------|
|
|||
|
|
| `GEMINI_API_KEY` | Gemini API Key | (必須) |
|
|||
|
|
| `GEMINI_MODEL` | 使用するモデル | `gemini-1.5-flash` |
|
|||
|
|
| `RATE_LIMIT_PER_DAY` | 1日あたりの制限 | `10` |
|
|||
|
|
|
|||
|
|
## データ保存
|
|||
|
|
|
|||
|
|
- 使用状況: `/app/data/usage.json`
|
|||
|
|
- 30日以上前のデータは自動削除
|
|||
|
|
|
|||
|
|
## セキュリティ
|
|||
|
|
|
|||
|
|
- デバイスIDはSHA256ハッシュ化されたもののみ受け入れ
|
|||
|
|
- CORS設定でオリジン制限可能
|
|||
|
|
- APIキーは環境変数で管理（コードに埋め込まない）
|
|||
|
|
|
|||
|
|
## ローカルでのテスト
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 依存関係インストール
|
|||
|
|
pip install -r requirements.txt
|
|||
|
|
|
|||
|
|
# 環境変数設定
|
|||
|
|
export GEMINI_API_KEY="YOUR_API_KEY"
|
|||
|
|
|
|||
|
|
# サーバー起動
|
|||
|
|
python server.py
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
http://localhost:8080 でアクセス可能
|