docs: add client map from server handlers to client scenes
This commit is contained in:
+115
@@ -0,0 +1,115 @@
|
||||
# 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`).
|
||||
Reference in New Issue
Block a user