Architecture Diagram

TapIn EventFlow
Full-Stack Architecture

A real-time event operations and intelligence platform — managing organizations, events, attendees, NFC check-ins, live monitoring, and reporting from a single unified system.

End-to-End Check-In Flow

Attendee / NFC Tap
Check-In URL
Backend API
Database
Live Monitor
Architecture Layers

React-based web app with role-based dashboards for super admins, organizers, and check-in staff.

Admin Dashboard

System-wide KPIs — orgs, events, check-ins, walk-ins, activity feed

Organization Manager

Create and manage partner organizations, contacts, billing status

Event Builder

Create events with walk-in mode, directory, check-out toggles, and station config

Attendee Manager

Upload CSV, preview imports, filter by status, search by name/phone/email

Staff Check-In Screen

Large-button mobile UI for searching, tapping to check in, and adding walk-ins

Live Event Monitor

Real-time check-in feed, progress bars, hourly charts, station breakdown

Reports & Exports

Attendance summaries, no-show reports, station performance — CSV export

Billing Module

Per-event billing records with plan type, payment status, and mark-paid action

Mobile-first check-in system accessed via unique NFC/QR station URLs. Handles registered lookup, walk-ins, and check-out.

NFC Check-In URL

Station-specific URL: /checkin/{eventId}/{stationId} — triggered by NFC tap

Attendee Lookup

Search by mobile number or name — instant match against event roster

Check-In Confirmation

One-tap confirm → logs timestamp, method, station, staff user

Walk-In Capture

If walk-in mode enabled → create attendee on-the-fly and check them in

Undo Check-In

Staff can reverse a check-in within the session for error correction

Station Auth

Station URLs are event-scoped — staff cannot access other events

All event operations, attendee management, check-in processing, and reporting logic run through the backend service layer.

API Gateway

Secure, rate-limited entry point — all frontend requests pass through here

Auth & RBAC

JWT sessions + role-based access: Super Admin, Organizer, Staff

Attendee Service

CRUD operations, CSV import pipeline, duplicate detection, status tracking

Check-In Engine

Validates attendee, creates CheckInLog entry, updates attendee status in real-time

Real-Time Sync

Websocket / subscription layer — Live Monitor updates without page refresh

Import Processor

Validates CSV rows, flags duplicates and missing fields, previews before commit

Analytics Engine

Aggregates check-in counts, walk-in rates, peak times, station performance

Billing Service

Per-event billing records, plan assignment, payment status management

All platform data is stored in structured, indexed collections optimized for real-time read/write operations during live events.

Organizations

Org profile, contact info, billing status, linked events

Events

Event config, walk-in mode, directory toggle, check-out settings, station list

Attendees

Full attendee records — name, phone, email, business, ticket type, check-in status

CheckInLogs

Every check-in: attendee ID, event ID, timestamp, method, station, staff user

Stations

Station name, type (Entrance/VIP/Booth/Exit), location, staff assignment, NFC URL

UploadedFiles

CSV import records with raw data, row validation results, import status

BillingRecords

Plan type, price, payment status, payment date per event

EventSettings

Per-event configuration flags, branding, custom fields

Platform infrastructure built for high-concurrency live event scenarios — handles hundreds of simultaneous check-ins without degradation.

Cloud Hosting

AWS / GCP — auto-scaling compute for event-day traffic spikes

CI/CD Pipeline

Automated testing and zero-downtime deployments

Monitoring & Alerts

System health, check-in latency, error rate tracking

Security Layer

DDoS protection, WAF, HTTPS everywhere, encrypted PII at rest

Backup & Recovery

Automated daily backups — event data is never lost

Core Data Entities

Organizations

Partner orgs

Events

Event config

Attendees

Roster & status

CheckInLogs

Every check-in

Stations

NFC stations

BillingRecords

Per-event billing

UploadedFiles

CSV imports

EventSettings

Config flags

Users

RBAC users

CheckOutLogs

Exit tracking

What Organizers Can Do

Create & Manage Events

Build events with full config — walk-ins, stations, check-out tracking, and expected attendance.

Upload Attendees

Import CSV rosters with duplicate detection, row validation, and approve-before-import preview.

NFC Check-In

Deploy station URLs via NFC or QR — staff taps, finds attendee, confirms check-in in seconds.

Monitor & Report

Watch real-time check-in feeds, station charts, and export full event reports as CSV.

TapIn EventFlow — Full-Stack Architecture Overview · 2026