FlowGate

Step 1: Create an Event
Go to the Manage tab. Enter event name, venue, date, start/end time, and expected capacity. Click Create Event.

Step 2: Add Gates
Still in Manage, select your new event from the dropdown. Under "Gates for Selected Event", add your gates (e.g. Gate A - General, Gate B - VIP). Each gate can have multiple scanner stations.

Step 3: Set Up Scanners
In Manage, create an Access Token with role "Scanner". Open scanner.html on a phone/tablet, enter the token. The scanner is ready — scan QR codes or enter ticket codes manually.

Step 4: Upload Guest List
Go to Guests tab. Upload a CSV with columns: name, email, type, ticket_code. Or add guests one by one.

Step 5: Go Live!
In Manage → Event Controls, click Go LIVE. The dashboard will start showing real-time data. Share the live status link with attendees.

Step 6: Monitor
Watch the Dashboard tab for real-time stats. Use AI Analyst to ask questions. Check Zones for crowd safety. Open Predictions for arrival forecasts.

Dashboard (Overview) — Your command center. Shows total scans, unique guests, gate throughput, live/idle gate count, and an arrival trend chart. Select an event from the top dropdown to load its data. Auto-refreshes every 10 seconds when event is live.

Gates — Detailed per-gate view. Each gate shows: total scans, scan rate per minute, unique guests, lane allocation, and status (active/idle). You can see which gates are under pressure and which have capacity.

Heatmap — Hourly grid showing scan intensity throughout the day. Darker cells = more scans. Helps identify peak hours and plan staffing. Toggle between week/day view.

Predictions — AI-powered arrival forecasting using EWMA (Exponential Weighted Moving Average). Shows 30-minute prediction window, anomaly detection (unexpected spikes/drops), and historical pattern comparison. Weather data is integrated if available.

Analytics — Deep-dive: arrival curves, entry speed analysis, no-show rates, peak detection, and dwell time. Cross-event benchmarks available in the Benchmarks tab.

Open /scanner.html on any phone or tablet. It works as a PWA — add to home screen for native app experience.

Modes:

• QR Scan — Uses device camera to scan ticket QR codes. Supports haptic feedback and sound confirmation.
• Manual Entry — Type ticket codes manually (FG-XXXXXXXXXXXX format).
• Manual Count — Quick headcount mode for venues without individual ticketing.
• Exit Mode — Toggle to scan check-outs instead of check-ins (bidirectional tracking).

Offline Mode: If internet drops, scans are saved to IndexedDB and auto-synced when connection returns. A queue indicator shows pending scans.

Night Mode: Red-tinted display for outdoor events after dark — preserves night vision and reduces phone glare.

Operator Commands: Dashboard admins can send commands to scanners (e.g. "switch to Gate B", "pause scanning"). Commands appear as pop-up notifications on scanner.

Zones — Define areas of your venue (Main Stage, VIP Area, Food Court, etc.) with max capacity. Real-time occupancy tracking via entry/exit scans. Color-coded status: green (<60%), yellow (60-80%), orange (80-90%), red (>90%).

Incidents — Full incident management system. Create incidents with priority (low/medium/high/critical), assign to team members, track workflow (open → in-progress → resolved). Attach photos. Push notifications sent to relevant staff when critical incidents are created.

Alerts — Auto-generated alerts when: zone capacity exceeds threshold, gate throughput drops unexpectedly, anomalies detected in arrival patterns, or scheduled report triggers fire.

Alert Rules (custom) — Create your own rules: "If scans per minute at Gate A exceeds 50, send notification". Conditions support: metric, operator (>, <, ==), value. Actions: in-app notification, webhook, push notification.

Guest List (Guests tab) — View, search, and manage all guests for an event. Supports:

• Bulk CSV Upload — Upload a CSV file with columns: name, email, type, ticket_code. Supports thousands of guests at once.
• Manual Add — Add individual guests with name, email, type (General/VIP/Guest/Press), and optional ticket code.
• Search — Search by name, email, or ticket code.
• QR Ticket Generation — Auto-generates unique ticket codes (FG-XXXXXXXXXXXX). Guests receive codes to show at gates.

Guest Self-Service Portal (/guest.html) — Public page where attendees can look up their ticket by code or email. Shows event info, ticket type, check-in status, and their ticket code to present at gates.

Ticket Validation — At scan time, the system validates: ticket exists, not already used, correct event, correct gate type (VIP ticket → VIP gate).

Team Management (Team tab) — Add team members with roles:

• Admin — Full access. Can create events, manage team, view all data.
• Manager — Can manage events, gates, guests. Cannot manage organization settings or team.
• Scanner — Scanner app access only. Can scan tickets at assigned gates.
• Viewer — Read-only dashboard access. Can view stats but cannot modify anything.

Access Tokens (Manage tab) — Generate tokens for scanner devices or external systems. Each token has a role and label. Revoke anytime.

API Keys (API Keys tab) — Create API keys (prefixed fg_) for external integrations. Scoped per event or global. Rate-limited. Keys are hashed on storage — you see the key only once at creation.

Audit Log — Every action (login, create event, scan, status change) is logged with timestamp, user, and details. Visible in Team tab.

AI Crowd Analyst (AI Analyst tab) — Powered by Claude. Ask any question about your event in natural language:

• "Should I open more gates?"
• "What's the predicted peak time?"
• "How does today compare to our last event?"
• "Give me a full status overview with recommendations"

The AI has access to all your event data: scans, gates, zones, weather, predictions, incidents. Answers with specific data and actionable recommendations.

Predictions v3 (Predictions tab) — Uses EWMA (Exponential Weighted Moving Average) + historical pattern matching + anomaly detection. Shows 30-minute forecast, confidence intervals, and pattern-based predictions.

Weather-Aware Predictions (Weather tab) — Integrates Open-Meteo API. Shows how weather conditions (rain, temperature, wind) historically affect attendance, adjusts arrival predictions accordingly.

NL Revenue Commands (Commands tab) — Type business rules in plain English: "Alert me when remaining tickets drop below 1000". Claude AI parses it into a structured rule and you can apply it with one click.

Revenue OS tracks ticket sales performance and automates business rules for your events.

Revenue Tab — KPIs:

• Break-Even % — How close you are to covering costs. Set break-even target in Manage.
• Sell-Out Probability — Linear projection based on current velocity and days to event. Shows 0-100% likelihood of selling out.
• Risk Score — 0-100 composite risk assessment. Factors: break-even gap, remaining days, velocity trend. Higher = more risk.
• Velocity Trend — Are ticket sales accelerating, decelerating, or stable? Based on comparing current vs. previous velocity.

Importing Data: In the Revenue tab, paste JSON with ticket data: {"tickets_sold_total": 800, "revenue_gross_total": 32000, "remaining_tickets": 4200} and click Import. Supports multiple imports over time to track trends.

Revenue Rules (Rev Rules tab) — Create automated rules that run every 15 minutes. Example: "If tickets_sold > 1000 AND risk_score < 30, then notify success". Rules support AND/OR conditions with any metric.

NL Commands (Commands tab) — Write rules in English, AI parses them into structured JSON, click Apply to activate.

Revenue Log (Rev Log tab) — Full audit trail of every rule evaluation and action taken.

Cron Engine: Every 15 minutes the system automatically: processes pending imports → computes fresh KPIs → evaluates all active rules → dispatches actions (with idempotency and cooldown checks).

Live Status Page (/status.html) — Public page for attendees. Shows: crowd level indicator (low/moderate/busy/near capacity), recommended gate, venue capacity progress, gate wait times, zone occupancy. Auto-refreshes every 15 seconds. Share via Manage → "Share Live Status".

Kiosk Self-Check-In (/kiosk.html) — Set up a tablet at the venue entrance. Guests type their ticket code and check themselves in. Full-screen mode optimized for kiosk displays.

Guest Portal (/guest.html) — Guests look up their ticket by code or email. See event info, ticket type, check-in status.

Embeddable Widget (Widget tab) — Generate an HTML snippet that shows live event stats. Paste it into your website or event page. Shows real-time scan count, capacity, and status.

Venue Map (Map tab) — Interactive canvas-based venue map. Drag and drop gates, define zones. During a live event, shows real-time density colors per zone.

Webhooks (Webhooks tab) — Send real-time HTTP POST notifications to any URL when events occur: scan completed, capacity threshold reached, incident created, gate status changed. Configure per-event or global.

Slack Integration — Add a Slack webhook URL in Webhooks tab. Receive formatted Slack messages for alerts, incidents, and milestones. Uses Slack Block Kit for rich formatting.

API Keys — Build custom integrations using the full FlowGate API. Create scoped API keys in the API Keys tab. Use as Authorization: Bearer fg_xxxxx header. Over 70 endpoints available.

Push Notifications — Browser push notifications via Web Push (VAPID). Subscribe from dashboard or scanner. Receive alerts for: critical incidents, zone capacity warnings, operator commands.

Post-Event Report (Report tab) — Comprehensive report with: total scans, peak hours, gate performance, zone occupancy timeline, incidents summary, staff leaderboard. Filter by date range and sections.

PDF Export — Export any report as PDF (powered by jsPDF). Includes charts, tables, and summary statistics.

CSV Export — Export raw data from any table: scans, guests, incidents, metrics, timeline. Available in most tabs via export button.

Scheduled Reports (Cron tab) — Set up automatic report generation and email delivery. Configure frequency (daily/weekly/post-event) and recipients.

Event Comparison (Compare tab) — Select two events and compare side-by-side: total scans, peak rate, gate distribution, timing patterns.

Shareable Links (Manage tab) — Generate public links for status pages or reports. Share with stakeholders without giving them dashboard login.