feat(onboarding): add new onboarding flows for Unraid OS (#1746)

### PR Summary

This PR introduces a new onboarding-focused API surface, expands system
configuration capabilities, and refactors activation/customization data
into a more structured schema.

### What changed

- Added full onboarding domain support in GraphQL:
  - `Onboarding`, `OnboardingState`, `OnboardingStatus`
  - `onboarding` mutation group (complete/reset/override flows)
- Added plugin install lifecycle APIs:
  - `unraidPlugins` mutations (`installPlugin`, `installLanguage`)
  - operation tracking queries + `pluginInstallUpdates` subscription
- Added system time management APIs:
  - `systemTime`, `timeZoneOptions`, `updateSystemTime`
- Added display/network/config enhancements:
  - `display` query + `displaySubscription`
  - `Info.networkInterfaces` and `Info.primaryNetwork`
  - server/SSH update mutations and `Server.comment`
- Updated REST customization asset endpoint to return dynamic image MIME
types (not hardcoded PNG).

### Breaking schema changes

- Removed `PublicPartnerInfo` type.
- Removed query fields:
  - `isInitialSetup`
  - `publicPartnerInfo`
- Removed `Customization.partnerInfo` and `Customization.theme`.
- Restructured `ActivationCode` from flat fields to nested:
  - `partner`, `branding`, `system` objects.

### Net effect

- API becomes more modular and onboarding-driven.
- Consumers must update GraphQL queries for removed fields and adopt the
new `ActivationCode` shape.
- Frontend onboarding/plugin/system-time workflows are now first-class
in the API.

### ⚠️ Breaking GraphQL changes (15 total)

1. Removed type:
- `PublicPartnerInfo`

2. Removed `Query` fields:
- `isInitialSetup`
- `publicPartnerInfo`

3. Removed `Customization` fields:
- `partnerInfo`
- `theme`

4. Reshaped `ActivationCode` (flat fields removed):
- `partnerName`, `partnerUrl`
- `serverName`, `sysModel`, `comment`
- `header`, `headermetacolor`, `background`, `showBannerGradient`,
`theme`

#### Migration mapping (old -> new)
- `activationCode.partnerName` -> `activationCode.partner.name`
- `activationCode.partnerUrl` -> `activationCode.partner.url`
- `activationCode.serverName` -> `activationCode.system.serverName`
- `activationCode.sysModel` -> `activationCode.system.model`
- `activationCode.comment` -> `activationCode.system.comment`
- `activationCode.header` -> `activationCode.branding.header`
- `activationCode.headermetacolor` ->
`activationCode.branding.headermetacolor`
- `activationCode.background` -> `activationCode.branding.background`
- `activationCode.showBannerGradient` ->
`activationCode.branding.showBannerGradient`
- `activationCode.theme` -> `activationCode.branding.theme`
- `query isInitialSetup` -> `query isFreshInstall` (verify semantics in
consumers)
- `Customization.partnerInfo` -> `Customization.activationCode.partner`
+ `Customization.activationCode.branding`
- `Customization.theme` -> use `publicTheme` (or `display.theme`,
depending on consumer need)

---

### Major non-breaking schema additions

1. Onboarding domain:
- New types: `Onboarding`, `OnboardingState`, `OnboardingStatus`
- New mutation namespace: `onboarding` (`completeOnboarding`,
`resetOnboarding`, override helpers)
- `Customization.onboarding` added

2. Plugin install lifecycle:
- New mutations: `unraidPlugins.installPlugin`,
`unraidPlugins.installLanguage`
- New queries: `pluginInstallOperation`, `pluginInstallOperations`,
`installedUnraidPlugins`
- New subscription: `pluginInstallUpdates`
- New types: `PluginInstallOperation`, `PluginInstallEvent`, status
enum/inputs

3. System time management:
- New query fields: `systemTime`, `timeZoneOptions`
- New mutation: `updateSystemTime`
- New types/inputs: `SystemTime`, `TimeZoneOption`,
`UpdateSystemTimeInput`

4. Display/network/settings surface:
- New query field: `display` (`InfoDisplay`)
- New subscription: `displaySubscription`
- `Info` adds `networkInterfaces`, `primaryNetwork`
- `Customization.availableLanguages` added
- New mutation: `customization.setLocale`
- New mutations: `updateServerIdentity`, `updateSshSettings`
- `Server.comment` added

---

### REST contract note (non-GraphQL)
- `GET /customizations/:type` now returns detected image MIME type
dynamically (not always `image/png`).

---

### Data/schema scope note
- No DB migration/schema files were changed in this branch; major schema
impact is API contract (primarily GraphQL).

Source files reviewed:
- `/Users/ajitmehrotra/Projects/api/api/generated-schema.graphql`
-
`/Users/ajitmehrotra/Projects/api/api/src/unraid-api/rest/rest.controller.ts`
-
`/Users/ajitmehrotra/Projects/api/api/src/unraid-api/rest/rest.service.ts`

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

# Release Notes

* **New Features**
  * Multi-step onboarding flow with partner branding support
  * System time and timezone configuration from UI
  * Plugin and language pack installation capabilities
  * Server identity management (name, description, model)
  * SSH settings configuration interface
  * Onboarding admin panel for testing and debugging

* **Improvements**
  * Enhanced theme and locale switching
  * Better network interface information display
  * Improved server information visibility
  * Partner logo and branding customization support
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Ajit Mehrotra <ajitmehrotra2009@gmail.com>
Co-authored-by: Ajit Mehrotra <ajit@lime-technology.com>

Author: elibosley

.gitignore

@@ -122,7 +122,11 @@ api/dev/Unraid.net/myservers.cfg
 
 # local Mise settings
 .mise.toml
+mise.toml
 
 # Compiled test pages (generated from Nunjucks templates)
 web/public/test-pages/*.html
 
+# local scripts for testing and development
+.dev-scripts/
+

@tailwind-shared/css-variables.css

@@ -141,4 +141,4 @@
     --background: 0 0% 3.9%;
     --foreground: 0 0% 98%;
     --border: 0 0% 14.9%;
-  }
+  }

api/dev/activation/activation_code_12345.activationcode

@@ -1,13 +1,37 @@
 {
   "code": "EXAMPLE_CODE_123",
-  "partnerName": "MyPartner Inc.",
-  "partnerUrl": "https://partner.example.com",
-  "serverName": "MyAwesomeServer",
-  "sysModel": "CustomBuild v1.0",
-  "comment": "This is a test activation code for development.",
-  "header": "#336699",
-  "headermetacolor": "#FFFFFF",
-  "background": "#F0F0F0",
-  "showBannerGradient": "yes",
-  "theme": "black"
+  "partner": {
+    "name": "MyPartner Inc.",
+    "url": "https://partner.example.com",
+    "hardwareSpecsUrl": "https://partner.example.com/specs/customBuild-v1",
+    "manualUrl": "https://partner.example.com/docs/customBuild-manual",
+    "supportUrl": "https://partner.example.com/support",
+    "extraLinks": [
+      {
+        "title": "Community Forums",
+        "url": "https://partner.example.com/forums"
+      },
+      {
+        "title": "Video Tutorials",
+        "url": "https://partner.example.com/tutorials"
+      }
+    ]
+  },
+  "branding": {
+    "theme": "black",
+    "bannerImage": "./assets/banner.png",
+    "caseModelImage": "./assets/case-model.png",
+    "partnerLogoLightUrl": "./assets/partner-logo-light.svg",
+    "partnerLogoDarkUrl": "./assets/partner-logo-dark.svg",
+    "onboardingTitle": "Welcome to MyPartner",
+    "onboardingSubtitle": "Setting up your CustomBuild v1.0",
+    "header": "#336699",
+    "headermetacolor": "#FFFFFF",
+    "background": "#F0F0F0",
+    "showBannerGradient": true
+  },
+  "system": {
+    "serverName": "MyAwesomeServer",
+    "model": "CustomBuild v1.0"
+  }
 }

api/dev/configs/api.json

@@ -1,9 +1,9 @@
 {
   "version": "4.29.2",
   "extraOrigins": [],
-  "sandbox": true,
+  "sandbox": false,
   "ssoSubIds": [],
   "plugins": [
     "unraid-api-plugin-connect"
   ]
-}
+}

api/dev/dynamix/default.cfg

@@ -28,6 +28,7 @@ hotssd="60"
 maxssd="70"
 power=""
 theme="white"
+terminalButton="yes"
 locale=""
 raw=""
 rtl=""
@@ -77,4 +78,4 @@ UseTLSCert="NO"
 TLSCert=""
 AuthMethod="login"
 AuthUser=""
-AuthPass=""
+AuthPass=""

api/dev/dynamix/dynamix.cfg

@@ -1,42 +1,52 @@
 [display]
-date=%c
-time=%I:%M %p
-number=.,
-scale=-1
-tabs=1
-users=Tasks:3
-resize=0
-wwn=0
-total=1
-usage=0
-banner=image
-dashapps=icons
-theme=black
-text=1
-unit=C
-warning=70
-critical=90
-hot=45
-max=55
-sysinfo=/Tools/SystemProfiler
-header=336699
-headermetacolor=FFFFFF
-background=F0F0F0
-showBannerGradient=yes
-
+date="%c"
+time="%I:%M %p"
+number=".,"
+scale="-1"
+tabs="1"
+users="Tasks:3"
+resize="0"
+wwn="0"
+total="1"
+usage="0"
+banner="image"
+dashapps="icons"
+theme="black"
+terminalButton="yes"
+text="1"
+unit="C"
+warning="70"
+critical="90"
+hot="45"
+max="55"
+sysinfo="/Tools/SystemProfiler"
+header="336699"
+headermetacolor="FFFFFF"
+background="F0F0F0"
+showBannerGradient="yes"
+width=""
+font=""
+tty="15"
+hotssd="60"
+maxssd="70"
+power=""
+locale=""
+raw=""
+rtl=""
+headerdescription="yes"
 [notify]
-entity=1
-normal=1
-warning=1
-alert=1
-unraid=1
-plugin=1
-docker_notify=1
-report=1
-display=0
-date=d-m-Y
-time=H:i
-position=top-right
-path=./dev/notifications
-system=*/1 * * * *
+entity="1"
+normal="1"
+warning="1"
+alert="1"
+unraid="1"
+plugin="1"
+docker_notify="1"
+report="1"
+display="0"
+date="d-m-Y"
+time="H:i"
+position="top-right"
+path="./dev/notifications"
+system="*/1 * * * *"