アーキテクチャ Architecture

オーナーポータルのクライアントは React + Vite + TypeScript の SPA で、 BFF 側の requireOwner ミドルウェアが owners テーブルを参照し、 「ログインユーザーがオーナー登録済みか」を確認します。 スポット管理・料金グループ・ブースト購入など、駐車場オーナーの自己管理に必要な全機能を提供します。

The owner portal client is a React + Vite + TypeScript SPA. The BFF middleware requireOwner checks the owners table to verify that the authenticated user is a registered owner before allowing access to any protected endpoint. The portal covers everything a parking-lot owner needs to self-manage: spots, pricing groups, applications, review replies, boosts, and credits.

オーナーポータルのチャネル接続 Owner portal channel view

flowchart LR
  OP["Owner Portal
React + Vite
dev-owner.parky.co.jp"]

  subgraph BFF["Cloudflare Workers BFF"]
    MW["requireOwner
middleware"]
    API["/v1/owner/* endpoints"]
    UF["/v1/storage/upload-url
(R2 presign)"]
  end

  subgraph Supabase["Supabase"]
    AUTH["Auth"]
    DB[("PostgreSQL
public schema")]
  end

  subgraph Storage["Object storage"]
    R2["Cloudflare R2
parky bucket"]
    CDN["cdn.parky.co.jp
(public GET)"]
  end

  OP -->|"JWT + request"| MW
  MW -->|"owners テーブル確認"| DB
  MW --> API
  API --> DB
  API --> UF
  UF -->|"presigned URL"| OP
  OP -->|"PUT (image)"| R2
  R2 --> CDN
  OP -->|"認証"| AUTH

requireOwner 認可フロー requireOwner authorization flow

sequenceDiagram
  participant C as Owner Portal (SPA)
  participant B as BFF (Cloudflare Workers)
  participant DB as Supabase DB

  C->>B: リクエスト + Supabase JWT
  B->>B: JWT 検証 (Supabase secret)
  B->>DB: SELECT id FROM public.owners WHERE user_id = $uid
  alt オーナー未登録
    DB-->>B: 0 rows
    B-->>C: 403 Forbidden
  else オーナー登録済み
    DB-->>B: owner_id
    B->>B: ctx.owner = { id, user_id }
    B->>DB: ビジネスロジック実行
    B-->>C: 200 OK
  end

関連テーブル Key tables

オーナー発行・認証フロー (LP → admin → 72h トークン) Owner provisioning & auth flow (LP → admin → 72h token)

2026-04-26 確定の統一フロー。新規招待もパスワードリセットも、72 時間有効な使い捨てトークン付きの「設定リンク」に一本化した。 メール本文に平文パスワードを載せる旧フロー、Supabase invite magic-link 系（/invite/accept）はすべて撤去済み。

Unified flow finalized on 2026-04-26. Both new invites and password resets now run through a single 72-hour single-use "setup link" token. The legacy plaintext-password emails and the Supabase invite magic-link path (/invite/accept) have been fully removed.

sequenceDiagram
  participant Owner as Future owner
  participant LP as LP form
  participant Admin as Admin portal
  participant API as BFF
  participant Email as Resend (email)
  participant OP as Owner portal

  Owner->>LP: 駐車場掲載問い合わせ
  LP->>API: POST /v1/web/owner-inquiries
  Admin->>API: POST /v1/admin/owner-registrations/{id}/approve
  Note over API: Auth user 作成 (placeholder pw)
+ owners + parking_lot_owners 作成
+ token 発行 (SHA-256 hash 保存, 72h)
+ 既存 active を invalidate
  API->>Email: 設定リンクメール送信
(/password-setup?token=<plain>)
  Email-->>Owner: メール受信
  Owner->>OP: リンククリック
  OP->>API: POST /v1/owner-public/password-setup/verify
  API-->>OP: ready (or 410 Gone if expired/used/invalidated)
  Owner->>OP: 新パスワード入力
  OP->>API: POST /v1/owner-public/password-setup/complete
  API-->>OP: 200 (token consume + Supabase Auth pw 更新 + invite 時 owners.status='active')
  Note over OP: 既存セッションは張らず
LoginPage に誘導
  Owner->>OP: メール + 新 PW でログイン
  OP->>API: GET /v1/owner/me (RequireAuth + role check)

エラー監視 (Sentry) Error monitoring (Sentry)

Owner Portal SPA は @sentry/react でフロント側の未処理例外・ErrorBoundary 捕捉・ルーティング Breadcrumb を Sentry に送信します。 DSN は Vite ビルドの環境変数 (VITE_SENTRY_DSN) から注入し、release 識別には git short SHA を使います。 BFF 側 (/v1/owner/*) の 5xx は Workers の toucan-js 連携で別途 capture されるため、SPA からは クライアント発生の例外のみを送る役割分担です。 セットアップ・DSN の入手・release tracking の手順は ops / sentry-setup を参照。

The Owner Portal SPA wires @sentry/react to forward unhandled exceptions, ErrorBoundary captures, and routing breadcrumbs to Sentry. The DSN is injected at Vite build time via VITE_SENTRY_DSN and the git short SHA is used as the release identifier. BFF-side 5xx responses on /v1/owner/* are captured separately through toucan-js on Workers, so the SPA only owns client-originated exceptions. See ops / sentry-setup for DSN provisioning and release-tracking steps.

デプロイ経路 Deployment pipeline