Files
sor/client-map.md
T

116 lines
4.5 KiB
Markdown

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