###### tags: `Fanplay対談機能`

# 1. スタッフシーケンス

## 1-1. 概要

* Liveへ「スタッフ」のLiveロールで入室する際のシーケンス。
* 入室すると対談にも参加したことになる。
* 入室してもカメラ/音声はOFFのまま。
* ホストスピーカーと同等の権限を有する。

## 1-2. スタッフの権限

* Live配信
* 撮影/テスト配信：×
* Live開始：○
* Live終了：○
* Live入室/退出
* Live入室：○
* Live退室：○
* Live参加/退出
* 対談参加：○
* 対談退室：○
* 挙手：×
* 対談招待：○
* 対談強制退出：○
* コメント
* コメント閲覧：○
* コメント投稿：○
* コメント削除：○
* スーパーエール
* スーパーエール送信：○
* スーパーエール閲覧：○
* スーパーエール削除：○
* オークション
* オークション入札：×

## 1-3. APIエンドポイント

* Live配信
* Live状態取得API
* Live開始API
* Live終了API
* Live入室 / 退室
* 参加可能Liveロール取得API
* Live入室状態取得API
* Live入室API
* Live退室API
* 対談招待 / 対談強制退室
* 入室中ユーザー一覧取得API
* 対談招待API
* 対談強制退室API
* コメント / スーパーエール
* コメント一覧API
* コメント投稿API
* コメント削除API
* オークション
* なし

## 1-4. シーケンス

### 1-4-1. Live開始/終了

sequenceDiagram
participant front as FE
participant portal as ポータル
participant backend as BE 
participant db as PostgresDB
participant dynamo as DynamoDB
    Note over portal: Live開始ボタン押下
    portal ->> backend: Live入室状態取得API
    backend ->> dynamo: Live入室状態参照
    dynamo -->> backend: 
    backend -->> portal: Live入室状態
    alt 入室中でない場合
        portal ->> backend: 参加可能Liveロール取得API
        backend --> portal: 参加可能Liveロール一覧
        Note over portal: Liveロール選択モーダル表示
        Note over portal: 入室ボタン押下
        portal ->> backend: Live入室API<br>（ロール=スタッフ指定）
        backend ->> dynamo: 入室状態に設定<br>（スタッフ）
        dynamo -->> backend: 
        backend -->> portal: 
    end
    portal -->> frony: Live画面へ遷移
    front ->> backend: Live状態取得API
    backend ->> db: Live状態参照
    db -->> front: Live状態
    alt Live状態 = 開始前の場合
        Note over front: Live開始ボタン押下
        front ->> backend: Live開始API
        backend ->> db: Liveオンエア状態に設定
        db -->> backend: 
        backend -->> front: 
    else Live状態 = オンエア中の場合
        Note over front: Live終了ボタン押下
        front ->> backend: Live終了API
        backend ->> db: Live終了状態に設定
        db -->> backend: 
        backend -->> front: 
        Note over front: Live終了画面表示
    end

### 1-4-2. 対談招待

sequenceDiagram
participant front as FE
participant backend as BE 
participant db as PostgresDB
participant dynamo as DynamoDB
    Note over front: ※参加者一覧の表示方法は要確認
    front ->> backend: 入室中ユーザー一覧取得API
    backend -> dynamo: 入室中ユーザー参照
    dynamo -->> backend: 
    backend -->> front: 入室中ユーザー一覧
    Note over front: 参加者一覧モーダル表示
    Note over front: 招待ボタン押下
    front ->> backend: 招待API
    backend ->> dynamo: 対象ユーザーを招待状態に設定
    dynamo -->> backend: 
    backend -->> front: 
    Note over front: ボタンを招待済みに変更

### 1-4-3. 対談退室制御

sequenceDiagram
participant front as FE
participant backend as BE 
participant db as PostgresDB
participant dynamo as DynamoDB
    Note over front: ※強制退室/ミュートモーダル表示<br>※表示方法要確認
    Note over front: 退出させるボタン押下
    front ->> backend: 対談退室API
    backend ->> dynamo: 
    Note over dynamo: 対象ユーザーのLiveロールをオーディエンスに格下げ
    dynamo -->> backend: 
    backend -->> front: 
    Note over front: 対象ユーザーにAgoraで退室メッセージ送信？