# DTS Torque Vault - Mini PC Kiosk Commissioning & QA Checklist Use this checklist after a fresh deployment with `setup.bat` or `scripts\install.bat`. For maintenance, also complete the Update Verification section after `scripts\update.bat`. --- ## Unit Information | Field | Details | | :----------------------------- | :-------------------------------------------- | | **Device Hostname / Serial #** | `________________________________________` | | **Site / Location** | `________________________________________` | | **Configured Kiosk Username** | `Torque Vault` _(or: `____________________`)_ | | **Technician Name** | `________________________________________` | | **Deployment Date** | `____ / ____ / ____` | --- ## 1. Pre-Deployment & Package Verification - [ ] Deployment package is available locally at `C:\Apps\mini-pc-setup\` (via `setup.bat`) or from the approved extracted release. - [ ] All required files are present: `setup.bat`, `scripts\install.bat`, `scripts\update.bat`, `scripts\uninstall.bat`, `templates\startup.html`, `compose.yml`, `.env.template`, `.env`, `Readme.md`, and `CheckList.md`. - [ ] `.env` has been reviewed and contains the intended `FRONTEND_IMAGE`, `BACKEND_IMAGE`, database, Redis, application, and Watchtower values. Production secrets have not been copied into the shared release. - [ ] `setup.bat` or `scripts\install.bat` was run as Administrator. - [ ] BIOS Hardware Virtualization (`Intel VT-x` / `AMD-V`) verified as **Enabled**. - [ ] Active LAN / Wi-Fi connection confirmed. - [ ] Microsoft Edge is installed in one of the standard 32-bit or 64-bit Program Files locations. --- ## 2. WSL2 & Docker Backend Verification _(Sign in as **Administrator** to run these checks if needed)_ - [ ] `Ubuntu-22.04` WSL2 distribution is installed with `systemd=true` in `/etc/wsl.conf` and `vmIdleTimeout=-1` in the installing Administrator's `%USERPROFILE%\.wslconfig`. - [ ] Docker Engine package `5:28.3.2-1~ubuntu.22.04~jammy` and Docker Compose V2 are installed; Docker Engine packages are pinned with `apt-mark hold`. - [ ] The `walmart` project runs from `/opt/walmart` and all services show an expected status: `wsl -d Ubuntu-22.04 -u root docker ps` - [ ] Container names are expected: `tv-proxy-prod`, `tv-redis-prod`, `tv-db-prod`, `tv-backend-prod`, `tv-frontend-prod`, and `tv-watchtower-prod`. - [ ] Backend health endpoint `http://localhost:3000/api/v1/system/health-check/` returns **`Online`**. - [ ] Scheduled Task **`WSL Docker Startup`** exists, triggers **At startup**, and runs under the installing Administrator account (not `SYSTEM`). - [ ] The startup task has no execution-time limit and is allowed to restart if it fails. --- ## 3. Kiosk Mode, Auto-Logon & Session Persistence - [ ] **Cold Boot / Reboot Test:** Restart the Mini PC and verify it bypasses the Windows login screen and automatically signs into the Kiosk account (`Torque Vault`). - [ ] **UI Lockdown:** The Start Menu and Taskbar are hidden in the kiosk session; Microsoft Edge launches fullscreen from `C:\KioskApp\startup.html` and transitions to `http://localhost:3000`. - [ ] Edge is launched with a persistent profile under `C:\KioskBrowserData` and InPrivate browsing, browsing-data clearing, and first-run prompts are disabled. - [ ] **Session Persistence Test:** Log into the web application inside Kiosk mode, reboot the Mini PC, and confirm the browser session/cookies in `C:\KioskBrowserData` remain intact (no forced re-login). - [ ] **Admin Escape Hatch:** Pressing `Ctrl + Alt + Del` and switching/signing out allows access to the Administrator account with a normal Windows Desktop. --- ## 4. 24/7 Power, Peripherals & Update Hardening - [ ] Active Windows Power Plan is set to **High Performance**. - [ ] Sleep and hibernation are disabled. The selected display-off timeout is applied (`0` means the display stays on). - [ ] **USB Selective Suspend** is **Disabled** (`0`). - [ ] Disk timeouts are set to **Never** (`0`). - [ ] Windows is configured not to automatically reboot with the logged-on user for scheduled updates. - [ ] Connected peripherals (USB dongle, barcode scanner, touchscreen) respond immediately after sitting idle for 15+ minutes. - [ ] **Power Loss Recovery Test:** Disconnect AC power (or perform a hard power cycle), reconnect power, and confirm the Mini PC boots directly back into the active Kiosk application without manual intervention. --- ## 5. Update Verification Complete this section after running `scripts\update.bat` as Administrator. - [ ] The current `.env` and `compose.yml` were reviewed and copied/synchronized by the updater. - [ ] Docker registry login succeeds and the updater completes the image pull. - [ ] `docker compose -p walmart up -d --remove-orphans` completes successfully. - [ ] Backend health endpoint returns **`Online`** after the update. - [ ] `C:\KioskApp\startup.html` is updated when `templates\startup.html` is present. - [ ] Existing named volumes `tv-data-prod`, `tv-redis-prod`, and `tv-state-prod` are preserved. - [ ] The application remains usable and required kiosk data/logon are unchanged. - [ ] Dangling Docker images are pruned and `docker compose -p walmart ps` shows the expected service state. --- ## 6. Troubleshooting Evidence - [ ] Container status checked: `wsl -d Ubuntu-22.04 -u root docker ps` - [ ] Backend logs checked if needed: `wsl -d Ubuntu-22.04 -u root docker logs tv-backend-prod` - [ ] Registry login and `FRONTEND_IMAGE` / `BACKEND_IMAGE` values verified if image pull fails. - [ ] `WSL Docker Startup` Task Scheduler entry verified if the application is unavailable after reboot. --- ## Final Sign-Off - [ ] **PASS — Unit approved for production deployment.** **Technician Signature:** `___________________________`     **Date:** `____ / ____ / ____`