メインコンテンツまでスキップ

α版クローズドリリース実行チェックリスト

最終更新日: 2025-10-20
バージョン: 0.2

目的

クローズド α リリースに向けて、環境構築から QA までを漏れなく実行するためのワンストップ手順書。動作確認・復旧手順・ドキュメント更新を同じフローで管理する。

1. 環境セットアップ

  1. cp supabase/.env.example supabase/.env を実行し、ANON_KEY / SERVICE_ROLE_KEY / JWT_SECRET / SMTP を本番値に更新。
    npm run supabase:upnpm run supabase:logs でコンテナ起動を確認。
  2. Cloudflare Workers の Secrets に SUPABASE_URL(self-hosted PostgREST)と SUPABASE_SERVICE_ROLE_KEY を設定し、npx wrangler publish を実行。
  3. Cloudflare R2(DATA_BUCKET)と Supabase Storage にカード参照ファイルを同期し、Workers Secrets に R2_ACCESS_KEY_ID / R2_ACCESS_KEY_SECRET 等を登録。
  4. GitHub Pages リポジトリ fractale-online/fractale-online.github.io にデプロイ鍵を設定し、Actions もしくは手動で build/ を反映。
  5. .env.production を用意して FRACTALE_API_BASE=https://api.fractale.jp / SUPABASE_URL=https://supabase.alpha.fractale などを設定。ビルド前に読み込ませる。
  6. カスタムドメインを利用する場合は Cloudflare DNS / SSL / Zero Trust を整備(α版中は GitHub Pages URL を継続利用しても可)。

2. データ同期と API 検証

  1. CKAN / DataEye ハーベスト(必要分のみ)
    node scripts/tools/harvest-ckan.js --portal ...
    node scripts/collectors/dataeye/collect-dataeye.js --limit 500
  2. カード生成: npm run build:cards
  3. Supabase 同期: npm run sync:supabase
    • 自動で supabase/.env / .env.local を読み込む。license:* / region:* タグが追加される。
  4. 件数・レスポンス確認
    • psql "$SUPABASE_DB_URL" -c "SELECT count(*) FROM public.datasets;"
    • jq '.total' static/catalog/summary.json
    • curl https://api.fractale.jp/api/v1/datasets?limit=1
    • curl -H "apikey:<ANON_KEY>" -L "https://api.fractale.jp/api/v1/datasets/<id>/download?format=csv" -I

3. フロントエンドビルドとデプロイ

  1. ローカルビルド: npm run build
  2. GitHub Actions または手動で build/fractale-online.github.io へデプロイ
  3. /, /catalog, /datasets/<id> の表示確認
    • 未サインイン状態では認証ガードが表示されること
    • サインイン後はコメントタブが利用できること
    • ダウンロードボタンから署名付き URL 経由でファイル本体を取得できること(CSV 先頭行や件数をスポットチェック)

4. 認証導線と QA

  1. /tokens ページでマジックリンクから Access Token を取得できるか確認。
  2. docs/dev/11_QA_CHECKLIST.md の QA-000〜008 を実施し、結果をテンプレートへ記録。
  3. α テスター招待メールのテンプレートを確認し、alpha@fractale.jp で問い合わせを受け付ける体制を確認。

5. ドキュメント同期

  1. docs/dev/03_DATA_STANDARDS.md: 提供データ件数とライセンス方針を更新。
  2. docs/dev/06_OPERATIONS.md: Supabase OSS / Workers / Pages の運用手順を反映。
  3. docs/dev/11_QA_CHECKLIST.md: QA シナリオやログ採取テンプレートを更新。
  4. docs/dev/12_ALPHA_TASKS.md: 完了項目にチェックを入れ、残タスクを整理。
  5. docs/dev/09_ALPHA_PLAN.md / docs/dev/04_CURRENT_STATUS.md にストリーミング要件と進捗を反映し、README など公開ドキュメントで実データ取得手順を更新。

6. ロールバック / 監視

  1. npm run backup:supabase でバックアップを取得し、復旧手順を docs/dev/06_OPERATIONS.md に追記。
  2. Cloudflare Workers / Pages のデプロイ ID を記録し、切り戻し手順を明文化。
  3. 主要指標(API レスポンス、エラー率、データセット件数)をスプレッドシート等でモニタリング。

付属資料

  • docs/dev/06_OPERATIONS.md: 環境セットアップ詳細
  • docs/dev/11_QA_CHECKLIST.md: QA フロー
  • docs/dev/12_ALPHA_TASKS.md: タスク進捗
  • docs/dev/13_RELEASE_COST.md: インフラコスト試算
  • docs/dev/14_NORMALIZATION_PLAN.md: 正規化運用方針