# Client Handler → Scene Map (Draft) This maps current server handlers (`Server/src/*/Handlers`) to suggested client scenes/features. ## Auth / Session Scene > Source: `SOR.Auth/Handlers/AuthGrpcHandler.cs` (gRPC, not websocket message handlers) - `AuthGrpcHandler.Login` → **Login scene** - `AuthGrpcHandler.Register` → **Register scene** - `AuthGrpcHandler.ValidateToken` → **App boot/session restore** - `AuthGrpcHandler.Logout` → **Settings / account menu logout** - `Get/Set/Delete/ListAccountProperty` → **Profile/settings persistence** - `LoginWithOAuth` → **OAuth login scene** (feature-flagged) ## Version Gate / Bootstrap Scene - `version.check` → **Startup version gate / patch-required modal** ## Content / Catalog Scene - `content.sync` → **Initial catalog sync + background refresh** - `content.sets` → **Card sets browser/filter data** - `content.card` → **Card detail view / tooltip inspector** ## Collection Scene (Deck Builder) - `collection.get_cards` → **Collection inventory grid** - `collection.get_decks` → **Deck list scene** - `collection.get_deck` → **Deck detail/editor scene** - `collection.create_deck` → **Create deck flow** - `collection.clone_deck` → **Duplicate deck action** - `collection.rename_deck` → **Rename deck action** - `collection.delete_deck` → **Delete deck action** - `collection.add_card` → **Deck editor add card** - `collection.remove_card` → **Deck editor remove card** - `collection.get_starter_decks` → **Starter deck selection scene** - `collection.select_starter_deck` → **Onboarding starter deck confirm** ## Bazaar / Store Scene - `bazaar.get_store` → **Store home** - `bazaar.buy_booster_pack` → **Booster pack purchase flow** - `bazaar.buy_prebuilt_deck` → **Prebuilt deck purchase flow** - `bazaar.buy_cosmetic` → **Cosmetics purchase flow** - `bazaar.get_listings` → **Marketplace listings** - `bazaar.get_my_listings` → **My listings management** - `bazaar.get_my_balance` → **Wallet/balance view** - `bazaar.list_card` → **Create listing flow** - `bazaar.cancel_listing` → **Cancel listing action** - `bazaar.place_bid` → **Bid flow** - `bazaar.buy_listing` → **Instant buy flow** - `bazaar.get_transactions` → **Transaction history scene** ## Social / Chat Scene ### Presence + social graph - `chat.get_social` → **Friends/social list pane** - `chat.friend_request` → **Add friend action** - `chat.friend_respond` → **Accept/decline friend request** - `chat.friend_remove` → **Remove friend action** - `chat.block` / `chat.unblock` → **Blocklist management** - `chat.presence.get` / `chat.presence.set` → **Presence status controls** ### Messaging + notifications - `chat.get_channels` → **Channel/DM sidebar** - `chat.dm_open` → **Open/start DM thread** - `chat.get_messages` → **Thread message history scene** - `chat.send` → **Send message action** - `chat.notifications.get` → **Notifications center** - `chat.notifications.read` → **Mark notifications read** ## Matchmaking Scene - `matchmaking.join` → **Queue/join matchmaking** - `matchmaking.leave` → **Leave queue** - `matchmaking.status` → **Queue status panel** ## Custom Lobby Scene - `game.custom.create` → **Create private/custom lobby** - `game.custom.list` → **Lobby browser** - `game.custom.join` → **Join selected custom lobby** - `game.custom.leave` → **Leave custom lobby** - `game.ready` → **Ready-up toggle in lobby** ## In-Match Scene (Battlefield) ### Session/state - `game.get_state` → **Load/rejoin current match state** - `game.transition` → **Phase transition orchestration** - `game.end_turn` → **End-turn action** - `game.concede` → **Concede action** ### Setup + economy - `game.place_arch_spirit` → **Placement phase scene** - `game.draw` → **Draw action** - `game.sacrifice` → **Sacrifice flow / ST economy** ### Core tactics - `game.move_unit` → **Unit movement interaction** - `game.attack` → **Attack targeting/confirm flow** - `game.ascend` → **Ascend action** ### Cards + abilities - `game.play_card` → **Card channeling flow (spirit/terramorpha/repentance/instinct/ruin)** - `game.activate_ability` → **Activated ability targeting + resolve** --- ## Notes - `AuthGrpcHandler` is gRPC-based and should be mapped via your auth transport client, not the websocket message dispatcher. - Scene names are suggestions; keep handler names as the source of truth for wiring. - For generated client routing, prefix groups map cleanly by namespace (`auth`, `content`, `collection`, `bazaar`, `chat`, `matchmaking`, `game`, `version`).