GateFlow Client
================

This package is the official GateFlow Client runtime for a Gate Device.
A Gate Device can be any laptop, desktop, or mini PC running Microsoft
Windows.

Client flow
-----------
Website prepares. Gate Device runs. Activation finalizes account-side
setup.

1. Sign in to your GateFlow account on the website.
2. On the website, walk the five guided steps: Operation (name, date,
   venue) -> Access types (add one row per type with a quantity, e.g.
   General Admission 10,000, VIP 500, Staff 100) -> Generate (review,
   then mint a secure QR for every admission) -> Export (download the
   CSV with links or the printable QR ZIP and distribute your way) ->
   Operation Key (generate the key, copy it; it is shown once).
   GateFlow is admission-inventory based: no guest-list upload, no
   gates to configure on the website.
3. Start GateFlow on the Gate Device. The first screen is "Activate
   Operation". Paste the Operation Key and click Activate Operation.
   The Gate Device runs the entire setup in one guided step: it
   activates with GateFlow, binds this Gate Device to the operation,
   downloads the operation, and becomes Ready for Offline Use. The
   Gate Device never asks for your GateFlow account email or password.
4. After activation, the account-side setup is view-only for this
   operation so live entry stays consistent. You can still view the
   summary, see Gate Device and sync status, and re-download the CSV
   and ZIP for distribution.
5. Approve scanners locally from the dashboard. Staff phones reach the
   Gate Device over the venue's local Wi-Fi.
6. Run entry locally. Validation, duplicate protection, re-entry
   checks, and per-device counters stay local. Internet is needed for
   activation and sync; internet is not needed for live admissions
   after activation finishes. Local Wi-Fi is still needed during the
   event so staff phones can reach the Gate Device.
7. Press End Operation when the event is over. The Gate Device freezes,
   auto-syncs the final results, and closes the operation on your
   account.

What an Operation Key is and is not
-----------------------------------
- It activates one operation on a Gate Device.
- It can be revoked or regenerated from your GateFlow account.
- It does NOT give access to billing, account settings, payments, or
  other operations.
- It does NOT act as your account password.

Positioning
-----------
GateFlow is QR entry control for events. It controls entry for every
ticket, pass, and invite. It is not a ticketing platform, payments
platform, marketplace, or message-delivery service. GateFlow does not
replace how access is distributed; it makes entry controlled. After
GateFlow generates QR admissions, distribute them through your own
channels: paper tickets, stickers, printed passes, wristbands,
WhatsApp, Instagram, email, bank transfer, cash, your existing
ticketing platform, or any tool your team already uses. GateFlow does
not pick the channel.

Automation notes
----------------
- Starter admissions refresh monthly and are protected by GateFlow review controls.
- Confirmed-admission purchases are requested from the website and synced back after Paymob confirms payment.
- Website sync retries automatically when connectivity returns.
- Manual help should only be needed for real exception cases.

Usage definition
----------------
1 usage = the first successful admission of a unique QR for that operation.

What does not count again
-------------------------
- duplicate scans
- denied scans
- retries
- re-entry

Scanner approval
----------------
Every phone must enter a scanner name and wait for approval from the local client dashboard.
Blocked phones cannot reconnect or scan until they are unblocked and request approval again.

Files in this package
---------------------
- GateFlow.exe
- Start_GateFlow.bat
- README.txt
- SETUP_GUIDE.md
- FAQ.md