5.8 KiB
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\(viasetup.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, andCheckList.md. .envhas been reviewed and contains the intendedFRONTEND_IMAGE,BACKEND_IMAGE, database, Redis, application, and Watchtower values. Production secrets have not been copied into the shared release.setup.batorscripts\install.batwas 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.04WSL2 distribution is installed withsystemd=truein/etc/wsl.confandvmIdleTimeout=-1in the installing Administrator's%USERPROFILE%\.wslconfig.- Docker Engine package
5:28.3.2-1~ubuntu.22.04~jammyand Docker Compose V2 are installed; Docker Engine packages are pinned withapt-mark hold. - The
walmartproject runs from/opt/walmartand 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, andtv-watchtower-prod. - Backend health endpoint
http://localhost:3000/api/v1/system/health-check/returnsOnline. - Scheduled Task
WSL Docker Startupexists, triggers At startup, and runs under the installing Administrator account (notSYSTEM). - 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.htmland transitions tohttp://localhost:3000. - Edge is launched with a persistent profile under
C:\KioskBrowserDataand 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:\KioskBrowserDataremain intact (no forced re-login). - Admin Escape Hatch: Pressing
Ctrl + Alt + Deland 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 (
0means 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
.envandcompose.ymlwere 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-orphanscompletes successfully.- Backend health endpoint returns
Onlineafter the update. C:\KioskApp\startup.htmlis updated whentemplates\startup.htmlis present.- Existing named volumes
tv-data-prod,tv-redis-prod, andtv-state-prodare preserved. - The application remains usable and required kiosk data/logon are unchanged.
- Dangling Docker images are pruned and
docker compose -p walmart psshows 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_IMAGEvalues verified if image pull fails. WSL Docker StartupTask Scheduler entry verified if the application is unavailable after reboot.
Final Sign-Off
- PASS — Unit approved for production deployment.
Technician Signature: ___________________________ Date: ____ / ____ / ____