登場人物と役割¶

smooth のサービスに関わる人・システムの役割を整理します。

flowchart LR
    Driver[🧑 ドライバー] -->|LINE ミニアプリ| Mobile[smooth-mobile]
    Owner[🏢 駐車場オーナー] -->|管理ポータル| OwnerApp[smooth-owner]
    SmoothBox[📷 SmoothBox<br>IoT デバイス] -->|プレート画像| API[smooth-backend]

    Mobile -->|API| API
    OwnerApp -->|API| API

    API <-->|決済・Connect| Stripe[Stripe]
    API <-->|OAuth 認証| Firebase[Firebase Auth]
    API -->|プッシュ通知| LINE[LINE]

人間のステークホルダー¶

ドライバー（一般ユーザー）¶

駐車場を利用する車のオーナー。

主なアクション:

smooth-mobile にアカウント登録
ナンバープレートを登録
クレジットカードを登録（Stripe）
駐車場を利用（入出庫は自動）
支払い履歴・請求書の確認
クーポンの使用
家族・同乗者との車の共同使用（カーグループ機能）

駐車場オーナー¶

駐車場を運営・管理する事業者。smooth に駐車場を登録し、収益を得る。

主なアクション:

smooth-owner にアカウント登録
駐車場情報・料金設定を登録
Stripe Connect でペイアウト設定
収益・稼働率・セッションの確認
分析レポートの閲覧（時間帯別・曜日別・稼働率など）
クレーム・紛争対応

smooth 管理者（Admin）¶

smooth 運営チームのメンバー。管理画面でサービス全体を管理する。

主なアクション:

ユーザー管理（作成・編集・削除）
駐車場の承認・管理
クーポンの作成・配布
IoTデバイスのAPIキー管理
セッション・決済の監視

システムのステークホルダー¶

SmoothBox（IoTデバイス）¶

駐車場の入口・出口に設置されるエッジデバイス。

カメラでナンバープレートを撮影
HMAC-SHA256 署名で認証しバックエンドに送信
入出庫検知をリアルタイムで報告

Stripe¶

決済プロセッサー。

ドライバーのカード情報を安全に管理（SetupIntent）
自動決済の実行
駐車場オーナーへの売上送金（Stripe Connect）
Webhook でバックエンドに決済結果を通知

Firebase Authentication（GCP）¶

ソーシャル認証プロバイダー。

Google / Apple ログインの OAuth 処理・トークン検証を担当
バックエンドが Firebase ID トークンを検証してユーザーを特定

LINE¶

通知チャンネル。

駐車セッション完了時にドライバーへプッシュ通知
LINE LIFF でログインにも対応