BUSON マニュアル

Appearance

環境変数一覧 ​

フロントエンド環境変数 (.env) ​

bash
# API エンドポイント
VITE_API_ROOT_URL=https://your-api-xxxxx-an.a.run.app

バックエンド環境変数 (.env) ​

bash
# =====================================================
# Supabase
# =====================================================
# SupabaseプロジェクトURL
SUPABASE_URL=https://xxxxx.supabase.co

# Supabaseサービスロールキー（サーバーサイド用）
SUPABASE_SERVICE_ROLE_KEY=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

# Supabase Direct Connection URL（PostgreSQL直接接続用）
SUPABASE_DB_URL=postgresql://postgres:[PASSWORD]@db.xxxxx.supabase.co:5432/postgres

# =====================================================
# Cloudflare Access
# =====================================================
# Cloudflare Accessチームドメイン
CF_ACCESS_TEAM_DOMAIN=yourcompany.cloudflareaccess.com

# Cloudflare Access Application Audience Tag
CF_ACCESS_AUD=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# =====================================================
# Server
# =====================================================
PORT=3000
NODE_ENV=development

# 公開スケジュールAPIの緊急停止（true で POST/DELETE を停止）
PUBLIC_SCHEDULE_MUTATIONS_DISABLED=false

# 緊急遮断する public_token（カンマ区切り）
PUBLIC_TOKEN_BLOCKLIST=

# Slack通知Webhook URL（未設定なら送信スキップ）
SLACK_WEBHOOK_URL=

# Slack通知でメンションするユーザーID（カンマ区切り・任意）
# 例: U01234567,U07654321
SLACK_MENTION_USER_IDS=

# /mypage の空き時間登録通知の送信先（未設定なら SLACK_WEBHOOK_URL を使う）
SLACK_SCHEDULE_WEBHOOK_URL=

# 上記通知でメンションする業務側ユーザーID（カンマ区切り・任意）
# SLACK_MENTION_USER_IDS にはフォールバックしない（エラー通知の宛先と分離するため）
SLACK_SCHEDULE_MENTION_USER_IDS=

# 管理画面のベースURL（Slack通知の求職者詳細リンク用・未設定ならリンクを省略）
# 例: https://buson.example.com
APP_BASE_URL=

GitHub Secrets一覧 ​

GCP関連 ​

Secret名説明例
GCP_PROJECT_IDGCPプロジェクトIDagent-management-12345
GCP_REGIONCloud Runリージョンasia-northeast1
GCP_SERVICE_NAMECloud Runサービス名agent-management-api
GCP_WORKLOAD_IDENTITY_PROVIDERWorkload Identity Providerprojects/123456/locations/global/workloadIdentityPools/github-pool/providers/github-provider
GCP_SERVICE_ACCOUNTサービスアカウントメールgithub-actions-deployer@project-id.iam.gserviceaccount.com

Supabase関連 ​

Secret名説明例
SUPABASE_URLSupabaseプロジェクトURLhttps://xxxxx.supabase.co
SUPABASE_SERVICE_ROLE_KEYサービスロールキーeyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
SUPABASE_DB_URLDirect Connection URLpostgresql://postgres:xxx@db.xxxxx.supabase.co:5432/postgres

Cloudflare Access関連 ​

Secret名説明例
CF_ACCESS_TEAM_DOMAINチームドメインyourcompany.cloudflareaccess.com
CF_ACCESS_AUDApplication Audience Tagxxx...

Cloudflare Pages関連 ​

Secret名説明例
CLOUDFLARE_API_TOKENCloudflare APIトークンxxx...
CLOUDFLARE_ACCOUNT_IDCloudflareアカウントIDxxx...
CLOUDFLARE_PROJECT_NAMEPagesプロジェクト名agent-management-frontend

API関連 ​

Secret名説明例
VITE_API_ROOT_URLCloud RunサービスURLhttps://agent-management-api-xxxxx-an.a.run.app

通知関連 ​

Secret名説明例
SLACK_WEBHOOK_URLSlack Incoming Webhook URL（任意）https://hooks.slack...
SLACK_MENTION_USER_IDSSlack通知でメンションするユーザーID（カンマ区切り）U01234567,U07654321
SLACK_SCHEDULE_WEBHOOK_URL/mypage 空き時間登録通知の送信先（未設定なら SLACK_WEBHOOK_URL）https://hooks.slack...
SLACK_SCHEDULE_MENTION_USER_IDS空き時間登録通知でメンションする業務側ユーザーIDU01234567,U07654321
APP_BASE_URLSlack通知に載せる管理画面のベースURLhttps://buson.example.com

Resume Converter連携 ​

変数名説明例
RESUME_CONVERTER_API_URLresume-converterバックエンドのURLhttp://localhost:5000

取得場所まとめ ​

Supabase ​

  1. Supabase Dashboard にログイン
  2. プロジェクト選択 → Settings → API
    • Project URL → SUPABASE_URL
    • service_role key → SUPABASE_SERVICE_ROLE_KEY
  3. Settings → Database
    • Connection string (URI) → SUPABASE_DB_URL

Cloudflare Access ​

  1. Cloudflare Zero Trust Dashboard にログイン
  2. Settings → General
    • Team domain → CF_ACCESS_TEAM_DOMAIN
  3. Access → Applications → 対象アプリ → Overview
    • Application Audience (AUD) Tag → CF_ACCESS_AUD

Cloudflare Pages ​

  1. Cloudflare Dashboard にログイン
  2. 右サイドバー → Account ID → CLOUDFLARE_ACCOUNT_ID
  3. My Profile → API Tokens → Create Token
    • 「Edit Cloudflare Workers」テンプレートを使用 → CLOUDFLARE_API_TOKEN

GCP ​

  1. Google Cloud Console にログイン
  2. プロジェクト選択
    • プロジェクトID → GCP_PROJECT_ID
  3. Cloud Run → サービスURL → VITE_API_ROOT_URL
  4. IAM → Workload Identity Federation → Provider名 → GCP_WORKLOAD_IDENTITY_PROVIDER
  5. IAM → Service Accounts → メールアドレス → GCP_SERVICE_ACCOUNT