Files

5.8 KiB

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: ____ / ____ / ____