データモデル Data model

モバイルアプリは管理者ポータル・オーナーポータルと同じ Supabase PostgreSQL データベースを共有します。 そのため、データモデルは 管理者ポータルのデータモデル と完全に同一です。 本ページでは、モバイルアプリから直接読み書きする主要エンティティを中心に整理します。

The mobile app shares the same Supabase PostgreSQL database as the admin and owner portals, so the data model is identical to the admin portal data model. This page focuses on the core entities the mobile app reads from and writes to directly.

7.1 ドメイン俯瞰図 7.1 Domain map

flowchart LR
  subgraph Parking["🅿️ 駐車場ドメイン"]
    PL[parking_lots]
    PLI[parking_lot_images]
    PLT[parking_lot_tags]
    PLPR[parking_lot_pricing_rules]
    PLH[parking_lot_hours]
    PLDO[parking_lot_date_overrides]
    %% parking_lot_attributes (028) と parking_lot_payment_methods (057) は tags に統合済み
    PR[parking_reviews]
    PS[parking_sessions]
  end
  subgraph Users["👤 ユーザー"]
    AU[app_users]
    USP[user_saved_parkings]
    UAL[user_activity_logs]
    US[user_subscriptions]
    UPT[user_push_tokens]
    UN[user_notifications]
    UE[user_exp]
    UB[user_badges]
    UBP[user_badge_progress]
    UT[user_themes]
    UAT[user_active_themes]
  end
  subgraph Game["🏆 ゲーミフィケーション"]
    BD[badge_definitions]
    LD[level_definitions]
    AER[activity_exp_rules]
  end
  subgraph Content["📝 コンテンツ"]
    ART[articles]
    ADS[ads]
    TAG[tags]
    HB[home_banners]
    ER[error_reports]
    ST[support_tickets]
  end
  subgraph Search["🔎 検索関連"]
    UD[user_destinations]
  end
  subgraph Sys["⚙️ マスター"]
    CD[codes]
    SP[subscription_plans]
  end

  PL --> PLI
  PL --> PLT
  PL --> PLPR
  PL --> PLH
  PL --> PLDO
  PL --> PR
  PL --> PS
  AU --> PS
  AU --> PR
  AU --> USP
  AU --> UAL
  AU --> US
  AU --> UPT
  AU --> UN
  AU --> UE
  AU --> UB
  AU --> UBP
  AU --> UT
  AU --> UAT
  AU --> UD
  BD --> UBP
  BD --> UB
  LD --> UE
  US --> SP

7.2 主要テーブル定義（モバイル視点） 7.2 Core table definitions (mobile-centric view)

parking_lots core

駐車場の中核テーブル。座標の SoT は PostGIS の location (geography 4326)。lat/lng は表示用にトリガーで派生。shape_type で point/line/area を切替、code (citext) は自然キー。周辺検索は nearby_parking_lots() RPC を使用。

The core lot table. location is the coordinate SoT; lat/lng are trigger-derived. shape_type selects point/line/area, code (citext) is the natural key. Nearby search uses the nearby_parking_lots() RPC.

parking_lot_pricing_groups core 2026-04-24 new

駐車場内の料金ポリシー集約単位。複数の parking_spots が同一 group を参照することで料金の共有編集が可能。(parking_lot_id, code) で一意。

Pricing-policy aggregation unit inside a lot. Multiple spots can share a group so pricing can be edited in bulk. Unique on (parking_lot_id, code).

parking_spots core 2026-04-24 new

駐車場内の個別車室。parking_sessions.parking_spot_id は NOT NULL なので、セッション作成時には spot を必ず確定させる必要がある。(parking_lot_id, code) で partial UNIQUE (soft delete 考慮)。

Individual parking spot. parking_sessions.parking_spot_id is NOT NULL, so a session always pins to a specific spot. Partial UNIQUE on (parking_lot_id, code) respecting soft delete.

parking_lot_hours core 2026-04-24 updated

駐車場の時間窓。2026-04-24 に window_type カラムを追加、1 行 = 1 種別の時間窓として正規化しました。 モバイルアプリは詳細画面で「営業中」「今すぐ入庫可」「今すぐ出庫可」バッジを表示する際に、Mobile BFF 経由で派生値 (derived.is_open_now / can_enter_now / can_exit_now) を受け取ります。

Time-window rows for a parking lot. 2026-04-24 added window_type. The mobile app receives derived flags (derived.is_open_now / can_enter_now / can_exit_now) from the Mobile BFF rather than evaluating rules client-side.

parking_lot_date_overrides core 2026-04-24 new

特定日のオーバーライド (花火大会・元旦特別営業など)。Mobile BFF は駐車場詳細 API のレスポンスに date_overrides[] を含め、当日の active_override を derived に載せます。 アプリ側では「今日は花火大会のため 12:00 以降のみ入庫可」等のバナー表示に利用。

Per-day override rows. The Mobile BFF returns date_overrides[] and sets derived.active_override for the current day so the app can show banners like "fireworks night — entry after 12:00".

判定の優先順: 日付オーバーライド → 祝日行 (jp_holidays 参照) → 曜日行 → day_type → all。 詳細は 2026-04-24 ADR。

parking_lot_pricing_rules core

料金エンジンのルール。pricing_group_id を必ず持ち、rule_order で優先順、category / day_type / time_start / time_end で条件絞り込み、cap_* で上限を表現する。金額は minor unit の bigint (JPY は 1 倍)。

Fee-engine rules. Each row belongs to a pricing_group_id and is ordered by rule_order; matching uses category / day_type / time_start / time_end; caps via the cap_* family. Money is bigint in minor units (×1 for JPY).

parking_sessions core

モバイルアプリの中心エンティティ。parking_spot_id は NOT NULL で、セッションは必ず特定の spot に紐付く。金額は total_amount_minor (bigint, minor unit)。geo_verified / geo_distance_m で開始時の位置検証、client_request_id で冪等性、fee_mismatch_flag / user_entered_fee_minor でユーザー手入力金額との突合を行う。updated_at / deleted_at は無く、ソフトデリートではなく status='cancelled' + cancelled_reason で運用。

The mobile app's central entity. parking_spot_id is NOT NULL — every session pins to a specific spot. Amount is bigint in minor units. geo_verified / geo_distance_m validate start location, client_request_id enforces idempotency, fee_mismatch_flag reconciles user-entered fees. No updated_at / deleted_at; cancellation is via status='cancelled' + cancelled_reason.

個人評価 (good / bad) は別テーブル parking_lot_ratings でユーザー × 駐車場の M:N として保持する (セッションのカラムでは無い)。レビュー本文は parking_reviews。

Personal ratings (good / bad) live in parking_lot_ratings (user × lot M:N), not as a session column. Full reviews live in parking_reviews.

parking_reviews

駐車場レビュー (UGC)。status='approved' のみ公開表示・集計対象 (parking_lot_avg_rating view が参照)。オーナー返信は owner_reply 系列で保持。画像はこのテーブルに保存せず、別途 assets + parking_session_photos を経由する。

User reviews (UGC). Only status='approved' is publicly visible and counted (parking_lot_avg_rating view). Owner replies live in the owner_reply* columns. Images are not stored on this table — use assets + parking_session_photos.

app_users core

エンドユーザー。auth_user_id で auth.users と 1:1 紐付け、RLS は auth_user_id = auth.uid() で自己行のみ。退会は status='withdrawn' + PII 匿名化で運用 (deleted_at 列は無い)。アバター / 通知設定 / locale は別テーブルで管理する (下表参照)。

End users. Linked 1:1 to auth.users via auth_user_id; RLS limits access to auth_user_id = auth.uid(). Withdrawals are status='withdrawn' + PII anonymization (no deleted_at). Avatar / notification prefs / locale live in separate tables.

付随テーブル: user_notification_prefs (通知種別ごとの push / in_app / email ON-OFF)、user_consents (同意履歴)、user_device_permissions (OS パーミッション現在値)、user_vehicles (登録車両 N 件)、user_search_presets / user_search_preferences、user_referral_codes、user_destinations、user_streaks。 アバター画像は assets テーブルに entity_type='app_user' + entity_id=app_users.id で関連付ける。

Companion tables: user_notification_prefs (per-type push / in_app / email toggles), user_consents, user_device_permissions, user_vehicles, user_search_presets / user_search_preferences, user_referral_codes, user_destinations, user_streaks. Avatar images are stored in assets with entity_type='app_user' + entity_id=app_users.id.

user_notification_prefs notifications

通知種別ごとに push / in_app / email の ON-OFF を保持する。app_users.notification_prefs jsonb 列は存在しない。

Per-notification-type push / in_app / email toggles. There is no app_users.notification_prefs jsonb column.

user_push_tokens

FCM デバイストークン。起動時に upsert し、Push 送信時に参照します。

FCM device tokens. Upserted on app boot and read when sending push notifications.

user_notifications

アプリ内通知の受信箱。Push と同じレコードを ここに INSERT し、Realtime で端末に配信されます。

The in-app notification inbox. The same record that backs a push is INSERTed here and streamed to devices via Realtime.

user_saved_parkings

user_activity_logs

全ての行動イベント。metadata（JSONB）にイベント固有の詳細を保持し、バッジ条件エンジンはこのメタデータをドット記法パスで評価します。

Every activity event. Event-specific detail lives in metadata (JSONB), and the badge condition engine evaluates that metadata via dot-notation paths.

user_exp / level_definitions / activity_exp_rules / badge_definitions / user_badges / user_badge_progress gamification

管理者ポータルと同じゲーミフィケーション基盤を共有。モバイルは書き込みしません（DB トリガ・Cloudflare Workers 経由で自動更新）。

Shares the same gamification stack as the admin portal. The mobile app never writes to it directly — updates are driven by DB triggers and Cloudflare Workers.

user_subscriptions / subscription_plans revenue

• subscription_plans：Free / Plus 等のマスター: master of plans such as Free / Plus
• user_subscriptions：契約行。IAPレシート検証後に Cloudflare Workers が INSERT/UPDATE。status: trial/active/grace/cancelled/expired: subscription rows. An Cloudflare Workers INSERT/UPDATEs after IAP receipt verification. status: trial/active/grace/cancelled/expired

articles / ads

メディア記事と広告のマスター。モバイルは read-only。

Master tables for media articles and ads. The mobile app is read-only.

home_banners 2026-04-24 new

ホーム画面上部に表示される誘導・広告バナー。GET /v1/mobile/views/home-feed の banners[] として配信される。 area_places / sponsors は座標付きの地理的スポット用の VIEW であり、バナー（広告・誘導カード）とは別概念。

Horizontal banner slots rendered at the top of the home screen. Delivered via GET /v1/mobile/views/home-feed as banners[]. Distinct from area_places / sponsors, which are geographic points on the map.

user_destinations 2026-04-24 new

Wherto 目的地入力欄のオートコンプリート履歴。GET /v1/mobile/views/destinations で最近候補を上位表示するためのユーザー個別テーブル。 Mapbox Search Box API（契約済の場合）から取得した place_id を持てば次回以降の重複判定に利用される。

User-scoped autocomplete history for the Wherto destination input. GET /v1/mobile/views/destinations surfaces recent picks first. When a Mapbox Search Box place_id is attached, it deduplicates subsequent selections.

support_tickets / error_reports ops

• support_tickets：ユーザーが送信、管理者が対応。ステータス：open/in_progress/waiting_user/resolved/closed: submitted by users and handled by admins. Status: open/in_progress/waiting_user/resolved/closed
• error_reports：駐車場情報の誤り報告。ステータス：submitted/triaging/resolved/rejected: reports of incorrect parking-lot information. Status: submitted/triaging/resolved/rejected

codes master

カテゴリ付きラベル辞書。起動時に一括フェッチし、クライアントのドロップダウン・ラベル表示に使用。実 DB 検証済の主要カテゴリ:

A category-keyed label dictionary. Fetched once on app boot to power every dropdown / label. Verified categories from the live DB:

7.3 モバイル固有の読み書きマトリクス 7.3 Mobile read/write matrix

7.4 データライフサイクル 7.4 Data lifecycle

7.5 データ更新ポリシー 7.5 Update policy

• 楽観的更新Optimistic updates：レビュー・メモ・保存等はクライアントで即時反映、失敗時にロールバック＋トースト通知: reviews, memos, saves, etc. are reflected on the client immediately, rolled back with a toast on failure
• 悲観的確定Pessimistic commit：駐車終了の料金確定は必ずサーバーRPCを待つ: final pricing at end-of-parking always waits on the server RPC
• 冪等性Idempotency：全てのRPCは client_request_id を受け取り、重複リクエストを排除: every RPC accepts a client_request_id and de-duplicates repeat requests
• ソフトデリートSoft delete：ユーザー直接操作の削除は deleted_at カラム利用（CLAUDE.md準拠）: user-initiated deletions use the deleted_at column (per CLAUDE.md)