Enhance first-boot script and documentation for eMMC provisioning: add structured logging, improve package installation process, and implement one-shot autostart for rotation and wallpaper setup. Update dashboard to manage portal file descriptions and enhance admin interface with new navigation links.

chromium-setup/emmc-provisioning/cloud-init/files-from-guard/README.md

@@ -0,0 +1,30 @@
+# Files for the file server
+
+first-boot.sh downloads from **`.../files/first-boot/`** (e.g. `http://10.130.60.141:5000/files/first-boot`). Put all first-boot assets in a **first-boot** subfolder of portal-files so provisioning works.
+
+## Required files (host under `.../files/first-boot/`)
+
+| File | Purpose |
+|------|--------|
+| **start-chromium.sh** | Chromium kiosk launcher (executable). |
+| **chromium-kiosk.desktop** | Autostart entry for the kiosk. |
+| **splash.png** | Boot splash + login + desktop wallpaper (single image). |
+| **custom.plymouth** | Plymouth theme config (from `plymouth-custom/`). |
+| **custom.script** | Plymouth script that displays splash.png (from `plymouth-custom/`). |
+| **99-wallpaper.conf** | LightDM greeter wallpaper (from `config-files/`). |
+| **99-default-session.conf** | LightDM default session plasmax11 (from `config-files/`). |
+| **kdeglobals** | KDE font DPI (from `config-files/`). |
+| **kwinrc** | KDE window/touch (from `config-files/`). |
+| **maliit-keyboard.desktop** | Maliit on-screen keyboard autostart (from `config-files/`). |
+| **set-rotation-once.sh** + **.desktop** | One-shot: DSI-1 rotation at first login. |
+| **set-wallpaper-once.sh** + **.desktop** | One-shot: desktop wallpaper at first login. |
+
+---
+
+## What’s in this folder
+
+- **plymouth-custom/splash.png** — Example splash image; host as `splash.png`.
+- **plymouth-custom/custom.plymouth** — Plymouth theme definition; host as `custom.plymouth`.
+- **plymouth-custom/custom.script** — Plymouth script that draws splash.png; host as `custom.script`.
+- **lightdm/RPiSystem_dark.png** — Unused; only `splash.png` is used now.
+- **set-rotation-once.sh** and **set-wallpaper-once.sh** live in `cloud-init/`; copy them into `portal-files/first-boot/` on the file server.

chromium-setup/emmc-provisioning/cloud-init/files-from-guard/plymouth-custom/custom.plymouth

@@ -0,0 +1,8 @@
+[Plymouth Theme]
+Name=Custom Splash
+Description=Custom boot splash screen
+ModuleName=script
+
+[script]
+ImageDir=/usr/share/plymouth/themes/custom
+ScriptFile=/usr/share/plymouth/themes/custom/custom.script

chromium-setup/emmc-provisioning/cloud-init/files-from-guard/plymouth-custom/custom.script

@@ -0,0 +1,40 @@
+screen_width = Window.GetWidth();
+screen_height = Window.GetHeight();
+
+theme_image = Image("splash.png");
+image_width = theme_image.GetWidth();
+image_height = theme_image.GetHeight();
+
+scale_x = image_width / screen_width;
+scale_y = image_height / screen_height;
+
+if (scale_x > 1 || scale_y > 1)
+{
+    if (scale_x > scale_y)
+    {
+        resized_image = theme_image.Scale(screen_width, image_height / scale_x);
+        image_x = 0;
+        image_y = (screen_height - ((image_height * screen_width) / image_width)) / 2;
+    }
+    else
+    {
+        resized_image = theme_image.Scale(image_width / scale_y, screen_height);
+        image_x = (screen_width - ((image_width * screen_height) / image_height)) / 2;
+        image_y = 0;
+    }
+}
+else
+{
+    resized_image = theme_image.Scale(image_width, image_height);
+    image_x = (screen_width - image_width) / 2;
+    image_y = (screen_height - image_height) / 2;
+}
+
+if (Plymouth.GetMode() != "shutdown")
+{
+    sprite = Sprite(resized_image);
+    sprite.SetPosition(image_x, image_y, -100);
+}
+
+fun message_callback(text) {
+}