Files
sor/client-map.md
T

4.5 KiB

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).