From af9e3358681a2bb8a626d7f935cfc568c1cb4968 Mon Sep 17 00:00:00 2001 From: dingo Date: Sat, 28 Feb 2026 00:33:20 +0000 Subject: [PATCH] docs: add client map from server handlers to client scenes --- client-map.md | 115 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 client-map.md diff --git a/client-map.md b/client-map.md new file mode 100644 index 0000000..c8a3611 --- /dev/null +++ b/client-map.md @@ -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`).