card/docs/DATABASE.md

データベース設定ガイド

ローカル開発（Docker Compose）

1. 起動

# データベースとAPIを起動
docker-compose up -d

# ログを確認
docker-compose logs -f

2. データベース初期化

# APIコンテナに入る
docker-compose exec api bash

# マイグレーション実行
alembic upgrade head

# マスタデータ投入
python init_db.py

Supabase連携

1. Supabaseプロジェクト作成

1. Supabaseでプロジェクト作成
2. Settings > Database から接続情報を取得

2. 環境変数設定

# .env
DATABASE_URL_SUPABASE=postgresql+asyncpg://postgres.[project-ref]:[password]@aws-0-[region].pooler.supabase.com:5432/postgres
USE_SUPABASE=true

3. テーブル作成

Supabase SQL Editorで以下を実行：

-- Alembicのマイグレーションを実行
-- または直接SQLでテーブル作成

Cloudflare Tunnel設定

1. トンネル作成

# Cloudflareダッシュボードでトンネル作成
# トークンを取得

2. 環境変数設定

# .env
CLOUDFLARE_TUNNEL_TOKEN=your-tunnel-token

3. 起動

# tunnelプロファイルを含めて起動
docker-compose --profile tunnel up -d

データベーススキーマ

users

• ユーザー情報（DID、ハンドル）

card_master

• カードマスタデータ（16種類）

user_cards

• ユーザー所有カード
• uniqueカードフラグ付き

unique_card_registry

• グローバルuniqueカード登録
• 各カードIDにつき1人のみ所有可能

draw_history

• ガチャ履歴

gacha_pools

• ピックアップガチャ設定

バックアップ

ローカル

# バックアップ
docker-compose exec postgres pg_dump -U postgres aicard > backup.sql

# リストア
docker-compose exec -T postgres psql -U postgres aicard < backup.sql

Supabase

• 自動バックアップが有効
• ダッシュボードからダウンロード可能