docs: new power user survey fields pxplanation powerUserLoggedIn powerUserPaid

Author: abose

docs/surveys-readme.md

@@ -6,13 +6,17 @@ Configuration file for user surveys displayed in Phoenix Code.
 
 - **newUser**: Survey shown once to new users after initial delay
 - **powerUser**: Recurring survey shown to active users at regular intervals
+  - **powerUserLoggedIn**: Optional survey URL for logged-in users (fallback to `powerUser` if not given)
+  - **powerUserPaid**: Optional survey URL for paid subscribers (takes precedence over `powerUserLoggedIn`)
 
 ## Configuration Properties
 
 | Property | Type | Default | Description                                                                      |
 |----------|------|---------|----------------------------------------------------------------------------------|
 | `newUser` | string | - | URL for new user survey                                                          |
-| `powerUser` | string | - | URL for power user survey                                                        |
+| `powerUser` | string | - | URL for power user survey (fallback for all users)                               |
+| `powerUserLoggedIn` | string/null | null | URL for logged-in users (overrides `powerUser`)                                  |
+| `powerUserPaid` | string/null | null | URL for paid subscribers (overrides `powerUserLoggedIn`)                         |
 | `newUserTitle` | string/null | null | Custom title for new user survey (null uses translated default)                  |
 | `powerUserTitle` | string/null | null | Custom title for power user survey (null uses translated default)                |
 | `newUserShowDelayMS` | number | 1200000 | Delay before showing new user survey (20 minutes)                                |
@@ -34,12 +38,16 @@ Use the `browser` object to override settings for browser deployments. All prope
   "newUserUseDialog": false,
   "newUserShowDelayMS": 1200000,
   "powerUser": "https://s.surveyplanet.com/v3j59a7z",
+  "powerUserLoggedIn": "https://s.surveyplanet.com/abc123",
+  "powerUserPaid": "https://s.surveyplanet.com/xyz789",
   "powerUserTitle": null,
   "powerUserUseDialog": false,
   "powerUserShowIntervalDays": 35,
   "browser": {
     "newUser": "https://s.surveyplanet.com/5lrpp9ud",
     "powerUser": "https://s.surveyplanet.com/wtohpj8x",
+    "powerUserLoggedIn": "https://s.surveyplanet.com/def456",
+    "powerUserPaid": "https://s.surveyplanet.com/uvw321",
     "newUserShowDelayMS": 600000,
     "powerUserShowIntervalDays": 30
   }
@@ -50,4 +58,5 @@ Use the `browser` object to override settings for browser deployments. All prope
 
 - **New User Survey**: Shown once per user. Version number in code determines if shown again after updates.
 - **Power User Survey**: First shown 14 days after initial boot, then repeats at configured interval.
+  - Survey URL selection priority: `powerUserPaid` (if paid subscriber) → `powerUserLoggedIn` (if logged in) → `powerUser` (fallback)
 - **Fallback**: If browser-specific config exists, native app uses main config, browser uses browser config with fallback to main.