機能カテゴリ別まとめ
Features by category
画面を横断して、管理者ポータルが提供する機能を11のカテゴリに整理しました。
「何ができるか」を把握してから、必要なページを 画面カタログ で探す流れを想定しています。
A cross-cutting grouping of what the portal can actually do, across 11 categories.
Start here to understand capability, then jump to the screen catalog for the exact page.
1. 駐車場の管理Parking lot management
| 機能Capability |
画面Screen |
概要Details |
| リスト/マップ表示List / map view | /parking | Mapbox 地図とリストを併用。住所/座標で検索可能。Mapbox map plus list, searchable by address or coords. |
| 詳細編集Detail edit | /parking/:id | 基本情報・画像・ルール・タグ・属性・支払い方法を1画面で編集。All fields edited from a single screen with tabs. |
| 料金ルールPricing rules | /parking/:id | 時間帯/曜日別ユニット料金 + キャップ料金。計算機で検証可能。Unit + cap rules by time / day, verifiable via calculator. |
| 画像管理Image management | /parking/:id | Cloudflare R2 へ署名URLでアップロード、メイン設定、並び替え。Signed-URL upload to Cloudflare R2, main image, reorder. |
| エンゲージメントEngagement | /parking/:id | 保存数・セッション数・検索数を RPC で集計。Saves / sessions / searches rolled up via RPC. |
2. ユーザー管理User management
| ja/en | Screen | Details |
|---|
| 一覧検索Search / filter | /users | 名前・メール・ステータス・車種・プランで絞り込み。Filter by name, email, status, vehicle, plan. |
| 360°詳細360° detail | /users/:id | プロフィール / 保存駐車場 / セッション / レビュー / チケット / 報告 / ゲーミをタブ切替。Profile / saved / sessions / reviews / tickets / reports / gamification tabs. |
| バッジとEXP表示Badges & EXP | /users/:id | バッジ進捗、獲得一覧、現在レベル、次レベルまでの進捗バー。Badge progress, unlocks, current level, progress bar. |
3. オーナーとクレジットOwners & credits
| Capability | Screen | Details |
|---|
| オーナーCRUDOwner CRUD | /owners | 個人/法人の区別、会社情報、ステータス。Individual / business split, company info, status. |
| 申請審査Application review | /owner-applications | 提出書類確認 → 承認で parking_lot_owners を自動生成。Review submitted docs; approval wires up parking_lot_owners. |
| 残高管理Credit balance | /credits | admin_charge / purchase / consumption / refund の4種トランザクション。4 transaction types: admin_charge / purchase / consumption / refund. |
4. 売上と収益Revenue & sales
| Capability | Screen | Details |
|---|
| 月別サマリーMonthly summary | /sales | revenue_monthly_summary ビューを使用。Backed by the revenue_monthly_summary view. |
| 取引明細Transactions | /sales | チャネル (subscription / parking / boost) とタイプでフィルタ。Filter by channel (subscription / parking / boost) and type. |
| 外部ストア連携External storefronts | /store-sales | Shopify 等の日次売上・指標・レビュー・同期履歴を確認。Daily sales, app metrics, reviews, and sync run history. |
5. サポートと誤情報対応Support & moderation
| Capability | Screen | Details |
|---|
| チケット管理Tickets | /support | 件名・メール・優先度・ステータスで絞込、担当割当、期限設定。Filter, assign, priority, due date. |
| 誤情報報告Error reports | /error-reports | 誤登録情報の報告→訂正フロー。Flag incorrect lot info and track remediation. |
| 統合インボックスUnified inbox | /admin-tasks | 4 種類のタスクを 1 画面に集約。admin_tasks テーブルで統一管理。Merges 4 task kinds into one stream via the admin_tasks table. |
6. 通知Notifications
| Capability | Screen | Details |
|---|
| ユーザー向けプッシュUser push | /notifications | タイプ(system/info/promo)、ターゲット(all/segment)、即時/予約配信。type=system/info/promo, target=all/segment, immediate or scheduled. |
| 送信実行Send execution | — | Workers queue parky-fcm-dispatch を invoke。Triggered via the parky-fcm-dispatch queue (Workers). |
| 管理者通知Admin-facing | /admin-notifications | Realtime 購読でサイドバーにバッジ表示。Realtime-subscribed sidebar badge count. |
7. エリアスポンサーArea sponsors
| Capability | Screen | Details |
|---|
| スポンサー CRUDSponsor CRUD | /sponsors | 施設情報・位置(Mapbox Search Box オートコンプリート)・課金設定・通知設定。Cloudflare R2 サムネイルアップロード。ソフトデリート。Facility info, location (Mapbox Search Box autocomplete), billing, notification settings. Cloudflare R2 thumbnail upload. Soft delete. |
| マップ表示Map markers | /parking (map) | 駐車場マップ上にカテゴリ別アイコン (Canvas SVG) でスポンサー表示。クリックで /sponsors?open={id} へ遷移。Sponsor markers with category-specific SVG icons on parking map. Click navigates to /sponsors?open={id}. |
| 近隣スポンサータブNearby sponsors tab | /parking/:id | 駐車場詳細の「近隣スポンサー」タブで 2km 以内のアクティブなスポンサーをカード表示。Parking detail "Nearby sponsors" tab shows active sponsors within 2 km as clickable cards. |
| チェックイン管理Check-in tracking | /sponsors | 詳細モーダルでチェックイン数・インプレッション・クリック・CTR を表示。Detail modal shows check-in count, impressions, clicks, CTR. |
| 近接通知Proximity notifications | — | スポンサーの notify_enabled が有効なとき、影響圏内ユーザーに FCM プッシュ。CF Cron Trigger handleSponsorProximity + pg_cron (10 分毎) + クールダウン (notify_cooldown_hours) で重複抑止。When a sponsor has notify_enabled=true, users in its influence radius receive FCM push notifications. Handled by the CF Cron Trigger handleSponsorProximity + pg_cron (every 10 min) + per-user cooldown (notify_cooldown_hours). |
8. ゲーミフィケーションGamification
| Capability | Screen | Details |
|---|
| バッジ定義Badge definitions | /gamification/badges | カテゴリ、条件JSON、アイコン(S3)、進捗サマリ。Category, condition JSON, icon (S3), progress summary. |
| バックフィルBackfill | /gamification/badges | 条件変更後の全ユーザー再集計。単体 / 全バッジ対応。Re-run progress for all users after a condition change. |
| EXPルールEXP rules | /gamification/exp | アクティビティ型ごとの付与量。How much EXP each activity type grants. |
| レベルLevels | /gamification/levels | レベル閾値の upsert と全ユーザー再計算 (RPC)。Upsert thresholds and recalculate all users via RPC. |
9. カスタマイズ (着せ替え)Customization (theming)
| Capability | Screen | Details |
|---|
| テーマ作成Create themes | /customizations/themes | 複数パーツを組み合わせて 1 テーマに。Compose several parts into one theme. |
| パーツ管理Part management | /customizations/parts | 駐車場ピン / 目的地ピン / 現在地 / 色 / ローディング。Parking pin, destination pin, current location, colors, loading effects. |
| ギフト配布Gift to user | /customizations/themes | gift_theme_to_user() RPC で user_themes に追加。Appends to user_themes via the gift_theme_to_user() RPC. |
10. コンテンツと広告Content & ads
| Capability | Screen | Details |
|---|
| 記事エディタArticle editor | /articles/:id/edit | TinyMCE + Markdown、公開ステータス遷移、アイキャッチ。TinyMCE + Markdown, status workflow, featured image. |
| 広告枠Ad slots | /ads | バナー画像、リンク、表示回数・クリック・CTR 集計。Banner, link, impressions / clicks / CTR metrics. |
| タグTags | /tags | タグ名・色・並び順。Name, color, sort order. |
11. システム設定System
| Capability | Screen | Details |
|---|
| 管理者アカウントAdmin accounts | /admins | Auth ユーザー + admins テーブルの同期、初期パスワード発行。Sync of Auth user + admins table, initial password generation. |
| ロールと権限Roles & permissions | /roles | 30+ の権限キーをチェックボックスで一括設定。30+ permission keys managed via a matrix UI. |
12. 分析とリアルタイムAnalytics & realtime
| Capability | Screen | Details |
|---|
| KPIKPIs | / | ユーザー数・駐車場数・セッション数・売上・エラー数を期間フィルタ可能。User / lot / session / revenue / error counts with time-range filter. |
| アクティビティフィードActivity feed | /user-activity | Realtime 購読で最新ログが即座に流れる。New logs stream in live via Realtime subscriptions. |
13. AI検索AI search
| Capability | Screen | Details |
|---|
| AI検索（駐車場）AI search (parking) | /parking | 検索フィルター内の「AI検索」ボタンからモーダルを開き、自然言語 or 音声で条件入力。LLM がパースした結果で目的地・半径・料金・時刻・ソートを自動設定。Opens via "AI Search" button in filter bar. Natural language or voice input → LLM parses into destination, radius, price, time, sort conditions. |
| AIプロバイダー設定AI provider settings | /ai-providers | Claude / Gemini / OpenAI の有効/無効・モデル選択（ドロップダウン）・優先順位変更・APIキー登録（Vault暗号化）。編集ボタンで編集モードに切替。Enable/disable Claude / Gemini / OpenAI, model dropdown, priority reorder, API key registration (Vault encrypted). Edit mode toggle. |
| AI使用状況AI usage dashboard | /ai-providers | リクエスト数・成功率・推定コスト・平均レイテンシ・エラー率のKPIカード、プロバイダー別集計、リクエストログテーブル。KPI cards (requests, success rate, cost, latency, error rate), per-provider breakdown, request log table. |
設計のコツDesign tip:
機能はカテゴリをまたぐ場合が多い (ユーザー詳細 ↔ ゲーミフィケーション など)。テーブル単位での責務分離ではなく、ユーザーの「仕事の流れ」単位で画面を設計しているのが特徴です。
Capabilities often span categories (user detail ↔ gamification, for example). Screens are carved up by user workflow, not by table ownership.