# ACS Simulator — sales demo guide

Start the installed package with **Start.cmd** (Windows) or **Start.command** (Mac), with Docker Desktop running. On the existing Pi, open the normal simulator website. Sign in with the installation’s own login. The full simulator is the default landing page at `/`, starting with Doors & readers. Choose **Demo mode** under **Manage**, or open `/demo`, when you want the sales demonstration. **Simulator** returns to the normal entry page, including Report issue and Record test. Existing `/advanced` bookmarks still work.

1. **Prepare once:** an administrator onboards this controller to the demo ISMP tenant and follows [ISMP setup](ISMP_SETUP.md). Open **Demo setup**, select the configured Lobby and Server Room doors and three separate cards, then **Load demo site / Save setup**. No IDs or terminal commands are needed. Role labels do not grant permission.
2. **Show the site:** open ISMP Activity Monitor beside Demo Mode. The door tiles show live contact, lock and alarm readings. Choose the friendly door name under **Run on**.
3. **Run a story:** start with **Valid card tap**, then **Denied card tap**. Follow each card’s ISMP hint and live step count. **Break-In** opens a locked contact; **Door held open** waits for the real held-open alarm. **Remote unlock** sends the controller’s existing RabbitMQ operator command. **Fire release** affects the selected DDM board; every affected door must be mapped. **Interlock** first checks Staff access at the second door, then verifies interlock denial while the first door is open.
4. **Reset between stories:** choose **Reset demo** or **Reset all alarms**. The simulator restores only inputs owned by this demo, then sends `reset_alarm` for eligible mapped doors. Success means fresh closed/locked readings with no reported door alarms. Active faults, changed mappings and interrupted-run recovery are reported for inspection; this never factory resets the controller. A stopped run restores its inputs; alarm clearance is a separate Reset operation.
5. **Finish safely:** **Stop & restore** stops a running demo. Closing the browser does not stop it. If a request’s result is uncertain, use **Check last request**; it checks the same request without sending the action twice. After recovery, use Reset demo.

A disabled card explains its missing setup. Card demos require enabled simulated readers in normal mode with toggle mode off; physical readers still need actual card presentations. The current unattended demo adapters support DDM EM/HSM120/HSM220 doors. Starter doors and optical/other turnstiles remain available in Advanced and need separate demo adapters.

The readiness strip separates controller telemetry, RabbitMQ configuration/last delivery, and recent backend HTTP evidence. A broker acknowledgement or an HTTP response does not prove what ISMP displayed. Check Activity Monitor. First installation, downloads and onboarding are preparation; the five-minute goal starts from a ready, configured site.

![Demo Mode on desktop](screenshots/demo-desktop.png)

Desktop and [mobile screenshot](screenshots/demo-mobile.png) show the implemented UI with synthetic test data, not a live ISMP acceptance run. These screenshots contain no real users, cards or credentials.
