diff --git a/Client/context-files/scenes.md b/Client/context-files/scenes.md index d48d8c7..0c0c2a3 100644 --- a/Client/context-files/scenes.md +++ b/Client/context-files/scenes.md @@ -31,7 +31,13 @@ This file defines scene scope and network data flow for the first client/server 18. `CardViewer` 19. `Cosmetics` -### 1.4 Per-Scene UI Blocks (Draft) +### 1.4 Global Persistent UI (All Scenes) + +- `Settings` button is present in every scene. +- `Report Bug` button is present in every scene. +- Placement and interaction pattern must remain consistent across scenes. + +### 1.5 Per-Scene UI Blocks (Draft) #### `ClientLaunch` - Splash/logo @@ -94,6 +100,37 @@ This file defines scene scope and network data flow for the first client/server - rotatable 3D grid layer - grid topology state can shift between square and hex +#### `AccountManagement` +- Identity panel: + - username + - email + - profile image +- Password change action: + - `Change Password` button opens popup/modal + - fields: `new password`, `confirm password` + - actions: `Submit` and `Cancel` +- Linked accounts panel: + - `Link Account` action for available OAuth providers + - show currently linked OAuth providers/status +- Stats panel: + - Origin points + - Win + - Loss + - Forfeit + - Draw + - Cards owned + - Cards played +- Spending panel: + - `Total Spent` value censored by default + - toggle to uncensor and reveal: + - money spent + - origin points spent + - `Download Report` action for full spending profile/metrics export +- Legal links panel: + - Terms of Service (TOS) + - EULA + - other required legal documents + #### `CollectionHub` - Tab nav (DeckEditor/CardViewer/Cosmetics) - Collection summary strip @@ -406,7 +443,85 @@ Server -> Client (`MainMenuBootstrapResponse`): --- -## 3.8 `Collection` (Hub Scene) +## 3.8 `AccountManagement` + +### Client + +- Display identity/profile details and account-linked providers. +- Support password update via modal workflow. +- Display account stats and spending summary with default-censored totals. +- Allow uncensor toggle for spending values. +- Provide export action for full spending profile report. +- Show legal document links (TOS, EULA, related policies). + +### Server + +- Return account profile, linked OAuth providers, and player/account stats. +- Process password change requests. +- Return spending summary fields and detailed spending report export. +- Return legal document metadata and URLs. + +### Data Exchange + +Client -> Server (`AccountOverviewRequest`): +- `requestId` +- `accountId` + +Server -> Client (`AccountOverviewResponse`): +- `requestId` +- `username` +- `email` +- `profileImageUrl` +- `linkedProviders` +- `stats`: + - `originPoints` + - `wins` + - `losses` + - `forfeits` + - `draws` + - `cardsOwned` + - `cardsPlayed` +- `spendingSummary`: + - `moneySpent` + - `originPointsSpent` + - `censoredByDefault` (`true`) +- `legalDocuments` (name + url) + +Client -> Server (`ChangePasswordRequest`): +- `requestId` +- `currentPassword` (if policy requires) +- `newPassword` +- `confirmPassword` + +Server -> Client (`ChangePasswordResponse`): +- `requestId` +- `success` +- `errorCode` (if failed) + +Client -> Server (`LinkOAuthRequest`): +- `requestId` +- `provider` + +Server -> Client (`LinkOAuthResponse`): +- `requestId` +- `success` +- `linkedProviders` +- `errorCode` (if failed) + +Client -> Server (`SpendingReportRequest`): +- `requestId` +- `format` (`csv`, `json`, `pdf`) + +Server -> Client (`SpendingReportResponse`): +- `requestId` +- `success` +- `downloadUrl` +- `expiresAtUtc` +- `errorCode` (if failed) + +--- + +## 3.9 `Collection` (Hub Scene) ### Client @@ -441,7 +556,7 @@ Server -> Client (`CollectionBootstrapResponse`): --- -## 3.9 `DeckEditor` +## 3.10 `DeckEditor` ### Client @@ -484,7 +599,7 @@ Server -> Client (`DeckSaveResponse`): --- -## 3.10 `CardViewer` +## 3.11 `CardViewer` ### Client @@ -516,7 +631,7 @@ Server -> Client (`CardSearchResponse`): --- -## 3.11 `Cosmetics` (Card Back / Trim / Variant Selection) +## 3.12 `Cosmetics` (Card Back / Trim / Variant Selection) ### Client @@ -547,7 +662,7 @@ Server -> Client (`CosmeticEquipResponse`): --- -## 3.12 Global Input Consistency Rules +## 3.13 Global Input Consistency Rules - Multi-touch support is required for touch-capable devices. - Core camera gestures and selection semantics are shared across all scenes. @@ -578,5 +693,5 @@ Server -> Client (`CosmeticEquipResponse`): - Ranked Play scene breakdown and matchmaking payload contracts. - Custom Play lobby + room state contracts. - Bazaar transaction flow and inventory mutation rules. -- Account management and settings data model. +- Settings scene-level data model and interactions. - Admin scene contracts and role-gated operations.