SWINGCOMPASS AI — MIGRATION PLAN — 2026.07.26

S3 → R2 移行実行計画Cloudflare 専用アカウント新規作成＋ドメイン DNS 移行＋動画ストレージ移行

決定事項（先に要点）

DECISION — 2026.07.26

動画ストレージを AWS S3 から Cloudflare R2 へ移す。最大の理由は「ダウンロード転送量の課金（エグレス）」が R2 ではゼロになること。動画アプリでは、これが毎月の請求を押し上げる一番の要因になる。
Cloudflare は SwingCompassAI 専用アカウントを新規作成する。course-guides（受講生向けコースガイド）とは分ける。無料枠を食い合わず、請求も事業単位で独立する。
ドメイン swingcompass-ai.com の DNS も Cloudflare へ移す。動画を独自ドメインで配信するには、そのドメインが同じ Cloudflare アカウント内にある必要があるため。
プログラムの書き換えはほぼ不要。ストレージ処理は最初から「S3 互換」で書かれており、接続先の設定（環境変数）を差し替えるだけで R2 に切り替わる。

現状の調査結果

AS-IS

項目	現状	移行後
ストレージ処理のコード	`backend/app/services/storage_s3.py` が S3 互換実装	変更なし
ドメイン `swingcompass-ai.com`	Amazon Registrar 登録 / Route 53 で DNS 管理	DNS を Cloudflare へ（レジストラ移管は任意）
ドメイン `swingcompass.ai`	DNS が引けない＝未取得の可能性	要確認（アプリ内で参照中）
S3 のデータ量	未計測	10GB 未満なら R2 の無料枠内
Cloudflare アカウント	course-guides 用が既存	SwingCompassAI 専用を新規作成

※ swingcompass.ai は frontend/src/lib/share.ts（招待リンク）と legal.ts（サポート窓口メール）が参照しています。取得済みかどうかの確認が必要です。

全体の流れ（8ステップ）

ROADMAP

順序が重要です。DNS を先に移さないと、動画配信用の独自ドメイン設定が後戻り作業になります。

Cloudflare 専用アカウント作成

専用メールアドレス・2要素認証・クレジットカード登録（R2 有効化に必須。10GB まで無料）

DNS を Route 53 → Cloudflare

無料・即日。ここが最初の山場

レジストラ移管（任意・後回し可）

ドメインの管理会社そのものを移す。急がない

R2 バケット作成

保存場所は APAC（日本のユーザーに近い）

データ移行

Super Slurper で S3 から一括コピー

環境変数の切替

Vercel と Worker ホストの両方

実機検証

アップロード → 解析 → 再生を通しで確認

AWS 撤収

差分コピー → 様子見 → S3 削除

ステップ1〜2：アカウント作成と DNS 移行

SETUP

DNS とは、ドメイン名（swingcompass-ai.com）を実際のサーバーに結びつける「住所録」です。今はこの住所録を AWS の Route 53 が持っており、それを Cloudflare に引っ越します。

Cloudflare で「サイトを追加」→ swingcompass-ai.com → Free プラン
既存レコードが自動スキャンされる。Route 53 の全レコードと突合して欠落がないか確認（特に Resend のメール認証用 SPF / DKIM、beta. の接続先）
Cloudflare が提示する2つのネームサーバーを控える
Route 53 コンソール →「登録済みドメイン」→ ネームサーバーを編集して貼り替え
伝播確認（通常1〜数時間）。完了したら Route 53 のホストゾーンを削除して月 $0.5 を削減

注意

Cloudflare の「プロキシ（オレンジ色の雲アイコン）」は、最初はオフ（グレー）にしておきます。Vercel 宛のレコードをプロキシすると、SSL 証明書やリダイレクトで不具合が出ることがあります。

ステップ3：レジストラ移管（任意）

OPTIONAL

DNS 移行とは別の作業です。急がないので数ヶ月後でも構いません。Cloudflare Registrar は上乗せ手数料なしの原価提供で、.com も .ai も対応しています。

60日ルール：ドメインの登録または前回の移管から60日以内は移管できません（ICANN の規則）
Route 53 側で ①転送ロックの解除 ②認証コード（auth code）の取得が必要
Cloudflare 側で申請 → 承認まで最大5〜7日

ステップ4〜5：R2 バケットとデータ移行

STORAGE

バケットとは、動画ファイルを入れておく箱のことです。名前は swingcompass、保存場所は APAC を選びます。作成後、読み書き権限を持つ「R2 API トークン」を発行します。

データのコピーは Super Slurper が推奨。Cloudflare 公式の一括コピー機能で、管理画面から AWS のアクセスキーを渡すだけで進捗と失敗件数が見えます。細かく制御したい場合は rclone を使います。

rclone copy s3:swingcompass-prod r2:swingcompass --progress --transfers 16

ステップ6〜7：設定切替と検証

CUTOVER

Vercel（frontend / admin-frontend / API）と Celery Worker ホスト（Fly.io / Railway）の両方に設定します。片方だけだと解析結果が保存されず、原因の分かりにくい不具合になります。

STORAGE_BACKEND=s3
S3_ENDPOINT_URL=https://<ACCOUNT_ID>.r2.cloudflarestorage.com
AWS_REGION=auto
AWS_ACCESS_KEY_ID=<R2 トークンの Access Key>
AWS_SECRET_ACCESS_KEY=<R2 トークンの Secret>
S3_BUCKET_NAME=swingcompass

検証項目：

動画アップロード → 解析パイプライン完走 → 再生
管理画面のファイル一覧
レッスンノートの画像・音声

ステップ8：AWS 撤収

TEARDOWN

差分コピー

切替後に増えた分だけ再コピー

数日〜1週間の様子見

すぐ消さない。不具合が出たら戻せる状態を保つ

S3 バケット削除 → IAM 削除 → アカウント整理

infra/terraform/ の AWS 定義も削除か保存かを判断

別途対応が必要なリスク

RISK

認証情報がコードに平文で残っています。infra/backend-taskdef-no-migration.json にデータベースのパスワードが書かれた状態でコミットされています。AWS 撤収時にそのデータベースごと消えますが、git の履歴には残るため「漏れた認証情報」として扱い、他所で使い回していないか確認してください。
swingcompass.ai の取得状況が不明です。アプリ内の招待リンクとサポートメールアドレスがこのドメインを前提にしています。未取得なら、新しい Cloudflare アカウントで取得すれば R2 の独自ドメイン配信にもそのまま使えます。
アカウントを分けたことによる管理コスト。Cloudflare の管理画面が course-guides 用と2つになります。ログイン情報の管理をパスワードマネージャーで整理しておいてください。

たきコーチへの宿題

NEXT ACTION

やること	場所	備考
Cloudflare 専用アカウント作成	cloudflare.com	専用メール＋2要素認証＋クレカ
S3 のデータ量を確認	AWS マネジメントコンソール	バケット →「メトリクス」タブ
`swingcompass.ai` を持っているか確認	ドメイン購入履歴	未取得なら取得の要否を判断

この3つが揃えば、DNS レコードの突合と環境変数の切替はこちらで進められます。

制約メモ

NOTES

R2 の署名付きURL（一時的な視聴リンク）の有効期限は最大7日。現在の設定は1時間なので問題なし
R2 は下り転送が無料。これが S3 + CloudFront からコストが大きく下がる主因
R2 の無料枠はアカウント単位。専用アカウントにしたことで course-guides 側と枠を食い合わない