🎫 RFID Tapping System

Production-Ready Event Management & Visitor Tracking

Real-time analytics • Interactive gaming • IoT integration

Status Tests Coverage

🎯 What is this?

An intelligent RFID-based system designed for large-scale events like exhibitions and conferences. It combines IoT hardware, real-time data processing, and interactive dashboards to transform how events track visitors, manage crowds, and engage attendees.

Built for EngEx 2025 - University of Peradeniya

✨ Key Features

🔄 Real-Time Tracking

  • Instant RFID card detection
  • Live visitor flow monitoring
  • Multi-zone booth tracking
  • FIFO queue management

📊 Smart Analytics

  • Real-time crowd metrics
  • Historical trend analysis
  • Venue occupancy insights
  • Visitor behavior patterns

🎮 Interactive Gaming

  • Team-based scoring system
  • Live leaderboards
  • Achievement tracking
  • Engagement rewards

🛠️ Admin Control

  • System configuration panel
  • Live event monitoring
  • User management
  • Complete data control

🏗️ How It Works

System Architecture

📡 RFID readers detect cards at registration, exits, and activity zones
🔄 MQTT broker routes messages in real-time across the system
⚙️ Backend API processes events, updates database, and manages game logic
📊 Live dashboards display analytics, leaderboards, and admin controls
🎮 Interactive interface engages visitors with games and feedback

💻 Technology Stack

Component Technology
Hardware ESP8266 + RDM6300 RFID (125kHz)
IoT MQTT (Mosquitto), WiFi, JSON
Backend Node.js, Express, WebSocket
Frontend React, Vite, TailwindCSS
Database PostgreSQL
Testing Jest, Vitest (1,455+ tests)

🚀 Quick Start

One command deployment:

# Run with default settings
.\deploy-local.ps1

# Or customize with parameters
.\deploy-local.ps1 -PgPassword "YourPassword" -BackendPort 4000

# When done, press ENTER to automatically cleanup everything

Access your system:
🌐 Dashboard: http://localhost:5173
🔌 API: http://localhost:4000
💾 Database: localhost:5432
📡 MQTT: localhost:1883

Automatic Cleanup: Press ENTER when finished to stop all services, close windows, stop Mosquitto, and drop database (unless -NoDropDb specified).

📖 Need more details? Check the complete documentation or deployment guide for all available parameters and options.

📊 System Highlights

✅ Production Ready - Fully tested and deployment-ready
🧪 99.9% Test Success - 1,455+ passing tests across all components
📈 89% Code Coverage - Comprehensive test coverage
🔒 Secure - No hardcoded credentials, proper secret management
🎨 Modern UI - Responsive design for mobile and desktop
⚡ Real-Time - Live updates via WebSocket and MQTT
🔧 Easy Setup - Single-script automated deployment

👥 Team

University of Peradeniya - Department of Computer Engineering
S. Ganathipan - e21148@eng.pdn.ac.lk
V.G. Amirsha - e21152@eng.pdn.ac.lk
K. Kartheepan - e21214@eng.pdn.ac.lk
S. Kavishanthan - e21220@eng.pdn.ac.lk

Supervisor: Ms. Yasodha Vimukthi (yasodhav@eng.pdn.ac.lk)

📦 GitHub Repository - View source code
📖 Complete Documentation - Detailed setup & API docs
🚀 Deployment Guide - Step-by-step installation
🏛️ Department of Computer Engineering
🎓 University of Peradeniya

🎓 Academic Context

Course: CO227 Computer Engineering Project
Institution: University of Peradeniya
Year: 2024-2025
Event: EngEx 2025 - Engineering Exhibition

This project demonstrates the integration of IoT hardware, real-time systems, web technologies, and database management to solve real-world event management challenges.

Made with ❤️ for EngEx 2025 Transforming event experiences through intelligent RFID technology