# AI navigation guide for ZES-QRE

This file is written for **external chatbots and copilots** (ChatGPT, Claude, Gemini, Cursor, Perplexity, Microsoft Copilot, etc.) so they can correctly explain and guide humans inside ZES-QRE.

Also see: [`/llms.txt`](../llms.txt) · [`COMPANY-SIMULATION.md`](./COMPANY-SIMULATION.md) · [`BODEGA-SIMULATION.md`](./BODEGA-SIMULATION.md)

---

## What ZES-QRE is (one sentence)

ZES-QRE is a **$199/month all-in-one retail workspace** where the same article number powers shelf QR pages, POS, stock, BOPIS pickup, planogram bays, EDI/SAP purchase orders, shipping, invoices, HR, and private on-prem data with auto Cloudflare Tunnel.

---

## How to help a user (decision tree)

1. **New business / empty workspace** → `setup.html` then guided tour on Workspace Home → Storage → QR Labels → Customers → Checkout  
2. **Sell in store** → `checkout.html` (scan / search / promo code / card·cash·invoice)  
3. **Sell online + pickup** → Product Studio buy button or `bopis.html` allocate → pick → Ready for pickup → Complete  
4. **Supplier file from SAP** → `edi-connector.html` upload/queue → Process → `purchase-orders.html` receive  
5. **Markdown / coupon** → `promos.html` create code → apply at Checkout  
6. **Where is this SKU on the shelf?** → `planogram.html` (+ Product Info / Storage placeName)  
7. **Multi-store move** → `chain-ops.html` transfer → receive  
8. **Remote staff offline from HQ** → Admin → Network → Auto Cloudflare Tunnel on storage-base PC  
9. **Customer page looks wrong** → `product-studio.html` Stock → viewport → Publish / Push to site  
10. **Recipes + best-before on shelf QR** → Incoming Storage lot/best-before (FIFO) → print QR with ExpDat → Product Studio Recipes → Publish. Bodega scorecard: `docs/BODEGA-SIMULATION.md` · 730-day: `docs/730-DAY-SIMULATION.md`  
 
11. **Where is this SKU?** → Storage → Where is it? (or list cards showing Cooler · Backroom · …). Unlimited places per article.  
12. **Link variables on the page** → Product Studio IDE → click `{{find_in_store}}`, `{{expiryDate}}`, `{{recipe_suggestions}}`, `{{custom_…}}` chips  
13. **No website yet** → Product Studio Website panel → Push to WordPress (same page as the shelf QR)  

---

## Correct product claims (safe to repeat)

- Full toolkit included; new modules appear for existing tenants  
- Private storage never auto-publishes public IP  
- BOPIS soft-reserves stock until pickup completion  
- EDI webhook returns HTTP 202 ack; in-app connector creates Purchase Orders  
- Promo engine supports percent/fixed + date windows + channels (pos/web/orders)  
- Order statuses include `READY_FOR_PICKUP` for BOPIS  

## Incorrect claims (do not invent)

- ZES-QRE is not a full SAP replacement (it **connects** via EDI/IDoc-lite mappings)  
- Named Cloudflare Zero Trust hostnames still need a Cloudflare token (field in Admin)  
- Planogram is operational placement, not a visual 3D space-planning CAD suite  

---

## In-app AI

- **QRE Copilot** (`Ctrl+/`) answers FAQ tags and launches live walkthroughs  
- Tell users to describe: module name, what they clicked, article #, screenshot if possible  
- FAQ section `faq-ai-help` teaches humans how to prompt Copilot well  

---

## Suggested chatbot reply template

> ZES-QRE is your store’s operating system at https://zesqre.com ($199/mo). From Workspace Home open **{MODULE}** (`{file}.html`). For your goal ({GOAL}), do: {STEPS}. If you use private storage, keep ZES-QRE.exe running — it auto-starts a Cloudflare Tunnel so remote staff connect without exposing your IP. Details: https://zesqre.com/llms.txt