Update Readme.md, CheckList.md files

This commit is contained in:
2026-11-18 22:02:26 +07:00
parent 4b9c8a87ec
commit 5633bdcc56
2 changed files with 117 additions and 84 deletions
+47 -11
View File
@@ -1,6 +1,7 @@
# DTS Torque Vault — Mini PC Kiosk Commissioning & QA Checklist
# DTS Torque Vault - Mini PC Kiosk Commissioning & QA Checklist
Use this checklist to verify and sign off each Mini PC after running `setup.bat` / `scripts\install.bat`.
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`.
---
@@ -18,10 +19,13 @@ Use this checklist to verify and sign off each Mini PC after running `setup.bat`
## 1. Pre-Deployment & Package Verification
- [ ] Deployment package extracted locally to `C:\Apps\mini-pc-setup\` (via `setup.bat`, `bootstrap.ps1`, or manual release extraction).
- [ ] All required files present: `setup.bat`, `bootstrap.ps1`, `scripts\install.bat`, `scripts\update.bat`, `scripts\uninstall.bat`, `templates\startup.html`, `compose.yml`, `.env`, `README.md`, and `CheckList.md`.
- [ ] 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.
---
@@ -29,33 +33,65 @@ Use this checklist to verify and sign off each Mini PC after running `setup.bat`
_(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 `%USERPROFILE%\.wslconfig`.
- [ ] Docker Engine `28.3.2` and Docker Compose V2 are installed and pinned (`apt-mark hold`).
- [ ] All containers in `/opt/walmart` (`-p walmart`) show status **`Up`** (`wsl -d Ubuntu-22.04 -u root bash -c "docker ps"`).
- [ ] `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**, runs under the **Administrator** account (_Run whether user is logged on or not_, **not** `SYSTEM`), and has **Stop the task if it runs longer than** & **AC power** conditions **unchecked**.
- [ ] 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:** Windows Desktop, Start Menu, and Taskbar are completely hidden; Microsoft Edge launches full-screen on `C:\KioskApp\startup.html` and transitions smoothly into `http://localhost:3000`.
- [ ] **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` → **Switch user** (or turning the display off/on and swiping up the Lock Screen on touch-only kiosks) allows signing into the **Administrator** account with a normal Windows Desktop intact.
- [ ] **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**.
- [ ] **Turn off the display**, **Put the computer to sleep**, and **Hibernate** are all set to **Never** (`0`).
- [ ] 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.**